English
Français
Tiếng Việt## 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](https://fedoraproject.org/wiki/EPEL)) repository. To install and enable this repository, run the following command:
yum install epel-release
### Database Management System
OBM only supports [PostgreSQL](http://www.postgresql.org/) 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)
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](https://wiki.centos.org/HowTos/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](/wiki/known-issues) with obm installation and features.
Now that your installation is done, take a quick look at our [Getting Started](/wiki/getting-started) page!