Developers Documentation

×

Warning

301 error for file:https://clearos.com/dokuwiki2/lib/exe/css.php?t=dokuwiki&tseed=82873f9c9a1f5784b951644363f20ef8

User Tools

Site Tools


Setup eGroupware

Before you start

Necessary and configured ClearOS modules:

  • LDAP
  • Mail (incl. IMAP/POP server module, SMTP server module)
  • MySQL database server module
  • Web server module (incl. PHP module)

Required information during installation:

  • [Root password]
  • [LDAP Bind Password]
  • [MySQL root password]

Installing Packages

Please login to the console or via 'ssh root@[clearosIP]' as you will need root rights

eGroupware is a PHP application but needs Pear (a framework and distribution system for reusable PHP components: more info here)

yum install php-pear.noarch php-gd.i386 php-xml.i386
apachectl restart
pear upgrade-all
pear install Auth_SASL
pear install XML_Feed_Parser
apachectl restart

eGroupware environment

Please login to the console or via 'ssh root@[clearosIP]' as you will need root rights

This instruction is based on the default eGroupWare installation path, you can change this yourself (http://[FQDN]/egroupware)

Let's download and unpack the eGroupware packages onto the web server.

cd /var/www/html
wget http://sourceforge.net/projects/egroupware/files/egroupware/eGroupware-1.6.002/eGroupware-1.6.002.tar.bz2/download
wget http://sourceforge.net/projects/egroupware/files/egroupware/eGroupware-1.6.002/eGroupware-egw-pear-1.6.002.tar.bz2/download
tar xvf eGroupware-1.6.002.tar.bz2
tar xvf eGroupware-egw-pear-1.6.002.tar.bz2
rm -fv eGroupware-1.6.002.tar.bz2 eGroupware-egw-pear-1.6.002.tar.bz2

This how-to is based on version 1.6.002 but can easily be adjusted to another version by replacing the version number

In /etc/PHP.ini change the following settings:

Old setting New setting
memory_limit = 16M memory_limit = 96M
upload_max_filesize = 2M upload_max_filesize = 8M
;mbstring.func_overload = x mbstring.func_overload = 7

and for the changes to take effect

apachectl restart

The memory_limit is required, upload_max_filesize is the php limit and has impact on attachments (composing mail), the mbstring.func_overload is not required but it gives a warning when not set during installation.

Installing eGroupware

And now for the fun part….. fire up your browser to start the eGroupware setup: http://[FQDN]/egroupware/setup

Make sure your firewall allows access!

Click a set of tests is now run, if the PHP.ini settings have been set as stated above, then you should see no 'red crosses' (errors that must be resolved) and only a few 'yellow thunderstrikes' (warnings regarding not installed database connectors → important: the MySQL connector must pass the test)

Click The header file is the actual configuration file that is needed to initialize eGroupware.

You can leave the settings default, but must specify (and note) passwords for the following accounts:

  • Header Username: admin / Header Password: [specify]
  • DB User: egroupware / DB Password: [specify]
  • Configuration User: admin / Configuration Password: [specify]

!Do NOT Click: because you do not have root access to MySQL

Because the header.inc.php cannot be created due to file permission restrictions you need to click and upload the file in /var/www/html/egroupware (or click and copy the contents in the console screen (VI))

In your (ssh) console run the following to protect your newly created header file and create two directories you will be needing later on

chmod 640 /var/www/html/egroupware/header.inc.php
chown :apache /var/www/html/egroupware/header.inc.php
mkdir -p /var/lib/egroupware/default/files /var/lib/egroupware/default/backup
chown -R apache /var/lib/egroupware/default/

in your browser click

you should now be able to login to the 'Setup/Config Admin Login' screen using your freshly created 'configuration user': admin

Step 1 - Simple Application Management

Note that there is a message that the database is not working. This is because setup is trying to create a database with the newly created 'DB user' who does not have these rights.

Just fill in your [MySQL root password] and click and if you don't see any errors click

if you get the message: “Your database is working, but you dont have any applications installed”, click (to install all applications), and if you don't see any errors click .

Step 2 - Configuration

Click

  • Path information, Virtual filesystem → [keep default]
  • Host information → fill in your own server settings
  • Standard mailserver settings (used for Mail authentication too) → fill in your own server settings
  • Authentication / Accounts →
    • Select which type of authentication you are using: choose [LDAP]
    • Select where you want to store/retrieve user accounts: [LDAP]
    • → [keep rest default]
  • If using LDAP → fill in your LDAP settings

Click

as an example please find below my settings:

  • LDAP host: 127.0.0.1
  • LDAP accounts: ou=Users,ou=Accounts,dc=xceed,dc=no-ip,dc=org
  • LDAP search filter..: [empty]
  • LDAP groups context: ou=Groups,ou=Accounts,dc=xceed,dc=no-ip,dc=org
  • LDAP rootdn: cn=manager,cn=internal,dc=xceed,dc=no-ip,dc=org
  • LDAP root password: [this is the [LDAP Bind Password] as stated in the ClearOS web interface (Directory → Setup → Domain and LDAP → LDAP information)
  • LDAP encryption type: MD5
  • Do you want to manage homedirectory and loginshell attributes?: No
  • LDAP Default homedirectory prefix (e.g. /home for /home/username): /home
  • LDAP Default shell (e.g. /bin/bash): /bin/bash

Step 3 - Admin Account

Click (The account used for administrating all user accounts and settings.

  • Give admin access to all installed apps → [empty]
  • Create demo accountsCreate demo account]

Click

Thats it!

Now click (left side frame) and log in with your newly created admin account…..

Click (first icon next to the logo) and select 'User Accounts'

Click behind you user account name.

In the 'Edit user account' screen check the information and select the applications that you want to use (with this account).

Click You can now log in with your own account.


content/en_us/kb_howtos_egroupware.txt · Last modified: 2015/02/11 10:11 (external edit)

https://clearos.com/dokuwiki2/lib/exe/indexer.php?id=content%3Aen_us%3Akb_howtos_egroupware&1710817575