Manual:Installing MediaWiki/ca

Aquesta pàgina inclou els passos per instal·lar manualment MediaWiki, amb passos de configuració addicionals que es troben a Manual:System_administration#Configuration.

La instal·lació de MediaWiki requereix una familiaritat bàsica amb l'ús d'un amfitrió web. És més fàcil si teniu experiència amb Apache (programari de servidor web), PHP i MySQL/MariaDB (base de dades). Hi ha ajuda addicional disponible a Project: Support desk.

La secció d'Annexos a continuació ofereix alternatives a la instal·lació manual. També proporciona notes d'instal·lació per a configuracions específiques del sistema.



Comproveu els requisits d'instal·lació
Comproveu que el vostre sistema compleixi els requisits d'instal·lació.

Assegureu-vos de comprovar també les 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.

En general, si utilitzeu un entorn de producció, voldreu executar la darrera versió estable, que és MediaWiki.



Extraieu el programari MediaWiki
El fitxer descarregat està en format  o. 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:



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 ), feu-ho ara.

Carregueu els fitxers al directori web del vostre servidor web, per algun dels tres sistemes:


 * 1) copiant directament la carpeta descomprimida o
 * 2) mitjançant un client FTP com FileZilla (Windows, OSX i Linux) o Cyberduck (Windows i OSX), o
 * 3) 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", heu de desactivar-la.

Si utilitzeu el servidor web Apache HTTPD, el directori correcte s'especifica al vostre fitxer  a la directiva. Per defecte, això està a  o.

La ubicació exacta de la configuració del servidor Apache i el fitxer de directoris  depèn del vostre sistema operatiu. A Debian i Ubuntu, el fitxer per a la configuració i els directoris del servidor Apache està a A Red Hat i Fedora, el fitxer està a.

Canvieu el nom de la carpeta penjada amb el que vulgueu tenir a l'URL. Si el vostre servidor web s'executa com a, per exemple, canviar el nom al directori   significaria que accedireu al vostre wiki a.



Configureu la base de dades
L'script d'instal·lació de MediaWiki us demanarà un nom de base de dades i un nom d'usuari de la base de dades, de manera que MediaWiki pot 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 further setup is required for SQLite if the  module for PHP is installed on the system.

On the SQLite installation page, choose a database name (which can be anything) and the SQLite database directory. For the database directory, the installer will attempt to use a subdirectory outside of the document root and create it if needed. If this directory is not safe (for example, web-readable), change it manually to avoid making it accessible to everyone on the web.

MariaDB/MySQL
Creeu la base de dades MariaDB/MySQL i l'usuari de la base de dades. Hi ha diverses maneres:


 * Utilitzeu un programari de tauler de control que ofereix el vostre servei d'allotjament (exemple: PhpMyAdmin)
 * Utilitzeu ssh per iniciar sessió al vostre amfitrió i escriviu les ordres següents en un indicador de MySQL. Consulteu la documentació corresponent del vostre proveïdor d'allotjament. Alternativament, poseu-vos en contacte amb el vostre proveïdor d'allotjament perquè us creïn un compte.

Les ordres següents creen una base de dades anomenada, un usuari anomenat  , i estableixen permisos per a l'usuari en aquesta base de dades.

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 ( en l'exemple següent):

PostgreSQL
If you are using PostgreSQL, you will need to either have a database and user created for you, or supply the name of a PostgreSQL user with "superuser" privileges to the configuration form. Often, this is the database user named. The following commands on a Linux command-line, as the postgres user, create a database user named, and a database named   owned by the user named.

createuser -S -D -R -P -E wikiuser (then enter the database password) createdb -O wikiuser my_wiki

or as superuser (default postgres) execute the following commands at the database prompt:

Beware of the list of known issues when running MediaWiki with 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.



Més informació

 * - Additional configuration
 * - Wiki administration



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:
 * pre-integrated software appliances
 * hosting services with 1-click installation, or wiki farms

See also the.

System-specific instructions
The pages listed on give more detailed installation instructions aimed at specific systems.

However, by and large these per-system docs are less maintained and might not always be up to date. First consult (this page) before looking at per-system installation documentation.

Running multiple wikis
Refer to Manual:FAQ#Installation and configuration.

Importing an existing wiki database
Refer to Manual:FAQ#Installation and configuration.