Open-Xchange cPanel Installation

From Open-Xchange
Revision as of 15:48, 30 June 2011 by Choeger (talk | contribs)

Install Open-Xchange on WHM/cPanel

BETA

Install and prepare Open-Xchange

  • Follow one of the Open-Xchange installation guides to install Open-Xchange.
  • Take care to install the package open-xchange-authentication-imap as Open-Xchange must authenticate against the cPanel IMAP server
  • Take care to install the packages open-xchange-gui-wizard-plugin open-xchange-gui-wizard-plugin-gui. The wizard must be used to enforce the user to provide a real valid displayname.
  • Install the package open-xchange-admin-plugin-reseller-soap from the repository http://software.open-xchange.com/OX6/unsupported/6.20/cpanel (see below)
  • edit file /opt/open-xchange/etc/groupware/imapauth.properties and set
USE_MULTIPLE=true
  • edit file /opt/open-xchange/etc/groupware/settings/open-xchange-gui-wizard-plugin.properties and set
ui/wizard/firstrunmode=true

Install on OX AppSuite

Debian GNU/Linux 11.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/unsupported/6.20/cpanel/DebianBullseye/ /
# 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 https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/unsupported/6.20/cpanel/updates/DebianBullseye/ /

and run

$ apt-get update
$ apt-get install open-xchange-admin-plugin-reseller-soap

Debian GNU/Linux 12.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/unsupported/6.20/cpanel/DebianBookworm/ /
# 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 https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/unsupported/6.20/cpanel/updates/DebianBookworm/ /

and run

$ apt-get update
$ apt-get install open-xchange-admin-plugin-reseller-soap


Install and prepare WHM/cPanel on CentOS5

Note: Choose either CentOS5 or RHEL5. Nothing else is supported to integrate Open-Xchange with cPanel.

$ vi /etc/yum.repos.d/oxintegration.repo
[oxcpintegration]
name=Open-Xchange cPanel
baseurl=http://software.open-xchange.com/OX6/unsupported/6.20/cpanel/RHEL5
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m
  • install the package open-xchange-cpanel
$ yum install open-xchange-cpanel
  • run the installer (-h for help):
$ /usr/local/cpanel/bin/oxcpanelinstall --oxurl http://ox.example.com --oxadmin-password oxadminmasterpassword

Now your Open-Xchange server is integrated with your cPanel installation.

To check the connection, run

$ /usr/local/cpanel/bin/oxcpanelenable -c

This program can also be used to enable all existing cPanel users in OX. Run

$ /usr/local/cpanel/bin/oxcpanelenable -h

for more information.