From Wiki Against Mines

back to install manual

Contents 1 MediaWiki Configuration 1.1 Basic Configuration 1.2 Continuative Configuration 1.3 Installation Failures 1.4 Configuration hints 2 References 3 Assessment

MediaWiki Configuration

If you are installing the MediaWIki for the first time, it Is recommended to execute the provided configuration script on your web-browser. This script provides all required information to get a executable MediaWii.

Basic Configuration

The following description is based on the fact that your webpage can be accessed at address http://www.example.com/. In addition it is required the your page is physically located at /var/www/httpdocs on the server. Please adapt the following examples to your particular situation.

1. Use your browser to get to your Wiki-page. The address needs to be the folder your have installed the MediaWiki in. Usually the address should be /wiki (if you have installed MediaWiki in the directory /var/www/httpdocs or /var/www/htdocs please type in the following http://www.example.com/wiki/ into the addsress bar of your browser).

2. You will receive a message advising you that the Wiki was installed already but not yet configured. Please clock now on "Please set up the wiki first" to start the configuration. In case you do not get to that page or get an error prompt like error 404 please check first if the MediaWiki was installed to the right location and second whether the Apache Webserver was installed correctly, and its configuration was started already.

3. In case the script discovers configuration failures, you are unable to continue the configuration. To get detailed information about possible failures and get information about how to avoid these failures please go to paragraph Installation failures at the end of this page.

4. If all tests were completed successfully you are requested to enter information that is needed by MediaWiki. That includes for instance the name of the Wiki, the language as well as information about the used database. Please attend the orders on the web page to get the required information. To get more detailed information about how to fill in the fields correctly, please go to paragraph Configuration hints at the end of this page.

If you followed this manual you can take the following settings:

Field	Value
Wiki name:	arbitrary but NOT MediaWiki
Contact e-mail:	Your EMail-Address
Language:	arbitrary
Copyright/license:	arbitrary - GNU Free Documentation License 1.2 recomended
Admin Username:	arbitrary
Password:	arbitrary
Shared memory caching:	No caching
Memcached servers:	leer
E-mail features (global):	Enabled
User-to-user e-mail:	Enabled
E-mail notification about changes:	Enabled for changes to user discussion pages, and to pages on watchlists
E-mail address authentication:	Enabled
Database type:	MySQL
Database Host:	localhost
Database name:	wikidb
DB Username:	wikiuser
DB Password:	P@ssw0rd
Superuser account:	not activated
Superuser name:	root
Superuser password:	empty
Database table prefix:	empty
Storage Engine:	InnoDB
Database character set:	Backwards-compatible UTF-8

5. click on the "Install MediaWiki"-button at the end of this page. Afterwards the script is going to dissect the database and generate a configuration file. If there are going to occur failures please go back to step 4 and check your entries. In case of misentries there will be a corresponding error message.

6. After executing the script successfully you will receive a corresponding advice. Additionally a file named LocalSettings.php has been generated at the directory /wiki/config. This file includes all necessary information to run MediaWiki. Please move this file to the Wiki-main-folder (if MediaWiki is installed at /var/httpdoc/wiki/, there). Now please set strict security directives on the file LocalSettings.php ("chmod 600 LocalSettings.php" and "chown root LocalSettings.php"). To do so, you have to be registered on the system as root, and located at the /var/httpdoc/wiki/ directory. Afterwards please delete the "config" directory.

If all these steps were successfully executed you are able to use your Wiki already. Please go to your web browser and type in the Wiki installation address (in this case http://www.example.com/wiki/).

Continuative Configuration

After the Wiki was installed by means of the configuration script from above additional configuration settings at LocalSettings.php are required.

For a technical continuative configuration please go to Manual: Systemadministration (engl.), Manual: Hilfekonfiguration (engl.), und Manual: Hilfeadministration (engl.).

To provide a short overview of helpful sites, text and layout modifications please go to Manual: Hilfeinstallation - Software Configuration (engl.).

Installation Failures

When you are executing the configuration script, there will be several system checks. It will inform you about possible problems.

If there are problems during the installation you may find help under: Manual:Errors and Symptoms#Installation Errors

Configuration hints

Subsequent please find a table to read about the meaning and the correct entry of all the required fields required for configuration.

Feld	Erläuterung
Database host	The Host (Computer) the database is running on. Here the input of an IP-address is required. If the database is running on the same server as the MediaWiki then you have to enter "localhost".
Database name	Der Name der MySQL oder Postgres Database, which was described in Configuration of MySQL Database – Create Database. Attention: If you are using MySQL but a different Socket File (e.g. mysql at localhost, with using --socket=/tmp/mysocketfile), set the database name as:"localhost:/tmp/mysocketfile".
Database username	The username of the Wiki-Database, which was created at step Configuration of MySQL Database – Creating user.
Database password	The database password which was created at step Configuration of MySQL Database - MySQL-System assure.
Database table prefix	(Just at a MySQL-Database) Please enter the string if a prefix should be prefended before every table name. If you want to setup different Wikis, you should use a prefix like "w1", that is linked to all tables of the first Wiki, "w1_". That enables you to install several Wikis on the same database with having just one name.
Database port	(Just at Postgres-Database) Here the port-number is shown at which Postgres was installed. The default value 5432 can be used for most of the entities.
Superuser account / Superuser password	Username and password of the database root-user – if existent. In case you do not know the password, leave it. In case you know the password you do not have to execute the previous steps to setup the database; because MediaWiki executes all these steps itself.#

References

• According to: MediaWiki Configuration manual (engl.)

Assessment

Please answer the following questions. For revision please click the button “Marking”. In case you have reached less then 4 points, it is highly recommended to read the MediaWiki Configuration paragraph again!

continue with Configuration of LocalSettings.php

back to install manual,,