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 [2019/07/29 09:39] – oemb1905 | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Upgrading DokuWiki ====== | + | ------------------------------------------- |
+ | * **dokuwiki** | ||
+ | * **Jonathan Haack** | ||
+ | * **Haack' | ||
+ | * **netcmnd@jonathanhaack.com** | ||
- | Note: if you installed DokuWiki through your Linux Distribution' | + | ------------------------------------------- |
- | 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 | + | Backup dokuwiki |
+ | tar zcpfv dokuwiki-backup.tar.gz / | ||
- | * **Step 1:** Make a [[: | + | Download dokuwiki, untar it, copy it to primary dokuwiki directory |
- | * Example: \\ <code bash>tar zcpfv dokuwiki-backup.tar.gz /path/to/dokuwiki</code> | + | wget https:// |
+ | | ||
+ | ' | ||
+ | |||
+ | Often, I need to recursively chmod the entire | ||
- | | + | |
+ | 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 3:** Download the newest release from the [[http://download.dokuwiki.org|download site]]. | + | Dokuwiki details their permission recommendations here: [[https://www.dokuwiki.org/ |
- | * <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/ | ||
+ | --- // |