LupusNobilis/sogo
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Initial pass of the doc for v2.2.10 on Debian/Ubuntu

Browse source
This commit is contained in:
Ludovic Marcotte 2014-11-18 16:56:45 -05:00
parent ac55509aea
commit 6bbaf58d43
1 changed files with 111 additions and 54 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

165
Documentation/SOGoNativeOutlookConfigurationGuide.asciidoc
View file

@ -233,13 +233,12 @@ Installation
This section will guide you through the installation of the native This section will guide you through the installation of the native
Microsoft Outlook compatibility layer SOGo offers. Microsoft Outlook compatibility layer SOGo offers.
Red Hat Enterprise Linux v5 and v6 Red Hat Enterprise Linux v6 x86_64
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you are using Red Hat Enterprise Linux (or CentOS) version 5 or If you are using Red Hat Enterprise Linux version 6 x86_64, packages
version 6, packages for Samba 4, OpenChange and SOGo and the SOGo for Samba 4, OpenChange and SOGo and the SOGo OpenChange backend are
OpenChange backend are available from SOGo's web site. Please follow the available from SOGo's web site. Please follow the instructions from
instructions from
http://www.sogo.nu/english/downloads/backend_nightly.html. http://www.sogo.nu/english/downloads/backend_nightly.html.
In order to satisfy certain dependencies, you should also add the EPEL In order to satisfy certain dependencies, you should also add the EPEL
@ -263,43 +262,32 @@ yum install samba4 \
Once the packages are installed, refer to the _Configuration_ chapter Once the packages are installed, refer to the _Configuration_ chapter
from this guide. from this guide.
Debian 6.0 (Squeeze) and Ubuntu 12.04 (Precise Pangolin) Debian 7.0 (Wheezy) and Ubuntu 12.04 (Precise Pangolin)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Samba 4, OpenChange, SOGo and the SOGo OpenChange backend are now SOGo, OpenChange and the SOGo OpenChange backend are now
available from SOGo's web site. Please follow the instructions from available from SOGo's web site. Please follow the instructions from
http://www.sogo.nu/english/downloads/backend_nightly.html to setup your http://www.sogo.nu/english/downloads/backend.html to setup your
apt sources. apt sources.
Debian Squeeze ships an older version of some libraries required by For Samba 4, you need to use the _wheezy-backports_ repository. To do so, create
Samba 4. In order to workaround this, users of this distribution will
have to use the _squeeze-backports_ repository. To do so, create
`/etc/apt/sources.list.d/backports.list`: `/etc/apt/sources.list.d/backports.list`:
deb http://backports.debian.org/debian-backports squeeze-backports main deb http://http.debian.net/debian wheezy-backports main
Then install the dependencies on Debian Squeeze, do: On Ubuntu 12.04, you will also have to add the Wheezy sources:
---- deb http://ftp.us.debian.org/debian wheezy main
apt-get update deb http://security.debian.org/ wheezy/updates main
apt-get install -t squeeze-backports libwbclient-dev samba-common smbclient libsmbclient libsmbclient-dev
----
Once ready, install the `samba4` package on top of an existing SOGo Then install Samba 4 on top of an existing SOGo
installation: installation:
---- ----
apt-get update apt-get update
apt-get install samba4 apt-get -t wheezy-backports install samba samba-dev
---- ----
The current post installation script shipped with the Samba 4 package is
far from perfect and might fail even on a fresh install. The following
command is needed to let dpkg know that everything is fine about Samba 4
if the post install script fails.
sed --in-place 'N; s/Package: samba4\nStatus: install ok half-configured/Package: samba4\nStatus: install ok installed/;' /var/lib/dpkg/status
Once completed, install the packages related to OpenChange and the SOGo Once completed, install the packages related to OpenChange and the SOGo
provider: provider:
@ -307,13 +295,53 @@ provider:
apt-get install openchangeserver \ apt-get install openchangeserver \
sogo-openchange \ sogo-openchange \
openchangeproxy \ openchangeproxy \
openchange-ocsmanager \ python-ocsmanager \
openchange-rpcproxy mysql-server \
python-mysqldb
---- ----
Once the packages are installed, refer to the _Configuration_ chapter Once the packages are installed, refer to the _Configuration_ chapter
from this guide. from this guide.
[NOTE]
On Ubuntu 12.04, the Samba init scripts need to be modified to
disable the upstart check. More more details, refer to:
https://wiki.samba.org/index.php/Samba4/InitScript
Ubuntu 14.04 (Trusty Tahr)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
For Ubuntu 14.04, you must not use the Debian Wheezy backports.
Please follow the instructions from
http://www.sogo.nu/english/downloads/backend.html to setup your
apt sources.
Then install Samba 4 on top of an existing SOGo
installation:
----
apt-get update
apt-get install samba samba-dev
----
Once completed, install the packages related to OpenChange and the SOGo
provider:
----
apt-get install openchangeserver \
sogo-openchange \
openchangeproxy \
python-ocsmanager \
mysql-server \
python-mysqldb
----
Once the packages are installed, refer to the _Configuration_ chapter
from this guide.
Configuration Configuration
------------- -------------
@ -349,16 +377,14 @@ You might consider changing the realm and domain used, to suit your
enviroment. enviroment.
You might also have to You might also have to
remove `/etc/samba4/smb.conf` (or `/etc/samba/smb.conf` on Debian-based remove `/etc/samba/smb.conf` prior running this command.
distributions) prior running this command.
Add the following parameters to the `[global]` section of the Add the following parameters to the `[global]` section of the
`/etc/samba4/smb.conf` (`/samba/smb.conf` if you use a Debian-based `/etc/samba/smb.conf` configuration file:
distribution) configuration file:
---- ----
### Configuration required by OpenChange server ### ### Configuration required by OpenChange server ###
dcerpc endpoint servers = +epmapper, +mapiproxy dcerpc endpoint servers = epmapper, mapiproxy, dnsserver
dcerpc_mapiproxy:server = true dcerpc_mapiproxy:server = true
dcerpc_mapiproxy:interfaces = exchange_emsmdb, exchange_nsp, exchange_ds_rfr dcerpc_mapiproxy:interfaces = exchange_emsmdb, exchange_nsp, exchange_ds_rfr
### Configuration required by OpenChange server ### ### Configuration required by OpenChange server ###
@ -392,11 +418,22 @@ Your Samba 4 configuration file should look like this:
OpenChange Configuration OpenChange Configuration
~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~
OpenChange 2.2 stores its metadata in MySQL so you need to have it installed.
First, create the OpenChange MySQL user:
---
$ mysql -u root -p
mysql> CREATE USER 'openchange-user'@'localhost' IDENTIFIED BY 'openchange$123';
mysql> GRANT ALL PRIVILEGES ON `openchange`.* TO 'openchange-user'@'localhost' WITH GRANT OPTION;
mysql> FLUSH PRIVILEGES;
---
The Samba AD schema needs to be filled with additional object The Samba AD schema needs to be filled with additional object
definitions by running the following commands:  definitions by running the following commands: 
---- ----
openchange_provision openchange_provision --standalone
NOTE: This operation can take several minutes NOTE: This operation can take several minutes
[+] Step 1: Register Exchange OIDs [+] Step 1: Register Exchange OIDs
@ -410,38 +447,59 @@ NOTE: This operation can take several minutes
[+] Step 9: Add Exchange classes to Samba schema [+] Step 9: Add Exchange classes to Samba schema
[+] Step 10: Add possSuperior attributes to Exchange classes [+] Step 10: Add possSuperior attributes to Exchange classes
[+] Step 11: Extend existing Samba classes and attributes [+] Step 11: Extend existing Samba classes and attributes
[+] Step 12: Exchange Samba with Exchange configuration objects [+] Step 12: Generic Exchange configuration objects
[+] Step 13: Finalize generic Exchange configuration objects
[SUCCESS] Done!
[+] Step 1: Exchange Samba registration
[SUCCESS] Done!
[+] Step 1: Register Exchange Samba as the main server
[SUCCESS] Done! [SUCCESS] Done!
---- ----
You can safely ignore the "`ERROR: no subClassOf 'serviceAdministrationPoint' for 'rRASAdministrationConnectionPoint'`" message when running the `openchange_provision` command. Create the OpenChange database: 
Provision the OpenChange database: 
---- ----
openchange_provision --openchangedb openchange_provision --openchangedb --openchangedb-uri 'mysql://openchange-user:openchange$123@localhost/openchange'
Setting up openchange db Setting up openchange db
[+] Public Folders [+] Public Folders
=================== ===================
* Public Folder Root 0x0100000000000001 * Public Folder Root : 0x0100000000000001 (72057594037927937)
* IPM_SUBTREE 0x0200000000000001 * IPM_SUBTREE : 0x0200000000000001 (144115188075855873)
* NON_IPM_SUBTREE 0x0300000000000001 * NON_IPM_SUBTREE : 0x0300000000000001 (216172782113783809)
* EFORMS REGISTRY 0x0400000000000001 * EFORMS REGISTRY : 0x0400000000000001 (288230376151711745)
* OFFLINE ADDRESS BOOK 0x0500000000000001 * OFFLINE ADDRESS BOOK : 0x0500000000000001 (360287970189639681)
* /o=First Organization/cn=addrlists/cn=oabs/cn=Default Offline Address Book 0x0600000000000001 * /o=First Organization/cn=addrlists/cn=oabs/cn=Default Offline Address Book: 0x0600000000000001 (432345564227567617)
* SCHEDULE+ FREE BUSY 0x0700000000000001 * SCHEDULE+ FREE BUSY : 0x0700000000000001 (504403158265495553)
* EX:/o=First Organization/ou=Exchange Administrative Group (UBUNTU-OC) 0x0800000000000001 * EX:/o=first organization/ou=first administrative group: 0x0800000000000001 (576460752303423489)
* Events Root 0x0900000000000001 * Events Root : 0x0900000000000001 (648518346341351425)
---- ----
Finally, modify `/etc/samba/smb.conf` to specify OpenChange connection information
for its indexing database. Add the following at the end of the `[global]` section:
---
mapistore:namedproperties = mysql
namedproperties:mysql_user = openchange-user
namedproperties:mysql_pass = openchange$123
namedproperties:mysql_host = localhost
namedproperties:mysql_db = openchange
mapistore:indexing_backend = mysql://openchange-user:openchange$123@localhost/openchange
mapiproxy:openchangedb = mysql://openchange-user:openchange$123@localhost/openchange
---
On RHEL, make sure SELinux is disabled: On RHEL, make sure SELinux is disabled:
setenforce 0 setenforce 0
Next, you can start Samba using the usual command : Next, you can start Samba using the usual command:
/etc/init.d/samba4 start /etc/init.d/samba start
On upstart-based distributions, use:
start samba-ad-dc
You can also launch the OpenChange web services: You can also launch the OpenChange web services:
@ -540,14 +598,13 @@ samba-tool domain passwordsettings set --complexity=off
samba-tool domain passwordsettings set --min-pwd-length=1 samba-tool domain passwordsettings set --min-pwd-length=1
samba-tool user add <username> samba-tool user add <username>
samba-tool user setexpiry <username> --noexpiry samba-tool user setexpiry <username> --noexpiry
# create user in openchange+ +openchange_newuser --create <username> # create user in openchange
openchange_newuser --create <username>
---- ----
If you don't have a trust between your IMAP server and SOGo, you must at If you don't have a trust between your IMAP server and SOGo, you must at
this point set the cleartext password of the newly created user in this point set the cleartext password of the newly created user in
`/var/lib/samba4/private/mapistore/<username/password` (or `/var/lib/samba/private/mapistore/<username/password`.
`/var/lib/samba/private/mapistore/<username/password` on Debian-based
distributions).
This per-user file contains the cleartext password of the user as a This per-user file contains the cleartext password of the user as a
UTF-8 string, on a single line. This password will be used to UTF-8 string, on a single line. This password will be used to