Manual:Installing MediaWiki/it

MediaWiki si installa con uno script di installazione interattivo web-based. Prima di poter avviare il programma, devi fare un paio di cose. Per prima cosa, assicurati di aver installato Apache, PHP, e MySQL. Poi devi scaricare i pacchetti e caricare MediaWiki sul tuo server. Devi anche aver creato un nuovo database per la tua wiki. Se necessario, creati un account sul server seguendo le istruzioni riportate qui.

Per l'utente medio che non ha esperienza con Apache, PHP e MySQL l'installazione di MediaWiki può presentare delle difficoltà. La maggior parte degli utenti di un software wiki, potrebbe essere agevolata usando un host non a pagamento.

Nota: Per informazioni sui messaggi di errore, vedi Manual:Errors and Symptoms.

= == Download del software MediaWiki == =

Scarica MediaWiki dalla pagina di download o via SVN.

Decomprimi i file in locale o sul tuo server. Per questa operazione puoi adoperare software come 7-Zip (open source), WinZip, WinRAR o IZArc su Windows. Su Linux e Mac OS X, puoi decomprimerlo digitando:

tar xvzf mediawiki-*.tar.gz

Carica i file sulla cartella del web server usando un client FTP come FileZilla (Open Source, Windows) o Cyberduck (OS X). Se hai installato Apache, la cartella corretta è riportata nel file. Se stai usando Linux o Unix puoi copiare i file in una qualunque cartella e fare un symbolic link a quella cartella.

= == Preparare le cartelle == =

MediaWiki necessita di scrivere nella cartella  quando si esegue lo script di installazione Se non l'hai ancora fatto, devi cambiare i permessi per la sottocartella , seleziona attributi e seleziona scrivibile da proprietario Se ricevi un numero o se usi un'interfaccia da linea di comando, usa 755 (o 777 su Linux eccetto RedHat Linux). In alternativa, puoi usare il pannello di controllo dell'host.

A seconda della configurazione del server, in alcuni casi, dovrai selezionare tutte le caselle (777) in FileZilla, per lanciare il programma di installazione di MediaWiki.

Su Unix e Linux, se sei root, usa il comando  setta tua cartella.

= == Creare un database == =

Se conosci la password del tuo database, il programma di installazione di MediaWiki può creare un nuovo database per te. In questo caso, passa a Lanciare il programma di installazione più in basso. Se non conosci la password, se ad esempio, sei in un server hosted, devi creare un nuovo database. Al momento puoi usare sia MySQL che Postgres.

= ===MySQL=== =


 * Devi creare un database MySQL ed un utente prima di installare MediaWiki. Puoi farlo usando vari pannelli di controllo, come PhpMyAdmin, che sono spesso utilizzabili su host condivisi, oppure muoi usare ssh per connetterti all'host ed immettere il comando in un prompt MySQL. Vedi la documentazione corrispondente. In alternativa, contatta il tuo provider per fargli creare un account per te.
 * Scarica ed installa MySQL 5.0. Dovrebe essere messo in /usr/local/mysql
 * Controlla se il database server sta andando ("/usr/local/mysql/bin/mysqladmin status"), se no: sudo /usr/local/mysql/bin/safe_mysqld &. (Per Fedora Core 5, usa /usr/bin/mysqld_safe)
 * Un altro modo per far partire il server MySQL è lanciare lo script configure disponibile al root all'installazione. Questo crea la tabella iniziale e lancia automaticamente il daemon mysql.
 * Seleziona una password per l'account root nel tuo database server. /usr/local/mysql/bin/mysqladmin -u root password tuapassword
 * Seleziona un utente su MySQL, /usr/local/mysql/bin/mysql -u root -p mysql
 * Ora, nel client da linea di comando di MySQL, digita:

create database wikidb; grant create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'localhost' identified by 'password'; flush privileges; \q

Se il database non gira nello stesso server del web server, devi dargli il nome appropriato del web server: grant create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'mediawiki.example.com' identified by 'password';

= ===Postgres=== =

Se usi Postgres, devi avere un database ed un utente creato per te, devi avere un database ed un utente creati o semplicemente un account superuser.

Il database che MediaWiki usa necessità di plpgsql e tsearch2 installati. L'installer script cercherà di installare plpgsql, ma dovrai installare a mano tsearch2. (tsearch2 è usato per la rirceca nel wiki). Ecco un modo per fare la maggior parte del setup. Questo è per un sistema Unix-like e assume che si abbia già installato i moduli plpgsql e tsearch2. In questo esempio, creeremo un database chiamato wikidb, posseduto da un utente chiamato wikiuser. Digita, da linea di comando.

createuser -S -D -R -P -E wikiuser createdb -O wikiuser wikidb createlang plpgsql wikidb

Aggiungere tsearch2 al database non è un passo semplice ma potrebbe essere già stato fatto dal package al momento dell'installazione. In ogni caso, se l'installer non lo troverà, te lo segnalerà.

I passi seguenti non sono necessari, in quanto l'installer cercherà di fare qualcosa se sei un superuser.

Per installare tsearch2 nel database wikidb sotto Windows, esegui le seguenti istruzioni: Fine!
 * 1) trova tsearch2.sql (probabilmente in .\PostgreSQL\8.x\share\contrib) e copialo in postgresql\8.x\bin;
 * 2) da un terminale nella directory postgresql\8.x\bin digita "psql wikidb < tsearch2.sql -U wikiuser";
 * 3) digita la password;

Il punto 2 sembra funzionare solo su Windows, siccome si on debian linux 4.0 (e seg.) solo gli utenti postgres possono usare il linguaggio c. così, bisonga usare:

su - postgres -c psql wikidb < tsearch2.sql

seleziona i diritti per wikiuser per tsearch ed inserisci il locale corretto.

su - postgres psql -d wikidb -c "grant select on pg_ts_cfg to wikiuser;" psql -d wikidb -c "grant select on pg_ts_cfgmap to wikiuser;" psql -d wikidb -c "grant select on pg_ts_dict to wikiuser;" psql -d wikidb -c "grant select on pg_ts_parser to wikiuser;" psql -d wikidb -c "update pg_ts_cfg set locale = current_setting('lc_collate') where ts_name = 'default' and prs_name='default';"

Se ricevi un errore tipo "ERROR: relation "pg_ts_cfg" does not exist" eseguendo le istruzioni, prova ad installare ancora tsearch2 nel wikidb, ma questa volta, prova:

1) su - postgres 2) psql wikidb -f tsearch2.sql

= == Lanciare il programma di installazione == =

Una volta che tutti questi passi sono stati effettuati, puoi completare l'installazione dal browser. Vedi Manual:Config script/it per i dettagli.