AppSuite:Upgrade from 6.22 for CentOS6 - Revision history

Christian.kundner: Switchet Repo by Text to Repo by Template; Added LDB-Credentials for the Update paths

2016-01-12T14:43:00Z

Switchet Repo by Text to Repo by Template; Added LDB-Credentials for the Update paths

← Older revision		Revision as of 14:43, 12 January 2016
Line 47:		Line 47:
	Add App Suite repositories to your sources.list:		Add App Suite repositories to your sources.list:

	[appsuite~~-frontend]~~		{{for loop\|\|call=YUMRepo\|pv=reponame\|pc1n=path\|pc1v=products/appsuite/stable\|pc2n=rhelname\|pc2v=RHEL6\|appsuiteui}}
	~~name~~=~~Appsuite-frontend~~
	~~baseurl~~=~~http://software.open-xchange.com/~~products/appsuite/stable~~/appsuiteui~~/RHEL6/		if you have a valid maintenance subscription, please uncomment the
	~~gpgkey~~=~~http~~:~~//software~~.~~open-xchange~~.~~com/oxbuildkey.pub~~		following and add the ldb account data to the url so that the most recent
	~~enabled~~=1		packages get installed
	~~gpgcheck~~=1
	~~metadata_expire~~=0m		{{for loop\|\|call=YUMRepo\|pv=reponame\|pc1n=path\|pc1v=products/appsuite/stable\|pc2n=rhelname\|pc2v=updates/RHEL6\|pc3n=ldbaccount\|pc3v=LDBUSER:LDBPASSWORD\|appsuiteui}}

			Since the OX App Suite backend is the same as the OX6 backend, there is no need to add the backend repository here. But, on the other hand, you may add it here, and remove the backend repository from the OX6 repository list.

			{{for loop\|\|call=YUMRepo\|pv=reponame\|pc1n=path\|pc1v=products/appsuite/stable\|pc2n=rhelname\|pc2v=RHEL6\|backend\|usm}}

	~~#[appsuite-backend]~~		if you have a valid maintenance subscription, please uncomment the
	~~#name=Appsuite-backend~~		following and add the ldb account data to the url so that the most recent
	~~#baseurl=http://software.open-xchange.com/products/appsuite/stable/backend/RHEL6/~~		packages get installed
	~~#gpgkey=http://software.open-xchange.com/oxbuildkey.pub~~
	~~#enabled=1~~
	~~#gpgcheck=1~~
	~~#metadata_expire=0m~~
	#
	~~#[appsuite-usm]~~
	~~#name=Appsuite-usm~~
	~~#baseurl=http://software.open-xchange.com/products/appsuite/stable/usm/RHEL6/~~
	~~#gpgkey=http://software.open-xchange.com/oxbuildkey.pub~~
	~~#enabled=1~~
	~~#gpgcheck=1~~
	~~#metadata_expire=0m~~

	~~Since the OX App Suite~~ backend ~~is the same as the OX6 backend, there is no need to add the backend repository here. But, on the other hand, you may add it here, and remove the backend repository from the OX6 repository list.~~		{{for loop\|\|call=YUMRepo\|pv=reponame\|pc1n=path\|pc1v=products/appsuite/stable\|pc2n=rhelname\|pc2v=updates/RHEL6\|pc3n=ldbaccount\|pc3v=LDBUSER:LDBPASSWORD\|backend\|usm}}

	Then, install packages:		Then, install packages:
Line 77:		Line 69:
	# yum install open-xchange-appsuite open-xchange-appsuite-backend open-xchange-appsuite-manifest		# yum install open-xchange-appsuite open-xchange-appsuite-backend open-xchange-appsuite-manifest

	{{AppSuiteUpgradeAdjustApacheConfig\|filename=ox.conf\|distro=~~CentOS_6~~\|apacheservice=httpd}}		{{AppSuiteUpgradeAdjustApacheConfig\|filename=ox.conf\|distro=RHEL6\|apacheservice=httpd}}

	{{AppSuiteUpgradeRemoveOX6GUI\|listpackages=rpm -qa\|uninstallpackages=yum remove\|apacheconf=/etc/httpd/conf.d/ox.conf\|distro=~~CentOS_6~~}}		{{AppSuiteUpgradeRemoveOX6GUI\|listpackages=rpm -qa\|uninstallpackages=yum remove\|apacheconf=/etc/httpd/conf.d/ox.conf\|distro=RHEL6}}

	== Leftover configuration files and runtime data ==		== Leftover configuration files and runtime data ==

	After the update you may see leftover configuration files and runtime data below <code>/opt/open-xchange/etc</code>. It is safe to remove all files ending in .rpmsave or .rpmnew once you are confident that your configuration is working after the update.		After the update you may see leftover configuration files and runtime data below <code>/opt/open-xchange/etc</code>. It is safe to remove all files ending in .rpmsave or .rpmnew once you are confident that your configuration is working after the update.

