Skip to content

CentOS Installation#

Overview#

Single-node Gluu Server Linux packages are available for CentOS 8 and 7. Follow the instructions below:

  1. Install the Linux package
  2. Start the Server and log in to the container
  3. Run the setup script
  4. Sign in via browser
  5. Disable Gluu repositories

Attention

To upgrade an existing Gluu Server installation, follow the upgrade guide.

Prerequisites#

  • Make sure the target server or VM meets all minimum requirements specified in the VM Preparation Guide.

  • SELinux must be set to permissive in /etc/selinux/config

Instructions#

Install the package#

The Gluu Server will create its file system under /root/ and will be installed under /opt. File size and minimum requirements remain the same as the host.

For CentOS 8, run the following commands to install:

wget https://repo.gluu.org/centos/Gluu-centos-8.repo -O /etc/yum.repos.d/Gluu.repo
wget https://repo.gluu.org/centos/RPM-GPG-KEY-GLUU -O /etc/pki/rpm-gpg/RPM-GPG-KEY-GLUU
rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-GLUU
yum clean all
yum install gluu-server-4.3.1-centos8.x86_64.rpm

After installation, the gluu-server package needs to be excluded from automatic updates with the following command.

yum versionlock gluu-server
Inside chroot, there is a bug in Centos 7 package. That causes /sbin/gluu-serverd login command to fail. For that we need to run below additional command to change the permissions of private key files.

chmod 600  /opt/gluu_server/etc/ssh/ssh_host_*_key

For CentOS 7, run the following commands to install:

wget https://repo.gluu.org/centos/Gluu-centos-7.repo -O /etc/yum.repos.d/Gluu.repo
wget https://repo.gluu.org/centos/RPM-GPG-KEY-GLUU -O /etc/pki/rpm-gpg/RPM-GPG-KEY-GLUU
rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-GLUU
yum clean all
yum install gluu-server-4.3.1-centos7.x86_64.rpm

After installation, the gluu-server package needs to be excluded from automatic updates with the following command.

yum versionlock gluu-server

Start the server and log in#

The Gluu Server is a chroot container, which must be started to proceed.

Run the following commands:

/sbin/gluu-serverd enable
/sbin/gluu-serverd start
/sbin/gluu-serverd login

Run the setup script#

Configuration is completed by running the setup script from inside the chroot container. This generates certificates, salt values, and renders configuration files. Run the script with the following commands:

cd /install/community-edition-setup
./setup.py

See the Setup Script Documentation for more detail on setup script options.

Sign in via browser#

Wait about 10 minutes in total for the server to restart and finalize its configuration. After that period, sign in via a web browser. The username will be admin and your password will be the ldap_password you provided during installation.

Note

If the Gluu Server login page does not appear, confirm that port 443 is open in the VM. If it is not open, open port 443 and try to reach the host in the browser again.

Disable Gluu Repositories#

To prevent involuntary overwrites of the currently deployed instance (in case a newer version of the same package is found during regular OS updates), disable the previously added Gluu repositories after initial installation.

Edit /etc/yum.repos.d/Gluu.repo so that the enabled=1 clause is changed to enabled=0

Note

The Gluu Server does not support package updates/upgrades via Linux package management (i.e. using commands like # yum update or # apt-get update). For upgrade instructions, see the upgrade docs.

Backups#

Sometimes things go wrong! It can be difficult to troubleshoot issues if the steps to reproduce the issue are not clearly documented. This is why we always recommend creating backups of your Gluu Server.

Uninstallation#

Run the following commands:

/sbin/gluu-serverd disable
/sbin/gluu-serverd stop
yum remove gluu-server 
rm -rf /opt/gluu-server.save

Note

apt-get purge gluu-server or apt-get remove --purge gluu-server can also be used to uninstall and remove all the folders and services of the Gluu Server. Make sure to back up ALL directories of /opt into other direction (tmp or root directory itself) before running the purge command.

Support#

Please review the Gluu support portal. There are many existing tickets about troubleshooting installation issues. If there is no similar existing public issue, register for an account and open a new ticket.

If your organization needs guaranteed responses, SLAs, and priority access to the Gluu support and development team, consider purchasing one of our VIP support contracts.