View source for AppSuite:Open-Xchange Installation Guide for CentOS 7

{{Version|7.8.4, 7.10.x}}

= Open-Xchange App Suite on CentOS7 Linux =

{{QuickInstIntro|release=appsuite}}

= Requirements =

* Plain installed CentOS7 with latest updates
* A configured internet connection
* <code>httpd</code> - Apache web server
* A supported Java Virtual Machine ([http://oxpedia.org/wiki/index.php?title=AppSuite:OX_System_Requirements#Server_Platforms learn more])
* <code>vim</code> is not installed by default on CentOS7. If you want to copy & paste the commands from this article into a shell window, you need to <code>yum install vim</code> first.

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

{{AddReposRHEL|rhelname=RHEL7|release=appsuite}}

= Updating repositories and installing 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]].

The following command starts the download and installation process of all required package for Open-Xchange deployment:

{{OXPackageInstallation|installer=yum|release=appsuite}}

{{OXConfiguration}}

{{oxinstaller|connector=http}}

After initializing the configuration, start the Open-Xchange service by executing:

 $ systemctl start open-xchange

{{OXRegister|globaldb=true}}

= Configure services =

{{ApacheOXModsIntro|connector=http}}

The default installation of the Apache webserver on CentOS provides a welcome screen which is not necessary for server operation, it can be removed by deleting the corresponding configuration file:

 $ rm /etc/httpd/conf.d/welcome.conf

{{Template:ApacheAppSuiteConf|connector=http|connectorConf=/etc/httpd/conf.d/proxy_http.conf|apacheconf=/etc/httpd/conf.d/ox.conf|docroot=/var/www/html|loadmodule=LoadModule proxy_http_module modules/mod_proxy_http.so|syncProxyName=eas_oxcluster}}

After the configuration is done, restart the Apache webserver

 $ systemctl start httpd

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

= Adding services to runlevels =

The new services are now installed and configured, but to make them start up on a server boot, they need to be added to some runlevels:

 $ systemctl enable mariadb
 $ systemctl enable httpd
 $ systemctl enable open-xchange

{{ContextUserAndLogs}}


[[Category: AppSuite]]