Necessary and configured ClearOS modules:
Required information during installation:
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
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
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
And now for the fun part….. fire up your browser to start the eGroupware setup: http://[FQDN]/egroupware/setup
Click <button>Run installation tests</button> 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 <button>Continue to the Header Admin</button> 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:
!Do NOT Click: <button>Add new database instance (eGW domain)</button> 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 <button>Download</button> and upload the file in /var/www/html/egroupware (or click <button>View</button> 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 <button>Continue</button>
you should now be able to login to the 'Setup/Config Admin Login' screen using your freshly created 'configuration user': admin
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 <button>Create Database</button> and if you don't see any errors click <button>Re-Check my installation</button>
if you get the message: “Your database is working, but you dont have any applications installed”, click <button>Install</button> (to install all applications), and if you don't see any errors click <button>Re-Check my installation</button>.
Click <button>Edit Current Configuration</button>
Click <button>Create Admin Account</button> (The account used for administrating all user accounts and settings.
Now click <button>Back to user login</button> (left side frame) and log in with your newly created admin account…..
Click <button>Admin icon</button> (first icon next to the logo) and select 'User Accounts'
Click <button>Edit</button> 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 <button>Save</button> You can now log in with your own account.