To convert an existing grommunio installation, installed with the community repository to a supported edition, a suitable license and some work is necessary. The update procedure is described below.
There are usually two options how the license data is delivered:
- First option, the license data (Username and Password) are printed on the invoice, in this case you receive the invoice and a ZIP archive containing the certificate.
- Second option, you receive a invoice and a ZIP archive containing a text file (*.txt) with the license data and the certificate.
The certificate like: grommunio_TTTTT_Subscription_UUU_YYYY_MM_DD.crt
is used to increase the user/mailbox limit.
The Username and Password is used to log on to the supported repository and download the updates.
Four steps are necessary for the conversion to the Supported Edition:
1. Import the certificate to increase the user/mailbox limit
In the Admin UI, upper right corner, click on the certificate ICON, click UPLOAD, select the certificate and upload it.
Now you can edit the number of licensed users/mailboxes.
Hint:
It is possible to continue using the community repository if you want to get the latest updates, stop at this point or switch to the more stable supported repository and continue with 2. step.
2. Switch to the supported repository, enter Username and Password in the repository/credentials file
- Connect via SSH like Putty to the grommunio server
- For most commands you may copy and paste the command to the grommunio server
Instructions for Open-SuSE:
Optional, document the currently installed packages:
rpm -qa | sort > /root/community_edition.txt
For Open-SuSE edit the file: /etc/zypp/repos.d/grommunio.repo
Please note:
Sample repository file if only the community repository is used:
[grommunio]
enabled=1
autorefresh=1
baseurl=https://download.grommunio.com/community/packages/openSUSE_Leap_15.5/?ssl_verify=no
type=rpm-md
keeppackages=0
To change the repository to the supported repository:
- copy the
baseurl=...
line
- change
community
to supported
- insert the Username and Password, add
UUUUUUUUUUU:PPPPPPPPPPP@
between https://
and download.grommunio...
- the community repository has to be remarked.
The sample repository file adapted in this way looks as follows:
[grommunio]
enabled=1
autorefresh=1
# community repository
# baseurl=https://download.grommunio.com/community/openSUSE_Leap_15.5/?ssl_verify=no
# supported repository
baseurl=https://UUUUUUUUUUU:PPPPPPPPPPP@download.grommunio.com/supported/openSUSE_Leap_15.5/?ssl_verify=no
type=rpm-md
keeppackages=0
Instructions for Debian:
Optional, document the currently installed packages:
dpkg -l | sort > /root/community_edition.txt
For Debian edit the file: /etc/apt/sources.list.d/grommunio.sources
Sample repository file if only the community repository is used:
Types: deb
Signed-By: /usr/share/keyrings/RPM-GPG-KEY-grommunio.gpg
URIs: https://download.grommunio.com/community/Debian_11/
Suites: Debian_11
Components: main
To change the repository to the supported repository:
- copy the
URIs: ...
line
- change
community
to supported
- the community repository has to be remarked
The sample repository file adjusted in this way looks like the following:
Types: deb
Signed-By: /usr/share/keyrings/RPM-GPG-KEY-grommunio.gpg
# community repository
# URIs: https://download.grommunio.com/community/Debian_11/
# supported repository
URIs: https://download.grommunio.com/supported/Debian_11/
Suites: Debian_11
Components: main
- create the credentials file
/etc/apt/auth.conf.d/grommunio.conf
with content:
machine download.grommunio.com
login UUUUUUUUUUU
password PPPPPPPPPPP
Thanks to @crpb.
Hint:
UUUUUUUUU
is the Username from the license file or invoice.
PPPPPPPPP
is the Password from the license file or invoice.
Hint:
It is also possible to switch between the repositories. To switch back to the community repository, remark the supported repository and activate the community repository and then perform a distribution upgrade with reboot, as described below.
3. Change the repository, a distribution upgrade is necessary
This is done on the command line, the steps are:
- refresh the repositories,
- run the distribution upgrade and
- reboot the server to finish the upgrade.
It is extremely important that a distribution upgrade is performed! Only a distribution upgrade will install all packages in the repository, possibly some packages will be downgraded.
Distribution upgrade for Open-SuSE:
zypper ref -f
zypper dup
Distribution upgrade for Debian:
apt update
apt dist-upgrade
4. Reboot the server to finish the update
Now wait about 5 minutes until the databases have been updated in the background (some updates perform a database update), and restart the server with
init 6
Optional, document the newly installed packages:
Instructions for Open-SuSE:
rpm -qa | sort > /root/supported_edition.txt
Instructions for Debian:
dpkg -l | sort > /root/supported_edition.txt
Optional, compare installed package versions:
If needed, we may compare the package version numbers with:
vim -d /root/community_edition.txt /root/supported_edition.txt
or use diff to compare the package version numbers:
diff /root/community_edition.txt /root/supported_edition.txt
5. After the reboot the conversion to the supported edition is finished.
Enjoy grommunio