From 35f47b024b76a1f7f663ffdfbaea669d411f5e2b Mon Sep 17 00:00:00 2001 From: Carla Schroder Date: Tue, 17 Mar 2015 18:54:02 -0700 Subject: [PATCH] Corrections to upgrading docs --- admin_manual/images/upgrade-1.png | Bin 0 -> 33175 bytes admin_manual/maintenance/index.rst | 2 +- admin_manual/maintenance/update.rst | 13 +- admin_manual/maintenance/upgrade.rst | 208 ++++++++++++++------------- 4 files changed, 116 insertions(+), 107 deletions(-) create mode 100644 admin_manual/images/upgrade-1.png diff --git a/admin_manual/images/upgrade-1.png b/admin_manual/images/upgrade-1.png new file mode 100644 index 0000000000000000000000000000000000000000..1b574fa9db07977ce51b03f5e21ff10f042c8142 GIT binary patch literal 33175 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, and then stay current by using your package manager to -upgrade. You should still maintain regular backups (see :doc:`backup`), and make -a backup before every update/upgrade. +`_ (see :doc:`../installation/linux_installation`), and then +stay current by using your Linux package manager to upgrade. You should still +maintain regular backups (see :doc:`../maintenance/backup`), and make a backup +before every upgrade. -Windows server admins must use the manual upgrade procedure. +All supported Linux distributions have update notifications and automatic +updaters. When a new ownCloud release is available from the openSUSE Build +Service repository, you will see it in your normal Linux package update +notifier, or it will be applied along with any other automatic updates. You may +wish to disable automatic package updates for ownCloud if you are running +third-party apps, so that you can verify their compatibility before upgrading +to a major release. -You cannot skip major releases; for example, upgrading from 5.0 to 7.0. This is -unsupported, and you'll experience unpredictable results. It is best to install -all upgrades and updates in order. +Upgrading With Your Linux Package Manager +----------------------------------------- + +When an ownCloud upgrade is available from the openSUSE Build Service +repository, you can apply it just like any normal Linux upgrade. For example, +on Debian or Ubuntu Linux this is the standard system upgrade command:: + + $ sudo apt-get update && sudo apt-get upgrade + +Or you can upgrade just ownCloud with this command:: + + $ sudo apt-get update && sudo apt-get install owncloud + +On Fedora, CentOS, and Red Hat Linux use ``yum`` to see all available updates:: + + $ yum check-update + +You can apply all available updates with this command:: + + $ sudo yum update + +Or update only ownCloud:: + + $ sudo yum update owncloud + +Your Linux package manager only downloads the current ownCloud packages. There +is one more step, and that is to run the upgrade wizard to perform the final +steps of updating the database and turning off maintenance mode. You will see +two screens. On the first screen, click the Start Upgrade button, or optionally +run the ``occ upgrade`` command instead of clicking the button. + +.. figure:: ../images/updater-8.png + +``occ upgrade`` +is more reliable, especially on installation with large datasets and large +numbers of users because it avoids the risk of PHP timeouts. The ``occ`` command +is in your ``owncloud/`` directory. You must run it as your HTTP user. This +example is for Debian/Ubuntu:: + + $ sudo -u www-data php occ upgrade + +This example is for Fedora, CentOS, and Red Hat Linux:: + + $ sudo -u apache php occ upgrade + +See :doc:`../configuration_server/occ_command` to learn more about using the +``occ`` command, and see the **Setting Strong Directory Permissions** section +of :doc:`../installation/installation_wizard` to learn about how to find your +HTTP user. + +When the upgrade is successful you will see the following screen: + +.. figure:: ../images/updater-7.png + +If the upgrade fails, then you must try a manual upgrade. Manual Upgrade Procedure ------------------------ Start by putting your server in maintenance mode. Do this by entering your -``config.php`` file and changing ``'maintenance' => false,`` to ``'maintenance' +``owncloud/config/config.php`` file and changing ``'maintenance' => false,`` to +``'maintenance' => true,``. This prevents new logins, and logged-in users can't make any further requests. -1. Ensure that you are running the latest point release of your current major - ownCloud version. -2. Deactivate all third party applications (not core apps), and review them for - compatibility with your new ownCloud version. -3. Back up your existing ownCloud Server database, data directory, and +1. If you are upgrading to a major release, for example from 7.0.5 to + 8.0, you must review all third party applications (not core apps), for + compatibility with your new ownCloud version. Then disable all of them + before starting the upgrade. +2. Back up your existing ownCloud Server database, data directory, and ``config.php`` file. (See :doc:`backup`.) -4. Download and unpack the latest ownCloud Server version from `owncloud.org/install/ +3. Download and unpack the latest ownCloud Server release (Archive file) from + `owncloud.org/install/ `_ into an empty directory outside of your current installation. For example, if your current ownCloud is installed in ``/var/www/owncloud/`` you could create a new directory called ``/var/www/owncloud2/`` -5. Stop your web server. +4. Stop your web server. -Depending on your environment, you will be running either an Apache server or -a Windows IIS server. To stop an Apache server, refer to the following table for -specific commands to use in different Linux operating systems: +Apache 2 is the recommended server for ownCloud (see :doc:`../release_notes` +for recommended setups and supported platforms.) +-----------------------+-----------------------------------------+ | Operating System | Command (as root) | @@ -65,68 +134,32 @@ specific commands to use in different Linux operating systems: | openSUSE 12.3 and up | ``systemctl stop apache2`` | +-----------------------+-----------------------------------------+ -To stop the Windows IIS web server, you can use either the user interface (UI) -or command line method as follows: - - - +----------------------+---------------------------------------------------+ - | Method | Procedure | - | | | - +======================+===================================================+ - | User Interface (UI) | 1. Open IIS Manager and navigate to the | - | | web server node in the tree. | - | | | - | | 2. In the **Actions** pane, click **Stop**. | - +----------------------+---------------------------------------------------+ - | Command Line | 1. Open a command line window as | - | | administrator. | - | | | - | | 2. At the command prompt, type **net stop WAS** | - | | and press **ENTER**. | - | | | - | | 3. (Optional) To stop W3SVC, type **Y** and | - | | then press **ENTER**. | - +----------------------+---------------------------------------------------+ - -6. Rename or move your current ownCloud directory (named ``owncloud/`` if +5. Rename or move your current ownCloud directory (named ``owncloud/`` if installed using defaults) to another location. -7. Unpack your new tarball: +6. Unpack your new tarball:: - ``tar xjf owncloud-latest.tar.bz2`` + tar xjf owncloud-latest.tar.bz2 - In Microsoft Windows environments, you can unpack the release tarball using - WinZip or a similar tool (for example, Peazip). Always unpack server code - into an empty directory. Unpacking the server code into an existing, - populated directory is not supported and will cause all kinds of errors. - -8. This creates a new ``owncloud/`` directory populated with your new server +7. This creates a new ``owncloud/`` directory populated with your new server files. Copy this directory and its contents to the original location of your old server, for example ``/var/www/``, so that once again you have ``/var/www/owncloud`` . -9. Copy and paste the ``config.php`` file from your old version of +8. Copy and paste the ``config.php`` file from your old version of ownCloud to your new ownCloud version. -10. If you keep your ``data/`` directory in your ``owncloud/`` directory, copy - it from your old version of ownCloud to the ``owncloud/`` directory of your - new ownCloud version. If you keep it outside of ``owncloud/`` then you - don't have to do anything with it. +9. If you keep your ``data/`` directory in your ``owncloud/`` directory, copy + it from your old version of ownCloud to the ``owncloud/`` directory of + your new ownCloud version. If you keep it outside of ``owncloud/`` then + you don't have to do anything with it. .. note:: We recommend storing your ``data/`` directory in a location other than your ``owncloud/`` directory. If you have your ``data/`` directory already stored in another location, you can skip this step. If you want to do so, now is a good time to change the location of your ``data/`` directory. -11. Restart your web server. - -Depending on your environment, you will be running either an Apache server or a -Windows IIS server. In addition, when running your server in a Linux -environment, the necessary commands for stopping the Apache server might differ -from one Linux operating system to another. - -To start an Apache server, refer to the following table for specific commands -to use in different Linux operating systems: +10. Restart your web server. +-----------------------+-----------------------------------------+ | Operating System | Command (as root) | @@ -142,38 +175,16 @@ to use in different Linux operating systems: | | | | openSUSE 12.3 and up | ``systemctl start apache2`` | +-----------------------+-----------------------------------------+ - -To start the Windows IIS web server, you can use either the user interface -(UI) or command line method as follows: - - +----------------------+---------------------------------------------------+ - | Method | Procedure | - | | | - +======================+===================================================+ - | User Interface (UI) | 1. Open IIS Manager and navigate to the | - | | web server node in the tree. | - | | | - | | 2. In the **Actions** pane, click **Stop**. | - +----------------------+---------------------------------------------------+ - | Command Line | 1. Open a command line window as | - | | administrator. | - | | | - | | 2. At the command prompt, type **net stop WAS** | - | | and press **ENTER**. | - | | | - | | 3. (Optional) To stop W3SVC, type **Y** and | - | | then press **ENTER**. | - +----------------------+---------------------------------------------------+ -12. Now you should be able to open a web browser to your ownCloud server and +11. Now you should be able to open a Web browser to your ownCloud server and log in as usual. You have a couple more steps to go: You should see a - **Start Update** screen. Review the prequisites, and if you have followed - all the steps click the **Start Update** button. + **Start Update** screen, just like in the **Upgrading With Your Linux + Package Manager** section, above. Review the prerequisites, and if you have + followed all the steps click the **Start Update** button. - - If you are an enterprise customer, or are running a large installation with - a lot of files and users, you should launch the update from the command - line using ``occ`` to avoid timeouts, like this example on Ubuntu Linux:: + If you are running a large installation with a lot of files and users, + you should launch the upgrade from the command line using ``occ`` to + avoid PHP timeouts, like this example on Ubuntu Linux:: $ sudo -u www-data php occ upgrade @@ -187,9 +198,8 @@ To start the Windows IIS web server, you can use either the user interface Assuming your upgrade succeeded, take a look at the bottom of the Admin page to verify the version number. Check your other settings to make sure they're correct. Go to the Apps page and review the core apps to make sure the right -ones are enabled. - -Now you can review your third-party apps, and upgrade and enable them. +ones are enabled. Now you can review your third-party apps, and upgrade and +enable them. Troubleshooting ---------------