Skip to content

Gluu Server Update Package#

Attention

The official support end-of-life (EOL) date for Gluu Server 2.4.4 is December 31, 2018. Starting January 1, 2019, no further security updates or bug-fixes will be provided for Gluu Server 2.X. We strongly recommend upgrading to the newest version.

Gluu Server update packages are released to fix urgent issues, with low impact on deployment. Normally these involve updates to the java code, effected replacing the war file. These are installed using yum or apt-get command.

Check version of installed Gluu CE server.#

  • Version of the server can be found from the name of the installed home Gluu directory
  • Below is an alternate method to determine the version of the installed CE server

oxTrust version: cat /opt/tomcat/webapps/identity/META-INF/MANIFEST.MF oxAuth version: cat /opt/tomcat/webapps/oxauth/META-INF/MANIFEST.MF

image

Backup#

It is highly recommended to stop the Gluu Server, and tar folder /opt/gluu-server-2.4.4 to ensure speedy recovery from any unexpected hiccup. If the organization has any other contingency plans, that is ok too.

Warning

Please make sure that there is enough disk space to tar the entire Gluu Server, at least 4GB of Disk Space is recommended.

Use the following commands to tar the Gluu Server folder from the host OS:

# service gluu-server-2.4.4 stop
# tar cvf gluu244-backup.tar /opt/gluu-server-2.4.4/

Enable Gluu Repositories#

If, during installation, you disabled the Gluu repositories to avoid involuntary overwrite, you need to enable them before you can get the update package. Do the following to enable them:

  • CentOS 6.x/7.2, RHEL 6/7:

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

  • Ubuntu Server 14.04/16.04, Debian 8:

/etc/apt/sources.list.d/gluu-repo.list needs to be edited to uncomment the Gluu-related repos.

Install Update Package#

Gluu Server update packages are available from the Gluu Repository. Make sure to stop Gluu Server before installing and finalizing the update package. Gluu-updater package will pull latest Service Pack, as for example 'gluu-updater-2.4.4' will pull SP3 ( Service Pack 3 ).

  • CentOS 6.x/7.2, RHEL 6/7: 
# yum update
# /sbin/gluu-serverd-2.4.4 stop
# yum install gluu-updater-2.4.4
  • Ubuntu Server 14.04/16.04, Debian 8: 
# apt-get update
# service gluu-server-2.4.4 stop
# apt-get install gluu-updater-2.4.4

After the update package is installed, use the following commands to finalize the installation by running the update script. 

# service gluu-server-2.4.4 start
# service gluu-server-2.4.4 login
# cd /opt/upd/2.4.4.sp2/bin
# ./update_system.sh
# ./update_ldap.sh
# ./update_opendj.sh
# ./update_war.sh

Upon successful update, check the version again to confirm on the update.

Note

It is recommended to wait for few minutes while the changes take place and Gluu Server CE can be used.