extern/egroupware_official
1
0
Fork 0
mirror of https://github.com/EGroupware/egroupware.git synced 2025-08-09 07:15:04 +02:00
Code Issues Packages Projects Releases Wiki Activity

Updated EGroupware Community Edition Installation (markdown)

Hadi Nategh
2016-11-02 11:07:36 +01:00
parent 9db1e37187
commit 8ecb6f01d5
1 changed files with 45 additions and 57 deletions
Download Patch File Download Diff File Expand all files Collapse all files

102
EGroupware-Community-Edition-Installation.md

@ -1,29 +1,29 @@
<a id="I">
### Content
</a>
Content
=======
* [Short Overview](#short-overview)
* [What do I need to backup, if I have a already running EGroupware Installation](#K2)
* [Installation](#K3)
* [What do I need to backup, if I have a already running EGroupware Installation](#what-do-i-need-to-backup-if-i-have-a-already-running-egroupware-installation)
* [Installation](#installation)
* [RedHat and CentOS](#K4)
* [SuSE (SLES and OpenSuSE)](#K5)
* [Debian](#K6)
* [Ubuntu](#K7)
* [RedHat and CentOS](#redhat-and-centos)
* [SuSE (SLES and OpenSuSE)](#suse-sles-and-opensuse)
* [Debian](#debian)
* [Ubuntu](#ubuntu)
* [MySQL and PHP adjustments](#K8)
* [Setup SSL (https) access to your EGroupware](#K9)
* [Keeping your Installation up to date](#K10)
* [MySQL and PHP adjustments](#mysql-and-php-adjustments)
* [Setup SSL (https) access to your EGroupware](#setup-ssl-https-access-to-your-egroupware)
* [Keeping your Installation up to date](#keeping-your-installation-up-to-date)
* * *
<a id="K1">
Short Overview
==============
</a>
The application EGroupware is external represented by a central webserver. A standard webbrowser is used as client. Therefore the application EGroupware is universal available.
@ -48,11 +48,9 @@ With the provision of the Community Edition repositories for various Linux distr
* an update / install with the shell command installer of your distribution
* if possible and wanted a differing configuration from the standard installation defaults
<a id="K2">
### What do I need to backup, if I have a already running EGroupware Installation
</a>
What do I need to backup, if I have a already running EGroupware Installation
=============================================================================
Before you begin to update an already in use EGroupware installation, you should do a backup of the following:
@ -68,11 +66,9 @@ The default directory of the above files and backup directories is: /var/lib/egr
After the installation you will need to restore and migrate the saved database backup using EGroupware setup. You may need to add/change your egroupware database password in /var/lib/egroupware/header.inc.php. The variables you need to change are: db_user and db_pass.
<a id="K3">
### Installation
</a>
Installation
============
For any Linux distribution the installation steps has to be done as user _root_ and with root rights in a terminal session.
@ -80,13 +76,13 @@ Please consider that your network and firewall on your server is configured to a
Help on commands used through the installation process is always available on your system in kind of the manual pages - _man commandname_ -, by entering the command with option _-h_ or _--help_ or entering the command without any options, which show usually a brief usage info of the command.
_back to [Content](#I)_
_back to [Content](#content)_
<a id="K4">
#### RedHat and CentOS
</a>
RedHat and CentOS
-----------------
<table border="1">
@ -217,13 +213,11 @@ If errors occur during the installation you will find hints and error descriptio
According to your requirements and the amount of users using your installation the mysql database system and php may need adjustments. Details are specified in chapter [MySQL and PHP adjustments](#K8).
_back to [Content](#I)_
_back to [Content](#content)_
<a id="K5">
#### SuSE (SLES and OpenSuSE)
</a>
SuSE (SLES and OpenSuSE)
------------------------
<table border="1">
@ -241,7 +235,8 @@ _back to [Content](#I)_
</table>
#### Installation on OpenSUSE
Installation on OpenSUSE
------------------------
_EGroupware installation:_
@ -269,8 +264,8 @@ If errors occur during the installation you will find hints and error descriptio
According to your requirements and the amount of users using your installation the mysql database system and php may need adjustments. Details are specified in chapter [MySQL and PHP adjustments](#K8).
#### Installation on SLES
Installation on SLES
--------------------
_EGroupware installation:_
In your Webbrowser go to following Website: [RPM packages from openSUSE buildservice](http://software.opensuse.org/download.html?project=server%3AeGroupWare&package=egroupware-epl)
@ -319,13 +314,12 @@ If errors occur during the installation you will find hints and error descriptio
According to your requirements and the amount of users using your installation the mysql database system and php may need adjustments. Details are specified in chapter [MySQL and PHP adjustments](#K8).
_back to [Content](#I)_
_back to [Content](#content)_
<a id="K6">
#### Debian
Debian
------
</a>
<table border="1">
@ -369,13 +363,12 @@ If errors occur during the installation you will find hints and error descriptio
According to your requirements and the amount of users using your installation the mysql database system and php may need adjustments. Details are specified in chapter [MySQL and PHP adjustments](#K8).
_back to [Content](#I)_
_back to [Content](#content)_
<a id="K7">
#### Ubuntu
Ubuntu
------
</a>
<table border="1">
@ -419,13 +412,12 @@ If errors occur during the installation you will find hints and error descriptio
According to your requirements and the amount of users using your installation the mysql database system and php may need adjustments. Details are specified in chapter [MySQL and PHP adjustments](#K8).
_back to [Content](#I)_
_back to [Content](#content)_
<a id="K8">
### MySQL and PHP adjustments
</a>
MySQL and PHP adjustments
-------------------------
Example Configurations for MySQL respectively Maria DB can be found under the directory /usr/share of your server. Those can be copied as my.cnf for MySQL or server.cnf for Maria DB to directory /etc. To find them enter:
@ -461,13 +453,11 @@ _php_value upload_max_filesize_ will determine the size of files users will be a
_php_value session.gc_maxlifetime_ determine the time in seconds of inactivity before a user session will be terminated.
_back to [Content](#I)_
_back to [Content](#content)_
<a id="K9">
### Setup SSL (https) access to your EGroupware
</a>
Setup SSL (https) access to your EGroupware
-------------------------------------------
If you are accessing your EGroupware from the internet, it should be only done encrypted via ssl - https. Port 80 should be disabled and port 443 as default enabled in the web server and as well in your firewall.
@ -509,13 +499,11 @@ SSLCertificateChainFile /<your directory path>/CA.crt
After a restart/reload of your webserver the browser should now show a valid certificate of your certificate provider while accessing your EGroupware URL.
_back to [Content](#I)_
_back to [Content](#content)_
<a id="K10">
### Keeping your Installation up to date
</a>
Keeping your Installation up to date
====================================
It is good practice to update your system regularly with patches and security fixes. We recommend to do it once per week.
@ -554,4 +542,4 @@ Automatic update: Using a cron script or cron-apt; have a look at: [https://help
* * *
_back to [Content](#I)_
_back to [Content](#content)_