Trusted
1,351
edits
Changes
From Amahi Wiki
Upgrading ownCloud to New Version Releases (view source)
Revision as of 18:31, 10 September 2015
, 18:31, 10 September 2015→Upgrading ownCloud on Amahi
Use the following steps for upgrading ownCloud:
* It is '''highly''' desirable that your current ownCloud instance is at the latest release number (nothing below release 8.0.0 will upgrade) before the next major version release. This is important as there may have been some important meta data fixes (or other fixes) that the new major release is dependent on. If you skip this step the upgrade for ownCloud may have some problems at a future time. The following sub-steps use an upgrade from ownCloud 8.0.7 to 8.1.1 as an example.* Catalogue Catalog all applications active in the current ownCloud instance. Take special care to identify the "core" applications that were activated and Approved/Experimental applications that were installed. There is no guarantee that non-core applications will work on a new ownCloud release.
* Review and document all ownCloud sharing techniques used in the current ownCloud instance.
* Do backups of the ownCloud database, binaries and stored files.
* Go to the Amahi Dashboard, Apps => Installed, and uninstall the current ownCloud instance. This will remove the ownCloud binaries and ownCloud database.
* Go to the Amahi Dashboard, Apps => Available, and install the new ownCloud release.
* The following sub-steps must be done for ownCloud releases from version 8.0 and beyond. Refer to the ''"ownCloud 8.0 and Future Updates/Upgrades on Amahi"'' section on this page for more information.
* Using a "terminal" connection, "cd" in to the ownCloud directory containing the binaries.
cd /var/hda/web-apps/owncloudx/html
- where "x" is an ownCloud major release number
* Restore the ownCloud "config.php" file from backups. Remember that this restore '''should be''' from the last major point release (i.e. 68.0.67) versus the new major release (i.e. 78.01.31) that will be the upgrade (not update).* The following sub-steps must be done for ownCloud releases from version 6.0.5 and beyond. Refer to the ''"ownCloud 8.0 and Future Updates/Upgrades on Amahi"'' section on this page for more information. The following sub-steps use an upgrade from ownCloud 6.0.6 to 7.0.3 as an example.
::Navigate to the ownCloud "config" directory:
cd /var/hda/web-apps/owncloud7owncloud8/html/config/
::The restored "config" directory contains a file, "config.php" as follows:
'instanceid' => 'xxx',
'passwordsalt' => 'xxxx',
'datadirectory' => '/var/hda/files/owncloud6owncloud8/data',
'dbtype' => 'mysql',
'version' => '68.0.6.17', 'dbname' => 'owncloud6owncloud8',
'dbhost' => 'localhost',
'dbtableprefix' => 'oc_',
'dbuser' => 'owncloud6owncloud8', 'dbpassword' => 'owncloud6owncloud8',
'installed' => true,
'theme' => '',
'maintenance' => false,
);
----'''NOTE::All '''When required, say an upgrade from 7 to 8, references with "owncloud6owncloud7" in this file must be changed to "owncloud7owncloud8". '''DO NOT''' change the "version".::The changes can be made with a text editor or the following handy Linux command. The following old example shows a major release change from 6 to 7. The command:looks through the "restored" config.php file in the new ownCloud7 upgrade instance, for occurrences of owncloud6 and changes them to owncloud7.
sed -i 's/owncloud6/owncloud7/g' /var/hda/web-apps/owncloud7/html/config/config.php
::The "config.php" will be would have been changed as follows:
$CONFIG = array (
'maintenance' => false,
);
----
* Using a "terminal" connection and using the command-line '''OR''' an Amahi MySQL application, restore the ownCloud database from backups.
* Using an Internet Browser navigate to ownCloud, the upgrade will now begin. Follow any instructions given by the ownCloud upgrade process.
* If the upgrade was successful, login to the ownCloud "adminadministration" ID user account as usual.
* Navigate to the Admin page and confirm new version release number.
* Confirm some of the other settings and make appropriate changes (file upload/download sizes, versioning).
* Navigate to the Apps page.
* Enable "core" applications that were used in the previous ownCloud instance "one-at-time". Testing each after enabling.
* Enable /Install any additional Approved/Experimental applications available from the new release that were used in the prior ownCloud instance. Testing each after enabling.* Login to a normal user ID account and test ownCloud functionality (i.e. sharing) and applications.
* If the prior testing was successful have other users test their ownCloud IDs.
* The upgrade is now completed.
