# MediaWiki/Installazione

MediaWiki
Copertina Tutti i moduli · Sviluppo
IntroduzioneMediaWiki/Introduzione
Markup NamespaceMediaWiki/Namespace TemplateMediaWiki/Template Ricerca SkinMediaWiki/Le skin EdittoolsMediaWiki/Edittools Importazione ed esportazioneMediaWiki/Importazione ed esportazione API
PrerequisitiMediaWiki/Installare i programmi necessari - InstallazioneMediaWiki/Installazione - ConfigurazioneMediaWiki/Configurazione - LocalSettings.phpMediaWiki/LocalSettings.php UploadMediaWiki/Upload
Personalizzare la graficaMediaWiki/Personalizzare la grafica
* Hacking interfacciaMediaWiki/Hacking interfaccia
* La barra lateraleMediaWiki/La barra laterale
* La toolbar di modificaMediaWiki/
* Altre personalizzazioni graficheMediaWiki/Altre personalizzazioni grafiche
Cancellare vandalismi in Ultime modificheMediaWiki/Ultime modifiche Limitare l'accesso al wikiMediaWiki/Restrizioni di accesso AggiornamentoMediaWiki/Aggiornamento Dump JavascriptMediaWiki/Javascript AltroMediaWiki/Come fare per
Le estensioniMediaWiki/Estensioni
* Semantic MediaWikiMediaWiki/Semantic MediaWiki
* Formule matematicheMediaWiki/TeX
* Estensione CollectionMediaWiki/Estensione Collection
* Estensione WarnNoCategoriesMediaWiki/Estensione WarnNoCategories
Contribuire allo sviluppo di MediaWikiMediaWiki/Contribuire Grammatica del markup GlossarioMediaWiki/Glossario
Modifica il sommario

## Requisiti

È necessario avere i permessi in lettura e scrittura delle cartelle e delle sottocartelle dove si installa MediaWiki, nonché del database. In caso contrario, le tecniche descritte in questo manuale potrebbero non funzionare.
Inoltre, per garantire che il wiki risponda in tempo utile alle richieste in scrittura da parte degli utenti, è consigliabile assicurarsi che il servizio sia in grado di gestire il traffico che si prevede per il proprio wiki. MediaWiki è stato pensato per girare su siti con un intenso traffico web, come Wikipedia. Essendo stato ottimizzato per questo uso, potrebbe non operare al meglio su siti di piccole dimensioni e con poca capienza di banda.

### Ambiente e hardware

I requisiti minimi di MediaWiki sono:
* l'interprete PHP, necessario per eseguire il software;
* un database manager, cioè il software che permette a MediaWiki di leggere e scrivere su database;
* un web server, cioè il software che indirizza a MediaWiki le richieste inviate al computer in uso.
Inoltre, è necessario creare un database: quello che sarà usato da MediaWiki. È possibile farlo dal pannello di controllo del database manager in uso.
Le versioni di PHP compatibili sono indicate nella documentazione di MediaWiki.
L'hardware minimo richiesto è di 256MB di RAM per il sito su un computer singolo con 40MB di spazio su disco, sebbene questo non sia possibile per un sito pubblico trafficato con l'upload abilitato. Alcuni utenti sono riusciti a far partire MediaWiki su computer con 48MB di RAM.

### Software aggiuntivi

* zlib: compressione dati; utilizzata in alcune funzioni di esportazione; (EN) http://www.zlib.net
* diff: evidenza le differenze tra due documenti; (EN) http://www.gnu.org/software/diffutils/diffutils.html
* ImageMagick: gestione delle immagini; (EN) http://www.imagemagick.org
* eAccelerator: cache pensata per migliorare le prestazioni di PHP e rendere più veloce il caricamento delle pagine; questo software non è obbligatorio, ma è consigliato per wiki con molte pagine e molti utenti; per l'installazione, vedi eAccelerator; (EN) http://www.eaccelerator.net

## Posizionare MediaWiki sul web server

* Individuare la cartella in cui il web server contiene i documenti Web.
* Scaricare MediaWiki da http://www.mediawiki.org/
* Decomprimere il pacchetto compresso
* Salvare i file in una sottocartella della "document root".

### Punto 1

Individuare la cartella in cui il web server contiene i documenti Web. In genere è chiamata "document root". Per conoscerne il percorso, consultare la documentazione del web server e i suoi file di configurazione (che potrebbero assegnarle un valore diverso). Per esempio, su Apache è per default /usr/local/apache/htdocs; sul server HTTP di BusyBox e su LightTPD il default è /var/www.

