Difference between revisions of "Installation"

Revision as of 14:20, 30 June 2009

Hardware recommendation

We recommend an x86 dual core processor of a speed that is not too low or too high on the price/performance ratio. The more RAM you put in the machine, the more users you can serve at the same time. You should start with at least 2GB but 4GB is recommended.

We recommend SAS disks in RAID 1 setup. This has the fastest performance and is redundant.

Easy installation on a dedicated Debian or Ubuntu server

deb http://repos.groupoffice.eu/ main/

Now do:

apt-get update apt-get install groupoffice groupoffice-mailserver groupoffice-servermanager

groupoffice is the software itself groupoffice-mailserver will configure postfix, dovecot and spamassassin groupoffice-servermanager allows you to create multiple groupoffice installations on the machine. Any domain that points to the server IP address will work.

Manual installation

Preparing the server

You need to make sure your system meets the system requirements. You can see it here:

http://www.group-office.com/Pricing+and+Sign+up/Server+version

You can test the system by running the test script:

http://group-office.svn.sourceforge.net/viewvc/*checkout*/group-office/trunk/www/install/gotest.php

This script should output all OK's for best performance.

You can follow this howto to setup an ideal Group-Office server:

http://www.howtoforge.com/groupware-server-with-group-office-postfix-dovecot-spamassassin-on-debian-lenny

When this is ready you need to have a connection to the server. Preferably you must have an SSH connection but an FTP connection will do too but it a little cumbersome. Apart from that you need a MySQL database with all privileges setup for the user.

So if you want Intermesh to install it then you must provide:

1. A working domain where the test script runs OK
2. An SSH or FTP connection to this domain
3. The MySQL database connection parameters

Installing libwbxml

To Synchronize with Mobile phones you need a wbxml to xml and vice versa convertor. You need to install libwbxml.

For Max OS X you can find a package here: http://darwinports.com/ (Just search for wbxml)

On Debian / Ubuntu : just type: "apt-get install libwbxml2-utils" on the command line

You can find the source of the program here: http://libwbxml.aymerick.com/

An RPM for Redhat or CentOS:

http://atrpms.net/dist/el4/wbxml2/

Yum Alternative:

yum install libexpat.so.0 wbxml2

Installing TNEF

RPM for Redhat / CentOS http://dag.wieers.com/rpm/packages/tnef/tnef-1.3.3-1.2.el4.rf.i386.rpm

Debian: apt-get install tnef

Installing IonCube

Download from http://www.ioncube.com/loaders.php

Example:

    wget http://downloads2.ioncube.com/loader_downloads/ioncube_loaders_lin_x86.tar.gz

    tar -zxvf ioncube_loaders*

    mv ioncube /var/www/html/ioncube

    Add "zend_extension = /var/www/html/ioncube/ioncube_loader_lin_5.2.so" into your php.ini file before Zend references.

Installing Group-Office

When you've got all Ok's on the test script you can proceed with the Group-Office installation. Upload the Group-Office files and launch your browser. The installation process will appear and it will guide you through the installation.

PDF fonts

Group-Office can create PDF's. Like an invoice or calendar print. By default Group-Office users the default font Helvetica. This is fine in most cases so you don't need to do anything. This font is a standard PDF font and does need to be embedded in the PDF which results in a small PDF file (< 100kb). However when you need special characters like Chinese or Russian characters you'll need to select another font. The "dejavusans" font is available by default and containts all unicode characters. The drawback is that this font is about 500kb large and your PDF will grow with that size too. You can optimize the font by only incuding the characters you need. You can find more information about that here:

http://www.tecnick.com/public/code/cp_dpage.php?aiocp_dp=tcpdf_fonts

To use a custom font put this in your config.php file:

$config['tcpdf_font']='dejavusans';

Installing Group-Office on Plesk using Centos

(Examples developed around a managed hosting account on mediatemple.com so there may be some differences that you will have to accommodate for)

In your administration panel you must turn on all of the developer tools and install YUM Directions can be found at http://kb.mediatemple.net/questions/1564/Installing+the+yum+package+manager

For those that have not installed YUM but have developer tools installed you can run these commands

1. Install Python Iniparse (a new dependency of Yum)

   rpm -Uvh http://mirror.centos.org/centos/5.2/os/i386/CentOS/python-iniparse-0.2.3-4.el5.noarch.rpm

1. Install the Yum Metadata parser (another dependency of Yum)

   rpm -Uvh http://mirror.centos.org/centos/5.2/os/i386/CentOS/yum-metadata-parser-1.1.2-2.el5.i386.rpm

1. Now install Yum

   rpm -Uvh http://mirror.centos.org/centos/5.2/os/i386/CentOS/yum-3.2.8-9.el5.centos.1.noarch.rpm

Next create a file call "vhost.conf" in your "/var/www/vhosts/<domain>/conf" folder path. Obviously change <domain> to your domain (ex. "/var/www/vhosts/group-office.com/conf")

   <Directory /var/www/vhosts/<domain>/httpdocs>    
   php_admin_value open_basedir none
   </Directory>

Once that file is in place run this command

   /usr/local/psa/admin/sbin/websrvmng -v -a

Once you have the above done you should be able to install the basic functions of Group-Office.

Install libwbxml

   rpm -Uvh http://dl.atrpms.net/all/wbxml2-0.9.2-5.el4.at.i386.rpm

Install TNEF

   rpm -Uvh http://dag.wieers.com/rpm/packages/tnef/tnef-1.3.3-1.2.el4.rf.i386.rpm