extern/egroupware_official
1
0
Fork 0
mirror of https://github.com/EGroupware/egroupware.git synced 2024-11-24 17:04:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

starting 20.1 release notes

Ralf Becker 2020-06-17 16:40:46 +02:00
parent 2f2ebdd383
commit b699027903
1 changed files with 49 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
20.1--Installation-using-egroupware-docker-RPM-DEB-package.md Normal file

@ -0,0 +1,49 @@
> 20.1 is still in a beta state, so make proper backup, before updating any essential installations
## Major differences from a 19.1 installation
* push server in an additional **egroupware-push** container, allowing instant updates without polling
* new installations use MariaDB 10.4 in an additional **egroupware-db** container (19.1 updates keep using the database on the host)
* new installations use Nginx as webserver/proxy on the host by default, unless you specify explicitly to use Apache2
* modifications to docker-compose file are now kept in a separate docker-compose.override.yml to ease updates
* EGroupware now uses TypeScript instead of plain JavaScript to ease client-side development
### 20.1 packages are currently available only in a special repository
The following example is for Ubuntu 20.04 (replace ```20.04``` with ```18.04``` or ```16.04```, or ```xUbuntu_20.04``` with ```Debian_10```):
> For CentOS, RHEL, openSUSE or SLES [follow the 19.1 instructions](https://github.com/EGroupware/egroupware/wiki/19.1-Release-notes-and-distribution-specific-instructions/_edit#opensuse-151--150-or-sles-15--12) replacing ```server:eGroupWare``` with ```server:eGroupWare:/trunk``` in the repository
```
sudo sh -c "echo 'deb http://download.opensuse.org/repositories/server:/eGroupWare:/trunk/xUbuntu_20.04/ /' > /etc/apt/sources.list.d/server:eGroupWare:trunk.list"
sudo apt-get install gnupg # required for Debian 10 to use apt-key add
wget -nv https://download.opensuse.org/repositories/server:eGroupWare:/trunk/xUbuntu_20.04/Release.key -O - | \
sudo apt-key add -
apt update
```
### To upgrade in place from 19.1
```
apt upgrade
```
> Use the default to NOT replace config-files, if you are asked. The update script takes care of all necessary changes!
### For a new 20.1 installation
```
apt install egroupware-docker
```
> If you prefer to use Apache2 on the host as proxy, add ```apache2``` to the above install command.
It will create (or update) the following files in /etc/egroupware-docker:
* **nginx.conf** config for using Nginx as proxy on the host, symlinked to /etc/nginx/conf.d/egroupware.conf
* **apache.conf** config for using Apache2 on the host, symlinked to /etc/apache2/sites-{enabled,avalable}/egroupware.conf
* **docker-compose.override.yml** for local modifications with many commented out examples (contains your 19.1 docker-compose.yml in case of an update!)
* **.env** contains root password of MariaDB container
* **mariadb.cnf** file to overfide MariaDB configuration in the container
* **docker-compose.yml**, **latest-*.yml** or **create-override.sh** **do NOT modify!**
* **use-epl.sh** script to update to EPL (EGroupware GmbH subscription version)
* **egroupware-logs.sh** tail EGroupware's error-log
> This currently brief information will receive more updates in the next weeks. In the meantime most of the 19.1 documentation is valid for 20.1 too.