### Punto 2

Su Unix e Unix-like è sufficiente eseguire

### Punto 3

Salvare i file in una sottocartella della "document root". Assicurarsi di avere i permessi in lettura e scrittura su questa sottocartella.
Se il server è il computer locale, si copiano banalmente i file da una cartella ad un'altra. Se il server è remoto, si copia il contenuto via FTP, usando un apposito programma o una estensione del browser in uso.

### In sintesi

Per esempio, da terminale in ambiente Unix:

## Installazione

Aprire in un browser la pagina mediawiki*/config/index.php e compilare i campi richiesti.
Dopo questa configurazione, è necessario mettere il file creato dalla procedura di configurazione nella cartella principale di MediaWiki:
(per sicurezza, bloccare l'accesso alla cartella di configurazione con questa riga:)

### Configurare MediaWiki

Al primo avvio di MediaWiki appare la schermata per la configurazione del wiki. La configurazione si svolge con una procedura guidata che chiede alcune informazioni e in base ad esse
* genera in automatico le tabelle del database che sarà usato da MediaWIki
* al termine, genera il file di configurazione LocalSettings.php, il quale andrà infine copiato nella cartella in cui MediaWiki è stato copiato.
Per installare più copie di MediaWiki, è sufficiente copia-incollare i file in cartelle diverse e configurare separatamente ciascuna di queste copie, incollando ciascuno dei file LocalSettings.php nella cartella del rispettivo wiki.
La procedura guidata dà una serie di campi, che vanno lasciati ai valori di default, se non per alcune eccezioni.
All'inizio la procedura chiede di impostare i seguenti campi:
* La lingua da usare nel seguito della procedura guidata
* La lingua del wiki
A questo punto, viene svolto un controllo automatico che verifica se MediaWiki può essere installato. La procedura elenca un insieme di informazioni che saranno utili qualora si riscontrassero problemi causati da errori durante l'installazione. La maggior parte delle righe sono note informative del fatto che le rispettive operazioni hanno avuto successo. Altre note, le warning, non indicano errori, ma situazioni che potrebbero essere fonte di problemi e meritano attenzione.
Quindi sono richieste le informazioni per connettersi ad uno dei database manager installati sul sistema, e le informazioni necessarie per connettersi ad uno dei database. Il database deve essere stato creato in precedenza.
* Database host: il dominio del database. Il valore localhost indica che il database si trova sullo stesso computer del wiki.
* Database name: il nome del database che MediaWiki dovrà usare.
* Database username e password: username e password che MediaWiki userà per accedere al database.
* Database table prefix: un prefisso che viene apposto davanti al nome di ciascuna tabella creata da MediaWiki in quel database. Può essere omesso, tuttavia risulta molto utile se si vuole condividere qualcuna delle tabelle con un altro wiki, oppure se installano più wiki su uno stesso server che non permette di creare altri database: infatti, serve per non confondere le tabelle fra i diversi wiki installati, così da assicurare che non ci siano conflitti. Esempio: itwiki_p
Una volta che MediaWiki si è connesso al database, la procedura chiede alcune informazioni aggiuntive.
* Use the same account as for installation: lasciare il segno di spunta per usare ogni volta le impostazioni inserite nella schermata precedente.
* Storage engine (si può lasciare il default)
* Database character set (si può lasciare il default)
Nella schermata successiva bisogna inserire
* il nome della wiki
* il nome del namespace di progetto (per esempio Wikipedia).
Inoltre, sul wiki sarà creato un account iniziale: inserire il nome utente, la password, e opzionalmente la e-mail (utile in caso di smarrimento della password). La password deve essere diversa dal nome utente.
Dopo aver cliccato su "Continua", la procedura guidata chiede una ulteriore conferma prima di cominciare con l'installazione, al termine della quale viene generato in automatico il file LocalSettings.php che contiene le personalizzazioni inserite durante la procedura guidata: questo file va salvato e quindi copiato nella cartella di MediaWiki.
* Schermata iniziale.
* Si impostano la lingua della procedura guidata e la lingua del wiki.
* Prima di cominciare, MediaWiki controlla i requisiti di sistema.
* Sono richieste le informazioni per la connessione al database manager.
* Sono richieste le impostazioni per configurare il database.
* Sono richiesti i parametri che configurano la wiki.
* Prima di installare, viene chiesta una conferma.
* L'installazione in corso.
* Installazione completata. LocalSettings.php è stato generato.

## Collegamenti esterni

* Download di MediaWiki
* Manual:Errors
* Manual:Errors#Warning