Christian.kundner: Switchet Repo by Text to Repo by Template; Added LDB-Credentials for the Update paths

2016-01-12T14:40:44Z

Switchet Repo by Text to Repo by Template; Added LDB-Credentials for the Update paths

@@ Line 7: / Line 7: @@
 If not already configured, we make the latest OX6 repos available by ajdusting the file <code>/etc/yum.repos.d/ox.repo</code>:
-  [ox6-frontend]
+  {{for loop||call=YUMRepo|pv=reponame|pc1n=path|pc1v=OX6/6.22|pc2n=rhelname|pc2v=RHEL6|frontend|backend|usm}}
- name=OX6-frontend
- baseurl=http://software.open-xchange.com/OX6/6.22/frontend/RHEL6/
+if you have a valid maintenance subscription, please uncomment the
- gpgkey=http://software.open-xchange.com/oxbuildkey.pub
+following and add the ldb account data to the url so that the most recent
- enabled=1
+packages get installed
- gpgcheck=1
- metadata_expire=0m
+  {{for loop||call=YUMRepo|pv=reponame|pc1n=path|pc1v=OX6/6.22|pc2n=rhelname|pc2v=RHEL6|pc3n=ldbaccount|pc3v=LDBUSER:LDBPASSWORD|updates/frontend|updates/backend|updates/usm}}
 Verify the repos:

Dominik.epple: /* Update Open-Xchange Repositories */

2013-09-27T14:54:56Z

Update Open-Xchange Repositories

← Older revision		Revision as of 14:54, 27 September 2013
Line 34:		Line 34:
	# following and add the ldb account data to the url so that the most recent		# following and add the ldb account data to the url so that the most recent
	# packages get installed		# packages get installed
			#
	[ox6-frontend]		#[ox6-frontend-updates]
	name=OX6-frontend		#name=OX6-frontend-updates
	baseurl=http://software.open-xchange.com/OX6/6.22/updates/frontend/RHEL6/		#baseurl=http://software.open-xchange.com/OX6/6.22/updates/frontend/RHEL6/
	gpgkey=http://software.open-xchange.com/oxbuildkey.pub		#gpgkey=http://software.open-xchange.com/oxbuildkey.pub
	enabled=1		#enabled=1
	gpgcheck=1		#gpgcheck=1
	metadata_expire=0m		#metadata_expire=0m
			#
	[ox6-backend]		#[ox6-backend-updates]
	name=OX6-backend		#name=OX6-backend-updates
	baseurl=http://software.open-xchange.com/OX6/6.22/updates/backend/RHEL6/		#baseurl=http://software.open-xchange.com/OX6/6.22/updates/backend/RHEL6/
	gpgkey=http://software.open-xchange.com/oxbuildkey.pub		#gpgkey=http://software.open-xchange.com/oxbuildkey.pub
	enabled=1		#enabled=1
	gpgcheck=1		#gpgcheck=1
	metadata_expire=0m		#metadata_expire=0m
			#
	[ox6-usm]		#[ox6-usm-updates]
	name=OX6-usm		#name=OX6-usm-updates
	baseurl=http://software.open-xchange.com/OX6/6.22/updates/usm/RHEL6/		#baseurl=http://software.open-xchange.com/OX6/6.22/updates/usm/RHEL6/
	gpgkey=http://software.open-xchange.com/oxbuildkey.pub		#gpgkey=http://software.open-xchange.com/oxbuildkey.pub
	enabled=1		#enabled=1
	gpgcheck=1		#gpgcheck=1
	metadata_expire=0m		#metadata_expire=0m

	Verify the repos:		Verify the repos:

