eGroupware – web-based groupware suite Setup
- System software e.g. Linux, Windows or MacOSX
- Downloading the eGroupWare Package
- Webserver and php-Interpreter e.g. Apache, IIS recommended Apache 2, min. php 4.3, recommended php 5
- Database (SQL) e.g. MySQL, Postgres, MaxDB, MSSQL min. MySQL 4.0, recommended MySQL 4.1 or 5.0
- SMTP-Server e.g. Postfix
- Client Browser e.g. Firefox, Internet Explorer
- Client IMAP-Server e.g. Cyrus (POP3 also possible, supported only by Anglemail -- not by the standard email application FelaMiMail.
Before installing egroupware you have to install apache2 and mysql with php support
Web Server Setup
Install apache2 with php support check here
Database Server Setup
Install mysql with php support
sudo apt-get install mysql-server mysql-client libmysqlclient15-dev
sudo apt-get install php4-mysql
If you want to install php5 support use the following command
sudo apt-get install php5-mysql
Install postfix in Ubuntu
sudo aptitude install postfix mailx php5-imap
choose satellite system and just press enter when asked other questions, but don't select any relay host (remove smtp.xxx.xxxx)
Change /etc/mailname to say: test.com
Change /etc/aliases such that,
# Added by installer for initial user
root: [email protected]
Replace [email protected] with your own e-mail address!
Finally, do as root
restart postfix using the following command
sudo /etc/init.d/postfix restart
and if you want to install imap or pop3 servers you can install of your choice and this is only optional.
Installing eGroupware in Ubuntu
sudo aptitude install egroupware
This will start the installation process and you see the following screen first
Now it will ask for which webserver you want to configure for egroupware i am using apache2 and select which one you are using from the list.
Enter the which user you want to use for header user admin and i have entered admin and click on ok
enter the header admin user password
Confirm the header admin password
this time you have choose the option for libc-client without maildir support and i am selecting yes and click on ok
That’s it this will complete the egroupware basic installation.
Go to http://yourserverip/egroupware/setup/ to setup egroupware
Select Your Language and click on "Run Installation Tests"
Now you should see similar to the following screen here you need to click on "Continue to the Header Admin"
Enter your header user admin username and password to login.
Once you login you should see the following screen in this you need to enter all the required fields with the exact information.Important one is enter the configuration username and password for you to login after installation .You click on Add new database instance and write config click on continue.
header.inc.php created click on continue
Now you need to enter the setup/config admin login details and click on login
Here you need to enter DB root username,password and click on Create database
you should see the following screen with red cross marks first thing is you need to click on install button to install all the required applications
Now you should see the following screen with two red cross marks this means you have to setup mail server settings, create the admin account.
Once you created everything you should see similar to the following screen
Now you need to login using the following URL
http://yourserverip/egroupware/ enter your configuration admin username and password to login
Once you logged in into the egroupware you should see similar to the following screen
hey thanks for the info. i am very happy for every thing
i first setup failed but thanks to your notes
it went through very very well
thanks a lot for everything and look forward to hearing from you
Excellent instructions. I managed to get everything working on my 8.04 LTS server, apart from IMAP support. apt-get install php5-imap didn’t work as it seemed to think it was already installed. But egroupware was having none of it.
sudo apt-cache policy php5-imap
*** 5.2.3-0ubuntu3 0
500 http://gb.archive.ubuntu.com hardy/universe Packages
I found in a web site the following solution that worked for me.
Make sure to also do a:
as the php5-imap is installed after the apache2 server is restarted and will not be loaded. The installation should be change so that the server is reloaded at the end of install.
hope helps somebody,
/etc/php5/conf.d/imap.ini is not created by installation process, so
when we restart apache and we try to use php-imap module it doesn’t work
because it wasn’t loaded by php5.
Creating the /etc/php5/conf.d/imap.ini file containing:
# configuration for php IMAP module
during the installation phase will solve the problem.
Found when I went a googling.
Checking file-permissions of .././etemplate/doc for not world writable:
.././etemplate/doc does not exist !!!
can anyone help me with this?
thank you guys!
* You appear to have MySQL support.
* You appear to have MySQLi (php5) support.
* No PostgreSQL support found. Disabling
* No MS SQL Server support found. Disabling
* No ODBC support found. Disabling
* No Oracle support found. Disabling
* You appear to have PHP session support. Enabling PHP sessions.
* Found existing configuration file. Loading settings from the file…
* You need to add some domains to your header.inc.php.
is this ok? i think i missed some things…
I’d like to know how to solve that doc’s not found error too… I hope someone posts a fix. Thanks! Ric
I went through all the steps up until the part where we either create a new database or RE-Check Database. It doesn’t allow me to create a new one, just re-check it. I’m running on PGSQL, am I supposed to be running my SQL? How do I back up out of this if this is the case and redo??
I too am having problems with permissions and the
Checking file-permissions of .././etemplate/doc for not world writable:
.././etemplate/doc does not exist !!!”
and am not finding a fix with lots of googling.
Has anyone figured this out for an install on Ubuntu server 9.04 ?
@Rich: had the same issue. quick fix was to rm that sym-link, /usr/share/egroupware/etemplate/doc and cp -r what it’s pointing to, /usr/share/doc/egroupware/etemplate/doc or whatever it was. after fixing the first one, it’ll do the same thing again with another sym-link, just do the same thing with it’s proper directory and you should be set.
Thanks ‘jimbo’! I am now past the Installation Check but am stuck at Step 1 of Setup…
rcvg this …
backupdir ‘/var/lib/setup/default/backup’ is not writeable by the webserver*
and cannot fix it even with a chmod 777 of the entire path.
Are these bugs in the install and config scripts?
Sure wish this install was less error prone 🙁
In installation test finally got no errors, only advertisement of Oracle, but I use mysql, but in login windows still:
Your session could not be verified.
Summer, I have had the same problem since day one. I too would like to know how to fix this. Thanks to the Ubuntu Crew for their efforts. Ric
2nd try at an install worked… not sure what I did differently , but I followed the above instructions carefully this time with no shortcuts.
Ubuntu 9.04 Server + did the Apache2 and MySql install part anyway (even thou these come with Unbuntu) + the egroupware install…
main difference is I left the Ubuntu srvr quite bare and did the eGW setup from another computer using a browser (1st attempt was all on the Unbuntu srvr after adding a GUI and browser and other stuff) to the Ubuntu install ISO.
I am willing to try to answer questions if others try this and have any problems.
I see you have a very recent install experience with eGroupware. Are you using this in a production environment?
I was hoping to install on an 8.04 LTS server I just built, but am trying to decide if I should go native on the O/S or build a VM in VirtualBox.
Sorry this reply is so late… just going ‘production’ with Ubuntu 9.04 server and eGW 1.4 this week. It is our new company ‘intranet portal’. Kind of a steep learning curve, and behind schedule, but so far so good!
I am using Ubuntu ‘native’. I would not try in VM mostly from my lack of experience with eGW and the VM environment.
About the doc not found error.
After lots of head scratching, I bit the bullet and went back a generation in the server OS from JJ (Ubuntu 9.04) to HH (Ubuntu 8.04lts).
All of the permissions errors disappear as long as you follow the apache/php/mysql install guide also referenced here.
Don’t forget to create a mysql database for egroupware first (egroupware is a good name for it) and to also create a mysql user (again egroupware seems appropriate) and not to forget to set permissions to be all and a password of your choosing (as i was on a roll, egroupware got to be that as well!). If you do not create the database to begin with when you try to populate the db it will fail.
sudo rm /usr/share/egroupware/etemplate/doc
sudo cp -R /usr/share/doc/egroupware-etemplate/ /usr/share/egroupware/etemplate/doc
sudo rm /usr/share/egroupware/sitemgr/doc
sudo cp -R /usr/share/doc/egroupware-sitemgr/ /usr/share/egroupware/sitemgr/doc
Following joe325 directions under Ubuntu 10.04 using egroupware 1.6.001 resulted in an error in finding sitemgr-link. Found sitemgr-link.php in the sitemgr directory. Fixed by linking the file correctly.
@cyberdoo78 can you elaborate a bit more, Im having the same issue.. thanks.
Use this command and it should fix ya up:
sudo ln -s /usr/share/egroupware/sitemgr/sitemgr-link.php /usr/share/egroupware/sitemgr-link.php
for my installation the cyberdoo78 solution does not work, I’ve fixed with:
sudo rm /usr/share/egroupware/sitemgr-link
sudo ln -s /usr/share/egroupware/sitemgr/sitemgr-link-php /usr/share/egroupware/sitemgr-link
seem to search the file without extension
i am using ubuntu server 10.04
and do installation steps completely but when i want to login the ” Your session could not be verified” showed please help me to solve it ?
I also encountered this problem during install on Ubuntu 10.04.2 LTS
I fixed like this :
Each time I had a link called ‘doc’ (etemplates, sitemgr) I remove it and create a new folder
sudo rm doc
sudo mkdir doc
sudo chown -R www-data:www-data doc
sudo chmod -R 775 doc
About these links :
/usr/share/egroupware/sitemgr -> /usr/share/egroupware/sitemgr/sitemgr-link-php
sitemgr-link.php -> /usr/share/egroupware/sitemgr/sitemgr-link.php
I simply removed them, and check is OK…
And it seems to work for me.
I seem to get to the setup/config admin login page and it will not accept the password. I have used the same password for the mysql user and when the database was added. I have also started again from scratch (new ubuntu 10.04 LTS installation – still no success). I can log in to the header admin account only.