This page describes how to backup and upgrade the contents of this wiki
Backup
- download the whole wiki folder at
./httpdocs/wiki
to your local machine - (you might need to enable and run
./httpdocs/fixfiles.php
on your installation to make sure chmod is setup correctly - finally, run
upgrade.sh backup
to create awiki-backup.tar.gz
of all important files (plugins and templates will not be backed up)
Upgrade
- make backup first and place
wiki-backup.tar.gz
intoSites
folder
- download new dokuwiki.tgz release and place it into
Sites
folder - place
upgrade.sh
into same folder - run
upgrade.sh all
(will unpack, chmod and migrate data into new release) - adjust
./wiki/.htaccess
(i.e. RewriteBase /~user/wiki) - open webbrowser http://localhost/~user/wiki
- re-install templates (http://www.dokuwiki.org/template)
- re-install plugins (http://www.dokuwiki.org/plugins)
- Change logo image of template
mkdir lib/tpl/vector/user/ && cp data/media/logo.png lib/tpl/vector/user/
- Upload
wiki
folder to webserver - adjust/correct
./httpdocs/wiki/.htaccess
Upgrade Test Run
- Upload new wiki folder to a different directory
- adjust
./httpdocs/wiki/.htaccess
upgrade.sh code
#!/bin/sh wikidir=./wiki all() { clean && import && migrate } import() { echo "##### importing" tar xfz dokuwiki-*.tgz mv dokuwiki $wikidir cd $wikidir chmod 777 conf chmod 777 lib/tpl chmod 777 lib/plugins chmod -R 777 data cd .. } migrate() { echo "##### migrating" tar xfpz wiki-backup.tar.gz cp -pR backup/* $wikidir cp backup/.htaccess $wikidir } backup() { echo "##### backup" [ -d backup ] && rm -rf backup mkdir backup mkdir backup/conf mkdir backup/data mkdir backup/data/pages mkdir backup/data/attic mkdir backup/data/meta mkdir backup/data/media mkdir backup/data/media_attic mkdir backup/data/media_meta # backup config cp $wikidir/.htaccess backup cp $wikidir/conf/local.php backup/conf cp $wikidir/conf/users.auth.php backup/conf cp $wikidir/conf/acl.auth.php backup/conf # backup data dir cp -R $wikidir/data/pages/* backup/data/pages cp -R $wikidir/data/attic/* backup/data/attic cp -R $wikidir/data/meta/* backup/data/meta cp -R $wikidir/data/media/* backup/data/media cp -R $wikidir/data/media_attic/* backup/data/media_attic cp -R $wikidir/data/media_meta/* backup/data/media_meta # remove OSX extended attributes xattr -c -r backup chmod -R 777 backup rm -rf wiki-backup.tar.gz tar cfpz wiki-backup.tar.gz backup rm -rf backup } clean() { echo "##### cleaning" rm -rf $wikidir rm -rf backup rm -rf dokuwiki } usage() { echo "Usage: $0 <action>" echo echo "ACTIONS:" declare -F | awk '{print " "$3}' | grep -v usage && echo } if [ $# -eq 0 ]; then usage exit fi action="$1" shift declare -F "$action" >/dev/null && $action $* [ $? -ne 0 ] && echo "no such action: $action" echo "##### done"