| Next revision | Previous revision |
| computing:dokuwiki [2017/05/16 02:14] – created oemb1905 | computing:dokuwiki [2022/07/15 05:19] (current) – oemb1905 |
|---|
| ====== Upgrading DokuWiki ====== | ------------------------------------------- |
| | * **dokuwiki** |
| | * **Jonathan Haack** |
| | * **Haack's Networking** |
| | * **webmaster@haacksnetworking.org** |
| |
| Note: if you installed DokuWiki through your Linux Distribution's package manager (eg. using a [[install:Debian]] or [[install:Fedora]] package) or similar tools you should also use this tool to upgrade your DokuWiki. Descriptions on this page are meant for standard, manual installations as described on the [[:install]] page only. | ------------------------------------------- |
| | To install dokuwiki: |
| |
| DokuWiki is very simple to upgrade. Its file layout is organized in a way that avoids overwriting any user content, which means an upgrade generally is just unpacking a new version on top of an old one. You should first try the simple instructions given here, if you encounter problems or the instructions are not detailed enough for you, read the details in the section below. Mac users should use Terminal : copy files via Finder will delete all data. | wget doku.tgz |
| | tar zxvf doku.tgz |
| | |
| | Once that's done, follow the instructions in [[https://wiki.haacksnetworking.org|Apache Survival]] in order to set up a dedicated domain and virtual host for your wiki. Once that's done, replace the ''public_html'' directory with the dokuwiki directory above. Once that's done, establish correct permissions: |
| |
| * **Step 1:** Make a [[:faq:backup]] of your DokuWiki, this is not necessarily needed but recommended | sudo chmod g+rwx /var/www/jonathanhaack.com/public_html/dokuwiki |
| * Example: \\ <code bash>tar zcpfv dokuwiki-backup.tar.gz /path/to/dokuwiki</code> | sudo chmod -R 755 /var/www/jonathanhaack.com/public_html/dokuwiki/conf |
| | sudo chown -R www-data:user /var/www/jonathanhaack.com/public_html/dokuwiki/conf |
| | sudo chown www-data:user /var/www/jonathanhaack.com/public_html/dokuwiki/data |
| | sudo chmod -R 775 /var/www/jonathanhaack.com/public_html/dokuwiki/data |
| | sudo chmod -R 755 /var/www/jonathanhaack.com/public_html/dokuwiki/lib |
| | sudo chmod -R 755 /var/www/jonathanhaack.com/public_html/dokuwiki/conf |
| | cd /var/www/jonathanhaack.com/public_html/dokuwiki/data/ |
| | sudo chmod 2775 {attic,cache,index,locks,media,meta,pages,tmp,media_attic,media_meta} |
| | sudo chown www-data:user {attic,cache,index,locks,media,meta,pages,tmp,media_attic,media_meta} |
| |
| * **Step 2:** Read the [[:changes|changelog]] to see if there are any special things to consider | After permissions are all set, navigate to the installer page so it can instantiate the database and global wiki settings. |
| |
| * **Step 3:** Download the newest release from the [[http://download.dokuwiki.org|download site]]. | https://wiki.jonathanhaack.com/install.php |
| * <code bash>cd ~ | |
| wget http://.../dokuwiki-xxxx-xx-xx.tgz</code> | |
| |
| * **Step 4:** [[unpacking|Unpack]] the distribution tarball and upload/copy the files over your previous installation. Make sure to **overwrite all files** when prompted. | Eventually your instance will become outdated. In that case, first back up the install, then wget the new tgz file, then unpack and migrate the new content on top of the existing as follows: |
| * <code bash>tar zxvf dokuwiki-xxxx-xx-xx.tgz | |
| 'cp' -af dokuwiki-xxxx-xx-xx/* /path/to/dokuwiki/</code> The quotes on cp assure that it will run as is, even if an alias is set. | zip -r doku-bu-date.zip /path/to/doku |
| * Check copied files ownership and permissions | wget https://getdownloadlinkfromsite.tgz |
| | tar zxvf dokuwiki-example-39fe13964.tgz |
| | 'cp' -af dokuwiki/* /var/www/jonathanhaack.com/public_html/dokuwiki/ |
| | |
| | Remember, the permissions will be wrong on the files you copied over since root performed that task. In order to make the instance functional again, you need to re-update the permissions (same as above): |
| |
| * **Step 5:** Delete all [[unused files]] | sudo chmod g+rwx /var/www/jonathanhaack.com/public_html/dokuwiki |
| | sudo chmod -R 755 /var/www/jonathanhaack.com/public_html/dokuwiki/conf |
| | sudo chown -R www-data:user /var/www/jonathanhaack.com/public_html/dokuwiki/conf |
| | sudo chown www-data:user /var/www/jonathanhaack.com/public_html/dokuwiki/data |
| | sudo chmod -R 775 /var/www/jonathanhaack.com/public_html/dokuwiki/data |
| | sudo chmod -R 755 /var/www/jonathanhaack.com/public_html/dokuwiki/lib |
| | sudo chmod -R 755 /var/www/jonathanhaack.com/public_html/dokuwiki/conf |
| | cd /var/www/jonathanhaack.com/public_html/dokuwiki/data/ |
| | sudo chmod 2775 {attic,cache,index,locks,media,meta,pages,tmp,media_attic,media_meta} |
| | sudo chown www-data:user {attic,cache,index,locks,media,meta,pages,tmp,media_attic,media_meta} |
| |
| * **Step 6:** Upgrade your [[:template]] and [[:plugins]] if necessary | Dokuwiki details their rational for these permission recommendations here: [[https://www.dokuwiki.org/install:permissions|Install Permissions]]. The recommended permissions from them - which I used to make my own permissions above - are listed below for historical reference: |
| | |
| * **Step 7:** Wait for a day for update notifications to go away, or speed the process by following the steps in [[:update_check|Update Check]] | |
| | |
| | |
| Note: Yes, we explicitly recommend overwriting your old installation. If you adhered to the advice of defining config options in *.local files only (the Configuration Manager does this automatically) your previous config settings will **not** be overwritten. The same is true for all your pages and media files. Using the overwrite approach will save you a lot of trouble with keeping page revisions correctly working as these are depending on file modification time-stamps. | |
| | |
| | |
| ===== Pitfall on suhosin php extension ===== | |
| Dokuwiki version since 2015-08-10 "Detritus" requires some special settings in [[https://suhosin.org/stories/index.html|suhosin php extension]] (if installed), otherwise edit page and plugin update/install won't work. Please refer to [[:install|DokuWiki Installation]] for detailed instruction. | |
| ===== Troubleshooting ===== | |
| | |
| The following pages should give you hints on common post-upgrade problems: | |
| | |
| * [[:caching]] -- purge the cache if things look strange or error messages appear | |
| * [[config:updatecheck]] -- if update notifications persist | |
| * [[faq:toolbar]] -- Quickbuttons and JavaScript problems | |
| * [[faq:searchindex]] -- if search box gives you no result | |
| | |
| If you get errors about missing/non-writable directories, you probably didn't read the [[:changes|changelog]] carefully enough. When upgrading to Angua you need to create two new directories and make them writable: | |
| | |
| * ''data/media_attic'' | |
| * ''data/media_meta'' | |
| | |
| | |
| ===== Alternative Ways ===== | |
| | |
| Here are a few different upgrade descriptions, provided by users. They might be slightly out of date. | |
| | |
| * Use [[plugin:upgrade|Upgrade Plugin]] | |
| * [[.:diffupgrade|Upgrading by creating diffs]] | |
| * [[http://installatron.com/dokuwiki|Upgrading using Installatron Applications Installer]] | |
| * [[http://apscatalog.com/1/splitbrain.org/dokuwiki/|Upgrading by APS]] | |
| * [[http://home.komsys.org/~jocke/upgrade-dokuwiki.txt|Upgrading using common Linux commands (copy-paste commands)]] | |
| * [[http://falstaff.agner.ch/2010/08/12/using-git-to-install-dokuwiki/|Installing and upgrading via git]] | |
| | |
| | |
| ===== Upgrading an Old Distribution ===== | |
| | |
| When upgrading from a distribution which is a few or more years old, it is best to upgrade in stages, one year at a time, using the steps described above. You can get old distributions from the [[http://download.dokuwiki.org/archive|download archive]]. | |
| |
| | yourwiki> chmod -R 775 data/ |
| | yourwiki> chown -R www-data:foo data/ |
| | everything below the data directory: |
| | yourwiki/data> chmod 2775 {attic,cache,index,locks,media,meta,pages,tmp} |
| | yourwiki/data> chown www-data:foo {attic,cache,index,locks,media,meta,pages,tmp} |
| |
| | --- //[[jonathan@haacksnetworking.org|oemb1905]] 2022/07/14 22:47// |
