Difference between revisions of "AppSuite:Open-Xchange Installation Guide for Debian 8.0"

(Requirements)
 
Line 3: Line 3:
 
= OX App Suite on Debian GNU/Linux 8.0 =
 
= OX App Suite on Debian GNU/Linux 8.0 =
  
{{QuickInstIntro|release=appsuite}}
+
Up until now Open-Xchange has provided support for installations of OX App Suite 7.10.x on Debian Jessie. OX App Suite v7.10.x requires OpenJDK 8; OpenJDK 8 is a backport on Debian Jessie and Debian Jessie is currently in LTS (Long Term Support).
  
= Requirements =
+
Recently we have found out that the support for this backport in Debian Jessie has now been discontinued. This means that Debian Jessie no longer supports the required OpenJDK 8.
  
* Plain installed Debian GNU/Linux 8.0, no graphical tools required
+
Due to the above situation we regrettably have to inform you that support of OX App Suite v7.10.x and any future version on Debian Jessie must be discontinued from the 2019-03-31.
* A supported Java Virtual Machine ([[AppSuite:OX_System_Requirements#Java|learn more]])
 
* A working internet connection
 
* vim is not installed by default on Debian. If you want to copy & paste the commands from this article into a shell window, you need to <code>apt-get install vim</code> first.
 
  
= Debian Jessie backports repository for OpenJDK 8 (only for AppSuite 7.10.0) =
+
Open-Xchange encourages administrators to regularly update to the latest available platform releases. To ensure a stable and up to date environment please note the different versions supported. An overview of the latest supported platform release can be found in the OXpedia at: http://oxpedia.org/wiki/index.php?title=AppSuite:OX_System_Requirements#Linux_Distributions
 
 
OX App Suite v7.10.0 requires OpenJDK 8 while for previous OX App Suite versions Java version 7 was required. Unfortunately Debian Jessie does not contain Java version 8. Therefore we need to install it from the Debian Jessie backports repositories to be able to run OX App Suite v7.10.0 on Debian Jessie.
 
 
 
Add the repository for Debian Jessie backports.
 
 
 
$ cat <<EOF > /etc/apt/sources.list.d/backports.list
 
deb http://<your debian mirror>/debian jessie-backports main
 
EOF
 
 
 
Furthermore you need to allow the Debian package manager to install the OpenJDK 8 related packages from the Debian Jessie backports repository. Normally these packages have less priority and are not chosen as installation candidates. Raise the priority as shown below:
 
 
 
$ cat <<EOF > /etc/apt/preferences.d/ca-certificates-java.pref
 
Package: ca-certificates-java
 
Pin: release a=jessie-backports
 
Pin-Priority: 501
 
EOF
 
 
 
Now the package manager is able to choose OpenJDK 8 from the Debian Jessie backports.
 
 
 
= Database installation =
 
 
 
Please consult our [[OXLoadBalancingClustering_Database#Standalone_database_setup|database installation instructions]] for information on how to install a database on the local system.
 
 
 
Before proceeding, make sure the local machine has got a working MySQL service in one of the supported versions / flavors with the configuration / tunings applied as mentioned on our [[My.cnf|corresponding page]].
 
 
 
{{AddReposDebian|debname=jessie|debnameox=DebianJessie|release=appsuite}}
 
 
 
= Updating repositories and install packages =
 
 
 
It is highly recommended to import the Open-Xchange build key to your package systems trusted keyring in order to make sure only Open-Xchange packages with valid signing are installed on the system. Otherwise you'll encounter warnings about untrusted package sources. To import the Open-Xchange buildkey, please refer to this quick guide: [[Importing_OX_Buildkey#Importing_key_into_apt_based_systems|Importing OX Buildkey]].
 
 
 
Reload the package index. This will download the package descriptions available at the software repositories and will enable the Open-Xchange repository as a valid source for signed packages:
 
 
 
$ apt-get update
 
 
 
The following command starts the download and installation process of all required package for Open-Xchange deployment:
 
 
 
{{OXPackageInstallation|installer=apt-get|javavendor=sun|release=appsuite}}
 
 
 
{{OXConfiguration}}
 
 
 
{{oxinstaller|connector=http}}
 
 
 
After initializing the configuration, restart the Open-Xchange Administration service by executing:
 
 
 
$ systemctl restart open-xchange
 
 
 
{{OXRegister|globaldb=true}}
 
 
 
= Configure services =
 
 
 
{{ApacheOXModsDebian|connector=http|extramods=lbmethod_byrequests}}
 
 
 
{{Template:ApacheAppSuiteConf|connector=http|connectorConf=/etc/apache2/conf-available/proxy_http.conf|apacheconf=/etc/apache2/sites-enabled/000-default.conf|docroot=/var/www/html|loadmodule=|syncProxyName=eas_oxcluster}}
 
 
 
Enable the proxy configuration
 
 
 
$ a2enconf proxy_http.conf
 
 
 
After the configuration is done, restart the Apache webserver
 
 
 
$ systemctl restart apache2
 
 
 
== Upgrade from Debian 7 ==
 
 
 
If you updated from Debian 7 to Debian 8 the proxy_http.conf file is still located in the <tt>conf.d</tt> directory which is not read in Debian 8. So you have to move the file to <tt>conf-available</tt> and execute <tt>a2enconf proxy_http</tt> afterwards.
 
 
 
== Apache Setting for more concurrent Connections ==
 
 
 
By default apache2 is configured to support 150 concurrent connections. This forces all parallel requests beyond that limit to wait. Especially if, for example, active sync clients maintain a permanent connection for push events to arrive. The following article explains how that can be done
 
 
 
[[Tune_apache2_for_more_concurrent_connections|Apache Setting for more concurrent Connections]]
 
 
 
{{ContextUserAndLogs}}
 
 
 
[[Category: AppSuite]]
 

Latest revision as of 09:57, 26 March 2019

This information is valid from 7.8.4, 7.10.x

OX App Suite on Debian GNU/Linux 8.0

Up until now Open-Xchange has provided support for installations of OX App Suite 7.10.x on Debian Jessie. OX App Suite v7.10.x requires OpenJDK 8; OpenJDK 8 is a backport on Debian Jessie and Debian Jessie is currently in LTS (Long Term Support).

Recently we have found out that the support for this backport in Debian Jessie has now been discontinued. This means that Debian Jessie no longer supports the required OpenJDK 8.

Due to the above situation we regrettably have to inform you that support of OX App Suite v7.10.x and any future version on Debian Jessie must be discontinued from the 2019-03-31.

Open-Xchange encourages administrators to regularly update to the latest available platform releases. To ensure a stable and up to date environment please note the different versions supported. An overview of the latest supported platform release can be found in the OXpedia at: http://oxpedia.org/wiki/index.php?title=AppSuite:OX_System_Requirements#Linux_Distributions