Difference between revisions of "Server Manager"

Revision as of 07:40, 27 July 2010

Server manager

The server manager is a module that can manage other Group-Office installations on a Debian server. You need to have a domain and all subdomains point to the IP address of the server. For example *.groupoffice.eu. CustomerX will get the domain http://customerx.groupoffice.eu

By default the servermanager is installed at https://<IP_ADDRESS>/groupoffice

You can install the servermanager on Debian or Ubuntu with:

apt-get install groupoffice-servermanager (See Installation)

How is the server organized?

The server uses Apache 2, Postfix, Dovecot and Spamassassin

Apache and Group-Office

You should not have to edit any of these configuration files. Everything can be managed through the servermanager. This is just to explain how it works.

A virtual host for all Group-Office installations is created in: /etc/apache2/sites-enabled/000-groupoffice.

It uses a VirtualDocumentRoot (More info: [1]) so any domain name pointing to the server IP will automatically work when it's created in the servermanager. SSL is also preconfigured with a test certificate using the apache module mod_ssl.

The VirtualDocumentRoot is located at /home/govhosts/. There's a directory for each domain in that directory. For example: /home/govhosts/customer.groupoffice.eu/.

The home directories and other data files are stored in /home/govhosts/customer.groupoffice.eu/data. The database is called groupoffice_groupoffice_eu.

In that directory there is a symlink called "groupoffice" that points to "/usr/share/groupoffice". That is where the actual source of Group-Office is located.

The config.php file for each Group-Office installation can be found in "/etc/groupoffice/<DOMAIN>/config.php". There is also a "/etc/groupoffice/globalconfig.php". The configuration parameters in here apply to all installations.

There is also a configuration file for the servermanager module: "/etc/groupoffice/servermanager.inc.php". It contains some default configuration values for new installations.

Apache and PHP errors are logged in /var/log/apache2/groupoffice_error_log

Postfix and Dovecot

Postfix is setup to use virtual accounts in MySQL like described in detail here:

http://www.group-office.com/wiki/Mailserver

All users are stored in the MySQL database "servermanager" and can be managed with the servermanager. A special perl script is used to handle autoresponse when a user is on vacation. Dovecot checks the quota in MySQL.

The actual mails are stored in /vmail/<domain>/<user>/

Changing the MySQL root password

Because Postfix, Dovecot and the vacation autoresponder all connect to the MySQL database using the root password, you will have to edit the following configuration files:

/etc/postfix/mysql_*

/etc/dovecot/dovecot-sql.conf

/var/spool/vacation/vacation.pl

/etc/groupoffice/<yourip>/config.php

Licenses

The license "/etc/groupoffice/license.inc.php" tells how many users you are allowed to have. You should obtain this license from Intermesh. Every installation checks the servermanager to see if all installations are validated. In both /usr/local/groupoffice and /usr/local/servermangers is a license file called groupoffice-sm-3.00-stable-x.txt. This is the Ioncube license file and needs to be renewed every year. You will get those from Intermesh.

Backup the server

To be able to restore the servermanager completely you need to backup the following folders:

/var/www : The files stored in Group-Office /vmail : The e-mail messages /etc/groupoffice : The configurations

A backup from all MySQL databases should also be made

A server can be restored by reinstalling Debian and the Group-Office servermanager. After that you can restore the folders and databases.