Manuale:Installazione MediaWiki
Questa pagina descrive i passaggi necessari per installare manualmente MediaWiki. Dopo l'installazione, ulteriori dettagli della configurazione si possono trovare su Manual:System administration#Configuration.
Per installare MediaWiki è necessaria una conoscenza di base dell'hosting web. Avere esperienza con Apache, PHP e MySQL/MariaDB renderà il processo più semplice. Per qualsiasi domanda riguardante l'installazione di MediaWiki, consultare Project: Support desk o fare riferimento alle altre risorse indicate in Comunicazione.
La sezione seguente Appendices offre alternative più semplici all'installazione manuale, insieme a note di installazione specifiche per differenti configurazioni di sistema.
Per una configurazione del server locale più veloce di MediaWiki, si veda il Local development quickstart.
Requisiti di installazione
Verificare che il sistema soddisfi i requisiti di installazione.
Assicuratevi di controllare anche le Note di rilascio della versione di MediaWiki che intendete installare.
Download del software MediaWiki
Scaricare il file tar MediaWiki dalla pagina ufficiale di download.
Se utilizzi MediaWiki in un ambiente di produzione, il responsabile delle release ha fortemente raccomandato di utilizzare in produzione esclusivamente le versioni elencate in Ciclo di vita delle versioni e fine del supporto come "versione stabile", "versione legacy" o "versione con supporto a lungo termine". Le versioni più vecchie possono contenere vulnerabilità di sicurezza critiche e altri gravi difetti, compreso il rischio di perdita e/o corruzione dei dati. La versione stabile attuale è MediaWiki 1.46.0.
Estrarre il software MediaWiki
I file scaricati sono nel formato .zip o .tar.gz.
È necessario decomprimere questo file di archivio prima di utilizzarlo.
È possibile decomprimere il file localmente (e poi caricarlo via FTP sul server) o direttamente sul server.
In Windows puoi farlo con programmi come 7-Zip (libero), WinZip, WinRAR o IZArc (libero).
Su Linux e Mac OS X, puoi decomprimere il file utilizzando
questo comando:
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder> Per ulteriori informazioni sulla protezione delle autorizzazioni dei file, consultare Manual:Security#Permessi dei file.
Caricare i file sul server
Se non hai ancora caricato i file sul tuo server web (oppure copiato i file, nel caso in cui il software del server web sia in esecuzione localmente sul tuo localhost), fallo ora.
I file devono essere collocati nella directory radice dei documenti del server web (ossia la directory in cui si troverebbe index.html se tale file fosse accessibile tramite un URL come https://www.example.com/index.html).
Questa directory avrà un nome simile a: html, public_html, http, htdocs, www, web.
Potrebbe trovarsi nella directory del server, ad esempio: /var, /srv, /usr/share.
Su un server condiviso, si troverà nella tua directory principale (home directory).
Se stai utilizzando il web server Apache HTTPD, la directory corretta è specificata nel tuo file httpd.conf nella direttiva DocumentRoot.
Per impostazione predefinita, questo è /var/www/ oppure <apache-folder>/htdocs.
La posizione esatta del file delle impostazioni e delle directory del server Apache httpd.conf dipende dal sistema operativo in uso.
In Debian e Ubuntu, il file per le impostazioni e le directory del server Apache è /etc/apache2/apache2.conf.
Su Red Hat e Fedora, il file è /etc/httpd/conf/httpd.conf.
Caricare i file nella directory web del server web tramite:
- Copiando direttamente la cartella decompressa oppure
- Mediante un client FTP come FileZilla (Windows, macOS e Linux) o Cyberduck (Windows e macOS).
- utilizzando il software già fornito dal tuo servizio di hosting, come cPanel File Manager
Se lo strumento utilizzato per il caricamento dispone dell'opzione "converti i nomi dei file in minuscolo", è necessario disattivarla per evitare modifiche indesiderate ai nomi dei file durante il processo di caricamento.
Rinominare la cartella caricata con il nome desiderato, poiché questo determinerà come apparirà nell'URL.
Ad esempio, se si cambia il nome della cartella a wiki, l'URL rifletterà questo come example.com/wiki.
Se il vostro server web funziona come http://localhost, ad esempio, rinominare la directory in /w/ significherebbe accedere al vostro wiki da http://localhost/w/index.php.
/wiki/ se si vuole configurare gli URL brevi dopo aver eseguito lo script di configurazione iniziale.
Impostare il database
Lo script di configurazione iniziale di MediaWiki richiede un nome di database e un nome utente del database per memorizzare i contenuti del wiki.
Se disponi già di un server di database e conosci la password dell'utente root (amministratore), puoi passare direttamente alla sezione Eseguire lo script di installazione.
Se non conosci la password dell'utente root, ad esempio perché utilizzi un servizio di hosting, dovrai creare un nuovo database prima di procedere con lo script di installazione di MediaWiki.
I database raccomandati sono MariaDB/MySQL. Mentre PostgreSQL e SQLite sono supportati, offrono una compatibilità limitata e dovrebbero essere utilizzati solo se assolutamente necessario. Se non sei sicuro di quale database scegliere, usa MariaDB.
Una volta completata la configurazione del database, procedi con la sezione Eseguire lo script di installazione riportata di seguito
SQLite
Per SQLite non è richiesta alcuna configurazione aggiuntiva, a condizione che il modulo PHP pdo-sqlite sia installato nel sistema.
Nella pagina di installazione di SQLite, scegli un nome per il database (è possibile utilizzare qualsiasi nome) e una directory per il database SQLite. Il programma di installazione tenterà di utilizzare una directory esterna alla directory radice del sito web e la creerà, se necessario. Se questa directory è accessibile dal web o non è adeguatamente protetta, è consigliabile modificarla manualmente per prevenire accessi non autorizzati.
MariaDB/MySQL
Per creare il database e l'utente per MariaDB/MySQL, è possibile utilizzare uno dei seguenti metodi:
- Un pannello di controllo fornito dal servizio di hosting, come phpMyAdmin.
- Accesso SSH al server di hosting, da cui è possibile inserire i comandi riportati di seguito nel prompt di MySQL. Fare riferimento alla documentazione fornita dal proprio provider di hosting. In alternativa, è possibile richiedere al proprio fornitore del servizio di hosting di creare il database e l'utente per voi.
I seguenti comandi creeranno un database denominato my_wiki, un utente denominato wikiuser e assegneranno a tale utente le autorizzazioni sul database.
CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
Solo se il database non è in esecuzione sullo stesso server del server web, è necessario specificare il nome host appropriato del server web (mediawiki.example.com nell'esempio seguente):
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
 Attenzione: | MySQL/MariaDB registra tutte le query in un file della cronologia. Questo file conterrà anche la password del database dell'account utente. Se ciò desta preoccupazione, dopo aver eseguito queste query eliminare il file .mysql_history e impedirne la futura creazione seguendo le istruzioni riportate nella documentazione di MySQL. |
PostgreSQL
Se si utilizza PostgreSQL, è necessario che il database e l'utente vengano creati preventivamente oppure fornire al modulo di configurazione il nome di un utente PostgreSQL con privilegi di "superutente".
Spesso questo utente corrisponde all'utente del database denominato postgres.
I seguenti comandi, eseguiti dalla riga di comando di Linux come utente postgres, creano un utente del database denominato wikiuser e un database denominato my_wiki di proprietà dell'utente denominato wikiuser.
createuser -S -D -R -P -E wikiuser (quindi inserire la password del database) createdb -O wikiuser my_wiki
oppure, come superutente (per impostazione predefinita postgres), eseguire i seguenti comandi al prompt del database:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
Prestare attenzione alla lista dei problemi noti relativi all'esecuzione di MediaWiki con PostgreSQL.
Eseguire il script d'installazione
Successivamente, completare l'installazione di MediaWiki visitando con il browser web l'URL dell'installazione di MediaWiki. Seguire le istruzioni in Manual:Script di configurazione.
Configurazione successiva all'installazione
- Manuale:Amministrazione del sistema - Configurazione aggiuntiva
- Manuale:Amministratori - Amministrazione della wiki
Rimanere aggiornato
Una volta completata l'installazione, assicurarsi di mantenere MediaWiki aggiornato alle versioni più recenti e di proteggere adeguatamente il server.
Appendici
Alternative all'installazione manuale
L'installazione manuale è spesso il metodo preferito perché offre all'utente maggiore controllo e una migliore comprensione del processo di installazione del wiki, rendendo più semplici la risoluzione dei problemi e la manutenzione. I processi automatizzati, i pacchetti, i bundle e i servizi hanno tutti le proprie peculiarità.
Invece di installare manualmente MediaWiki, le opzioni alternative potrebbero essere più facili:
- soluzioni software preintegrate
- servizi di hosting con installazione in un solo clic o wiki farm
- software bundles
- I servizi di hosting che offrono l'installazione automatica di applicazioni come MediaWiki potrebbero fornire versioni non aggiornate o presentare altri problemi. Se si riscontrano problemi, ciò non significa che non sia possibile installare MediaWiki. Significa invece che è opportuno installare MediaWiki manualmente.
Vedere anche comparison of distribution options.
Istruzioni specifiche per sistema
Le pagine elencate in Manual:OS specific help forniscono istruzioni di installazione più dettagliate, destinate a sistemi specifici.
Tuttavia, nel complesso, questa documentazione specifica per sistema è meno curata e potrebbe non essere sempre aggiornata. Consulta innanzitutto Installazione MediaWiki (questa pagina) prima di passare alla documentazione di installazione specifica per i singoli sistemi.
Avviare più wiki
Consultare Manual:FAQ#Installazione e configurazione.
Importare un database wiki esistente
Consultare Manual:FAQ#Installazione e configurazione.