CentOS 7 Installation Guide
Installing Gluu Server
Download and install Gluu Server by the following commands. Use the
.rpm installation to perform a base chroot installation with the
following Gluu Server Base CentOS requirements.
As an alternative, use our Gluu repository for CentOS 7:
# wget https://repo.gluu.org/centos/Gluu-centos7.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-22.214.171.124
Note: It is recommended to copy and paste the commands to avoid errors and issue
Configuring Gluu Server
After both the retrieval, and the installation of the Gluu Server software package start the Gluu Server, and login into the local chroot environment to configure the Gluu Server.
Below are the steps to configure Gluu Server:
- Start the Gluu Server
- Login into local chroot environment to configure Gluu Server. 3. Navigate or change to community-edition-setup directory where setup.py script is located. 4. Run setup.py to configure the Gluu Server.
Below are the following commands:
# /sbin/gluu-serverd-126.96.36.199 start # /sbin/gluu-serverd-188.8.131.52 enable # /sbin/gluu-serverd-184.108.40.206 login # cd /install/community-edition-setup/ #./setup.py
setup.py script will bring up a prompt to provide information for certificate. It is recommened to use
hostname.domain structure for hostname and refrain from using
for IP address. After the successful execution of
setup.py script, login to oxTrust,
the policy administration point for Gluu.
Access the oxtrust UI from the local browser using
https://hostname.domain, which was provided during the configuration. And the uri will be mentioned at the end of successful configuration.
For both help and the latest installation options see either setup.py help, or run
If resolvable DNS host is not used, add the hostname to your hosts file on the server or the system where the oxtrust UI is accessed. Login with the default user name “admin” and the password used in
the configuration (also contained in
setup.properties.last use the
grep --color -i pass to find the according line quickly)
and look for the LDAP password which is the same as the admin password.
Make sure to remove or encrypt
setup.properties.last It has the clear
text passwords for everything: LDAP, admin user, keystores, and 3DES salt.
Logs can be analyzed for installation errors in
setup.log for a detailed step-by-step analysis
of the installation. As an alternative check the file
setup_errors.log to just see the errors (or stderr output from the
Removing/disabling Gluu repo
After initial installation is completed, it's recommended to remove Gluu
repos from sources list, to avoid accidental upgrade of the Gluu package by conducting regular system's update procedures (like, by running
# yum update)
/etc/yum.repos.d/Gluu.repo file, or modify it setting
"enabled" property to "0" for Gluu CE repos there.
Starting and Stopping the Gluu Server
To start the Gluu Server use the below command:
# /sbin/gluu-serverd-220.127.116.11 start
To stop the Gluu Server use the below command:
# /sbin/gluu-serverd-18.104.22.168 stop
To check the Gluu Server status use the below command:
# /sbin/gluu-serverd-22.214.171.124 status
Login to the chroot environment
# /sbin/gluu-serverd-126.96.36.199 login
Below are the steps to script the installation of the Gluu Server:
- Save and backup your existing file
- Uninstall existing Gluu Server installation.
- For a new installation you can either grab a new VM, or just use the existing one.
- Run all the commands until
# /sbin/gluu-serverd-188.8.131.52 login.
- Copy your file
setup.properties.lastinto the new server's
- Rename the file
- Run the setup script with
Step by Step instructions to uninstall Gluu Server:
1. Exit from the chroot environment to main linux, by entering Logout command. 2. Stop the Gluu Server chroot environment which will unmount all chroot directories. 3. Delete both the Gluu Server packages that are installed, and the home directory of the Gluu Server user.
# /sbin/gluu-serverd-184.108.40.206 stop # yum remove gluu-server-220.127.116.11 # rm -rf /opt/gluu-server-18.104.22.168*
During an installation, any modified files will be saved in the directory,
/opt/gluu-server24.save. If required to remove all the remnants of the installation, delete these files with the command `rm -
Gluu offers both community and VIP support. Anyone can browse and open tickets on our support portal. For private support, expedited assistance, and strategic consultations, please view our pricing and schedule a meeting with us to discuss VIP support options.