AppSuite:Upgrade from 6.22 for SLES11 - Revision history

Martin.schneider: /* US 68424070: Remove AJP because of discontinued support */

2014-11-17T13:51:06Z

US 68424070: Remove AJP because of discontinued support

← Older revision		Revision as of 13:51, 17 November 2014
Line 37:		Line 37:
	$ zypper dup -r ox-backend -r appsuite-frontend -r ox-usm -r ox-updates-backend -r appsuite-updates-frontend -r ox-updates-usm		$ zypper dup -r ox-backend -r appsuite-frontend -r ox-usm -r ox-updates-backend -r appsuite-updates-frontend -r ox-updates-usm

	~~=== Replace AJP with Grizzly ===~~

	You need to decide whether whether you want to replace AJP by Grizzly now, or later. AJP is deprecated with OX App Suite 7.4 / OX6 v6.22.4 released in September 2013 and will be discontinued with OX App Suite 7.6 in April 2014. For more information, see [[AppSuite:Grizzly]].

	{{AppSuiteUpgradeChangesByVersion}}		{{AppSuiteUpgradeChangesByVersion}}

Dominik.epple at 08:24, 30 September 2013

2013-09-30T08:24:31Z

Show changes

WolfgangRosenauer: /* Add the App Suite UI */

2013-02-15T12:36:19Z

Add the App Suite UI

← Older revision		Revision as of 12:36, 15 February 2013
Line 96:		Line 96:
	AllowOverride Indexes FileInfo		AllowOverride Indexes FileInfo
	</Directory>		</Directory>

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

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

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

	# deflate		# deflate
Line 112:		Line 108:
	AddType text/css .cssz		AddType text/css .cssz
	AddType text/xml .xmlz		AddType text/xml .xmlz
	AddType text/plain .po		AddType text/plain .po

	AddEncoding gzip .jsz .cssz .xmlz		AddEncoding gzip .jsz .cssz .xmlz

WolfgangRosenauer: /* Update Open-Xchange Repositories */

2013-02-15T12:34:55Z

Update Open-Xchange Repositories

← Older revision		Revision as of 12:34, 15 February 2013
Line 35:		Line 35:

	Optionally		Optionally
	$ zypper ar http://software.open-xchange.com/products/appsuite/stable/usm/SLES11/ ox-usm		$ zypper ar http://LDBACCOUNT:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/usm/SLES11/ ox-usm
	$ zypper ar http://software.open-xchange.com/products/appsuite/stable/updater/SLES11/ ox-windows		$ zypper ar http://LDBACCOUNT:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/updater/SLES11/ ox-windows
	$ zypper ar http://software.open-xchange.com/products/appsuite/stable/mobilityconnector/SLES11/ ox-eas		$ zypper ar http://LDBACCOUNT:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/mobilityconnector/SLES11/ ox-eas


	= Updating repositories and update packages =		= Updating repositories and update packages =

WolfgangRosenauer: /* Add the App Suite UI */

2013-02-15T12:32:25Z

Add the App Suite UI

← Older revision		Revision as of 12:32, 15 February 2013
Line 79:		Line 79:
	Full sample versions of those files below.		Full sample versions of those files below.

			# /etc/apache2/vhosts.d/ox.conf
	<VirtualHost *:80>		<VirtualHost *:80>
	ServerAdmin webmaster@localhost		ServerAdmin webmaster@localhost
Line 106:		Line 107:

	# deflate		# deflate
	AddOutputFilterByType DEFLATE text/html text/plain text/javascript application/javascript text/css text/xml application/xml text/x-js application/x-javascript		AddOutputFilterByType DEFLATE text/html text/plain text/javascript application/javascript text/css text/xml application/xml text/x-js application/x-javascript

	# pre-compressed files		# pre-compressed files

WolfgangRosenauer at 12:30, 15 February 2013

2013-02-15T12:30:56Z

@@ Line 74: / Line 74: @@
   # zypper 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>.
+Now adjust Apache's <code>ox.conf</code> as well as <code>proxy_ajp.conf</code>.
-Basically you need to merge the OX6 and App Suite versions of those files. For the Apache config file <code>/etc/apache2/vhosts.d/ox.conf</code>, replace the element <code><Directory /srv/www/htdocs> ... </Directory></code> with the following:
+Basically you need to merge the OX6 and App Suite versions of those files.
+Full sample versions of those files below.
   <VirtualHost *:80>

WolfgangRosenauer at 12:25, 15 February 2013

2013-02-15T12:25:43Z

← Older revision		Revision as of 12:25, 15 February 2013
Line 26:		Line 26:
	$ zypper rr ox-updates		$ zypper rr ox-updates
	</code>		</code>

			In case you are using optional components as Outlook and Business Mobility also remove the repositories for them.

	Finally, add the new Open-Xchange repositories for SLES11:		Finally, add the new Open-Xchange repositories for SLES11:
