Preparing VM for Gluu Server Installation#
Thank you for your interest in the Gluu Server! This document will provide instructions for preparing your VM for a standard Gluu Server deployment. Once the server is ready, move on to the installation instructions.
Good luck and welcome to the community!
To learn more about software licenses, use cases, and more, visit the docs homepage
The Gluu Server needs to be deployed on a server or VM with the following minimum requirements.
|CPU Unit||RAM||Disk Space||Processor Type|
If you plan on installing more than the default components (i.e. oxAuth, oxTrust, and LDAP), we recommend using a machine with at least 8GB of RAM.
Want to try our newly released "Docker Edition"? Head over to the docker edition docs
Gluu must be deployed on a server or VM with a static IP Address. The static IP address should resolve to a computer hostname which can be achieved by adding an entry to the DNS server or in
Supported Operating Systems#
Deploy Gluu on a server or VM with one of the following supported operating systems:
- Ubuntu 14.04, 16.04
- CentOS 6.x, 7.x
- RHEL 6.x, 7.x
- Debian 8
The following ports are open to the Internet by default.
|80||tcp||Forwards to 443|
See the operations guide for a list of internal ports used by Gluu Server components (e.g. oxAuth, oxTrust, etc.).
The Gluu Server requires setting the
file descriptors to 65k.
Follow these steps or research how to do this on your Linux platform.
- Add the following lines in the
* soft nofile 65536 * hard nofile 262144
Add the following lines to
/etc/pam.d/loginif not already present.
session required pam_limits.so
Increase the FD limit to 65535. The system file limit is set in
It is recommended to check the FD limit before increasing it, and if this limit is customized and more than default, we recommend using the higher one. The FD limit can be found using the below command.
Please note, the command may vary depending on the OS flavor used.
# cat /proc/sys/fs/file-max
* Use the
echo 65535 > /proc/sys/fs/file-max**
ulimitcommand to set the FD limit to the hard limit specified in
ulimit -n unlimited
Centos by default will not accept more than the default maximum of 65535. You may get an error while performing the above command. If you do get an error, set it to
ulimit -n 262144, or
65535 if you get a second error.
- Restart your system.
Amazon AWS instances provide a public and private IP address. While
/install/community-edition-setup/setup.py script, use the
Private IP address. Also, use a hostname other than the long default
hostname that Amazon provides as CN(Canonical Name). Update your DNS or hosts file accordingly.
Google Cloud Platform#
Gluu Server installation in GCP is pretty straight forward. We need to check a couple of points for this installation:
- Deployer must select supported operating system and required resources.
- Enable 'HTTPS' from 'Firewall'
- Do not enter any IP during the installation of Gluu Server, the setup script will automatically gather appropriate IP information.
- When accessing the newly installed Gluu server from a browser, update the DNS or hosts file accordingly.
A video tutorial is also available in the Gluu channel
Accessing the Gluu Server on Azure can be a little tricky because of the Public/Private IP. Azure assigns new Public/Private IP addresses each time the server is started.
Follow these steps to set up the VM on Azure:
Log into Windows Azure Administrative Panel
Create a Virtual Machine
From the menu, choose
Choose Ubuntu Server 14.04 LTS or CentOS 6.7. Remember to set selinux to permissive if you choose CentOS.
Provide a name for the VM in the
Virtual Machine Namefield and use
Select a server with at least 4GB RAM in the
Provide a username/password to connect via SSH and upload an SSH certificate. Click
Create a new cloud service and select
Availability Setoption. * Endpoints Section: This is where port forwarding is set so that the internal IP address can be selectively reachable from the outside world. By default, only tcp /22 is there for SSH. The public ports for
https(tcp ports 80 and 443) have to be added and mapped to the same private ports. If the cloud mappings are flagged as conflicting, proceed without setting them. Remember to set them after the creation of the VM. Then, click
Choose not to install
VM Agentand click the
tickbutton to finalize the VM.
Go to the
Dashboardtab of VM Management Panel and copy the
DNS Name. This is the name that is used to access the Gluu Server.
SSH to the server and proceed with the installation.
Linode Virtual Machines (VM) use a custom kernel which is not supported by the Gluu Server, therefore the kernel must be updated before the Gluu Server can be installed in a Linode VM. The following steps will guide you through kernel update in the Linode VM.
Check for the current version of the kernel. If the output contains
-Linode, then proceed
# uname -a
Run the following command to update the kernel:
# apt-get install linux-image-virtual grub2
grubfile in the
# vim /etc/default/grub
Ensure that the following lines are present in the grub file
GRUB_TIMEOUT=10 GRUB_CMDLINE_LINUX="console=ttyS0,19200n8" GRUB_DISABLE_LINUX_UUID=true GRUB_SERIAL_COMMAND="serial --speed=19200 --unit=0 --word=8 --parity=no --stop=1"
Finally run the following commands to update
# update-grub # reboot