Wiki

From CLONWiki
Jump to navigation Jump to search

We are using MediaWiki. Current article describes installation procedure and some useful procedures.

Mediawiki Upgrade

Save clondocs subdirectory, dump and save wikidb database - just in case.

Download recent tarball, untar to the NEW directory (/www on clonwiki), go inside, copy LocalSettings.php from old version, go to maintenance/ and run php update.php.

MediaWiki Installation Procedure

Create user 'clonwiki' with private group.

Create database:

ssh root@clondb1
mysql -u root -p
create database wikidb\g
##grant create, select, insert, update, delete, lock tables on wikidb.* to boiarino@clonweb.jlab.org identified by '*********'\g
##grant create, select, insert, update, delete, lock tables on wikidb.* to boiarino@clonwiki0.jlab.org identified by '*********'\g
grant all on wikidb.* to boiarino@clonweb.jlab.org identified by '*********'\g
grant all on wikidb.* to boiarino@clonwiki0.jlab.org identified by '*********'\g
flush privileges\g
\q

Download and install mediawiki:

su
download 'mediawiki-1.6.8.tar.gz' from web to '/usr/local/downloads'
cp /usr/local/downloads/mediawiki-1.6.8.tar.gz /www/apache2.2.3/htdocs/
cd /www/apache2.2.3/htdocs
gunzip mediawiki-1.6.8.tar.gz
tar xvf mediawiki-1.6.8.tar
rm mediawiki-1.6.8.tar
mv mediawiki-1.6.8 wiki

Installation procedure (we assume machine name is 'clonwiki'):

  • open browser at http://clonwiki/wiki/; click on link 'Please setup the wiki first'; following message shows up:
Can't write config file, aborting
In order to configure the wiki you have to make the config subdirectory writable by the web server.
Once configuration is done you'll move the created LocalSettings.php to the parent directory, and
for added safety you can then remove the config subdirectory entirely.
To make the directory writable on a Unix/Linux system:
   cd /www/apache2.2.3/htdocs/wiki
   chmod a+w config
  • click 'Please setup the wiki first' again, and type following information:
Wiki name: CLONWiki
Contact e-mail: boiarino@jlab.org
Admin username: wikiadmin
Password: xxxxxxxx
Password confirm: xxxxxxxx
SQL server host: clondb1.jlab.org
Database name: wikidb
DB username: boiarino
DB password: xxxxxxxxx
DB password confirm: xxxxxxxxx

All the rest is default. Proceed, it will show report page, in the end it will tell: 'Installation successful! Move the config/LocalSettings.php file into the parent directory, then follow this link to your wiki'. Do what it said, and close 'config' directory:

chmod 400 config

Proceed with link. Everything must work.


NOTE: All WIKI-related documents are stored in subdirectories of /www/apache2.2.3/htdocs/wiki/clondocs/. To access those areas group clonweb must be created locally, and all users who suppose to modify those documents must be in that group. To do so following line must be added to the /etc/group file (list of users could be changed of course):

clonweb:!!:9996:clonweb,clonwiki,nagios,mrtg,boiarino,sergpozd,braydo,nerses,marki

All subdirectories modes and ownership must be set as following:

chmod 775 <dirname>
chown root:clonweb <dirname>