Differences

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

--- dokuwiki:upgrade_dokuwiki [2020/03/08 18:00] – created 192.168.1.69
+++ dokuwiki:upgrade_dokuwiki [2022/06/30 18:12] (current) – 45.89.242.195
@@ Line 1: / Line 1: @@
 ====== DokuWiki - Upgrade DokuWiki ======
+===== Make a backup of your DokuWiki =====
 <code bash>
@@ Line 5: / Line 7: @@
 </code>
-This will create the **dokuwiki-backup.tar.gz** backup.
+<WRAP info>
+**NOTE:**  This will create the **dokuwiki-backup.tar.gz** backup.
+</WRAP>
+----
+===== Check for changes =====
+Read the [[https://www.dokuwiki.org/changes|changelog]] to see if there are any special things to consider
+----
+===== Download the new version =====
+Download the newest release from the download site.
+<code bash>
+cd ~
+wget http://.../dokuwiki-xxxx-xx-xx.tgz
+</code>
+----
+===== Unpack the distribution tarball =====
+<code bash>
+tar zxvf dokuwiki-xxxx-xx-xx.tgz
+</code>
+----
+===== Upload/copy the files over your previous installation =====
+Make sure to overwrite all files when prompted.
+<code bash>
+'cp' -af dokuwiki-xxxx-xx-xx/* /path/to/dokuwiki/
+</code>
+<WRAP info>
+**NOTE:**  The quotes on **cp** assure that it will run as is, even if an alias is set.
+</WRAP>
+----
+===== Check copied files ownership and permissions =====
+<code bash>
+<?php
+if(function_exists('posix_geteuid')){
+  // use posix to get current uid and gid
+  $uid   = posix_geteuid();
+  $usr   = posix_getpwuid($uid);
+  $user  = $usr['name'];
+  $gid   = posix_getegid();
+  $grp   = posix_getgrgid($gid);
+  $group = $grp['name'];
+}else{
+  // try to create a file and read it's ids
+  $tmp = tempnam ('/tmp', 'check');
+  $uid = fileowner($tmp);
+  $gid = filegroup($tmp);
+  // try to run ls on it
+  $out = `ls -l $tmp`;
+  $lst = explode(' ',$out);
+  $user  = $lst[2];
+  $group = $lst[3];
+  unlink($tmp);
+}
+echo "Your PHP process seems to run with the UID $uid ($user) and the GID $gid ($group)\n"; ?>
+</code>
+Here are the most commonly used values for setting permissions on directories and files.
+^directories^files^result^
+|0700|0600|read/write for owner only. Owner must be the same as the PHP process user.|
+|0770|0660|read/write for owner and group. The PHP process user needs to be in the user group|
+|0777|0666|read/write for everyone. Dangerous because everybody with access to the server may write and delete your files. Use only as a last resort on trusted machines, NOT on a cheap shared hosting server.|
+----
+===== Delete all unused files =====
+<code bash>
+grep -Ev '^($|#)' data/deleted.files | xargs -n 1 rm -vf
+</code>
+----
+===== Upgrade your template and plugins =====
+Upgrade your template and plugins if necessary.
+----
+===== References =====
+https://www.dokuwiki.org/install:upgrade
+https://www.dokuwiki.org/install:unused_files