Dominik.epple at 14:53, 27 September 2013

2013-09-27T14:53:50Z

Show changes

Malasa: /* Update Open-Xchange Repositories */

2013-03-25T14:15:56Z

Update Open-Xchange Repositories

← Older revision		Revision as of 14:15, 25 March 2013
Line 40:		Line 40:
	[appsuite-eas]		[appsuite-eas]
	name=Appsuite-eas		name=Appsuite-eas
	baseurl=http://software.open-xchange.com/products/appsuite/stable/mobilityconnector/RHEL6/		baseurl=http://LDBUSERNAME:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/mobilityconnector/RHEL6/
	gpgkey=http://software.open-xchange.com/oxbuildkey.pub		gpgkey=http://software.open-xchange.com/oxbuildkey.pub
	enabled=1		enabled=1

Malasa: wrong link for eas repo

2013-02-27T14:35:22Z

wrong link for eas repo

← Older revision		Revision as of 14:35, 27 February 2013
Line 40:		Line 40:
	[appsuite-eas]		[appsuite-eas]
	name=Appsuite-eas		name=Appsuite-eas
	baseurl=http://software.open-xchange.com/products/appsuite/stable/~~eas~~/RHEL6/		baseurl=http://software.open-xchange.com/products/appsuite/stable/mobilityconnector/RHEL6/
	gpgkey=http://software.open-xchange.com/oxbuildkey.pub		gpgkey=http://software.open-xchange.com/oxbuildkey.pub
	enabled=1		enabled=1

Khgras at 13:11, 25 February 2013

2013-02-25T13:11:23Z

Dominik.epple: /* Update Open-Xchange Repositories */

2013-02-14T11:04:47Z

Update Open-Xchange Repositories

← Older revision		Revision as of 11:04, 14 February 2013
Line 37:		Line 37:
	gpgcheck=1		gpgcheck=1
	metadata_expire=0m		metadata_expire=0m

	[appsuite-eas]		[appsuite-eas]
	name=Appsuite-eas		name=Appsuite-eas

Dominik.epple: /* Update Open-Xchange Repositories */

2013-02-14T11:04:24Z

Update Open-Xchange Repositories

@@ Line 25: / Line 25: @@
   name=Appsuite-backend
   baseurl=http://software.open-xchange.com/products/appsuite/stable/backend/RHEL6/
   gpgkey=http://software.open-xchange.com/oxbuildkey.pub
   enabled=1

Dominik.epple at 10:45, 14 February 2013

2013-02-14T10:45:05Z

← Older revision		Revision as of 10:45, 14 February 2013
Line 71:		Line 71:
	# yum install open-xchange-appsuite open-xchange-appsuite-backend open-xchange-appsuite-manifest		# yum install open-xchange-appsuite open-xchange-appsuite-backend open-xchange-appsuite-manifest

	It them remains to adjust Apache's <code>ox.conf</code> as well as <code>proxy_ajp.conf</code>.		It them remains to adjust Apache's <code>ox.conf</code> as well as <code>proxy_ajp.conf</code>. Full sample versions of those files are given in the following.

	Basically you need to merge the OX6 and App Suite versions of those files. For the Apache config file <code>/etc/httpd/conf.d/ox.conf</code>, replace the element <code><Directory /var/www/html> ... </Directory></code> with the following:		# /etc/httpd/conf.d/ox.conf

	~~<Directory /var/www/html>~~
	~~Options Indexes FollowSymLinks MultiViews~~
	~~AllowOverride None~~
	~~Order allow,deny~~
	~~allow from all~~
	~~RedirectMatch ^/$ /appsuite/~~
	~~</Directory>~~

	~~<Directory /var/www/html/appsuite>~~
	~~Options None +SymLinksIfOwnerMatch~~
	~~AllowOverride Indexes FileInfo~~
	~~</Directory>~~

	~~ErrorLog ${APACHE_LOG_DIR}/error.log~~

	# ~~Possible values include: debug, info, notice, warn, error, crit,~~
	~~# alert, emerg.~~
	~~LogLevel warn~~

	~~CustomLog ${APACHE_LOG_DIR}/access.log combined~~

	~~For the <code>~~/etc/httpd/conf.d/~~proxy_ajp~~.conf~~</code>, you need to add an element before the element <code><Proxy /ajax> ... </Proxy></code>:~~

	~~# OX AppSuite frontend~~
	~~<Proxy /appsuite/api>~~
	~~ProxyPass balancer://oxcluster/ajax~~
	~~</Proxy>~~

	~~Full sample versions of those files are given in the following.~~

	~~# /etc/apache2/sites-available/default~~
	<VirtualHost *:80>		<VirtualHost *:80>
	ServerAdmin webmaster@localhost		ServerAdmin webmaster@localhost