Line 31:		Line 33:
	$ zypper ar http://software.open-xchange.com/products/appsuite/stable/appsuiteui/SLES11/ appsuite-frontend		$ zypper ar http://software.open-xchange.com/products/appsuite/stable/appsuiteui/SLES11/ appsuite-frontend
	$ zypper ar http://software.open-xchange.com/products/appsuite/stable/backend/SLES11/ ox-backend		$ zypper ar http://software.open-xchange.com/products/appsuite/stable/backend/SLES11/ ox-backend

			Optionally
			$ zypper ar http://software.open-xchange.com/products/appsuite/stable/usm/SLES11/ ox-usm
			$ zypper ar http://software.open-xchange.com/products/appsuite/stable/updater/SLES11/ ox-windows
			$ zypper ar http://software.open-xchange.com/products/appsuite/stable/mobilityconnector/SLES11/ ox-eas


Line 40:		Line 47:
	Download and update all installed Open-Xchange packages:		Download and update all installed Open-Xchange packages:

	$ zypper dup -r ox-backend -r ~~appsuiteui~~		$ zypper dup -r ox-backend -r appsuite-frontend
			or (if in use)
			$ zypper dup -r ox-backend -r appsuite-frontend -r ox-usm -r ox-windows -r ox-eas

	One configuration setting is to be made manually:		One configuration setting is to be made manually:
Line 67:		Line 76:
	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>.

	Basically you need to merge the OX6 and App Suite versions of those files. For the Apache config file <code>/etc/apache2/~~conf~~.d/ox.conf</code>, replace the element <code><Directory /srv/www/htdocs> ... </Directory></code> with the following:		Basically you need to merge the OX6 and App Suite versions of those files. For the Apache config file <code>/etc/apache2/vhosts.d/ox.conf</code>, replace the element <code><Directory /srv/www/htdocs> ... </Directory></code> with the following:

	<Directory /srv/www/htdocs>		<Directory /srv/www/htdocs>

WolfgangRosenauer at 11:19, 15 February 2013

2013-02-15T11:19:51Z

← Older revision		Revision as of 11:19, 15 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 App Suite 7. See [[Open-Xchange_620_622_Update_Guide_for_SLES11\|Open-Xchange 6.20 to 6.22 Update Guide for SLES 11]] 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, you have toupdate to the latest release of v6.22 before attempting an update to OX App Suite 7. See [[Open-Xchange_620_622_Update_Guide_for_SLES11\|Open-Xchange 6.20 to 6.22 Update Guide for SLES 11]] for instructions regarding that update.

	= Requirements =		= Requirements =
Line 20:		Line 20:
	</code>		</code>

	Then, ~~disable~~ your configured Open-Xchange repositories. Assuming they are called <code>ox</code> and <code>ox-updates</code>, the commands would be:		Then, remove your configured Open-Xchange repositories. Assuming they are called <code>ox</code> and <code>ox-updates</code>, the commands would be:

	<code>		<code>
	$ zypper ~~mr -d~~ ox		$ zypper rr ox
	$ zypper ~~mr -d~~ ox-updates		$ zypper rr ox-updates
	</code>		</code>

	~~Instead of disabling the repositories, you can also remove them with <code>zypper rr</code>.~~

	Finally, add the new Open-Xchange repositories for SLES11:		Finally, add the new Open-Xchange repositories for SLES11:

WolfgangRosenauer: Created page with "= Update of Open-Xchange Server v6.22 to OX App Suite 7.0 on SLES 11. = This example describes updating an OX 6 Server installation to OX App Suite 7. = Supported update path..."

2013-02-13T09:23:49Z

Created page with "= Update of Open-Xchange Server v6.22 to OX App Suite 7.0 on SLES 11. = This example describes updating an OX 6 Server installation to OX App Suite 7. = Supported update path..."

New page

= Update of Open-Xchange Server v6.22 to OX App Suite 7.0 on SLES 11. =
This example describes updating an OX 6 Server installation to OX App Suite 7.

= 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 App Suite 7. See [[Open-Xchange_620_622_Update_Guide_for_SLES11|Open-Xchange 6.20 to 6.22 Update Guide for SLES 11]] for instructions regarding that update.

= 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_SLES11_622|Download and Installation Guide for SLES 11]]
* 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 App Suite 7.0.
* As for every update we strongly recommend that you make a backup of your system(s) before you proceed.

= Update Open-Xchange Repositories =
First, you need to add the current repositories to your zypper configuration to access the App Suite packages.

To do so, start with listing your existing repositories.

<code>
$ zypper lr
</code>

Then, disable your configured Open-Xchange repositories. Assuming they are called <code>ox</code> and <code>ox-updates</code>, the commands would be:

<code>
$ zypper mr -d ox
$ zypper mr -d ox-updates
</code>

Instead of disabling the repositories, you can also remove them with <code>zypper rr</code>.

Finally, add the new Open-Xchange repositories for SLES11:

$ zypper ar http://software.open-xchange.com/products/appsuite/stable/appsuiteui/SLES11/ appsuite-frontend
$ zypper ar http://software.open-xchange.com/products/appsuite/stable/backend/SLES11/ ox-backend

= Updating repositories and update packages =
Reload the package index:

$ zypper ref

Download and update all installed Open-Xchange packages:

$ zypper dup -r ox-backend -r appsuiteui

