Werk 11495 removes Dokuwiki from standard Checkmk packages shipped with the software. If you were using Dokuwiki in 1.6 as site user and want to use it again in 2.0, then you can follow the steps described in this guide.
All files in the local hierarchy are synchronized to all remote sites in distributed setups in case you have "Replicate extensions" enabled for your remote sites. Having larger files in that directory will increase the amount of data that needs to be synchronized and might slow down the activation of changes.
Please keep in mind, that this not officially supported by Checkmk and use on your own risk!
It works only on 2.0 and have not been tested on 2.1
Steps:
- After the updgrade from 1.6. to 2.0.x, the files /omd/sites/<your site>/etc/dokuwiki and /omd/sites/<your site>/var/dokuwiki are already present. So, the data and config file is still available.
- Download the latest version of Dokuwiki from their official page in the /tmp folder.
- Switch to root user and extract the content of /tmp/dokuwiki-xyz.tgz to /omd/sites/<your site>/local/share/
- If dokuwiki folder is already there , then under /omd/sites/<your site>/local/share/dokuwiki.
You will now have a folder ~/local/share/dokuwiki and the contents of this folder will look like this:
root@localhost:/omd/sites/test/local/share/dokuwiki# ls -l total 100 drwxr-xr-x 2 root root 4096 Jun 1 11:24 bin drwxr-xr-x 2 root root 4096 Jun 1 11:24 conf -rw-r--r-- 1 2012 2012 18092 Jul 29 2020 COPYING drwxr-xr-x 12 root root 4096 Jun 1 11:24 data -rw-r--r-- 1 2012 2012 3618 Jul 29 2020 doku.php -rw-r--r-- 1 2012 2012 19576 Jul 29 2020 feed.php drwxr-xr-x 20 root root 4096 Jun 1 11:24 inc -rw-r--r-- 1 2012 2012 2540 Jul 29 2020 index.php -rw-r--r-- 1 2012 2012 20463 Jul 29 2020 install.php drwxr-xr-x 8 root root 4096 Jun 1 11:24 lib -rw-r--r-- 1 2012 2012 308 Jul 29 2020 README drwxr-xr-x 11 root root 4096 Jun 1 11:24 vendor -rw-r--r-- 1 2012 2012 23 Jul 29 2020 VERSION
- Create a folder "htdocs" under /omd/sites/<your site>/local/share/dokuwiki and mv all the files under the htdocs folder.
It will look like this:
OMD[test]:~/local/share/dokuwiki$ find . -maxdepth 1 -type d -exec ls -l "{}" \; total 4 drwxr-xr-x 8 test test 4096 May 31 12:40 htdocs total 100 -rw-r--r-- 1 test test 18092 May 31 12:40 COPYING -rw-r--r-- 1 test test 308 May 31 12:40 README -rw-r--r-- 1 test test 23 May 31 12:40 VERSION drwxr-xr-x 2 test test 4096 May 31 12:40 bin drwxr-xr-x 2 test test 4096 Jun 1 09:50 conf drwxr-xr-x 12 test test 4096 May 31 12:40 data -rw-r--r-- 1 test test 3618 May 31 12:40 doku.php -rw-r--r-- 1 test test 19576 May 31 12:40 feed.php drwxr-xr-x 20 test test 4096 May 31 12:40 inc -rw-r--r-- 1 test test 2540 May 31 12:40 index.php -rw-r--r-- 1 test test 20463 May 31 12:40 install.php drwxr-xr-x 8 test test 4096 May 31 12:40 lib drwxr-xr-x 11 test test 4096 May 31 12:40 vendor- Copy the contents of the directory /omd/sites/<your site>/var/dokuwiki/data/* to /omd/sites/<your site>/local/share/dokuwiki/htdocs/data/<here>
- Change the ownership of the directory to site user ~/local/share/dokuwiki using "chown -R test:test ~/local/share/dokuwiki"
- Create a symbolic link in the directory ~/etc/apache/conf.d using the below command:
OMD[test]:~/etc/apache/conf.d$ ln -s ../../dokuwiki/apache.conf dokuwiki.conf OMD[test]:~/etc/apache/conf.d$ ls -l total 36 -rw-r--r-- 1 test test 145 May 31 12:35 01_wsgi.conf -rw-r--r-- 1 test test 508 May 31 12:29 02_fcgid.conf -rw-r--r-- 1 test test 224 May 31 12:29 auth.conf lrwxrwxrwx 1 test test 26 May 31 12:29 check_mk.conf -> ../../check_mk/apache.conf -rw-r--r-- 1 test test 134 May 31 12:35 cookie_auth.conf lrwxrwxrwx 1 test test 26 Jun 1 09:48 dokuwiki.conf -> ../../dokuwiki/apache.conf lrwxrwxrwx 1 test test 24 May 31 12:29 nagvis.conf -> ../../nagvis/apache.conf -rw-r--r-- 1 test test 833 May 31 12:29 omd.conf -rw-r--r-- 1 test test 3611 May 31 12:35 security.conf -rw-r--r-- 1 test test 111 May 31 12:29 site.conf -rw-r--r-- 1 test test 637 May 31 12:29 stats.conf -rw-r--r-- 1 test test 265 May 31 12:29 var_www.conf
- Now, you can update the rule notes URL of hosts and services with the new URL. For example, the custom notes URL for host will now be: http://localhost/test/wiki/local/doku.php?id=localhost:localhost
Last but not the least, please restart OMD apache.
OMD[test]:~ omd restart apache
- Now, you will be able to access the custom notes of your hosts on http://localhost/test/wiki/local/doku.php?id=localhost:localhost