Difference between revisions of "Egroupware"

From SME Server
Jump to navigationJump to search
(RPM updated. Added new features and cleaned obsolete ones)
Line 1: Line 1:
 
{{Languages|Egroupware}}
 
{{Languages|Egroupware}}
=eGroupware 1.4.002 for SME 7.x=
+
=eGroupWare 1.4.002 for SME 7.x and above=
  
==Maintainer==
+
==Maintainers==
 
[[User:Berdie/de|Dietmar Berteld]]<br/>
 
[[User:Berdie/de|Dietmar Berteld]]<br/>
 
mailto:dietmar@berteld.com
 
mailto:dietmar@berteld.com
  
 +
[[User:Cool34000|Sylvain Gomez]]<br/>
 +
mailto:sylvaingomez@free.fr
  
This rpm is based on the great [http://forums.contribs.org/index.php?topic=35146.0 HowTo] of [http://forums.contribs.org/profile.php?mode=viewprofile&u=10295 Sylvain Gomez (Cool34000)].
+
==Description==
 +
eGroupWare is a [http://www.egroupware.org/philosophy free] enterprise ready groupware software for your network. It enables you to manage contacts, appointments, todos and many more for your whole business.
 +
 
 +
eGroupWare is a groupware server. It comes with a native web-interface which allowes to access your data from any platform all over the planet. Moreover you also have the choice to access the eGroupWare server with your favorite groupware client (Kontact, Evolution, Outlook) and also with your mobile or PDA via SyncML.
 +
 
 +
eGroupWare is international. At the time, it supports more than [http://www.egroupware.org/languages 25 languages] including rtl support.
  
==Description==
+
For more information see ''http://www.egroupware.org/''.
eGroupware 1.4.002 for SMEserver 7.x is a powerfull modular Internet/Intranet application framework.
 
* Features calendaring, project management, e-mail, tasks, addressbook, file management.
 
* Supports many languages. En, Sv, ....  
 
  
With this RPM you can use eGroupware on your SME 7.x. You can install it as one single package in a very comfortable way. For more information see ''http://www.egroupware.org/''.
+
With this RPM you can use eGroupWare on your SME 7.x (and above). You can install it as one single package in a very comfortable way.
  
 
==Download==
 
==Download==
You can download this package at ''[http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/smeserver-egroupware-1.4-9.noarch.rpm smeserver-egroupware]'' . If you would like to save it directly on your SME Server, you should give this command at a linux-prompt
+
You can download this package at ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/egroupware/smeserver-egroupware-1.4.002-2.noarch.rpm smeserver-egroupware]'' . If you would like to save it directly on your SME Server, you should give this command at a linux-prompt
  wget http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/smeserver-egroupware-1.4-9.noarch.rpm
+
  wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/egroupware/smeserver-egroupware-1.4.002-2.noarch.rpm
  
==Installation and Uninstall==
+
==Installation==
 
For installation just hit the following command
 
For installation just hit the following command
  yum localinstall smeserver-egroupware-1.4-9.noarch.rpm
+
  rpm -Uvh smeserver-egroupware-1.4.002-2.noarch.rpm
 +
 
 +
==Update/Upgrade==
 +
{{Warning box|'''Because of a bug in old RPM versions'''*''', YOU MUST UNINSTALL THE OLD RPM BEFORE UPDATING WITH THE FOLLOWING COMMAND:'''
 +
'''rpm -e smeserver-egroupware --noscripts'''
 +
'''This will prevent installation files and MySQL to be deleted.'''
 +
 
 +
<nowiki>*</nowiki>'' Affected versions are smeserver-egroupware-1.4-10 and older''}}
 +
 
 +
Then, you can update your existing 1.4 installation with
 +
rpm -Uvh smeserver-egroupware-1.4.002-2.noarch.rpm
 +
If you were upgrading eGroupWare version (i.e.1.4.001 to 1.4.002) you must finish the upgrade at the Config-Admin Setup with your existing creditentials.
 +
A backup is done by the RPM before updating. All Files and MySQL DataBase are saved in /opt/eGW_RPM_BACKUP
 +
'''You must move the backup to a safe directory.'''
 +
 
 +
This automatic step is just for safety, '''make your own backup before updating/upgrading.'''
 +
 
 +
==Uninstallation==
 
For uninstall just hit the following command
 
For uninstall just hit the following command
  yum remove smeserver-egroupware
+
  rpm -e smeserver-egroupware
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.
+
In the new release (1.4.002-x), if you want to completly remove eGroupWare from your server, you need the following command:
 +
sh /root/eGW_Full_Uninstall.sh
 +
This will delete eGroupWare's installation files, MySQL DB and SME DB entries.
  
==Use==
+
==Starting with eGroupWare==
Please perform the Intial Configuration '''FIRST''' before login to eGroupware.
+
Please perform the Intial Configuration '''FIRST''' before login to eGroupWare.
After that SME users can login to eGroupware with their used SME account + password. At first login, eGroupware creates user accounts and passwords automatically and synchronize them to the SME Server.
+
After that SME users can login to eGroupWare with their used SME account + password. At first login, eGroupWare creates user accounts and passwords automatically and synchronize them to the SME Server.
  
 
===Inital Configuration===
 
===Inital Configuration===
You can find eGroupware in the ''/opt/egroupware'' directory. For using eGroupware start your browser with the URL ''http://servername/egroupware/setup'' and logon with the user ''config-admin'' + password ''admin'' at Setup/Config Admin Login.
+
You can find eGroupWare in the ''/opt/egroupware'' directory. For using eGroupWare start your browser with the URL ''http://servername/egroupware/setup'' and logon with the user ''config-admin'' + password ''admin'' at Setup/Config Admin Login.
  
 
[[Image:EGW-config-admin-en.png]]
 
[[Image:EGW-config-admin-en.png]]
  
Now you should create the admin-account 'admin' with password itentical to the SME admin account for receiving and sending SME admin emails in eGroupware.
+
Now you should create eGroupWare's admin-account. Because eGroupWare uses mail authentication, the admin-account must be a valid SME account/password. This account will be able to use+administrate eGroupWare.
  
 
[[Image:EGW-create-admin-account-en.png]]
 
[[Image:EGW-create-admin-account-en.png]]
Line 43: Line 66:
  
 
===Changing passwords for eGW config-admin / header-admin===
 
===Changing passwords for eGW config-admin / header-admin===
 
Logon to the SME console with user ''root'' and give this command at a linux-prompt
 
chmod 777 /opt/egroupware/html/header.inc.php
 
 
 
Go to your browser and logon with the user ''header-admin'' + password ''admin'' at Header Admin Login.  
 
Go to your browser and logon with the user ''header-admin'' + password ''admin'' at Header Admin Login.  
  
Line 58: Line 77:
  
 
Store the new passwords with "Write".  
 
Store the new passwords with "Write".  
 
Go another time to your SME console and change the rights to the former values:
 
chown www:www /opt/egroupware/html/header.inc.php
 
chmod 640 /opt/egroupware/html/header.inc.php
 
 
Finally, logout of the SME console.
 
  
 
{{Warning box|For security-reasons, change the passwords for the users ''config-admin'' and ''header-admin'' after your first login !}}
 
{{Warning box|For security-reasons, change the passwords for the users ''config-admin'' and ''header-admin'' after your first login !}}
  
 
===Adjusting accessibility===
 
===Adjusting accessibility===
The default behaviour of eGroupware is accessible from LAN + Internet with "forced https" (SSL on + rewrite rule)
+
The default behaviour of eGroupWare is: accessible from LAN + Internet with "forced https" (SSL on + rewrite rule)
 
You can easily change those defaults settings with following commands:
 
You can easily change those defaults settings with following commands:
 
  # config setprop egroupware HTTPS on
 
  # config setprop egroupware HTTPS on
Line 80: Line 93:
  
 
===Synchronization===
 
===Synchronization===
 
+
eGroupWare provides '''Synchronization of calender, todo's, notes and addressbook''' with offline-clients like MS Outlook and PDA's. Unfortunally there is a requirement for PHP5 to accomplish these functions, which is not implemented in SME 7. But actually it is possible to sync to MS Outlook with the ''xmlrpc'' protocol and the ''eGWOSync'' application.
eGroupware provides '''Synchronization of calender, todo's, notes and addressbook''' with offline-clients like MS Outlook and PDA's. Unfortunally there is a requirement for PHP5 to accomplish these functions, which is not implemented in SME 7. But actually it is possible to sync to MS Outlook with the ''xmlrpc'' protocol and the ''eGWOSync'' application.
 
  
 
====MS Outlook Synchronization====
 
====MS Outlook Synchronization====
 
+
You can sync eGroupWare-Data to MS Outlook as follows:
You can sync eGroupware-Data to MS Outlook as follows:
 
  
 
'''1. Install certificate with MS Internet Explorer'''
 
'''1. Install certificate with MS Internet Explorer'''
Line 153: Line 164:
 
== Additional information ==
 
== Additional information ==
  
*[http://www.egroupware.org Website]
+
*[http://www.egroupware.org Homepage]
 +
*[http://www.egroupware.org/wiki Documentation]
 +
*[http://www.egroupware.org/index.php?page_name=wiki&wikipage=ManualSetupUpdate Howto Update]
 
*[http://forums.contribs.org/index.php?topic=35146.0 thread at contribs.org forum]
 
*[http://forums.contribs.org/index.php?topic=35146.0 thread at contribs.org forum]
 
*[http://forums.contribs.org/index.php?topic=35861.0 thread at contribs.org forum]
 
*[http://forums.contribs.org/index.php?topic=35861.0 thread at contribs.org forum]
  
Have much fun with eGroupware as your preferred Groupware !
+
 
 +
Have much fun with eGroupWare as your preferred Groupware !
  
 
''Dietmar Berteld (berdie)''
 
''Dietmar Berteld (berdie)''

Revision as of 14:23, 21 October 2007


eGroupWare 1.4.002 for SME 7.x and above

Maintainers

Dietmar Berteld
mailto:dietmar@berteld.com

Sylvain Gomez
mailto:sylvaingomez@free.fr

Description

eGroupWare is a free enterprise ready groupware software for your network. It enables you to manage contacts, appointments, todos and many more for your whole business.

eGroupWare is a groupware server. It comes with a native web-interface which allowes to access your data from any platform all over the planet. Moreover you also have the choice to access the eGroupWare server with your favorite groupware client (Kontact, Evolution, Outlook) and also with your mobile or PDA via SyncML.

eGroupWare is international. At the time, it supports more than 25 languages including rtl support.

For more information see http://www.egroupware.org/.

With this RPM you can use eGroupWare on your SME 7.x (and above). You can install it as one single package in a very comfortable way.

Download

You can download this package at smeserver-egroupware . If you would like to save it directly on your SME Server, you should give this command at a linux-prompt

wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/egroupware/smeserver-egroupware-1.4.002-2.noarch.rpm

Installation

For installation just hit the following command

rpm -Uvh smeserver-egroupware-1.4.002-2.noarch.rpm

Update/Upgrade

Warning.png Warning:
Because of a bug in old RPM versions*, YOU MUST UNINSTALL THE OLD RPM BEFORE UPDATING WITH THE FOLLOWING COMMAND:
rpm -e smeserver-egroupware --noscripts

This will prevent installation files and MySQL to be deleted.

* Affected versions are smeserver-egroupware-1.4-10 and older


Then, you can update your existing 1.4 installation with

rpm -Uvh smeserver-egroupware-1.4.002-2.noarch.rpm

If you were upgrading eGroupWare version (i.e.1.4.001 to 1.4.002) you must finish the upgrade at the Config-Admin Setup with your existing creditentials. A backup is done by the RPM before updating. All Files and MySQL DataBase are saved in /opt/eGW_RPM_BACKUP You must move the backup to a safe directory.

This automatic step is just for safety, make your own backup before updating/upgrading.

Uninstallation

For uninstall just hit the following command

rpm -e smeserver-egroupware

In the new release (1.4.002-x), if you want to completly remove eGroupWare from your server, you need the following command:

sh /root/eGW_Full_Uninstall.sh

This will delete eGroupWare's installation files, MySQL DB and SME DB entries.

Starting with eGroupWare

Please perform the Intial Configuration FIRST before login to eGroupWare. After that SME users can login to eGroupWare with their used SME account + password. At first login, eGroupWare creates user accounts and passwords automatically and synchronize them to the SME Server.

Inital Configuration

You can find eGroupWare in the /opt/egroupware directory. For using eGroupWare start your browser with the URL http://servername/egroupware/setup and logon with the user config-admin + password admin at Setup/Config Admin Login.

EGW-config-admin-en.png

Now you should create eGroupWare's admin-account. Because eGroupWare uses mail authentication, the admin-account must be a valid SME account/password. This account will be able to use+administrate eGroupWare.

EGW-create-admin-account-en.png

Logout after creating the admin account.

Changing passwords for eGW config-admin / header-admin

Go to your browser and logon with the user header-admin + password admin at Header Admin Login.

EGW-header-admin-en.png

Change the passwords for the users config-admin and header-adminnow:

EGW-password-config-admin-en.png

EGW-password-header-admin-en.png

Store the new passwords with "Write".


Warning.png Warning:
For security-reasons, change the passwords for the users config-admin and header-admin after your first login !


Adjusting accessibility

The default behaviour of eGroupWare is: accessible from LAN + Internet with "forced https" (SSL on + rewrite rule) You can easily change those defaults settings with following commands:

# config setprop egroupware HTTPS on
# config setprop egroupware HTTPS off
# config setprop egroupware PublicAccess global
# config setprop egroupware PublicAccess local

Once done, apply modifications and restart Apache:

# expand-template /etc/httpd/conf/httpd.conf
# service httpd-e-smith restart

Synchronization

eGroupWare provides Synchronization of calender, todo's, notes and addressbook with offline-clients like MS Outlook and PDA's. Unfortunally there is a requirement for PHP5 to accomplish these functions, which is not implemented in SME 7. But actually it is possible to sync to MS Outlook with the xmlrpc protocol and the eGWOSync application.

MS Outlook Synchronization

You can sync eGroupWare-Data to MS Outlook as follows:

1. Install certificate with MS Internet Explorer

  • Start Internet Explorer
  • Enter URL = https://servername
  • Enter "show certificate"
  • Enter "install certificate" and go on to install your SME certificate
Important.png Note:
Under Vista, you have to put your domain in the approved website list before being able to install the certificate.


2. MS Outlook

  • Finish your MS Outlook if active.
  • Go to system control, register mail.
  • show profiles... -> delete all profiles
  • Start MS Outlook, create a new profile with your mail account

3. eGWOSync

Download eGWOSync and .NET, if necessary. If your .NET release is newer than version 1.x, you must install both versions on your system.

  • You need .NET Version 1.x, eGWOSync accepts no newer versions
  • User/Password = SME user account/password
  • Domain = default
  • Hostname = SME domain
  • Port = 443
  • Use SSL = enabled
  • URL = keep default values
  • Perform test

4. Funambol

Download Web site: Funambol Web Site Download Funambol 6.0.14 link Funambol 6.0.14

                      1) Install Funambol 6.0.14
                      2) Change "7" to "0" for mbstring.func_overload = 0 in php.ini 
                      3) Open Outlook go to the Funambol Setup (Funambol --> Option)
                      4) Select all items
                      5) Setup options:

ACCOUNT

     Location = http://Domain Name/egroupware/rpc.php or http://Server IP/egroupware/rpc.php
     Username = Your user login name for eGroupWare
     Password = Your user password for eGroupWare

SYNC

     CONTACTS
     Sync Direction = Two-Way
     Remote name = ./sifcontacts
     Data Format = SIF
     CALENDAR
     Sync Direction = Two-Way
     Remote name = calendar
     Data Format = vCalendar
     TASKS
     Sync Direction = Two-Way
     Remote name = ./siftasks
     Data Format = SIF
     NOTES
     Sync Direction = Two-Way
     Remote name = ./sifnotes
     Data Format = SIF

--Snoopyski 19:04, 20 September 2007 (MDT)

Additional information


Have much fun with eGroupWare as your preferred Groupware !

Dietmar Berteld (berdie)