View source for OX6:Open-Xchange Installation Guide for RHEL6 622

= Open-Xchange Server 6 (v6.22) on RedHat Enterprise Linux 6 =

{{QuickInstIntro|release=6}}


'''Important: This installation guide will only work for v6.22. If you want to install v6.20 please use the [http://oxpedia.org/wiki/index.php?title=Open-Xchange_Installation_Guide_for_RHEL6 installation guide for earlier versions].'''

= Requirements =

* Plain installed RedHat Enterprise Linux 6 with latest updates
* Valid access to the RedHat Network
* A configured internet connection


= Enabling required RedHat Repositories =

When setting up RedHat Enterprise Linux (RHEL), only the base software channel is subscribed, this alone does not provide all required software packages. Before you start, please login to the RedHat Network (https://rhn.redhat.com) using your RedHat Account and enable the channel '''RHEL Supplementary (v. 6 for ...)''' by selecting the registered RHEL deployment and using the "Alter Subscriptions" button. After saving this configuration, the RHEL installation is capable to fetch all required software packages for Open-Xchange to work properly.


{{AddReposRHEL|rhelname=RHEL6|release=6.22}}


= Updating repositories and installing packages =

Reload the package index. This will download the package descriptions available at the software repositories:

 $ yum update

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

{{OXPackageInstallation|installer=yum|mysql=mysql-server|javavendor=sun|addonpkgs=java-sun|release=6.22}}

'''Note:''' instead of java-sun, you can also use java-openjdk.


{{OXConfiguration|mysqlstart=/etc/init.d/mysqld start}}

{{oxinstaller|connector=http}}

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

 $ /etc/init.d/open-xchange start

{{OXRegister}}


= Configure services =

Now as the Open-Xchange Server has been set up and the database is running, we have to configure the Apache webserver and the mod_proxy_ajp module to access the groupware frontend. To gain better GUI performance, the usage of ''mod_expires'' and ''mod_deflate'' is strongly recommended. Those modules will limit the amount of client requests and compress the delivered content. The default installation of the Apache webserver on RHEL 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:ApacheOXConf|connector=http|connectorConf=/etc/httpd/conf.d/proxy_http.conf|apacheconf= /etc/httpd/conf.d/ox.conf|docroot=/var/www/html/|release=6.22|loadmodule=LoadModule proxy_http_module modules/mod_proxy_http.so|easProxyName=eas_oxcluster}}

After the configuration is done, restart the Apache webserver

 $ /etc/init.d/httpd restart

Finally restart the Open-Xchange service

 $ /etc/init.d/open-xchange restart


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

 $ chkconfig --level 345 mysqld on
 $ chkconfig --level 345 httpd on
 $ chkconfig --level 345 open-xchange on


{{ContextUserAndLogs}}

= Installing Open-Xchange Update packages =

Please read [[UpdatingOXPackages]] on how to get access to the latest Open-Xchange packages.

[[Category: OX6]]