Line 191:		Line 159:
	</VirtualHost>		</VirtualHost>

	# /etc/~~apache2~~/conf.d/proxy_ajp.conf		# /etc/httpd/conf.d/proxy_ajp.conf
	# Please note that the servlet path to the soap API has changed:		# Please note that the servlet path to the soap API has changed:
	<Location /webservices>		<Location /webservices>
Line 253:		Line 221:
	</IfModule>		</IfModule>

	After this, stop and start the ~~apache2~~ and open-xchange services. Then you should be able to use the App Suite UI.		After this, stop and start the httpd and open-xchange services. Then you should be able to use the App Suite UI.

	= Remove the OX6 GUI =		= Remove the OX6 GUI =
Line 267:		Line 235:
	Then adjust the <code>/etc/httpd/conf.d/ox.conf</code> file to remove obsolete stuff which was required for the OX6 GUI, but is not required by the App Suite. To do so, you may consult the [[AppSuite:Open-Xchange_Installation_Guide_for_CentOS_6\|Installation Guide for OX Appsuite]] to learn which sections of the file are required for an App Suite UI.		Then adjust the <code>/etc/httpd/conf.d/ox.conf</code> file to remove obsolete stuff which was required for the OX6 GUI, but is not required by the App Suite. To do so, you may consult the [[AppSuite:Open-Xchange_Installation_Guide_for_CentOS_6\|Installation Guide for OX Appsuite]] to learn which sections of the file are required for an App Suite UI.

	The file <code>/etc/~~apache2~~/conf.d/proxy_ajp.conf</code> will not require adjustments; the settings for Appsuite are a superset of the settings of the OX6 GUI.		The file <code>/etc/httpd/conf.d/proxy_ajp.conf</code> will not require adjustments; the settings for Appsuite are a superset of the settings of the OX6 GUI.

	= Leftover configuration files and runtime data =		= Leftover configuration files and runtime data =

	After the update you may see leftover configuration files and runtime data below <code>/opt/open-xchange/etc</code> It is safe to remove all files ending in .rpmsave or .rpmnew once you are confident that your configuration is working after the update.		After the update you may see leftover configuration files and runtime data below <code>/opt/open-xchange/etc</code> It is safe to remove all files ending in .rpmsave or .rpmnew once you are confident that your configuration is working after the update.

← Older revision		Revision as of 13:11, 25 February 2013
Line 3:		Line 3:

	= Supported update path =		= Supported update path =
	Updates from an OX6 installation to App Suite are only possible from 6.22 to 7.0. If you have an earlier version of Open-Xchange Server 6 installed, please update to the latest release of v6.22 before attempting an update to OX ~~Appsuite~~ 7. See [[Open-Xchange_620_622_Update_Guide_for_CentOS6\|Open-Xchange 6.20 to 6.22 Update Guide for CentOS 6]] for instructions regarding that update.		Updates from an OX6 installation to App Suite are only possible from 6.22 to 7.0. If you have an earlier version of Open-Xchange Server 6 installed, please update to the latest release of v6.22 before attempting an update to OX App Suite 7. See [[Open-Xchange_620_622_Update_Guide_for_CentOS6\|Open-Xchange 6.20 to 6.22 Update Guide for CentOS 6]] for instructions regarding that update.

	= Requirements =		= Requirements =
	* An Open-Xchange Server installation v6.22.0 or later. This update guide is valid for a system installed through our [[Open-Xchange_Installation_Guide_for_CentOS_6_622\|Download and Installation Guide for CentOS 6]]		* An Open-Xchange Server installation v6.22.0 or later. This update guide is valid for a system installed through our [[Open-Xchange_Installation_Guide_for_CentOS_6_622\|Download and Installation Guide for CentOS 6]]
	* If you have custom packages done by Open-Xchange, please discuss with your Open-Xchange contact when these packages are available for OX ~~Appsuite~~ 7. Do not attempt the update earlier.		* If you have custom packages done by Open-Xchange, please discuss with your Open-Xchange contact when these packages are available for OX App Suite 7. Do not attempt the update earlier.
	* Custom packages built for 6.22.1 or earlier might not work with OX ~~Appsuite~~ 7.0.		* Custom packages built for 6.22.1 or earlier might not work with OX App Suite 7.0.
	* As for every update we strongly recommend that you make a backup of your system(s) before you proceed.		* As for every update we strongly recommend that you make a backup of your system(s) before you proceed.

