Collabsuite Setup Guide

Collab

Synovel Collabsuite OS Installation

Related Screencasts - Synovel Collabsuite OS Installation

Minimum of 1.5 GB and a recommended of 2 GB of RAM is required to run Collabsuite. Also, please keep the below information ready:
1. Mail Domain (ex. example.com)
2. FQDN (Fully Qualified Domain Name) of the server (ex. mail.example.com)
3. Root Password of your choice for the OS
4. User "admin" password (Administrator password) of your choice
Next either boot the LiveCD or install it to a VM (suggested)

Synovel Collabsuite Configuration (Default OpenLDAP backend)

Related Screencasts - Synovel Collabsuite Hostname Check & Configuration

Edit /etc/hosts and add an entry for your FQDN. If you do not plan to access the server across the network, you can also map it to an IP in the local range. For example, the below entry can be added to /etc/hosts (assuming mail.example.com is your FQDN):
127.0.1.1 mail.example.com
Start the webadmin console setup at https://localhost:10000/setup/. You will have to fill the following mandatory information at a minimum:
- Basic Information Tab -> Primary Domain (this is mail domain)
- Nodes Tab -> Fully Qualified domain name (this is FQDN of the server)
- Nodes Tab -> Privileged Password (this is Root password)
- Admin Console Tab -> Admnistrator Password (this is Administrator Password)
Click on Verify. If there are no errors, you can then click on "Start Install" and the collabsuite will be setup.
After installation is completed, and in case you don't see any errors, restart apache2 and scs-server
# sudo /etc/init.d/apache2 restart
# sudo /etc/init.d/scs-server restart
Admin console is accessible at https://localhost:10000/. You can use username "admin" and administrator password that you had given during setup to access them.

Synovel Collabsuite Configuration (Active Directory Backend)

It is recommended that you do not run this setup directly on a live production Windows Server. Instead, first do a test setup, and then only install in production.

For illustrative purposes, we assume the following:
- Mail domain - example.com
- Mail server FQDN - mail.example.com
- Active Directory FQDN - ads.example.local
- Active Directory Domain - example.local
For Windows 2003, you will have to perform an additional step of raising the domain and forest functional level to Windows 2003 (instructions are available at http://technet.microsoft.com/en-us/library/cc776703%28WS.10%29.aspx and http://technet.microsoft.com/en-us/library/cc780862%28WS.10%29.aspx).
Install Support Tools (by running \support\tools\suptools.msi on first cd or by downloading it from Internet). This is not necessary for Windows 2008 (R2).
Download CopSSH from http://files.synovel.com/downloads/Copssh_4.1.0_Installer.zip and install it.
Start the CopSSH Control Panel and activate the user Administrator (or any other user with administrative privileges). While activating the user Administrator, you have have to select the machine hostname as the "Domain" value. For advanced security, private key could be used for Administrator SSH authentication (not covered in this guide).
Open Incoming SSH Port 22 in Windows Sever Firewall.
Test if SSH access is enabled for Administrator by running the below command from mail server (you should be able to successfully login):
# ssh Administrator@ads.example.local
In your mail server, edit /etc/hosts and add an entry for your FQDN and active directory server.
Now visit the Collabsuite Setup Admin Console at https://mail.example.com:10000/setup/ and enter the following values.
- Basic Information:
  - Primary Domain - example.com (this is the mail domain)
  - Realm - EXAMPLE.LOCAL (this is the Active Directory Domain)
  - Use Windows AD Server - Checked
  - Realm Domains - .example.com (or mail.example.com)
- Nodes - Primary Server Information
  - Fully Qualified Domain - mail.example.com
  - Privileged Password - Enter password for root
- Nodes - Active Directory
  - Fully Qualified Domain - ads.example.local
  - Privileged Password - Enter password of Administrator User
- Admin Console
  - Administrator Password - Enter password which you would like to be set for "admin" user
After entering the above details, click on Verify. After a few checks, the Install button will be enabled. Click on Install to complete the installation.
It is possible that sometimes the installation might fail. In this case, you will first have to delete the self-signed certificate for ads.example.local (which gets installed automatically in Windows Server) by following the below steps.
- Go to Start -> Run... and execute "mmc"
- Go to File -> Add/Remove Snap-in...
- From the list of availabe snap-ins, select Certificates -> Add -> Computer account -> Local computer. Click on OK.
- Now in the left pane, go to Certificates -> Personal -> Certificates and delete the certificate for ads.example.local.
- Similarly, go to Certificates -> Trusted Root Certification Authorities -> Certificates and delete the certificate for ads.example.local.
- Now revisit the Collabsuite Setup Admin Console, and re-rerun the setup (use the same values which you used last time).

Configuring Synovel Collabsuite Webclient

Related Screencasts - Synovel Collabsuite Webclient

Edit /opt/scs-webclient/roundcubemail/config/main.inc.php and change the line
$rcmail_config['mail_domain'] = 'example.net';
to
$rcmail_config['mail_domain'] = 'example.com';
where 'example.com' is assumed to be your mail domain
Edit /opt/scs-webclient/roundcubemail/config/main.inc.php and set the appropriate basedn in the line:
'base_dn' => 'dc=example,dc=com',
Edit /opt/scs-webclient/ijab/ijab_config.js and change the line
domain:"example.net"
to
domain:"example.com"
where 'example.com' is assumed to be your mail domain
Webmail is accessible at https://localhost/. You can use username "admin" and administrator password that you had given during setup to access them.

Configuring Synovel Collabsuite Archiver

Related Screencasts - Synovel Collabsuite Archiver

SCS Archiver is accessible at https://localhost/scs-archiver/. You can also access this by logging into the webadmin console and clicking on "Mail and IM" in "Archival & Statistics". The username is "admin" and default password is "admin". Once you login, follow the below steps to set it up.

Go to Configuration -> Volumes
- Enter a new "Email Encryption Password"
- Click on 'Save' to save the changes
Go to Configuration -> Login
- Enter a new "Master Admin Login Password"
- Click on 'Save' to save the changes
- Logout and login with the new password
Go to Configuration -> Volumes
- Add a new volume with index "/data/mailarchiva/index/index0" and store "/data/mailarchiva/store/store0". It is assumed that /data/mailarchiva/ is where you have mounted the partition to be used for archiving mails. It is recommended but not necessary to create a separate partition for archiving mails.
- Click on 'Save' to save the changes
In webadmin console (https://localhost:10000/), go to "Email and Anti-Spam", double-click on "SMTP Daemon" (which will bring up the daemon edit interface), go to tab "Domain and Networks", set "inet:127.0.0.1:8092" as a SMTPD Milter, and click on Save. Archiving of mails will now start.
For accessing chat archives, first copy the ejabberd database password by going to "IM and Calendaring" section in webadmin console, double-clcking on "XMPP Daemon" and clicking on "(Show Password)" in Advanced Details. You will have to set this password in /opt/scs-archiver/server/webapps/mailarchiva/WEB-INF/conf/chatsearch.conf. Chat archives should now be accessible.
Send a test mail. You should be able to retrieve this mail using the "Email Search" interface. Similary send a test chat message and you should be able to retrieve it using the "Chat Search" interface.

Support

If you face any problem with the installation or setup, just shoot a mail to support@synovel.com, and we will try to help you resolve your problem.

Collabsuite Setup Guide

Next Steps