- MediaWiki is a very popular Wiki engine.
Wiki's are online web pages that are editable
directly by the viewing them in a web browser.
|
|
- Related
- Elsewhere
|
Initial Setup
First carve out a URL that you want to serve a wiki from.
For example: http://wiki.oldquad.org/ and make sure Apache and DNS are handling it properly.
$ rcsdiff /etc/httpd/conf/httpd.conf
1131a1132,1136
> <VirtualHost *:80>
> DocumentRoot /public/oldquad/wiki
> ServerName wiki.oldquad.org
> </VirtualHost>
$ dig wiki.oldquad.org @ns1.foobar.com +short
64.32.175.104
$ cd /public/oldquad
$ tar xvzf /public/installers/mediawiki-1.7.1.tar.gz
$ mv mediawiki-1.7.1 wiki
- Now make sure you have MySQL installed, and the PHP MySQL packages as well. You need
to know the MySQL admin username and password so that database tables can be added for the Wiki.
# mysql -u root -p
> use mysql
> mysql> SELECT * FROM `user` WHERE user = 'root';
+------------------+------+------------------+-------------+-------------+-------------+-------------+- ... -+
| Host | User | Password | Select_priv | Insert_priv | Update_priv | Delete_priv | |
+------------------+------+------------------+-------------+-------------+-------------+-------------+- ... -+
| localhost | root | 0cbd366c6353a01f | Y | Y | Y | Y | |
| wiki.oldquad.org | root | 0cbd366c6353a01f | Y | Y | Y | Y | |
+------------------+------+------------------+-------------+-------------+-------------+-------------+- ... -+
- Now use a web browser to bring up the initial wiki setup page.
Note, make sure the config directory is world writable for this step.
$ cd /public/oldquad/wiki
$ ls -ld config
drwxr-sr-x 2 fredness oldquad 4096 Jul 8 22:45 config
$ chmod 777 config
- Now, check out the fat Wiki Installation page! Calm down. Many of the
settings can be left at the already provided default values. Here's an example
listing minimum fields that need values. Of course you will use slightly
different values. This is meant to help illustrate what needs to be entered.
Wiki name: OldQuad
Contact: wiki@oldquad.org
...
Admin username: WikiSysop
Password: ******
...
Database type: MySQL
Database host: localhost
Database name: wikioq
DB username: wikioq
DB password: ******
...
Superuser account: root
Superuser password: ******** (this should be known already)
Install MediaWiki!
[ can take over a minute? ]
- Getting close. See the instructions at the bottom of the post-Installation
page. A LocalSettings.php file has been generated, but now needs to be moved into the
main Wiki directory. Do this using the command line.
$ pwd
/public/oldquad/wiki
$ mv config/LocalSettings.php .
Backup
First, make sure you know the MySQL 'user account' username and password
that your wiki is using. The LocalSettings.php file from you existing wiki
should have these values already (wiki won't run without them).
- The following shows how to confirm wiki database user access
and basic backup commands.
# mysql -u wiki -p
mysql> use wikidb
mysql> show tables
...
mysql> \q
# cp -a /var/www/html/wiki [backupfiles]
# mysqldump wikidb -u wiki -p --skip-opt > [dbbackupfile]
Restore
If this is an upgrade, rename your old wiki dirctory.
Place the the latest wiki applicaiton file set in directory with
name that was used for you wiki.
If this is fresh system, you need to add the MySQL user account if
it is not already present.
This will show basic means for recreating Mysql user account, adopt this to add wiki user account
# mysqldump mysql user
If this is fresh system, you need to also import the MySQL database if
it is not already present.
# mysql scalixwiki -u wiki -p < /public/archive/wiki-20060912-daily2.sql
Create a AdminSettings.php file by adopting it from AdminSettings.sample file.
# rcsdiff AdminSettings.php
diff -r1.1 AdminSettings.php
23,24c23,24
< $wgDBadminuser = 'wikiadmin';
< $wgDBadminpassword = 'adminpass';
---
> $wgDBadminuser = 'wiki';
> $wgDBadminpassword = 'xilacs';
Make sure php-mysql package is installed
yum install php-mysql
Make sure to copy over your LocalSettings.php file. If this is a new conifuration, may need to
adjust LocalSettings.php $IP = include path.
[root@morpheus wiki]# diff ../wiki-old/LocalSettings.php LocalSettings.php
7c7
< $IP = "/var/www/html/scalix.com/wiki";
---
> $IP = "/var/www/html/wiki";
[root@morpheus maintenance]# php update.php
A copy of your installation's LocalSettings.php
must exist in the source directory.
[root@morpheus maintenance]# pwd
/var/www/html/wiki/maintenance
[root@morpheus maintenance]#
Note: LocalSettings.php may morph slightly from one version to another. May be worth setting up
scratch pad of net wiki and comparing the default Locasettings it creates ofr a new
wiki vs the one you are usign from you last wiki.
Miscellanious
- As of MediaWIki 1.7.X, PHP 5.X is required or install/upgrade errors
ensue :-(
# php update.php
PHP Parse error: parse error, unexpected T_STRING,
expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}'
in /var/www/html/wiki/includes/Exception.php on line 114
Content-type: text/html
X-Powered-By: PHP/4.3.9
|