MediaWiki Installation Part 2

Install Summary:
1. Connect to the sever using FileZilla
1.1. ftp.xxxx.com
1.2. username
1.3. password
2. Create mysql database
2.1. databaseName: medicine
2.2. user:
2.3. password:
2.4. give user all privilage
3. http://wiki.xxxx.li/
3.1. Click Setup
3.2. Fill the page
4. Copy localSetting.php to
public_html/xxx/wiki/medicines/wikimedia/
5. Rename config to config.bak
6. End of installation
---------------------
--
MediaWiki installs itself using an interactive, web-based installation script. Before you can run this script, you need to do a couple of things. First, ensure that you have installed prerequisites (Apache/IIS, MySQL4 or later and PHP5). Then you must acquire the MediaWiki software package and upload the MediaWiki software to your server. You may also have to create a new database for your wiki. If necessary, create an account on your web server by following the instructions at Manual:Installation/Creating system accounts.

MediaWiki can be difficult to install for the average computer user who does not have experience with Apache, PHP and MySQL. Most users who wish to use wiki software may benefit from using a free wiki host (see a list of wiki hosts on Wikibooks).

Note Note: For troubleshooting information, see Manual:Errors and Symptoms#Installation Errors.

Download MediaWiki Software

Download MediaWiki from the official download page or from subversion.

Uncompress the files locally or on your server. This is usually done with software such as 7-Zip (free), WinZip, WinRAR or IZArc (free) on Windows. On Linux and Mac OS X, you can untar the file using this command:

tar xvzf mediawiki-*.tar.gz

If you have not already uploaded the files to your web server, do so now. Upload the files to your web server's web directory either by directly copying the unzipped folder or by using an FTP client such as FileZilla (Open Source Software, Windows) or Cyberduck (OSX). If you installed Apache, the correct directory is specified in your httpd.conf file (its typically /htdocs). If you are using a Linux or Unix you can instead copy the files to any directory on your server and then make a symbolic link to that folder from your web server's web directory.

Rename the uploaded folder to whatever you would like to have in the URL. If your web server is running as http://localhost for example, uploading MediaWiki to /testwiki/ directory would mean you would access your wiki at http://localhost/testwiki/index.php.

This (renamed) folder will now be referred as .

Prepare the Directories

MediaWiki needs to be able to write to the /config directory when it runs its installation script. If you haven't done so already, you need to change the permission settings for the config subdirectory so that it is writable by the webserver. If you are using FileZilla, right-click on the config directory, select "attributes...", and check "Write" under "Owner". If it prompts you for a number instead or if you are using a command-line interface, use 755 (Use 777 on Linux except for RedHat Linux). Alternately, you may be able to change permissions using a "control panel" provided by your web host.

Depending on the server configuration, in some cases you have to check all boxes (777) in FileZilla, to be able to run the install-script of MediaWiki.

On Unix or Linux, if you have admin rights, you can run the command chmod 755 config in your wiki directory.

Create a database

If you know the root password on your database, the MediaWiki installation script can create a new database for you. If this is the case, you can skip to the Run the installation script section below. If you don't know the root password, for example if you are on a hosted server, you will have to create a new database now. Currently, you must use either MySQL or Postgres to store the actual contents of your wiki.

MySQL

* You need to create a MySQL database and a user before installing MediaWiki. You can do this using various control panels such as PhpMyAdmin, which are often available from shared hosts, or you may be able to use ssh to login to your host and type the commands into a MySQL prompt. See the corresponding documentation. Alternatively, contact your host provider to have them create an account for you
1. Download and install MySQL 5.0. It should put itself in /usr/local/mysql
2. Check and see if the database server is running ("/usr/local/mysql/bin/mysqladmin status"), If not, sudo /usr/local/mysql/bin/safe_mysqld &.
(For Fedora Core 5, use /usr/bin/mysqld_safe)
1. Another way to start initially the MySQL server is to run the configure script available at the root of the installation. It creates the initial tables and automatically starts the mysql daemon
3. Set a password for the "root" account on your database server. /usr/local/mysql/bin/mysqladmin -u root password yourpassword
4. Set up a user in MySQL for your Wiki--do this in your terminal: /usr/local/mysql/bin/mysql -u root -p mysql
5. This starts up the MySQL command line client. Now, do this in the client:

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

If your database is not running on the same server as your web server, you need to give the appropriate web server hostname -- mediawiki.example.com in my example -- as follows:

grant create, select, insert, update, delete, alter, lock tables on wikidb.* to
'wikiuser'@'mediawiki.example.com' identified by 'password';


http://www.mediawiki.org/wiki/Manual:Installing_MediaWiki


Opening the MediaWiki Installation form

In the following examples, it is assumed that your website is located at http://www.example.com/ which is physically located on your server at /home/example/web. You will need to adjust the examples to use the appropriate locations for your situation.

1. Use your web browser to browse to the main wiki page. This is the web-accessible folder that you installed MediaWiki into, and is typically /wiki (e.g. http://www.example.com/wiki/, assuming you installed MediaWiki to /home/example/web/wiki).
2. You will be presented with a message telling you that your wiki is installed, but has not yet been configured and that you need to "click here to setup the wiki". Click on the link to begin the configuration script. For reference (in case you want to go there directly), this is located in the wiki's config directory (so using the example above you would go to http://www.example.com/wiki/config/).
3. If the script spots any configuration errors then it will not allow you to continue. See below for details about the error messages you might encounter, and what to do if you do.
4. If all the tests pass, you will be presented with a form to fill in the information that MediaWiki now requires.

[edit] Filling up the Form fields

Follow the instructions on the form to fill in the required entries (refer to the following table if you're uncertain what to enter) and after that click on the "Install MediaWiki!" button. The script will now populate the database and write a configuration file.

After the setup script has finished running successfully, a file called LocalSettings.php is created in the "config" directory. This file contains all the information needed by MediaWiki to run. Since it stores the specified database user's password in plain text, it is strongly suggested that you create a wiki specific database account (i.e. not root). (see Database username in the table below)

1. Move this file to the main wiki directory (if you installed MediaWiki to /home/example/web/wiki, move it there).
2. Set stringent permissions on the LocalSettings.php file.
* Set chmod 600 and chown (Owner read and write, no other permissions).
3. Delete the "config" directory.

Once you have done the above, your wiki should be ready to use. Browse to the address you installed it to (in our example http://www.example.com/wiki/ and start editing!
http://www.mediawiki.org/wiki/Manual:Config_script


http://www.mediawiki.org/wiki/Manual:Installing_MediaWiki