Manual:Instal·lació de MediaWiki
Aquesta pàgina inclou els passos per instal·lar manualment MediaWiki. Després de la instal·lació, podeu trobar més detalls de configuració a Manual:Administració_del_sistema#Configuració.
La instal·lació de MediaWiki requereix una familiaritat bàsica amb l'ús d'un allotjament web. El procés és més fàcil si teniu experiència amb Apache, PHP i MySQL/MariaDB. Per a qualsevol pregunta sobre les instal·lacions de MediaWiki, pregunteu a Project: Support desk o consulteu altres llocs llistats a Comunicació.
La secció d'Annexos a continuació ofereix alternatives a la instal·lació manual, juntament amb notes d'instal·lació específiques per a diferents configuracions del sistema.
Per a una configuració més ràpida del servidor local de MediaWiki, consulteu Local development quickstart.
Comproveu els requisits d'instal·lació
Comproveu que el vostre sistema compleixi els requisits d'instal·lació.
Assegureu-vos de comprovar també les Notes de llançament de la versió de MediaWiki que teniu previst instal·lar.
Descarregueu el programari MediaWiki
Baixeu el fitxer tar de MediaWiki des de la pàgina oficial de descàrrega.
Si feu servir MediaWiki en un entorn de producció, el gestor de versions haurà emès una recomanació ferma que només s'haurien d'utilitzar en un entorn de producció les versions llistades al cicle de vida de la versió i el seu final de vida com a "versió estable", "versió antiga" o "versió de suport a llarg termini". Les versions anteriors poden contenir vulnerabilitats de seguretat crítiques i altres errors importants, inclosa l'amenaça de possible pèrdua i/o corrupció de dades. La versió d'estable actual és MediaWiki 1.45.1.
Extraieu el programari MediaWiki
El fitxer descarregat està en format .zip o .tar.gz.
Heu de descomprimir aquest fitxer d'arxiu abans d'utilitzar-lo.
Podeu descomprimir el fitxer localment (i després carregar-lo mitjançant FTP al servidor) o directament al vostre servidor.
A Windows, la descompressió es fa normalment amb programari com ara 7-Zip (gratuït), WinZip, WinRAR o IZArc (gratuït).
A Linux i Mac OS X, podeu descomprimir el fitxer amb l'ordre:
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder> Per obtenir més informació sobre com assegurar els permisos de fitxers, consulteu Manual:Security#File_permissions
Carregueu els fitxers al vostre servidor web
Si encara no heu penjat els fitxers al vostre servidor web (o copiats, si el programari del vostre servidor web s'executa localment al vostre localhost), feu-ho ara.
Els fitxers pertanyen a l'arrel de documents del servidor web (és a dir, el directori on es trobaria index.html si aquest fitxer fos accessible a una URL com ara https://www.example.com/index.html).
Aquest directori tindrà un nom semblant a: html, public_html, http, htdocs, www, web.
Es pot trobar al directori del servidor, per exemple: /var, /srv, /usr/share.
En un servidor compartit, serà al vostre directori d'inici.
Si utilitzeu el servidor web Apache HTTPD, el directori correcte s'especifica al vostre fitxer httpd.conf a la directiva DocumentRoot.
Per defecte, això està a /var/www/ o <apache-folder>/htdocs.
La ubicació exacta de la configuració del servidor Apache i el fitxer de directoris httpd.conf depèn del vostre sistema operatiu.
A Debian i Ubuntu, el fitxer per a la configuració i els directoris del servidor Apache està a /etc/apache2/apache2.conf
A Red Hat i Fedora, el fitxer està a /etc/httpd/conf/httpd.conf.
Carregueu els fitxers al directori web del vostre servidor web, per algun dels tres sistemes:
- copiant directament la carpeta descomprimida o
- mitjançant un client FTP com FileZilla (Windows, OSX i Linux) o Cyberduck (Windows i OSX), o
- utilitzant programari que ja proporciona el vostre servei d'allotjament, com ara el cPanel File Manager
Si la vostra eina de càrrega té l'opció "canvia els noms dels fitxers a minúscules", aleshores heu de desactivar-la per evitar modificacions no desitjades als noms dels fitxers durant el procés de càrrega.
Canvieu el nom de la carpeta carregada pel nom que vulgueu, ja que això determinarà com apareixerà a l'URL.
Per exemple, si canvieu el nom de la carpeta a wiki, l'URL ho reflectirà com a example.com/wiki.
Si el vostre servidor web s'executa com a http://localhost, per exemple, canviar el nom al directori /w/ significaria que accedireu al vostre wiki a http://localhost/w/index.php.
/wiki/ si voleu configurar URL curtes després d'executar l'script de configuració inicial.
Configureu la base de dades
L'script de configuració inicial de MediaWiki requereix un nom de base de dades i un nom d'usuari de base de dades per emmagatzemar el contingut del wiki.
Si ja teniu un servidor de bases de dades i coneixeu la contrasenya de l'usuari "root" (admin), aneu a la secció #Executeu l'script d'instal·lació de més avall.
Si no coneixeu la contrasenya de l'usuari root, per exemple, si esteu en un servidor allotjat, haureu de crear una nova base de dades abans d'executar l'script d'instal·lació de MediaWiki a la secció següent.
MariaDB/MySQL són les bases de dades recomanades. PostgreSQL i SQLite tenen un suport limitat i no s'han d'utilitzar tret que hi hagi una raó per fer-ho. Si no esteu segur de quina base de dades triar, feu servir MariaDB.
Després d'acabar la configuració de la base de dades, continueu amb #Executeu l'script d'instal·lació de més avall.
SQLite
No cal cap configuració addicional per a SQLite si el mòdul pdo-sqlite per a PHP està instal·lat al sistema.
A la pàgina d'instal·lació de SQLite, seleccioneu un nom de base de dades (qualsevol nom és acceptable) i un directori de base de dades SQLite. L'instal·lador intentarà utilitzar un directori fora de l'arrel (root) dels documents i crear-lo si cal. Si aquest directori és llegible al web o no és segur, s'ha de canviar manualment per evitar l'accés no autoritzat.
MariaDB/MySQL
Creeu la base de dades MariaDB/MySQL i l'usuari de la base de dades.
- Un panell de control proporcionat pel vostre servei d'allotjament, com ara phpMyAdmin.
- SSH accedeix al vostre allotjador, on podeu introduir les ordres següents en un indicador de MySQL. Consulteu la documentació corresponent del vostre proveïdor d'allotjament. Alternativament, podeu sol·licitar que el vostre proveïdor d'allotjament us creï la base de dades i l'usuari.
Les ordres següents crearan una base de dades anomenada my_wiki, un usuari anomenat wikiuser, i estableixen permisos per a l'usuari en aquesta base de dades.
CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
Només si la vostra base de dades no s'executa al mateix servidor que el vostre servidor web, heu de donar el nom d'amfitrió del servidor web adequat (mediawiki.example.com en l'exemple següent):
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
 Atenció: | MySQL/MariaDB registra totes les consultes en un fitxer d'historial. Inclourà la contrasenya de la base de dades per al compte d'usuari. Si això us preocupa, suprimiu i desactiveu el fitxer .mysql_history després d'executar aquestes consultes seguint la documentació de MySQL. |
PostgreSQL
Si feu servir PostgreSQL, haureu de crear una base de dades i un usuari, o bé proporcionar el nom d'un usuari de PostgreSQL amb privilegis de "superusuari" al formulari de configuració.
Sovint, aquest és l'usuari de la base de dades anomenat postgres.
Les ordres següents en una línia d'ordres de Linux, com a usuari de postgres, creen un usuari de base de dades anomenat wikiuser i una base de dades anomenada my_wiki propietat de l'usuari anomenat wikiuser.
createuser -S -D -R -P -E wikiuser (després introduïu la contrasenya de la base de dades) createdb -O wikiuser my_wiki
o com a superusuari (postgres per defecte) executeu les ordres següents a l'indicador de la base de dades:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
Aneu amb compte amb la llista de problemes coneguts quan executeu MediaWiki amb PostgreSQL.
Executeu l'script d'instal·lació
A continuació, completeu la instal·lació de MediaWiki anant a l'URL de la vostra instal·lació de MediaWiki al vostre navegador web: Seguiu les instruccions a Manual:Script de configuració.
Més informació
- Manual:Administració del sistema - Configuració addicional
- Manual:Administrators - Administració de wikis
Manteniu-la al dia!
Un cop instal·lat, assegureu-vos de mantenir-vos al dia de les versions i manteniu el vostre servidor segur!
Apèndixs
Alternatives a la instal·lació manual
La instal·lació manual és sovint el mètode preferit perquè ofereix a l'usuari més control i informació sobre com s'instal·la la seva wiki, facilitant la resolució de problemes i el manteniment. Tots els processos, paquets i serveis automatitzats tenen la seva pròpia idiosincràsia.
En lloc d'instal·lar manualment MediaWiki, les opcions alternatives podrien ser més fàcils:
- dispositius de programari preintegrats
- serveis d'allotjament amb instal·lació amb un clic o granges de wikis
- Lots de programes
- Els serveis d'allotjament que proporcionen instal·lació automàtica d'aplicacions com ara MediaWiki poden oferir versions obsoletes o tenir altres problemes. Si teniu problemes, no vol dir que no pugueu instal·lar MediaWiki. Vol dir que heu d'instal·lar MediaWiki manualment.
Veges també el comparison of distribution options.
Instruccions específiques del sistema
Les pàgines que figuren a Manual:Ajuda específica per sistema operatiu donen instruccions d'instal·lació més detallades dirigides a sistemes específics.
No obstant això, en general, aquests documents per sistema estan menys mantinguts i potser no sempre estan actualitzats. Consulteu primer Instal·lació de MediaWiki (aquesta pàgina) abans de consultar la documentació d'instal·lació per sistema.
Execució de diversos wikis
Consulteu Special:MyLanguage/Manual:FAQ#Installation and configuration.
Importació d'una base de dades wiki existent
Consulteu Manual:FAQ#Installation and configuration.