This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
tutorials:dokuwiki [2011/09/12 23:27] razvan [LDAP Authentication] |
tutorials:dokuwiki [2013/06/28 08:40] razvan old revision restored |
||
---|---|---|---|
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:// | * its community develops a lot of useful [[http:// | ||
- | * it is, in my opinion, very usable: the interface, the editing features, information organization, | + | * it is, in my opinion, very usable: the interface, the editing features, information organization, |
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, | + | * Mircea Bardac and me have created a set of scripts for installation, |
* Issue the following command to get a copy of the repository< | * Issue the following command to get a copy of the repository< | ||
git clone http:// | git clone http:// | ||
Line 104: | Line 104: | ||
* The [[http:// | * The [[http:// | ||
- | * The [[http:// | + | * The [[http:// |
+ | $conf[' | ||
$conf[' | $conf[' | ||
- | + | ||
$conf[' | $conf[' | ||
$conf[' | $conf[' | ||
Line 137: | Line 139: | ||
# use the {{{$conf[' | # use the {{{$conf[' | ||
# use the DokuWiki' | # use the DokuWiki' | ||
- | === Split authentication | + | === Split Authentication |
The LDAP service often offers little support for group authorization inside DokuWiki. A better approach would be authenticating through LDAP and using another engine for authentication. This can be accomplished through the use of [[http:// | The LDAP service often offers little support for group authorization inside DokuWiki. A better approach would be authenticating through LDAP and using another engine for authentication. This can be accomplished through the use of [[http:// | ||
- | In order to provide split authentication, | + | The [[http:// |
- | # Download the [[http:// | + | |
+ | In order to configure split authentication, | ||
# Update the {{{local.php}}} file with configuration lines such as these:< | # Update the {{{local.php}}} file with configuration lines such as these:< | ||
$conf[' | $conf[' | ||
Line 158: | Line 161: | ||
# user: | # user: | ||
- | razvan:x:Razvan Deaconescu: | + | razvan:x:x: |
- | oana:x:Oana Baron:x:so | + | oana:x:x:x:so |
- | ddvlad:x:Vlad Dogaru:x:so | + | ddvlad:x:x:x:so |
- | dbaluta:x:Daniel Baluta:x:so | + | dbaluta:x:x:x:so |
- | apitis:x:Andrei Pitis:x:so | + | apitis:x:x:x:so |
- | bdrutu:x:Bogdan Drutu:x:so | + | bdrutu:x:x:x:so |
- | catalinme: | + | catalinme: |
[...] | [...] | ||
</ | </ | ||
- | #* The {{{MD5password}}} and {{{email}}} fields are provided by the LDAP authentication engine and aren't filled. This may also hold true for {{{Real Name}}} but I didn't check. | + | #* The {{{MD5password}}}, {{{Real Name}}} and {{{email}}} fields are provided by the LDAP authentication engine and aren't filled. |
- | # You can now use the {{{Access Control List Management}}} link in the Administration menu for authorization: | + | # You can now use the {{{Access Control List Management}}} link in the "Administration" |
== Upgrading == | == Upgrading == | ||
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:// | 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:// | ||
- | The steps below have been undertaken during an actual upgrade. | + | 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 |
- | # Backup | + | |
- | $ cp -a wiki/ 2009-12-30-wiki-bak | + | |
- | </ | + | |
- | # [[http:// | + | |
- | $ wget http:// | + | |
- | $ ls | + | |
- | 2009-12-30-wiki-bak | + | |
- | </ | + | |
- | # Unpack the DokuWiki archive.< | + | |
- | $ tar xzf dokuwiki-2009-12-25.tgz | + | |
- | $ ls | + | |
- | 2009-12-30-wiki-bak | + | |
- | </ | + | |
- | # Copy new files over the old wiki installation. Overwrite existing files.< | + | |
- | $ cp -rf dokuwiki-2009-12-25/ | + | |
- | </ | + | |
- | # Do a check for [[http:// | + | |
- | $ rm inc/ | + | |
- | [...] | + | |
- | </ | + | |
- | # Check permissions, | + | |
- | # Update plugins. I' | + | |
- | $ cd lib/ | + | |
- | $ wget http:// | + | The {{{dw-upgrade}}} script (run by {{{root}}}) is to be used when your backup needs to be web accessible. The 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 installation. In order for the backup copy to be completely accesible, its {{{.htaccess}}} filesh ould probably be updated. |
- | $ tar xzf googleanalytics-stable.tar.gz | + | |
- | $ rm googleanalytics-stable.tar.gz | + | |
- | $ wget http:// | + | 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}}}). |
- | $ tar xzf plugin-include.tgz | + | |
- | $ rm plugin-include.tgz | + | |
- | $ wget http://cloud.github.com/downloads/tatewake/dokuwiki-plugin-displaywikipage/displaywikipage-stable.tar.gz | + | A sample run is shown below:< |
- | $ tar xzf displaywikipage-stable.tar.gz | + | razvan@swarm: |
- | $ rm displaywikipage-stable.tar.gz | + | |
- | $ wget http://www.chimeric.de/ | + | * Logging information to /tmp/tmp.xQuZwTyfgu. |
- | $ tar xzf plugin-creole.tgz | + | * Downloading DokuWiki ... done. |
- | $ rm plugin-creole.tgz | + | * 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 | |
- | $ wget http://samuele.netsons.org/dokuwiki/media/indexmenu.zip | + | * Installing plugins |
- | $ unzip indexmenu.zip | + | * Installing plugin: Creole |
- | $ rm indexmenu.zip | + | * Installing plugin: Google Analytics |
- | </code> | + | * Installing plugin: Include |
- | # Clean the workplace.< | + | * Installing plugin: Index-Menu ... done. |
- | $ rm dokuwiki-2009-12-25.tgz | + | * Installing plugin: Display-Wiki-Page |
- | $ rm -fr dokuwiki-2009-12-25/ | + | * Installing ggauth backend |
- | </ | + | |
- | # < | + | |
- | === Upgrade script === | + | |
- | + | ||
- | Our [[http://koala.cs.pub.ro/git/?p=admin-public.git; | + | |
- | elf:~/ | + | |
- | + | ||
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
</ | </ | ||
Enjoy! | Enjoy! |