Differences

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

--- build:wiki [2008/06/11 20:34]
70.253.185.251 Minor formatting. (CMB)
+++ build:wiki [2011/01/12 16:39] (current)
SLUUG Administration Upgrade to DokuWiki 2010-11-07. (CMB)
@@ Line 1: / Line 1: @@
 ====== DokuWiki ======
-These instructions detail how to install [[http://wiki.splitbrain.org/wiki:dokuwiki | DokuWiki]] on our Debian GNU/Linux system. We're currently running the 2008-05-05 version of DokuWiki.
+These instructions detail how to install [[http://wiki.splitbrain.org/wiki:dokuwiki | DokuWiki]] on our Debian GNU/Linux system. We're currently running the 2010-11-07 version of DokuWiki.
 ===== Requirements =====
@@ Line 68: / Line 68: @@
 $conf['mailguard'] = 'visible';    // Use "name [at] domain [dot] com" format to display email addresses.
 $conf['typography'] = 0;           // Don't convert quotes to fancy version.
+$conf['license'] = 'cc-by-sa';     // License of all content. See conf/license.php and conf/license.local.php for choices.
+$conf['showuseras'] = 'username';  // Show users' full names, no email addresses or login names.
 #$conf['useacl'] = 1;               // TODO: Have to create users (manually).
 #$conf['authtype'] = 'plain';       // User IDs are stored in a flat file.
 #$conf['openregister'] = 1;         // Users may register themselves.
 #$conf['defaultgroup'] = 'user';    // Users registering themselves belong to this group.
-?>
 </code>
@@ Line 88: / Line 89: @@
 </code>
-Create the backup script in /etc/cron.daily/backup-dokuwiki:
+Create the backup script in ''/etc/cron.daily/backup-dokuwiki'':
 <code bash>
 #!/bin/sh
@@ Line 106: / Line 107: @@
 </code>
-Run the script to test that it works, and saves a file in /var/backups/web/. Run 'tar tfz' on the resulting backup file to make sure it contains files in the data and conf directories.
+Run the script to test that it works, and saves a file in ''/var/backups/web/''. Run ''tar tfz'' on the resulting backup file to make sure it contains files in the ''data'' and ''conf'' directories.
-TODO: Copy the files in /var/backups off the server.
+TODO: Copy the files in ''/var/backups'' off the server.
 ===== Testing =====
@@ Line 120: / Line 121: @@
 ===== Upgrading =====
-Here are the steps taken to upgrade to version 2007-06-26b.
+Here are the steps taken to upgrade to version 2010-11-07.
-First we create a backup of the existing site.
+First, read the [[http://www.dokuwiki.org/changes | changes made in the new release]]. Make sure you follow any directions specific to the new release.
-<code rootshell>
+Then we create a full backup of the existing site.
+<code bash>
 cd /home/web/wiki.sluug.org
-tar cfz /var/backups/web/wiki.sluug.org.BACKUP-`date +%Y%m%d`.tgz public
+export OLD_VERSION=2009-12-25
+sudo tar cfz /var/backups/web/wiki.sluug.org.BACKUP-`date +%Y%m%d`.tgz dokuwiki-$OLD_VERSION
 </code>
 Download and unpack the new version.
-<code rootshell>
+<code bash>
-export VERSION=2008-05-05
+cd /home/web/wiki.sluug.org
+export VERSION=2010-11-07
 wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-$VERSION.tgz
 tar xfz dokuwiki-$VERSION.tgz
@@ Line 136: / Line 141: @@
 </code>
-Read through ''dokuwiki-$VERSION/.htaccess'' to look for anything new.
+Read through ''dokuwiki-$VERSION/.htaccess.dist'' to look for anything new. Make any necessary changes.
 <code bash>
-diff -u public/.htaccess dokuwiki-$VERSION/.htaccess.dist | less
+diff -u dokuwiki-$OLD_VERSION/.htaccess dokuwiki-$VERSION/.htaccess.dist | less
 </code>
-Read through the ''dokuwiki-$VERSION/conf/dokuwiki.php'' file to look for any new config options.
+Read through the ''dokuwiki-$VERSION/conf/dokuwiki.php'' file to look for any new config options. Make any necessary changes to ''conf/local.php'' in the OLD directory.
 <code bash>
-diff -u public/conf/dokuwiki.php dokuwiki-$VERSION/conf/dokuwiki.php | less
+diff -u dokuwiki-$OLD_VERSION/conf/dokuwiki.php dokuwiki-$VERSION/conf/dokuwiki.php | less
 </code>
-Double-check to see if there are any patches in the old version of DokuWiki. If so, you'll probably have to manually apply the patches to the new version. (Check to ensure they're still needed first though.) In this case, I manually added the patch listed above.
+Double-check to see if there are any patches in the old version of DokuWiki. If so, you'll probably have to manually apply the patches to the new version. (Check to ensure they're still needed first though.)
 <code bash>
-find public -name '*.ORIG*'
+find dokuwiki-$OLD_VERSION -name '*.ORIG*'
 </code>
-Delete the old caches, since we don't need it, and the formats may have changed between versions. We can also use the new help pages (in the wiki namespace), so we can delete them from the old site.
+Delete the old cache and index, since they can be regenerated, and the formats may have changed between versions. We can also use the new help pages (in the wiki namespace), so we can delete them from the old site.
-<code rootshell>
+<code bash>
-rm public/data/cache/* -rf
+sudo rm dokuwiki-$OLD_VERSION/data/cache/* -rf
-rm public/data/pages/wiki -rf
+sudo rm dokuwiki-$OLD_VERSION/data/index/* -rf
+sudo rm dokuwiki-$OLD_VERSION/data/pages/wiki -rf
 </code>
 Copy all the configuration info and data over from the old site to the new site.
-<code rootshell>
+<code bash>
-cp -f public/conf/{local.php,acl.auth.php,users.auth.php} dokuwiki-$VERSION/conf/
+cp -f dokuwiki-$OLD_VERSION/conf/{*local.php,acl.auth.php,users.auth.php} dokuwiki-$VERSION/conf/
-cp -f public/.htaccess dokuwiki-$VERSION/
+cp -f dokuwiki-$OLD_VERSION/.htaccess dokuwiki-$VERSION/
-cp -a public/data/* dokuwiki-$VERSION/data/
+cp -a dokuwiki-$OLD_VERSION/data/* dokuwiki-$VERSION/data/
 </code>
-It installed a new ''entities.conf'', so get rid of it again.
+Get rid of the files that we don't need.
-<code rootshell>
+<code bash>
-mv dokuwiki-$VERSION/conf/entities.conf dokuwiki-$VERSION/conf/entities.conf.out
+mv dokuwiki-$VERSION/conf/entities.conf dokuwiki-$VERSION/conf/entities.conf.dist
+rm dokuwiki-$VERSION/{install,index}.php
 </code>
@@ Line 172: / Line 179: @@
 Re-create the sitemap file.
-<code rootshell>
+<code bash>
 touch dokuwiki-$VERSION/sitemap.xml.gz
 </code>
-Correct the ownership so that the web server can write to where it needs to.
+Re-index the site.
-<code rootshell>
+<code bash>
-chown -R www-data:www-data dokuwiki-$VERSION
+php dokuwiki-$VERSION/bin/indexer.php -c
+</code>
+Correct the ownership and permissions so that the web server can write to where it needs to, and so admins can also write files within the directory.
+<code bash>
+sudo chown -R www-data:www-data dokuwiki-$VERSION
+sudo chmod -R g+w dokuwiki-$VERSION
 </code>
 Switch over to the new version.
-<code rootshell>
+<code bash>
 rm public
 ln -s dokuwiki-$VERSION public
 </code>
-Test the site. Make sure you can browse to a few different pages. Also make sure you can edit and save a page. Once you're comfortable that the upgrade went OK, you can delete the directory for the previous version of DokuWiki.
+Test the site. Make sure you can browse to a few different pages. Also make sure you can edit and save a page. Check out the search feature, backlinks, and old revisions.
-===== TODO: Enable ACLs and User Accounts =====
+Once you're comfortable that the upgrade went OK, you can delete the directory for the previous version of DokuWiki.
-Create the conf/users.auth file:
+<code bash>
-<code rootshell>
+rm -rf dokuwiki-$OLD_VERSION
-touch conf/users.auth
-chown www-data:www-data conf/users.auth
-chmod 440 conf/users.auth
 </code>
-Add an admin account in the file (replace $WIKI_ADMIN_PWD with real password):
+===== Enable ACLs and User Accounts =====
-  # echo "admin:`echo -n '$WIKI_ADMIN_PWD' | md5sum | awk '{print $1;}'`:Administrator:webmaster@sluug.org:admin,users" >> conf/users.auth
+==== This is a minimal implementation with a single account ====
+=== The sole purpose is to reduce defacement and overhead from recovery. ===
-Create the conf/acl.auth file:
+Go to the DokuWiki configuration directory
-<code rootshell>
+<code>
-cp conf/acl.auth.dist conf/acl.auth
+cd /home/web/wiki.sluug.org/public/conf
-chown www-data:www-data conf/acl.auth
-chmod 440 conf/acl.auth
 </code>
-Edit the conf/acl.auth file to look something look this:
+Install the skeleton authorization files
-<code configfile>
+<code>
-*               @admin  255
+cp -ip users.auth.php.dist users.auth.php
-*               @ALL    7
+cp -ip acl.auth.php.dist acl.auth.php
-private:*       @admin  255
-private:*       @ALL    0
-readonly:*      @admin  255
-readonly:*      @ALL    1
 </code>
+Create a backup of the main config file
+<code>
+cp -ip local.php local.php.090219
+</code>
+Edit local.php using your favorite editor to uncomment the useacl line:
+<code>
+$conf['useacl']       = 1;        // Enable Access Control List authorization
+</code>
+Create a new account using your web browser:
+  - Point the web browser at http://wiki.sluug.org/
+  - Select the "Login" button at the bottom of the page.
+  - Select the "Register" link.
+  - Fill in
+    - Username:  discuss
+    - Real name: SLUUG Administration
+    - E-mail:    (your e-mail address)
+  - Select the "Register" button.  You should end up at the login page again.
+  - Read the mail sent to you and login using the generated password.
+  - At the bottom of the page, select the "Update Profile" button.
+  - Change these fields:
+    - E-mail:        root@mail.sluug.org
+    - New passsword: (The password for the discuss mailing list archive)
+  - Select the "Save" button.
+Edit local.php using your favorite editor to add this line:
+<code>
+$conf['disableactions'] = 'register';   // Users can't register themselves
+</code>
+Test security using your web browser:
+  - Select the "Logout" button.
+  - Tried editing a page without being logged in, but it let me.
+  - Tried editing a page after closing and restarting the browser, but it let me.
+Edit acl.auth.php using your favorite editor to:
+  - Change the authority of the "ALL" group from "8" to "1".
+  - Create a new line in the same format, giving user "discuss" "16" level authority.
+<code>
+*               discuss    16
+</code>
+An attempt to edit the same page (still displayed from the earlier test)
+still displays the source, but now says that update is not allowed.
+Refreshing the page, it no longer has the "Edit" buttons.
+Test for an authenticated user:
+  - Use the "Login" button, enter the username and password from above.
+  - The Edit buttons are now displayed and able to update this page.
+For more information, see the
+[[http://wiki.splitbrain.org/wiki:acl | ACL documentation]].
 ===== TODO =====
 Copy the files in /var/backups off the server. Delete older versions, or at least create a subdirectory structure.
-Accounts/ACLs. [[http://wiki.splitbrain.org/wiki:acl | See documentation]]. Set admin's password.
 Turn on wordblock to ban edits with certain words (to prevent spamming and profanity)?
@@ Line 241: / Line 301: @@
 ===== Credits =====
-Initially installed, configured, and documented by Craig Buchek, 2005-09-10. Updated to newer versions on 2005-11-26, 2007-05-09, and 2008-06-11.
+Initially installed, configured, and documented by Craig Buchek, 2005-09-10.
+Updated to newer versions on 2005-11-26, 2007-05-09, 2008-06-11, 2009-02-19, 2010-01-08.

SLUUG Wiki

User Tools

Site Tools

Differences

Page Tools