One configuration setting is to be made manually:

# vi /opt/open-xchange/etc/cluster.properties
com.openexchange.cluster.name=oxcluster

= Restart Open-Xchange =

To restart Open-Xchange Server after the update, run

$ rcopen-xchange restart

You might want to check with

$ ps aux | grep open-xchange

that there is exactly one newly spawned process running Open-Xchange Server.

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. The next version 6.22.2 is planned to be fully compatible with the 7.0.2 backend. Upon the first connection after the backend update, you will ge the message <code>Error: updating database, try later</code>. The second try should succeed.

= Add the App Suite UI =

# zypper 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>.

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

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

<Directory /srv/www/htdocs/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/apache2/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.

<VirtualHost *:80>
ServerAdmin webmaster@localhost

DocumentRoot /srv/www/htdocs

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

<Directory /srv/www/htdocs/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

# deflate
AddOutputFilterByType DEFLATE text/html text/plain text/javascript application/javascript text/css text/xml application/xml text/x-js application/x-javascript

# pre-compressed files
AddType text/javascript .jsz
AddType text/css .cssz
AddType text/xml .xmlz
AddType text/plain .po

AddEncoding gzip .jsz .cssz .xmlz
SetEnvIf Request_URI "\.(jsz|cssz|xmlz)$" no-gzip

ExpiresActive On

<Location /ox6>
# Expires (via ExpiresByType to override global settings)
ExpiresByType image/gif "access plus 6 months"
ExpiresByType image/png "access plus 6 months"
ExpiresByType image/jpg "access plus 6 months"
ExpiresByType image/jpeg "access plus 6 months"
ExpiresByType text/css "access plus 6 months"
ExpiresByType text/html "access plus 6 months"
ExpiresByType text/xml "access plus 6 months"
ExpiresByType text/javascript "access plus 6 months"
ExpiresByType text/x-js "access plus 6 months"
ExpiresByType application/x-javascript "access plus 6 months"
ExpiresDefault "access plus 6 months"
Header append Cache-Control "private"
Header unset Last-Modified
Header unset Vary
# Strip version
RewriteEngine On
RewriteRule v=\w+/(.+) $1 [L]
# Turn off ETag
Header unset ETag
FileETag None
</Location>

<Location /ox6/ox.html>
ExpiresByType text/html "now"
ExpiresDefault "now"
Header unset Last-Modified
Header set Cache-Control "no-store, no-cache, must-revalidate, post-check=0, pre-check=0"
# Turn off ETag
Header unset ETag
FileETag None
</Location>

<Location /ox6/index.html>
ExpiresByType text/html "now"
ExpiresDefault "now"
Header unset Last-Modified
Header set Cache-Control "no-store, no-cache, must-revalidate, post-check=0, pre-check=0"
# Turn off ETag
Header unset ETag
FileETag None
</Location>
</VirtualHost>

# /etc/apache2/conf.d/proxy_ajp.conf
# Please note that the servlet path to the soap API has changed:
<Location /webservices>
# restrict access to the soap provisioning API
Order Deny,Allow
Deny from all
Allow from 127.0.0.1
# you might add more ip addresses / networks here
# Allow from 192.168 10 172.16
</Location>
# the old path is kept for compatibility reasons

<Location /servlet/axis2/services>
# restrict access to the soap provisioning API
Order Deny,Allow
Deny from all
Allow from 127.0.0.1
# you might add more ip addresses / networks here
# Allow from 192.168 10 172.16
</Location>
LoadModule proxy_ajp_module modules/mod_proxy_ajp.so

<IfModule mod_proxy_ajp.c>
ProxyRequests Off
<Proxy balancer://oxcluster>
Order deny,allow
Allow from all
# multiple server setups need to have the hostname inserted instead localhost
BalancerMember ajp://localhost:8009 timeout=100 smax=0 ttl=60 retry=60 loadfactor=50 route=OX1
# Enable and maybe add additional hosts running OX here
# BalancerMember ajp://oxhost2:8009 timeout=100 smax=0 ttl=60 retry=60 loadfactor=50 route=OX2
ProxySet stickysession=JSESSIONID
</Proxy>

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

<Proxy /ajax>
ProxyPass balancer://oxcluster/ajax
</Proxy>
<Proxy /servlet>
ProxyPass balancer://oxcluster/servlet
</Proxy>
<Proxy /infostore>
ProxyPass balancer://oxcluster/infostore
</Proxy>
<Proxy /publications>
ProxyPass balancer://oxcluster/publications
</Proxy>
<Proxy /Microsoft-Server-ActiveSync>
ProxyPass balancer://oxcluster/Microsoft-Server-ActiveSync
</Proxy>
<Proxy /usm-json>
ProxyPass balancer://oxcluster/usm-json
</Proxy>
<Proxy /webservices>
ProxyPass balancer://oxcluster/webservices
</Proxy>
</IfModule>

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

= 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!

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>.

# zypper remove open-xchange-gui*

Then adjust the <code>/etc/apache2/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_SLES11|Installation Guide for OX App Suite]] 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 App Suite are a superset of the settings of the OX6 GUI.

= 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.