AppSuite:Parallel UISupport OX6 AppSuite SLES 11 - Revision history

Dominik.epple: /* Configure services */

2013-06-17T06:56:02Z

Configure services

← Older revision		Revision as of 06:56, 17 June 2013
Line 50:		Line 50:
	AllowOverride Indexes FileInfo		AllowOverride Indexes FileInfo
	</Directory>		</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		# deflate

Khgras at 07:15, 8 March 2013

2013-03-08T07:15:45Z

← Older revision		Revision as of 07:15, 8 March 2013
Line 1:		Line 1:
	~~TODO:~~

	* verify this logging adjustment for apache. in my sles box the syntax ${APACHE_LOG_DIR}/error.log works not. this stems from install guide in wiki

	= Add OX6 UI to an OX App Suite Installation =		= Add OX6 UI to an OX App Suite Installation =
	This document outlines the steps required to add an OX6 UI to an OX App Suite installation.		This document outlines the steps required to add an OX6 UI to an OX App Suite installation.

Dominik.epple: /* Configure services */

2013-03-07T20:54:40Z

Configure services

← Older revision		Revision as of 20:54, 7 March 2013
Line 33:		Line 33:
	= Configure services =		= Configure services =

	Since we are only adding a frontend, there is nothing to change in the configuration of the backend servers, the database, mail, or such. It is only required to adjust the apache web server configuration in the file <code>/etc/~~httpd~~/~~conf~~.d/ox.conf</code>.		Since we are only adding a frontend, there is nothing to change in the configuration of the backend servers, the database, mail, or such. It is only required to adjust the apache web server configuration in the file <code>vi /etc/apache2/vhosts.d/ox.conf</code>.

	Basically we need to merge the [[AppSuite:Open-~~Xchange_Installation_Guide_for_RHEL6~~#Configure_services\|OX App Suite]] and [[Open-~~Xchange_Installation_Guide_for_RHEL6_622~~#Configure_services\|OX6]] versions of this file. A sample is given in the following.		Basically we need to merge the [[AppSuite:Open-Xchange_Installation_Guide_for_SLES11#Configure_services\|OX App Suite]] and [[Open-Xchange_Installation_Guide_for_SLES11_622#Configure_services\|OX6]] versions of this file. A sample is given in the following.

	# /etc/~~httpd~~/~~conf~~.d/ox.conf		# /etc/apache2/vhosts.d/ox.conf
	<VirtualHost *:80>		<VirtualHost *:80>
	ServerAdmin webmaster@localhost		ServerAdmin webmaster@localhost

	DocumentRoot /~~var~~/www/~~html~~		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>

	~~<Directory /var/www/html>~~		ErrorLog ${APACHE_LOG_DIR}/error.log
	~~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,		# Possible values include: debug, info, notice, warn, error, crit,
	# alert, emerg.		# alert, emerg.
	LogLevel warn		LogLevel warn

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

	# 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
Line 121:		Line 120:
	FileETag None		FileETag None
	</Location>		</Location>

	</VirtualHost>		</VirtualHost>

	Restart the web server:		Restart the web server:

	$ ~~/etc/init.d/httpd~~ restart		$ service apache2 restart

	That's it. It should now be able to access the OX6 frontend using the location <code>/ox6/</code> in the request.		That's it. It should now be able to access the OX6 frontend using the location <code>/ox6/</code> in the request.

Dominik.epple: /* Updating repositories and install packages */

2013-03-07T20:52:02Z

Updating repositories and install packages

← Older revision		Revision as of 20:52, 7 March 2013
Line 27:		Line 27:
	Install the OX6 frontend packages.		Install the OX6 frontend packages.

	$ ~~yum~~ install open-xchange-gui		$ zypper install open-xchange-gui

	This will install the OX6 fronted packages. (OX App Suite frontend package names start with <code>open-xchange-appsuite</code>.)		This will install the OX6 fronted packages. (OX App Suite frontend package names start with <code>open-xchange-appsuite</code>.)

Dominik.epple: /* Add Open-Xchange Repository */

2013-03-07T20:51:44Z

Add Open-Xchange Repository

← Older revision		Revision as of 20:51, 7 March 2013
Line 19:		Line 19:
	$ zypper ar http://software.open-xchange.com/OX6/6.22/frontend/SLES11/ ox-frontend		$ zypper ar http://software.open-xchange.com/OX6/6.22/frontend/SLES11/ ox-frontend

	~~In case~~ you have a subscription, ~~you can~~ also add the update repo:		If you have a valid maintenance subscription, also add the update repo:

	$ zypper ar http://LDBACCOUNT:LDBPASSWORD@software.open-xchange.com/OX6/6.22/updates/frontend/SLES11/ ox-updates-frontend		$ zypper ar http://LDBACCOUNT:LDBPASSWORD@software.open-xchange.com/OX6/6.22/updates/frontend/SLES11/ ox-updates-frontend

Dominik.epple: /* Add Open-Xchange Repository */

2013-03-07T20:50:50Z

Add Open-Xchange Repository

← Older revision		Revision as of 20:50, 7 March 2013
Line 15:		Line 15:

	= Add Open-Xchange Repository =		= Add Open-Xchange Repository =
	We start by adding some OX6 frontend repos to our ~~yum~~ repos.		We start by adding some OX6 frontend repos to our zypper repos.

	~~# /etc/yum.repos.d/ox.repo~~		$ zypper ar http://software.open-xchange.com/OX6/6.22/frontend/SLES11/ ox-frontend
	~~[ox-frontend]~~
	~~name=Open-Xchange-frontend~~		In case you have a subscription, you can also add the update repo:
	~~baseurl=~~http://software.open-xchange.com/OX6/6.22/frontend/~~RHEL6~~/
	~~gpgkey=~~http://software.open-xchange.com/~~oxbuildkey~~.~~pub~~		$ zypper ar http://LDBACCOUNT:LDBPASSWORD@software.open-xchange.com/OX6/6.22/updates/frontend/SLES11/ ox-updates-frontend
	~~enabled=1~~
	~~gpgcheck=1~~
	~~metadata_expire=0m~~

	= Updating repositories and install packages =		= Updating repositories and install packages =

Dominik.epple: /* Requirements */

2013-03-07T20:49:46Z

Requirements

← Older revision		Revision as of 20:49, 7 March 2013
Line 10:		Line 10:

	= Requirements =		= Requirements =
	* An OX App Suite installation v7.0.2 or later. This update guide is valid for a system installed through our [[AppSuite:Open-~~Xchange_Installation_Guide_for_RHEL6~~\|~~OX App Suite~~ Download and Installation Guide for ~~RedHat~~ Enterprise ~~Linux 6~~]]~~. It applies also to installations on 100% compatible RHEL clones such as CentOS~~.		* An OX App Suite installation v7.0.2 or later. This update guide is valid for a system installed through our [[AppSuite:Open-Xchange_Installation_Guide_for_SLES11\|Download and Installation Guide for SUSE Linux Enterprise Server 11]].
	* If you have custom plugins written by yourself which depends on an specific Open-Xchange Server, Open-Xchange can't guarantee that the plugins will work with the parallel setup.		* If you have custom plugins written by yourself which depends on an specific Open-Xchange Server, Open-Xchange can't guarantee that the plugins will work with the parallel setup.
	* As for every modification of the installation we strongly recommend that you make a backup of your system(s) before you proceed.		* As for every modification of the installation we strongly recommend that you make a backup of your system(s) before you proceed.

Dominik.epple: Start by copying the RHEL guide. SLES adjustments to follow.

2013-03-07T20:48:16Z

Start by copying the RHEL guide. SLES adjustments to follow.

New page

TODO:

* verify this logging adjustment for apache. in my sles box the syntax ${APACHE_LOG_DIR}/error.log works not. this stems from install guide in wiki

= Add OX6 UI to an OX App Suite Installation =
This document outlines the steps required to add an OX6 UI to an OX App Suite installation.

= Supported OX Versions =
Running parallel UIs (OX6 and OX App Suite) is supported beginning with OX6 version 6.22.2 (backend version 7.0.2) and OX App Suite version 7.0.1.

= Requirements =
* An OX App Suite installation v7.0.2 or later. This update guide is valid for a system installed through our [[AppSuite:Open-Xchange_Installation_Guide_for_RHEL6|OX App Suite Download and Installation Guide for RedHat Enterprise Linux 6]]. It applies also to installations on 100% compatible RHEL clones such as CentOS.
* If you have custom plugins written by yourself which depends on an specific Open-Xchange Server, Open-Xchange can't guarantee that the plugins will work with the parallel setup.
* As for every modification of the installation we strongly recommend that you make a backup of your system(s) before you proceed.

= Add Open-Xchange Repository =
We start by adding some OX6 frontend repos to our yum repos.

# /etc/yum.repos.d/ox.repo
[ox-frontend]
name=Open-Xchange-frontend
baseurl=http://software.open-xchange.com/OX6/6.22/frontend/RHEL6/
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m

= Updating repositories and install packages =

Install the OX6 frontend packages.

$ yum install open-xchange-gui

This will install the OX6 fronted packages. (OX App Suite frontend package names start with <code>open-xchange-appsuite</code>.)

= Configure services =

Since we are only adding a frontend, there is nothing to change in the configuration of the backend servers, the database, mail, or such. It is only required to adjust the apache web server configuration in the file <code>/etc/httpd/conf.d/ox.conf</code>.

Basically we need to merge the [[AppSuite:Open-Xchange_Installation_Guide_for_RHEL6#Configure_services|OX App Suite]] and [[Open-Xchange_Installation_Guide_for_RHEL6_622#Configure_services|OX6]] versions of this file. A sample is given in the following.

# /etc/httpd/conf.d/ox.conf
<VirtualHost *:80>
ServerAdmin webmaster@localhost

DocumentRoot /var/www/html

<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

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

Restart the web server:

$ /etc/init.d/httpd restart

That's it. It should now be able to access the OX6 frontend using the location <code>/ox6/</code> in the request.