This shows you the differences between two versions of the page.
Next revision | Previous revisionNext revisionBoth sides next revision | ||
computing:dokuwiki [2017/05/16 02:14] – created oemb1905 | computing:dokuwiki [2022/07/15 04:47] – oemb1905 | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Upgrading DokuWiki ====== | + | ------------------------------------------- |
+ | * **dokuwiki** | ||
+ | * **Jonathan Haack** | ||
+ | * **Haack' | ||
+ | * **netcmnd@jonathanhaack.com** | ||
- | Note: if you installed DokuWiki through your Linux Distribution' | + | ------------------------------------------- |
+ | To upgrade dokuwiki, 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: | ||
+ | |||
+ | zip -r doku-bu-date.zip /path/to/doku | ||
+ | wget https:// | ||
+ | tar zxvf dokuwiki-example-39fe13964.tgz | ||
+ | ' | ||
+ | |||
+ | Once that's complete, 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: | ||
- | 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 | + | sudo chmod g+rwx / |
+ | sudo chmod -R 755 / | ||
+ | sudo chown -R www-data:user / | ||
+ | sudo chown www-data:user / | ||
+ | sudo chmod -R 775 / | ||
+ | sudo chmod -R 755 / | ||
+ | sudo chmod -R 755 / | ||
+ | cd / | ||
+ | sudo chmod 2775 {attic, | ||
+ | sudo chown www-data: | ||
- | * **Step 1:** Make a [[: | + | Dokuwiki details their permission recommendations here: [[https://www.dokuwiki.org/ |
- | * Example: \\ <code bash>tar zcpfv dokuwiki-backup.tar.gz / | + | |
- | + | ||
- | * **Step 2:** Read the [[: | + | |
- | + | ||
- | * **Step 3:** Download the newest release from the [[http://download.dokuwiki.org|download site]]. | + | |
- | * <code bash>cd ~ | + | |
- | wget http:// | + | |
- | + | ||
- | * **Step 4:** [[unpacking|Unpack]] the distribution tarball and upload/copy the files over your previous installation. Make sure to **overwrite all files** when prompted. | + | |
- | * <code bash>tar zxvf dokuwiki-xxxx-xx-xx.tgz | + | |
- | ' | + | |
- | * Check copied files ownership and permissions | + | |
- | + | ||
- | * **Step 5:** Delete all [[unused files]] | + | |
- | + | ||
- | * **Step 6:** Upgrade your [[: | + | |
- | + | ||
- | * **Step 7:** Wait for a day for update notifications to go away, or speed the process by following the steps in [[: | + | |
- | + | ||
- | + | ||
- | 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 " | + | |
- | ===== Troubleshooting ===== | + | |
- | + | ||
- | The following pages should give you hints on common post-upgrade problems: | + | |
- | + | ||
- | * [[: | + | |
- | * [[config: | + | |
- | * [[faq: | + | |
- | * [[faq: | + | |
- | + | ||
- | If you get errors about missing/ | + | |
- | + | ||
- | * '' | + | |
- | * '' | + | |
- | + | ||
- | + | ||
- | ===== Alternative Ways ===== | + | |
- | + | ||
- | Here are a few different upgrade descriptions, provided by users. They might be slightly out of date. | + | |
- | + | ||
- | * Use [[plugin: | + | |
- | * [[.: | + | |
- | * [[http:// | + | |
- | * [[http:// | + | |
- | * [[http:// | + | |
- | * [[http:// | + | |
- | + | ||
- | + | ||
- | ===== Upgrading an Old Distribution ===== | + | |
- | + | ||
- | When upgrading from a distribution | + | |
+ | yourwiki> | ||
+ | yourwiki> | ||
+ | everything below the data directory: | ||
+ | yourwiki/ | ||
+ | yourwiki/ | ||
+ | --- // |