Trusted
1,351
edits
Changes
From Amahi Wiki
Upgrading ownCloud to New Version Releases (view source)
Revision as of 19:46, 15 November 2016
, 19:46, 15 November 2016→Upgrading ownCloud 8.2.1 to Nextcloud 10.x on Amahi
Starting from the ownCloud 8.0 release, new releases are issued in a "time based" schedule. Please be aware due to testing and software changes a schedule can be changed suddenly.
* z - patch and security intermediate releases are issued as necessary (i.e. 8.1.1, 8.1.2), also known as "point releases". This is an '''update'''.
<br/>
Refer to the ownCloud Nextcloud '''[https://github.com/owncloudnextcloud/coreserver/wiki/Maintenance-and-Release-Schedule Maintenance and Release Schedule]''' for more information.
<br/>
__TOC__
The following sections are meant for sites with small to medium installations. If for some reason an update/upgrade fails chances are it will be due to a "PHP timeout" or a software flaw in the ownCloud updater process. "PHP timeouts" can occur on larger installations, refer to the '''[https://docs.nextcloud.com/ Nextcloud documentation]''' regarding the use of the "'''occ'''" command-line facility (it works well for small to medium installations as well. Should the update/upgrade process (this happens from time-to-time) fail due to a software flaw consult the '''[https://help.nextcloud.com/categories/ Nextcloud Forum]''' for possible workarounds or wait a new release of Nextcloud.<br/>===Updating ownCloud/Nextcloud on Amahi=== Use the following steps for updating ownCloud:
* 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.
* The update is now completed.
===Upgrading ownCloud /Nextcloud 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.
----
'''NOTE:'''
The following old example shows a major release change from 6 to 7.<br/> When required, say an upgrade from 6 to 7 to 8, references with "owncloud7owncloud6" in this file must be changed to "owncloud8owncloud7". '''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 ownCloud 7 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 upgrade is now completed.
===ownCloud 8.0 /Nextcloud and Future Updates/Upgrades on Amahi===
In order to allow multiple instances of different version releases of ownCloud on the same Amahi server naming changes to the main ownCloud application directory and database names have been implemented.
* If you use automated backup and recovery software you may have to reload and reconfigure your ownCloud data and backup system configuration before the next backup set is taken. Some backup systems allow you to change the ownCloud directory names (data, ownCloud config,php location) in the existing backup sets (rsnapshot).
* Starting with ownCloud 8.0, any-to-any major version upgrades will be supported. Prior to ownCloud 8.0on upgrade, most applications are disabled, it was necessary to upgrade one release at a time only certain "core" applications are left enabled (i.e. ownCloud 6 -> 7 -> 8Files, Pictures) from the last prior software patch and security release. With The ownCloud 8, it will be possible Community has "slimmed" down their installation package to upgrade from 8provide basic functionality.0 Most "core" applications have now been moved to 8.3 or 9.1 directlythe ownCloud appStore.
# Backup the ownCloud 8.2.1 (not guaranteed to work for anything earlier) instance to be upgrade, including the database.# Rename the old owncloud code directory in “/var/www/html/”, to say “xowncloud”.# Download and extract “Nextcloud 10.0.x” to a "Downloads" or other known location.# Rename the “nextcloud” binaries directory to “owncloud”.# Copy the downloaded binaries (owncloud) directory over to the "/var/www/html/" location.# Go to the copied "owncloud" directory under /var/www/html/, find PHP files; "version.php" and "index.php". '''Copy''' them to a known location, they will be required downstream in the upgrade.# In “owncloud” directory, in the “version.php” file.# Find the line containing "$OC_VersionCanBeUpgradedFrom".# Change the entry to: $OC_VersionCanBeUpgradedFrom = array(8,2,1); '''<span style="color:#FF0000"><== DO NOT TRY THIS FOR VERSIONS PRIOR TO V8.2.1, IT MOST LIKELY WILL FAIL.</span>'''# Drop and create the database instance.# Perform the usual recommended upgrade steps (from backups??): ## Restore the old "config.php". ## Restore the database. ## Set permissions and ownership to binaries directory structure.# Now do the usual upgrade process (i.e. via the browser GUI). The upgrade "should" complete successfully. '''DO NOT''' login to Nextcloud yet.# Copy the original “index.php” and “version.php” files from the "known" location in to the “owncloud” directory, replacing the existing copies (this will overwrite the modified version.php).# After the copying of the PHP files, restart the Apache or reboot the server.# Login to Nextcloud as the “administration user” and go to the “Admin” application. A scanning operation will begin in the “Security & setup warnings” section. # After a period of time a warning message will appear in “red” stating that a “Code Integrity check...” failure has occurred.# On the red line for this failure, "click" on the "Rescan" link. This will force a new Nextcloud scan. After the new scan the code check failure should disappear.# Test the new instance. On the surface most things will upgrade correctly. ::*Sharing and data configurations tested worked "mostly".::*Some applications may not upgrade correctly, usually disabling/enabling each application should fix the issue. ::*If using “External Storage Support”, there maybe a double entry for the same items. Delete the second one.<br/>
----
[[OwnCloud|Main ownCloud Page]]
