User Tools

Site Tools


tutorials:dokuwiki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
tutorials:dokuwiki [2011/09/12 23:32]
razvan [Upgrading]
tutorials:dokuwiki [2015/09/08 17:05]
razvan [Upgrading]
Line 6: Line 6:
 * it uses a namespace-based structure, allowing for easy organization of information; * it uses a namespace-based structure, allowing for easy organization of information;
 * its community develops a lot of useful [[http://www.dokuwiki.org/plugins|plugins]]; * its community develops a lot of useful [[http://www.dokuwiki.org/plugins|plugins]];
-* it is, in my opinion, very usable: the interface, the editing features, information organization, overall view are intuitive and allow for rapid editing without little loss of time.+* it is, in my opinion, very usable: the interface, the editing features, information organization, overall view are intuitive and allow for rapid editing with little loss of time.
  
 That being said, let's move on to the requirements and installation steps. That being said, let's move on to the requirements and installation steps.
Line 24: Line 24:
 == Install and Upgrade Scripts == == Install and Upgrade Scripts ==
  
-* Mircea Bardac and me have created a set of scripts for installation, configuration and upgrade of DokuWiki. These scripts provide solutions to most of the above [[:tutorials:dokuwiki#user_requirements]]. The scripts are part of the [[http://koala.cs.pub.ro/git/?p=admin-public.git;a=tree|admin Git repository]] storing a variety of administrative scripts.+* Mircea Bardac and me have created a set of scripts for installation, configuration and upgrade of DokuWiki. These scripts provide solutions to most of the above [[:tutorials:dokuwiki#user_requirements]]. The scripts are part of the [[http://koala.cs.pub.ro/gitweb/?p=admin-public.git;a=tree|admin Git repository]] storing a variety of administrative scripts.
 * Issue the following command to get a copy of the repository<code> * Issue the following command to get a copy of the repository<code>
 git clone http://koala.cs.pub.ro/git/admin-public.git git clone http://koala.cs.pub.ro/git/admin-public.git
Line 104: Line 104:
  
 * The [[http://www.dokuwiki.org/auth:ldap|official LDAP Authentication page]] contains important information regarding the configuration of LDAP authentication. * The [[http://www.dokuwiki.org/auth:ldap|official LDAP Authentication page]] contains important information regarding the configuration of LDAP authentication.
-* The [[http://koala.cs.pub.ro/git/?p=admin.git;a=blob;f=dokuwiki/samples/dokuwiki-ldap-auth-swarm.conf;h=f955588a13f1ea8424d75f042cccb27ae623ace3;hb=HEAD|dokuwiki/samples/dokuwiki-ldap-auth-swarm.conf]] contains a configuration sample for LDAP authentication using the LDAP service installed on the {{{swarm.cs.pub.ro}}} server:<code>+* The [[http://koala.cs.pub.ro/gitweb/?p=admin-public.git;a=blob;f=dokuwiki/samples/dokuwiki-ldap-auth-swarm.conf;hb=HEAD|dokuwiki/samples/dokuwiki-ldap-auth-swarm.conf]] contains a configuration sample for LDAP authentication using the LDAP service installed on the {{{swarm.cs.pub.ro}}} server:<code> 
 +$conf['disableactions'] = 'register,profile,resendpwd'; 
 $conf['authtype'   = 'ldap'; $conf['authtype'   = 'ldap';
- +
 $conf['auth']['ldap']['port'       = 636; $conf['auth']['ldap']['port'       = 636;
 $conf['auth']['ldap']['server'     = 'ldaps://swarm.cs.pub.ro'; $conf['auth']['ldap']['server'     = 'ldaps://swarm.cs.pub.ro';
Line 174: Line 176:
 DokuWiki has a smart notification system that lets you know whether a new version of DokuWiki is available. A DokuWiki upgrade is fairly easy to accomplish. The upgrade steps are described on the [[http://www.dokuwiki.org/install:upgrade|official page]]. DokuWiki has a smart notification system that lets you know whether a new version of DokuWiki is available. A DokuWiki upgrade is fairly easy to accomplish. The upgrade steps are described on the [[http://www.dokuwiki.org/install:upgrade|official page]].
  
-=== Upgrade script ===+The are two scripts you may use. One is to be run by root (the {{{dw-upgrade}}} script), while the other (the {{{dw-upgrade-no-root}}} script) may be run by a non-priviliged user. Each script creates a backup copy of the current wiki installation before upgrading.
  
-Our [[http://koala.cs.pub.ro/git/?p=admin-public.git;a=summary|administration Git repository]] now contains [[http://koala.cs.pub.ro/git/?p=admin-public.git;a=blob;f=dokuwiki/upgrade_dokuwiki;hb=HEAD | a Dokuwiki upgrade script]]. A sample run is shown below:<code> +The {{{dw-upgrade}}} script (run by {{{root}}}) is to be used when your backup needs to be web accessibleThe backup uses the precises ownership information and access rights (may be owned by {{{www-data}}}) such that it would be an exact copy of the original DokuWiki installationIn order for the backup copy to be completely accesible, its {{{.htaccess}}} filesh ould probably be updated.
-elf:~/repo-admin.git/dokuwiki# ./upgrade_dokuwiki ~srisp/public_html/dokuwiki/ ~srisp/public_html/bak/ http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2009-12-25c.tgz+
  
- * Downloading Dokuwiki from http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2009-12-25c.tgz ... done +The backup directory passed to the scripts should exist. This is where the actual backup is created using a name starting with {{{dokuwiki-bak}}} (such as {{{dokuwiki-bak-2011-09-12}}}). 
- Unpacking Dokuwiki to /tmp//dokuwiki ... done + 
- * Backing up Dokuwiki instance to /home/srisp/public_html/bak//dokuwiki-bak-2010-01-22 ... done +A sample run is shown below:<code> 
- * Upgrading Dokuwiki installation in /home/srisp/public_html/dokuwiki/ ... done +razvan@swarm:~/scripts/dw$ ./dw-upgrade-no-root ~razvan/public_html/dw-test/ http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2011-05-25a.tgz ~razvan/public_html/backup/ 
- Cleaning up temporary files ... done+ 
 +Logging information to /tmp/tmp.xQuZwTyfgu. 
 +  * Downloading DokuWiki ... done. 
 + * Backing up Dokuwiki instance to /home/razvan/public_html/backup//dokuwiki-bak-2011-09-12 ... done 
 + * Upgrading Dokuwiki installation in /home/razvan/public_html/dw-test/ ... done 
 +Installing plugins 
 +  * Installing plugin: Creole ... done
 +  * Installing plugin: Google Analytics ... done. 
 +  * Installing plugin: Include ... done. 
 +  * Installing plugin: Index-Menu ... done. 
 +  * Installing plugin: Display-Wiki-Page ...done. 
 +  * Installing ggauth backend ...done.
 </code> </code>
  
 Enjoy! Enjoy!
 +
 +== Useful Plugins ==
 +
 +* https://www.dokuwiki.org/plugin:include
 +* https://www.dokuwiki.org/plugin:spoiler
 +* https://www.dokuwiki.org/plugin:note
 +* https://www.dokuwiki.org/plugin:comment
 +* https://www.dokuwiki.org/plugin:togglewrap
 +* https://www.dokuwiki.org/plugin:wrap
 +* https://www.dokuwiki.org/plugin:fontsize2
 +* https://www.dokuwiki.org/plugin:indexmenu
 +* https://www.dokuwiki.org/plugin:icons
 +* https://www.dokuwiki.org/plugin:authchained
 +* https://www.dokuwiki.org/plugin:authsplit
 +* https://www.dokuwiki.org/plugin:creole
 +* https://www.dokuwiki.org/plugin:dw2pdf
 +* https://www.dokuwiki.org/plugin:color
 +* https://www.dokuwiki.org/plugin:mathjax
 +* https://www.dokuwiki.org/plugin:move
 +* https://www.dokuwiki.org/plugin:googleanalytics
 +* https://www.dokuwiki.org/plugin:include
 +
tutorials/dokuwiki.txt · Last modified: 2020/07/20 09:16 (external edit)