View source for AppSuite:Open-Xchange Installation Guide for Debian 7.0

{{Version_unsupported|7.8.2}}

= OX App Suite on Debian GNU/Linux 7.0 =

{{QuickInstIntro|release=appsuite}}

= Requirements =

* Plain installed Debian GNU/Linux 7.0, no graphical tools required
* A supported Java Virtual Machine ([http://oxpedia.org/wiki/index.php?title=AppSuite:OX_System_Requirements#Server_Platforms learn more])
* A working internet connection
* vim is not installed by default on Debian Wheezy. 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.

= Add Open-Xchange Repository =

Open-Xchange maintains public available software repositories for different platforms, such as Debian. This repository should be added to the Debian installation to enable simple installation and updates.

Start a console and modify the Debian repository information file. Also add the Open-Xchange software repository:

 $ cat << EOF >> /etc/apt/sources.list.d/open-xchange.list
 
 deb http://software.open-xchange.com/products/appsuite/7.8.2/appsuiteui/DebianWheezy/ /
 deb http://software.open-xchange.com/products/appsuite/7.8.2/backend/DebianWheezy/ /
 
 # if you have a valid maintenance subscription, please uncomment the 
 # following and add the ldb account data to the url so that the most recent
 # packages get installed
 # deb http://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/7.8.2/appsuiteui/updates/DebianWheezy /
 # deb http://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/7.8.2/backend/updates/DebianWheezy /
 EOF

= 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|mysql=mysql-server|javavendor=sun|release=appsuite}}

You will be asked multiple times to enter a MySQL password, please do '''not''' enter a password at this point. You should enter a strong MySQL admin password for the user "mysql" after the installation has been finished. See: [http://dev.mysql.com/doc/refman/5.0/en/passwords.html MySQL Reference Manual]

'''Important:''' Some of the scripts assume you have mysql root access from the command line, therefore the advice of "not" to enter a password. If you do, you may find problems following the instructions provided in this howto.

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

{{oxinstaller|connector=http}}

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

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

{{OXRegister}}

= Configure services =

{{ApacheOXModsDebian|connector=http}}

{{Template:ApacheAppSuiteConf|connector=http|connectorConf=/etc/apache2/conf.d/proxy_http.conf|apacheconf=/etc/apache2/sites-enabled/000-default|docroot=/var/www|loadmodule=|syncProxyName=eas_oxcluster}}

After the configuration is done, restart the Apache webserver

 $ /etc/init.d/apache2 restart

{{ContextUserAndLogs}}

=Known issues=

If you can't login with the created user:

 vim /opt/open-xchange/etc/sessiond.properties

and set com.openexchange.sessiond.autologin to true.

[[Category: OX7]]
[[Category: AppSuite]]