Dokuwiki
dokuwiki for SME Server
Maintainer
We have now imported these contribs originally built by Daniel into smecontribs.
[1]Daniel B. from Firewall Services
Version
Description
DokuWiki is a simple to use and highly versatile Open Source wiki software that doesn't require a database. It is loved by users for its clean and readable syntax. The ease of maintenance, backup and integration makes it an administrator's favorite. Built in access controls and authentication connectors make DokuWiki especially useful in the enterprise context and the large number of plugins contributed by its vibrant community allow for a broad range of use cases beyond a traditional wiki.
Installation 9.x
v9 is now EOL and deprecated
Installation v10.x
To install normally you would use the following:
yum --enablerepo=smecontribs install smeserver-dokuwiki dokuwiki dokuwiki-plugins
You should not need a reboot.
Any changes should be activated with
signal-event webapps-update
There is no panel in the server-manager, you can go to https://sme-ip/dokuwiki and perform a login with users and passwords of your internal ldap.
Configuration
A few DB properties are available to control DokuWiki configuration:
- AliasOnPrimary (enabled|disabled). Default is enabled. If disabled, the alias /dokuwiki will not be added in your main vhost in apache. This is only usefull if you want to create a dedicated vhost for DokuWiki
- Authentication: can be either ldap, which is the default. With this setting, all the accounts on your SME Server will be used. Group membership is available to handle ACL. The admin user has full access to all option. Other valid values are internal, which will use the internal account in DokuWIki (you have to manually create accounts, or enable user registration in the configuration). The last value is 'LemonLDAP' which can be used to protect DokuWiki with [LemonLDAP-NG]. In this case, LemonLDAP::NG will handle authentication only, user information and group membership is looked up in LDAP, and authroization is handled by the DokuWiki ACL
- access (public|private). Default is private, which means the wiki is only available from the internal networks (and IP allowed to access the server-manager). If set to public, the wiki will be available from anywhere
- status (enabled|disabled). If set to disabled, the wiki won't be available anymore
Backup and restore
You should backup /etc/dokuwiki and /var/lib/dokuwiki (which store configuration and data respectivly)
Manual upgrade
I had an existing RPM install and wondered if I could upgrade.
The latest fedora RPMs are patched to remove compose code from the dokuwiki code and use rpms.
I thought I would try and see if compose would work.
First I installed compose. See this link:
https://wiki.koozali.org/PHP#Installation_of_Composer
Next we get a copy of the dokuwiki code. Go here and get a download link:
https://download.dokuwiki.org/
cd ~ mkdir -p /root/dokuwiki cd /root/dokuwiki wget https://download.dokuwiki.org/out/dokuwiki-c98g4519b5d16cfdee29a855275c5759f.tgz
Or from here (check the latest release):
https://github.com/dokuwiki/dokuwiki/releases/download/release-2024-02-06a/dokuwiki-2024-02-06a.tgz
tar -zxvf dokuwiki-2024-02-06a.tgz cd dokuwiki chown -R apache:www *
Backup
mkdir -p /root/dokuwiki-backup/etc/dokuwiki mkdir -p /root/dokuwiki-backup/var/lib/dokuwiki
cp -r /etc/dokuwiki/* /root/dokuwiki-backup/etc/dokuwiki cp -r /var/lib/dokuwiki/* /root/dokuwiki-backup/var/lib/dokuwiki
Copy file over without trashing the remote symlinks to /etc/and /var
rsync -av -K /root/dokuwiki/dokuwiki/* /usr/share/dokuwiki/
cd /usr/share/dokuwiki chown -R apache:www *
Check you can access the wiki.
Now clean up the old files: https://www.dokuwiki.org/install:unused_files
cd /usr/share/dokuwiki grep -Ev '^($|#)' data/deleted.files | xargs -n 1 rm -vf
I may try and build an RPM to update this way at some stage.
Uninstall
yum remove smeserver-dokuwiki dokuwiki-plugins dokuwiki signal-event post-upgrade; signal-event reboot
Bugs
Please use the relevant section to create a bug
smeserver-dokuwiki is listed in the bugtracker contribs section.
ID | Product | Version | Status | Summary |
---|---|---|---|---|
10583 | SME Contribs | 9.2 | CONFIRMED | Extension directory is not writable |
dokuwiki is listed in the bugtracker contribs section.
dokuwiki-plugins is listed in the bugtracker contribs section.
ID | Product | Version | Status | Summary |
---|---|---|---|---|
11710 | SME Contribs | 10.0 | CONFIRMED | dokuwiki-plugins change pagemove to move |