Line 83:		Line 83:
	Now the backend has been upgraded to 7.0.x. The v6.22 frontend might still work with this new backend but is NOT' supported up to version 6.22.1. Upon the first connection after the backend update, you will ge tthe message <code>Error: updating database, try later</code>. The second try should succeed.		Now the backend has been upgraded to 7.0.x. The v6.22 frontend might still work with this new backend but is NOT' supported up to version 6.22.1. Upon the first connection after the backend update, you will ge tthe message <code>Error: updating database, try later</code>. The second try should succeed.

	= Add the App Suite UI =		= Add the OX App Suite UI =

	# yum install open-xchange-appsuite open-xchange-appsuite-backend open-xchange-appsuite-manifest		# yum install open-xchange-appsuite open-xchange-appsuite-backend open-xchange-appsuite-manifest
Line 241:		Line 241:
	= Remove the OX6 GUI =		= Remove the OX6 GUI =

	This step is optional. You may just skip it and offer both GUIs, the OX6 GUI and the App Suite UI. This will only be supported after the 6.22.2 release!		This step is optional. You may just skip it and offer both GUIs, the OX6 GUI and the OX App Suite UI. This will only be supported after the 6.22.2 release!

	If you want to uninstall the OX6 GUI, this step consists of removing the OX6 GUI packages and and adjusting Apache's configuration.		If you want to uninstall the OX6 GUI, this step consists of removing the OX6 GUI packages and and adjusting Apache's configuration.

	The packages to be removed can be identified by their version number in the output of <code>rpm -qa \| grep open-x</code>. It will probably boil down to uninstall everything which starts with <code>open-xchange-gui</code>, as the names of the App Suite UI packages start with <code>open-xchange-appsuite</code>.		The packages to be removed can be identified by their version number in the output of <code>rpm -qa \| grep open-x</code>. It will probably boil down to uninstall everything which starts with <code>open-xchange-gui</code>, as the names of the OX App Suite UI packages start with <code>open-xchange-appsuite</code>.

	# yum remove open-xchange-gui*		# yum remove open-xchange-gui*

	Then adjust the <code>/etc/httpd/conf.d/ox.conf</code> file to remove obsolete stuff which was required for the OX6 GUI, but is not required by the App Suite. To do so, you may consult the [[AppSuite:Open-Xchange_Installation_Guide_for_CentOS_6\|Installation Guide for OX ~~Appsuite~~]] to learn which sections of the file are required for an App Suite UI.		Then adjust the <code>/etc/httpd/conf.d/ox.conf</code> file to remove obsolete stuff which was required for the OX6 GUI, but is not required by the OX App Suite. To do so, you may consult the [[AppSuite:Open-Xchange_Installation_Guide_for_CentOS_6\|Installation Guide for OX App Suite]] to learn which sections of the file are required for an OX App Suite UI.

	The file <code>/etc/httpd/conf.d/proxy_ajp.conf</code> will not require adjustments; the settings for ~~Appsuite~~ are a superset of the settings of the OX6 GUI.		The file <code>/etc/httpd/conf.d/proxy_ajp.conf</code> will not require adjustments; the settings for OX App Suite are a superset of the settings of the OX6 GUI.

	= Leftover configuration files and runtime data =		= Leftover configuration files and runtime data =

	After the update you may see leftover configuration files and runtime data below <code>/opt/open-xchange/etc</code> It is safe to remove all files ending in .rpmsave or .rpmnew once you are confident that your configuration is working after the update.		After the update you may see leftover configuration files and runtime data below <code>/opt/open-xchange/etc</code> It is safe to remove all files ending in .rpmsave or .rpmnew once you are confident that your configuration is working after the update.