mirror of
https://github.com/EGroupware/egroupware.git
synced 2024-11-21 23:43:17 +01:00
Created 20.1 Release notes and distribution specific instructions (markdown)
Ralf Becker
parent
0ba7d96cb0
commit
4168ec8c00
158
20.1-Release-notes-and-distribution-specific-instructions.md
Normal file
158
20.1-Release-notes-and-distribution-specific-instructions.md
Normal file
@ -0,0 +1,158 @@
|
||||
|
||||
|
||||
> Please read the [general 20.1 Installation](https://github.com/EGroupware/egroupware/wiki/20.1--Installation-using-egroupware-docker-RPM-DEB-package) instructions first, they are not repeated here again!
|
||||
|
||||
## How to install EGroupware GmbH's EPL version
|
||||
> If you update or install EPL, you have to install the Community Edition first!
|
||||
|
||||
The update described below will remove the EPL packages, of cause leaving your data intact.
|
||||
To install the EPL source / run the EPL container you need your download.egroupware.org credentials and run the following command:
|
||||
```
|
||||
/etc/egroupware-docker/use-epl.sh
|
||||
```
|
||||
It will ask your EPL repo credentials, add them and the EPL image to your docker-compose.yml file and start the EPL container.
|
||||
|
||||
# Ubuntu 20.04, 18.04 & 16.04 or Debian 10
|
||||
For new installations or updating from EPL you need to add our server:eGroupWare repo first:
|
||||
```
|
||||
echo 'deb http://download.opensuse.org/repositories/server:/eGroupWare/xUbuntu_20.04/ /' | sudo tee /etc/apt/sources.list.d/server:eGroupWare.list
|
||||
sudo apt install gnupg # required, but not installed by apt-key add for Debian 10
|
||||
wget -nv https://download.opensuse.org/repositories/server:eGroupWare/xUbuntu_20.04/Release.key -O - | sudo apt-key add -
|
||||
sudo apt update
|
||||
```
|
||||
For Ubuntu 18.04 the docker.service must be enable manually to automatic start at system start:
|
||||
`sudo systemctl enable docker.service`
|
||||
|
||||
> For Ubuntu 18.04 or 16.04 please replace in the above instructions "xUbuntu_20.04" with "xUbuntu_18.04" or "xUbuntu_16.04", for Debian 10 use "Debian_10".
|
||||
|
||||
Then you need to run for new installations as well as **upgrades from before 19.1** explicitly (```apt upgrade``` alone is not sufficient!):
|
||||
```
|
||||
sudo apt-get install egroupware-docker
|
||||
```
|
||||
|
||||
> If you prefer to use Apache on the host ***for a new installation***, you can do so by adding ***apache2*** to the install command above. This is not supported for an upgrade!
|
||||
|
||||
> Our Ubuntu package recommends Collabora Online Office, which mean they will be installed by default, unless you opt out by using ```--no-install-recommends``` in the above ```apt-get``` command. Of cause you can always deinstall them after testing, if you prefer to use something else.
|
||||
|
||||
> Ubuntu 16.04 does not provide a docker-compose package/command, therefore we provide one in our repository.
|
||||
|
||||
# Debian 9
|
||||
Debian 9 does NOT contain a docker.io package. You can use Docker CE [by following this instructions](https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-debian-9), or the short version here:
|
||||
```
|
||||
apt update
|
||||
apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common
|
||||
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
|
||||
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
|
||||
apt update
|
||||
apt install docker-ce
|
||||
# due to known bug docker-ce wont start unless you reboot the maschine
|
||||
reboot
|
||||
```
|
||||
Please verify that docker is running, after the reboot, our installation will not run without:
|
||||
```
|
||||
systemctl status docker
|
||||
```
|
||||
Now you can follow the Ubuntu/Debian instructions above using "Debian_9.0" instead of "xUbuntu_18.04".
|
||||
|
||||
> Even as Debian 9 does not provide a docker package, it provides a too old docker-compose package/command, therefore we provide a current one in our repository.
|
||||
|
||||
# openSUSE 15.2, 15.1 & 15.0 or SLES 15 & 12
|
||||
> If you have automatic updates enabled or run ```zypper update``` manually update to 20.1 will happen automatic!
|
||||
|
||||
For new installations or updating from EPL you need to add our server:eGroupWare repo first:
|
||||
```
|
||||
zypper addrepo https://download.opensuse.org/repositories/server:eGroupWare/openSUSE_Leap_15.2/server:eGroupWare.repo
|
||||
```
|
||||
> For openSUSE 15.0 or 15.1 please replace in the above instructions "openSUSE_Leap_15.2" with "openSUSE_Leap_15.1" or "openSUSE_Leap_15.0", for SLES use "SLE_15" or "SLE_12".
|
||||
|
||||
Then you need to run for new installations or updating EPL:
|
||||
```
|
||||
zypper refresh
|
||||
zypper install egroupware-docker
|
||||
```
|
||||
or to update an existing installation
|
||||
```
|
||||
zypper update
|
||||
```
|
||||
> Our SUSE packages recommends Collabora Online Office, which mean they will be installed by default, unless you opt out by using ```--no-recommends``` in the above ```zypper``` command. Of cause you can always deinstall them after testing, if you prefer to use something else.
|
||||
|
||||
> SLES does not provide a docker-compose package/command, therefore we provide one in our repository.
|
||||
|
||||
# RHEL or CentOS 7
|
||||
> If you have automatic updates enabled or run ```yum update``` manually, the update to 20.1 will happen automatic!
|
||||
|
||||
> RHEL/CentOS 7 have SELinux enabled by default, which stops MariaDB/MySQL socket bind-mounted into the container from working. **You currently need to switch SELinux off in order to use EGroupware!**
|
||||
> To do so temporary run ```setenforce 0``` to permanently switch it off edit /etc/sysconfig/selinux, set ```SELINUX=disabled``` and reboot.
|
||||
|
||||
> RHEL/CentOS 7 has a firewall enabled by default which do NOT allow to access the webserver!
|
||||
|
||||
To enable http(s) access in the default firewall run the following commands:
|
||||
```
|
||||
firewall-cmd --add-service=http --permanent
|
||||
firewall-cmd --add-service=https --permanent
|
||||
firewall-cmd --reload
|
||||
```
|
||||
For new installations or updating from EPL you need to add our server:eGroupWare repo first:
|
||||
```
|
||||
cd /etc/yum.repos.d/
|
||||
wget https://download.opensuse.org/repositories/server:eGroupWare/RHEL_7/server:eGroupWare.repo
|
||||
```
|
||||
Then you need to run for a new installations:
|
||||
```
|
||||
yum install mariadb-server
|
||||
systemctl enable mariadb
|
||||
systemctl start mariadb
|
||||
yum install egroupware-docker egroupware-collabora-key egroupware-rocketchat
|
||||
```
|
||||
> It is important that MariaDB runs, before you attempt to install EGroupware!
|
||||
|
||||
or updating EPL:
|
||||
```
|
||||
yum install egroupware-docker
|
||||
```
|
||||
or to update an existing (non-EPL) installation:
|
||||
```
|
||||
yum update
|
||||
```
|
||||
> RHEL/CentOS does not provide a docker-compose package/command, therefore we provide one in our repository.
|
||||
|
||||
# RHEL or CentOS 8
|
||||
> RHEL/CentOS 8 uses nftables instead of iptables, which does not work with current docker-ce. You need to configure firewalld to use iptables by editing /etc/firewalld/firewalld.conf:
|
||||
```
|
||||
#FirewallBackend=nftables
|
||||
FirewallBackend=iptables
|
||||
systemctl restart firewalld
|
||||
```
|
||||
|
||||
> RHEL/CentOS 8 has no docker package (it uses it's own replacement podman instead). To install docker-CE run the following commands
|
||||
```
|
||||
curl https://download.docker.com/linux/centos/docker-ce.repo -o /etc/yum.repos.d/docker-ce.repo
|
||||
yum install --nobest docker-ce
|
||||
systemctl enable --now docker
|
||||
```
|
||||
From their on you can follow the RHEL/CentOS 7 instructions above, replacing RHEL_7 in the repo-url with CentOS_8.
|
||||
|
||||
# Univention
|
||||
|
||||
> EGroupware 20.1 is available via the Unvention App Center, thought there are a couple of requirements
|
||||
|
||||
* UCS 4.4-2 is required
|
||||
* if the server was installed before UCS 4.3 and updated, you have to [manually enable the memberOf overlay](https://help.univention.com/t/memberof-attribute-group-memberships-of-user-and-computer-objects/6439)
|
||||
* if you use EGroupware on a slave, you need to use the ldap from the master (is set automatic for new installations)
|
||||
|
||||
# PostgreSQL
|
||||
> EGroupware does NOT (yet) support PostgreSQL 12, you have to use version 11 or below!
|
||||
|
||||
> Keep in mind, that you can NOT use ```localhost``` to address a service eg. PostgreSQL inside the container, as it does NOT refer to the host, but the container itself. You have to use the IP address of the host or the docker0 bridge AND make sure the service is not just bound to localhost!
|
||||
|
||||
While an update of a PostgreSQL instance works similar to MariaDB/MySQL, a new installation does not happen automatic!
|
||||
1. Edit /etc/egroupware-docker/docker-compose.override.yml, uncomment the [environment section](https://github.com/EGroupware/build.opensuse.org/blob/master/server:eGroupWare/egroupware-docker-20.1/egroupware-docker/docker-compose.override.yml#L51) and add the following:
|
||||
```
|
||||
- EGW_SKIP_INSTALL=true
|
||||
```
|
||||
2. remove the header.inc.php, so EGW_SKIP_INSTALL takes effect
|
||||
```
|
||||
rm -f /var/lib/egroupware/header.inc.php
|
||||
```
|
||||
3. start the containers as usual with: ```docker-compose up -d```
|
||||
4. Go to http://example.org/egroupware/setup/ and do a manual installation
|
||||
Loading…
Reference in New Issue
Block a user