Install OBM 3.2 on CentOS 7

System requirements

Hostname configuration

You need to configure the hostname (FQDN) you intend to use for the OBM virtual host on the machine. There's several ways to do this, but the easiest one is probably the hostnamectl command:

hostnamectl set-hostname obm.my.domain

To verify that your changes are correct, you can simply run

hostnamectl

Third-party software

EPEL

OBM uses some packages from the Extra Packages for Enterprise Linux (EPEL) repository. To install and enable this repository, run the following command:

yum install epel-release

Database Management System

OBM only supports PostgreSQL as its DBMS. To install it, simply run the following commands, in order:

yum install postgresql-server
postgresql-setup initdb (to initialize a new postgresql cluster)
service postgresql start

Verify that the service is running, then edit PostgreSQL configuration file at /var/lib/pgsql/data/postgresql.conf in order to set

standard_conforming_strings = off

OBM

Repository configuration

This command will fetch the rpm "release" package, which will create and maintain the yum repository file for you:

rpm -ivh http://rpm.obm.org/release/obm-release.noarch.rpm

This configuration enables the obm-stable repository by default.

Installation

To install OBM, simply run the following command:

yum install obm-PostgreSQL obm-full

During installation, the system might ask you to import the public key from the EPEL repository. This is expected as packages from this repository are signed.
Simply answer yes if you get such a prompt:

Récupération de la clé à partir de file:///etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
Importation de la clef GPG 0x352C64E5 :
ID utilisateur : « Fedora EPEL (7) <epel@fedoraproject.org> »
Empreinte      : 91e9 7d7c 4a5e 96f1 7f3e 888f 6a2f aea2 352c 64e5
Paquet         : epel-release-7-5.noarch (@extras)
Provient de    : /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
Est-ce correct [o/N] :

and installation should proceed.

System configuration

Disable ipv6

echo "net.ipv6.conf.all.disable_ipv6 = 1" >> /etc/sysctl.conf

Disable SELinux:

setenforce 0
sed -i s/SELINUX=.*/SELINUX\=disabled/g /etc/selinux/config
setsebool -P httpd_can_network_connect 1

Disable iptables (the software firewall on the machine):

service iptables stop
service iptables6 stop
systemctl disable iptables
systemctl disable iptables6

Then you can proceed to the next section.

OBM configuration

Activate services on boot

systemctl enable postgresql
systemctl enable cyrus-imapd
systemctl enable postfix
systemctl enable obm-tomcat
systemctl enable obm-satellite
systemctl enable saslauthd
systemctl enable slapd
systemctl enable obm-locator
systemctl enable obm-provisioning
systemctl enable obm-imap-archive

Run the OBM configuration scripts

obm-admin

And answer the following questions:

  • "External URL of OBM": your host FQDN (as in /etc/sysconfig/network)
  • "LDAP Server Name": 127.0.0.1
  • "Enable module LDAP": y
  • "Enable module MAIL": y

OBM DB configuration

  • "Please enter the DataBase hostname": 127.0.0.1
  • "Enter the Database name": obm
  • "Enter the DataBase user": obm
  • "Enter the DataBase user password": obm

OBM System Users configuration

  • "LDAP password": default (mdp3PaAL)
  • "Enter admin cyrus password": default (cyrus)
  • "Do you want add syncrepl user?": default (no)

OBM UI configuration

  • "Choose the type of authentication": default (database)
  • "The /etc/httpd/conf.d/obm.conf file already exists. Do you want to replace it?": y
  • "What is the IP adress of the obm-provisioning server": 127.0.0.1
  • "What is the IP adress of the OBM-TOMCAT server": 127.0.0.1
  • "What is the IP adress of the OPUSH server": 127.0.0.1

OBM LDAP configuration

  • "The slapd.conf file already exists. Do you want to replace it?": y
  • "Do you want to activate syncrepl for this LDAP?": n
  • "Do you want to activate SSL/TLS in LDAP ? ": n

OBM Cyrus configuration

  • "Do you want replace configuration ? ": y

OBM Postfix configuration

  • "File /etc/postfix/main.cf already exist. Do you want replace this file ? ": y
  • "Please enter your relay host if you have it ": default (none)
  • "Please enter your 'mynetwork' (default empty) ": default (none)

Then reboot the server. After reboot, OBM will start normally.

You can then access the OBM web interface at https://obm.my.domain/.

 What's next?

You may read the list of known issues with obm installation and features.

Now that your installation is done, take a quick look at our Getting Started page!