ACIM Personal Knowledgebase

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== MediaWiki on CentOS ======

===== Introduction =====


MediaWiki is a free and open-source wiki application written in PHP. It was originally created for WikiPedia, but it now allows everyone to create their own wiki sites. Currently thousands of websites are running MediaWiki, including Wikipedia, Wiktionary and Wikimedia Commons. MediaWiki's homepage is located at https://www.mediawiki.org.

This tutorial goes through how to set up MediaWiki on a CentOS 7 Droplet.

===== Prerequisites =====

  * Unordered List ItemA CentOS 7 server with SSH access. For more information, visit this tutorial.
  * Unordered List ItemA LAMP stack, which you can install by following this tutorial.

===== Start Intallation =====

==== Step 1 — Setting Up Your Server ====


After you have installed the LAMP stack, we will first need to install a few additional PHP 5 modules. All of them are optional except for the first one (the XML extension).

The first one we will be installing is the XML extension, and it is required for MediaWiki to run:
<code> sudo yum install php-xml</code>

The second one we will be installing is the Intl extension, for internationalization support:
<code> sudo yum install php-intl</code>

Secondly, we will install GD for image thumbnailing:
<code> sudo yum install php-gd</code>

These last two modules are really optional. These are not necessary for most wikis, unless you have a high performance or math-heavy wiki. The first one is Tex Live for in-line display of mathematical formulae:
<code> sudo yum install texlive</code>

For added performance, you can install XCache. For this, however, you also need to install an extra repository, as XCache is not available in the CentOS repository by default:
<code> sudo yum install epel-release</code>

Now, you can install XCache:
<code> sudo yum install php-xcache </code>

To finish these installations, restart Apache HTTPD:
<code> sudo systemctl restart httpd.service </code>

==== Step 2 — Downloading MediaWiki ====

In this section we will download MediaWiki from source. MediaWiki can be downloaded from its official website. At time of writing, the latest version is 1.24.1, but you can double check via the download link on this page.

Download MediaWiki:
<code> curl -O http://releases.wikimedia.org/mediawiki/1.25/mediawiki-1.25.1.tar.gz.sig </code>

Untar the package:
 tar xvzf mediawiki-*.tar.gz

Move to the /var/www directory:
<code> sudo mv mediawiki-1.24.1/* /var/www/html </code>

====Step 3 — Creating a Database====
In this section we will set up a MySQL database. This is not strictly required to successfully install MediaWiki, as you can use a SQLite database as well. Despite this, it is definitely a recommended measure.

We will first log in to the MySQL shell:
<code> mysql -u root -p </code>

This will change your prompt to '' MariaDB [(none)]> ''.

Now, we will create the database. The database name does not matter for MediaWiki, but we will use my_wiki in this tutorial. You can choose another name if you prefer.
<code> CREATE DATABASE my_wiki;</code>

The output should be:
<code> Query OK, 1 row affected (0.00 sec)</code>

We don't want to use the <code>root</code> user for MediaWiki, so we will create a new database user:
<code> GRANT INDEX, CREATE, SELECT, INSERT, UPDATE, DELETE, ALTER, LOCK TABLES ON my_wiki.* TO 'sammy'@'localhost' IDENTIFIED BY 'password';</code>

Change <code>my_wiki</code> to your chosen database name, <code>sammy</code> to your username, and <code>password</code> to a secure password. The output should be:
<code> Query OK, 0 rows affected (0.01 sec) </code>

Next, we need to flush the MySQL privileges:
<code> FLUSH PRIVILEGES;</code>

The output should be:
<code> Query OK, 0 rows affected (0.00 sec) </code>

Last, we will need to exit the MySQL shell:
 exit;

The output should be:
 Bye

====Step 4 - Setting Up MediaWiki====
In this section, we will set up MediaWiki so it is ready to use. Visit the homepage of your Droplet in your browser by pointing your browser to ''http://your_server_ip''. On this page, select set up the wiki.

On the first page, select a language and click Continue. The next page should show your environment and it should say in green: The environment has been checked. You can install MediaWiki. Click Continue.

You will now get to the page with MySQL settings. For the Database type select MySQL (or compatible). For the database host, type localhost. The database name, username, and password will be the values you chose before. We used ''my_wiki'' for the database name, ''sammy'' for the username, and ''badpassword'' for the password. The table prefix can be left empty. It will look like this:

{{ :wiki:wiki_centos_1.png |}}

In the screen after the MySQL settings, the values can be left at their defaults. In the next screen, you will need to fill in the details of your wiki, like its name. You can also create the admin user for the wiki on this page.

In all the other screens, most, if not all, of the settings can be left untouched. If you want a specific setting enabled for your wiki, you might need to change something on one of these screens. Particularly if you have installed XCache before, you will need to check that to enable it.

When you have completed all steps, you should arrive at this page:

{{ :wiki:wiki_centos_2.png |}}

To successfully complete the installation, you will need to move a file called ''LocalSettings.php'' to your server, which should have started downloading automatically. You should download this file before closing the page.

Now, you will need to upload the file to ''/var/www/html''. You could use an external program, but it is easiest to open the file on your local computer, copy the contents and paste them into your SSH session. To do this, first open the file on the server:
<code> sudo nano /var/www/html/LocalSettings.php </code>

Now, open the file on your computer in your text editor of choice and copy the contents into your SSH window. After you have saved the file, you can click enter your wiki and your wiki should be ready to use.

===== End Installation =====

===== Post installation settings ===== 

To upload files (fotos,documets) you must login throw SSH like <code>root</code> and change permissions to folder <code>your_mediawiki_web_root/images/</code>, for example:
<code> chmod -R 777 /var/www/html/mediawiki/images/ </code>
 
You can add $wgFileExtensions in LocalSettings.php to allow uploads of other desired file types. For example, you can change the $wgFileExtensions line to look something like:
<code> $wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'doc', 'xls', 'mpp', 'pdf', 'ppt', 'tiff', 'bmp', 'docx', 'xlsx', 'pptx', 'ps', 'odt', 'ods', 'odp', 'odg'); </code>

===== Conclusion ===== 
You will now see your own MediaWiki installation, ready for use. To further customize the page, visit the System administration page on the MediaWiki homepage. You can also start adding pages directly.
ACIM Personal Knowledgebase

User Tools

Site Tools

Page Tools
