|
Size: 13178
Comment:
|
← Revision 9 as of 2011-10-04 16:35:39 ⇥
Size: 67
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| <<TableOfContents>> * http://tracker.openchange.org/projects/openchange/wiki/HowTo_Install_OpenChange_From_Source From a base install of ubuntu 10.04 server. = OpenChange = == Dependencies == First, install the dependencies needed to build both OpenChange and Samba4 : {{{apt-get install build-essential autoconf2.59 ccache pkg-config python python-dev subversion git-core flex bison docbook-xsl xsltproc libpopt-dev libical-dev libsqlite3-dev libmagic-dev libboost-thread-dev zlib1g-dev doxygen }}} == Source Code == Checkout the source from the ''sogo'' branch: {{{ mkdir openchange cd openchange svn co http://svnmirror.openchange.org/openchange/branches/sogo }}} == Samba4 compilation == The following steps have to be done since OpenChange makefiles are configured to install samba4 under /usr/local/samba: {{{ # Teach ld.so about the non standard location of samba4 libraries sudo su -c 'echo "/usr/local/samba/lib" > /etc/ld.so.conf.d/samba4.conf' # update PKG_CONFIG_PATH and PYTHONPATH sudo su -c 'echo "PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/samba/lib/pkgconfig; export PKG_CONFIG_PATH" >> /etc/profile.d/samba4-env-build.sh' sudo su -c 'echo "PYTHONPATH=$PYTHONPATH:/usr/local/samba/lib/python2.6/site-packages; export PYTHONPATH" >> /etc/profile.d/samba4-env-build.sh' . /etc/profile.d/samba4-env-build.sh }}} Once the environment is set, use the ''samba'' target to build and install samba4. This requires internet access from the host since it fetches the source code tarball from the samba web site. These commands can be run as a normal user with sudo access. The current code only works with samba-4.0.0alpha14. This is defined in {{{script/samba4_ver.sh}}} {{{ cd sogo make samba sudo ldconfig }}} === Fix tdb_wrap.h === There is an error in a samba4 header file, until this is fixed upstream the following patch has to be applied to /usr/local/samba/include/tdb_wrap.h: {{{ --- tdb_wrap.h.ori 2011-06-14 12:21:02.389043803 -0400 +++ tdb_wrap.h 2011-06-14 12:18:21.741047467 -0400 @@ -29,7 +29,7 @@ #ifndef _TDB_WRAP_H_ #define _TDB_WRAP_H_ -#include <../lib/tdb/include/tdb.h> +#include <tdb.h> struct tdb_wrap { struct tdb_context *tdb; }}} At this point, samba4 should be installed under /usr/local/samba/ == Build OpenChange == Launch the configure scripts: {{{ make clean && ./autogen.sh && ./configure --prefix=/usr/local/samba }}} This should yield an output similar to the following: {{{ =============================================================== OpenChange Configuration (Please review) * OpenChange Libraries: - libmapi (C library): yes Thread support: yes (pthread) - libmapi++ (C++ library): yes - libmapiadmin: yes - libocpf: yes * OpenChange Server: - mapiproxy: yes * OpenChange mapistore backends: - sqlite3: no * OpenChange Tools: - openchangeclient: yes - mapiprofile: yes - openchangepfadmin: yes - exchange2mbox: yes - exchange2ical: yes - mapitest: yes - openchangemapidump: yes - schemaIDGUID: yes * subunit format (mapitest): no * OpenChange Documentation: yes * Coverage Tests: no * OpenChange Bindings: - Python: no - Qt4: no * Installation prefix: /usr/local/samba =============================================================== }}} Compile and install OpenChange: {{{ make sudo make install sudo ldconfig }}} = SOGo = == Dependencies == {{{ sudo apt-get install monotone gnustep-make gnustep-base-runtime devscripts debhelper libgnustep-base-dev gobjc libxml2-dev libldap2-dev libssl-dev zlib1g-dev libpq-dev libmysqlclient-dev libmemcached-dev }}} This will pull in postfix, simply select "Local site" for local mail only or use "Internet site with smarthost" if you want to relay mail through another smtp server. == Getting the sources and compiling SOGo == Fetch the latest sources : {{{ mtn db init --db=~/db.mtn mtn --db=~/db.mtn pull inverse.ca ca.inverse.sogo mtn --db=~/db.mtn pull inverse.ca ca.inverse.sope cd $HOME mtn --db=~/db.mtn checkout --branch ca.inverse.sogo SOGo mtn --db=~/db.mtn checkout --branch ca.inverse.sope SOPE }}} SOPE has to be installed first since SOGo depend on it: {{{ cd SOPE ./configure --with-gnustep --enable-debug --disable-strip make sudo make install }}} Compile and install SOGo: {{{ cd ../SOGo ./configure --enable-debug --disable-strip make sudo make install }}} == SOGo Configuration == Next thing to do is to configure SOGo to use your current services, which are: IMAP, SMTP, SQL databases. The configuration instructions for this are available in the [[http://www.sogo.nu/files/docs/SOGo%20Installation%20Guide.pdf | SOGo Installation and Configuration guide ]] == SOGo OpenChange plugin == Run the the following commands to compile and install the SOGo OpenChange plugin: {{{ cd OpenChange make sudo PKG_CONFIG_PATH=$PKG_CONFIG_PATH make install }}} = OpenChange/Samba4 configuration = From the openchange/sogo/samba4/source4/ directory, run the following commands as root: {{{ cd ~/openchange/sogo/samba4/source4 sudo PYTHONPATH=$PYTHONPATH ./setup/provision --realm=OPENCHANGE.LOCAL --domain=OPENCHANGE --adminpass='%1OpenChange' --server-role='domain controller' }}} Add the ''openchange'' user to samba. This is the user to use for testing outlook: {{{ sudo ./bin/samba-tool newuser openchange openchange }}} Note that you don't necessarily need to use the ''openchange'' user. If you have ''bob'', which is also defined in your LDAP/Active Directory/SQL authentication source, you can simply use this and adjust the instructions below accordingly. Provision the OpenChange server by running the following commands: {{{ cd ~/openchange/sogo/setup sudo PYTHONPATH=$PYTHONPATH ./openchange_provision NOTE: This operation can take several minutes [+] Step 1: Register Exchange OIDs [+] Step 2: Add Exchange attributes to Samba schema [+] Step 3: Add Exchange auxiliary classes to Samba schema [+] Step 4: Add Exchange objectCategory to Samba schema [+] Step 5: Add Exchange containers to Samba schema [+] Step 6: Add Exchange *sub* containers to Samba schema [+] Step 7: Add Exchange CfgProtocol subcontainers to Samba schema [+] Step 8: Add Exchange mailGateway subcontainers to Samba schema [+] Step 9: Add Exchange classes to Samba schema [+] Step 10: Add possSuperior attributes to Exchange classes [+] Step 11: Extend existing Samba classes and attributes [+] Step 12: Exchange Samba with Exchange configuration objects [SUCCESS] Done! }}} Provision the OpenChange Database: {{{ sudo PYTHONPATH=$PYTHONPATH ./openchange_provision --openchangedb Setting up openchange db [+] Public Folders =================== * Public Folder Root 0x0100000000000001 * IPM_SUBTREE 0x0200000000000001 * NON_IPM_SUBTREE 0x0300000000000001 * EFORMS REGISTRY 0x0400000000000001 * OFFLINE ADDRESS BOOK 0x0500000000000001 * /o=First Organization/cn=addrlists/cn=oabs/cn=Default Offline Address Book 0x0600000000000001 * SCHEDULE+ FREE BUSY 0x0700000000000001 * EX:/o=First Organization/ou=Exchange Administrative Group (UBUNTU-OC) 0x0800000000000001 * Events Root 0x0900000000000001 }}} Create an OpenChange user: {{{ sudo ./openchange_newuser --create openchange [+] User openchange extended and enabled }}} Create the associated mailbox: {{{ sudo ./openchange_newuser --mailbox openchange [+] Mailbox for 'openchange' ============================ * GlobalCount (0xa) and ReplicaID (0x1) * Mapistore content repository created: /usr/local/samba/private/mapistore/openchange * User object created: CN=openchange,CN=First Organization Unit,CN=First Organization,CN=UBUNTU-OC,DC=openchange,DC=local * Adding System Folders * Mailbox Root : 0x0a00000000000001 * Deferred Actions : 0x0b00000000000001 * Common Views : 0x0c00000000000001 * Search : 0x0d00000000000001 * Schedule : 0x0e00000000000001 * Shortcuts : 0x0f00000000000001 * To-Do Search : 0x1000000000000001 * Views : 0x1100000000000001 * Spooler Queue : 0x1200000000000001 * IPM Subtree : 0x1300000000000001 * Sent Items : 0x1400000000000001 * Outbox : 0x1500000000000001 * Inbox : 0x1600000000000001 * Deleted Items : 0x1700000000000001 * Reminders : 0x1800000000000001 * Adding Special Folders: * Calendar : 0x1900000000000001 (IPF.Appointment) * Contacts : 0x1a00000000000001 (IPF.Contact) * Journal : 0x1b00000000000001 (IPF.Journal) * Notes : 0x1c00000000000001 (IPF.StickyNote) * Tasks : 0x1d00000000000001 (IPF.Task) * Drafts : 0x1e00000000000001 (IPF.Note) * Adding default Receive Folders: * All Message Class added to 0x1600000000000001 * IPM Message Class added to 0x1600000000000001 * Report.IPM Message Class added to 0x1600000000000001 * IPM.Note Message Class added to 0x1600000000000001 * IPC Message Class added to 0x1300000000000001 * Adding additional default properties to Inbox * Adding additional default properties to Reminders * GlobalCount (0x1f) }}} == Adding users == To add another user to OpenChange, run the following commands: {{{ # add user to samba cd ~/openchange/sogo/samba4/source4 sudo ./bin/samba-tool newuser username password # create user in openchange cd ~/openchange/sogo/setup sudo ./openchange_newuser --create username # create his mailbox sudo ./openchange_newuser --mailbox username }}} There is currently a limitation in the provisionning script: the password of the user is set to the same value as the username. To overcome this limitation, one must edit the ''openchange.ldb'' and fix the mapistore_uri: {{{ /usr/local/samba/bin/ldbedit -H /usr/local/samba/private/openchange.ldb }}} Once in the editor, manually set the password for each mapistore_uri associated with the new user. Or run the following vi commands: {{{ :%s/:username@/:password@/g }}} A user that exists in your current LDAP/Active Directory server '''must''' also be created (for now) in OpenChange. Otherwise, it will '''not''' work. == Samba Configuration == Add the following parameters to the [global] section of /usr/local/samba/etc/smb.conf: {{{ ### Configuration required by OpenChange server ### dcerpc endpoint servers = epmapper, mapiproxy dcerpc_mapiproxy:server = true dcerpc_mapiproxy:interfaces = exchange_emsmdb, exchange_nsp, exchange_ds_rfr ### Configuration required by OpenChange server ### }}} Since samba will be started as root, the sogo configuration files will be looked up under root's home directory. Create the following symlink to make sure that samba will find the configuration file: {{{ ln -s ~sogo/GNUstep /root/ }}} Start samba : {{{ sudo /usr/local/samba/sbin/samba -d3 -i -M single }}} At this point samba should be running in the frontend in interactive mode. The logs can be found in /usr/local/samba/var/samba.log when samba runs daemonized. = Outlook Client = Outlook will use the hostname returned by samba. In this document, the hostname was "ubuntu-oc.openchange.local". If proper DNS resolution is not in place, the ''hosts'' file will have to be modified. Add an entry like the following to c:\windows\system32\drivers\etc\hosts : {{{ 192.168.56.101 ubuntu-oc.openchange.local }}} To configure outlook : * open the Control Panel => Mail => Email Accounts. * Select ''Add a new email account'' * ''Microsoft Exchange Server'' * ''Microsoft Exchange Server'': (enter the hostname of your openchange server) * ''Username'': openchange * Click on ''More settings'' (and ignore the warning about exchange being offline, then click Cancel) * Select the ''Security'' tabs * Select ''Always prompt for user name and password'' Start outlook and enter your username and password (openchange/openchange), it should now start to synchronize. If you have a lot of information, especially mails, this process could take ages. It's recommended that you use test users. |
Deprecated - see: http://www.sogo.nu/downloads/documentation.html |
Deprecated - see: http://www.sogo.nu/downloads/documentation.html