[Pkg-owncloud-commits] [owncloud-doc] 02/18: Update.rst partially rewritten

[David Prévot]

This is an automated email from the git hooks/post-receive script.

taffit pushed a commit to branch dfsg_clean
in repository owncloud-doc.

commit 251f76a700bec0a0d7b8e39d9163874049be2506
Author: Francesco Frassinelli <fraph24 at gmail.com>
Date:   Fri Nov 15 15:04:02 2013 +0100

    Update.rst partially rewritten
    
    - Removed backup specific procedures
    - Default updating procedure now uses internal application 'Updater'
    - Some commands added
---
 admin_manual/maintenance/update.rst |   65 +++++++++++++----------------------
 1 file changed, 24 insertions(+), 41 deletions(-)

diff --git a/admin_manual/maintenance/update.rst b/admin_manual/maintenance/update.rst
index 4f1d8cf..9f556b4 100644
--- a/admin_manual/maintenance/update.rst
+++ b/admin_manual/maintenance/update.rst
@@ -1,42 +1,21 @@
 Updating ownCloud
 =================
 
+.. note:: If you have installed ownCloud from a repository, your package management should take care of it. Probably you will need to look for compatible third party applications yourself. **Always do backups anyway.**
+
 Update
 ------
-Updating means updating ownCloud to the latest *point release*, e.g. ownCloud 4.0.6 → 4.0.7. To update an ownCloud installation manually, follow those steps:
-
-.. note:: If you have installed ownCloud from a repository, your package management should take care of it.
-
-#. Make a backup.
-#. Unpack the release tarball in the owncloud directory, i.e. copy all new files into the ownCloud installation.
-#. Make sure that the file permissions are correct.
-#. After the next page request the update procedures will run.
-
-Assuming your ownCloud installation is at **./owncloud/** and you want to update to the latest version, you could do the following:
-
-Use rsync in archive mode (this leaves file owner, permissions, and time stamps untouched) to recursively copy all content from **./owncloud/** to a backup directory which contains the current date::
-
-  rsync -a owncloud/ owncloud_bkp`date +"%Y%m%d"`/
-
-Download the latest version to the working directory::
-
-  wget http://download.owncloud.org/community/owncloud-latest.tar.bz2
+Updating means updating ownCloud to the latest *point release*, e.g. ownCloud 4.0.6 → 4.0.7. This procedure uses the ownCloud updater plugin called "Updater": it's an internal application already present in your ownCloud installation.
 
-Extract content of archive to **./owncloud_latest/**::
+To update ownCloud, follow those steps:
 
-  mkdir owncloud_latest; tar -C owncloud_latest -xjf owncloud-latest.tar.bz2
+#. Make a backup of the ownCloud folder and the database.
+#. Make sure that updater plugin is enabled.
+#. Navigate to the 'Admin' page.
+#. Click 'Update'.
+#. Refresh the page with Ctrl+F5.
 
-Use rsync to recursivly copy extracted files (new) to ownCloud installation (old) using modification times of the new files, but preserving owner and permissions of the old files:
-
-.. warning:: You should not use this [--inplace] option to update files that are being accessed by others *(from rysnc man page)*
-
-::
-
-  rsync --inplace -rtv owncloud_latest/owncloud/ owncloud/
-
-Clean up::
-
-  rm -rf owncloud-latest.tar.bz2 owncloud_latest/
+If this procedure doesn't work (for example, ownCloud 5.0.10 doesn't show new any new version) you could try to perform a full upgrade to update to the lastest point release (see below).
 
 Upgrade
 -------
@@ -48,18 +27,22 @@ To upgrade ownCloud, follow those steps:
 #. Make sure that you ran the latest point release of the major ownCloud
    version, e.g. 4.0.7 in the 4.0 series. If not, update to that version first
    (see above).
-#. **Make a backup of the ownCloud folder and the database**
+#. Make a backup of the ownCloud folder and the database.
+#. Download the latest version to the working directory:
+    
+    wget http://download.owncloud.org/community/owncloud-latest.tar.bz2
+
 #. Deactivate all third party applications.
 #. Delete everything from your ownCloud installation directory, except data and
-   config.
+   config. Assuming that it's your working directory, you could execute this command:
+    
+    ls | grep -v '\(data\)\|\(config\)' | xargs rm -r
+
 #. Unpack the release tarball in the owncloud directory (or copy the
-   files thereto).
-#. Make sure that the file permissions are correct.
+   files thereto). Assuming that your installation directory is called 'owncloud' and that it's inside your working directory, you could execute this command:
+   
+    tar xfj owncloud-latest.tar.bz2
+   
 #. With the next page request the update procedures will run.
 #. If you had 3rd party applications, check if they provide versions compatible
-   with the new release.
-
-If so, install and enable them, update procedures will run if needed.  9. If
-you installed ownCloud from a repository, your package management should take
-care of it. Probably you will need to look for compatible third party
-applications yourself. Always do backups anyway.
+   with the new release. If so, install and enable them, update procedures will run if needed. 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-owncloud/owncloud-doc.git