Power Team Collaboration with eGroupware on CentOS 5
Updated by Amanda Folson
This guide has been deprecated and is no longer being maintained.
The eGroupware suite provides a group of server-based applications that offer collaboration and enterprise-targeted tools to help enable communication and information sharing between teams and institutions. These tools are tightly coupled and allow users to take advantage of data from one system, like the address book, and make use of it in other systems, including the calendar, CRM, and email systems. eGroupware is designed to be flexible and adaptable, and is capable of scaling to meet the demands of a diverse class of enterprise needs and work groups, all without the need to rely on a third-party vendor. As eGroupware provides its applications entirely independent of any third party service, the suite is a good option for organizations who need web-based groupware solutions, but do not want to rely on a third party provider for these services.
Before installing eGroupware, we assume that you have followed our getting started guide. If you’re new to Linux server administration, you may be interested in our introduction to Linux concepts guide, beginner’s guide and administration basics guide.Additionally, you will need install a LAMP stack as a prerequisite for installing eGroupware.
In this guide, we will be installing eGroupware from the packages provided by the eGroupware project and built by the OpenSUSE build service for CentOS 5. We’ve chosen to install using this method in an effort to ensure greater stability, easy upgrade paths, and a more straight forward installation process. Begin the installation by issuing the following commands to initialize the eGroupware repositories:
1 2 3 4 5
yum update yum install wget cd /etc/yum.repos.d/ wget http://download.opensuse.org/repositories/server:/eGroupWare/CentOS_5/server:eGroupWare.repo yum update
Now you can issue the following command to install eGroupware and other required packages:
yum install eGroupware mysql-server
Congratulations, you’ve now installed eGroupware!
Configure Access to eGroupware
The configuration options for eGroupware are located in the file
/etc/httpd/conf.d/egroupware. Add the following line to your virtual hosting configuration:
- Apache Virtual Hosting Configuration
Alias /egroupware /usr/share/egroupware
When inserted into the virtual hosting configuration for
example.com, accessing the URL
http://example.com/egroupware/ will allow you to access your eGroupware site. If you do not have virtual hosting configured, eGroupware will be accessible at
/egroupware of the default Apache host.
Before continuing with the installation of eGroupware, issue the following commands to start the webserver and database server for the first time. Furthermore the
chkconfig commands will ensure that these services are initiated following reboots:
1 2 3 4
/etc/init.d/httpd start /etc/init.d/mysqld start chkconfig mysqld on chkconfig httpd on
Before we begin the configuration of eGroupware, we need to ensure that a number of directories exist for use by eGroupware. Issue the following sequence of commands:
1 2 3 4 5 6
mkdir -p /srv/www/example.com/backup mkdir -p /srv/www/example.com/tmp mkdir -p /srv/www/example.com/files chown apache:apache -R /srv/www/example.com/backup/ chown apache:apache -R /srv/www/example.com/tmp chown apache:apache -R /srv/www/example.com/files
http://example.com/egroupware/setup/ in your web browser to begin the setup process presented by the eGroupware application. When you have completed the initial “Header Setup” process, select the option to write the “header” file and then continue to the “Setup/Admin.” Ensure that you’ve selected the correct “Domain” if you configured more than one. At this juncture, you must install the eGroupware applications that you will expect to use. Select the proper character set and select the button to “‘Install’ all applications.” You can now “Recheck” your installation. In the “Configuration” setup page, supply eGroupware with paths to the
files/ directory created above. Additionally, you will need to create an admin account for your eGroupware domain, which you can accomplish from this Setup Domain page.
When all applications have been installed, you will be provided with a number of options that you can use to fine-tune the operations and behavior of your eGroupware instance. If you wish to use eGroupware to help manage email, you will need to have a running email system.
You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
This guide is published under a CC BY-ND 4.0 license.