Installing the Gluster Management Gateway

To install the Gluster Management Gateway, perform the following steps:

1. Download the Gluster Management Gateway repository configuration file (glustermg.repo) and the Gluster Management Gateway RPM (glustermg-1.0.0-1.x86_64.rpm) from the location provided by Gluster.

   Note: glustermg.repo has been created and tested with CentOS 5.6. It may work with other versions of CentOS, however it has not been extensively tested.

2. Save the file in the following location on your machine:

   /etc/yum.repos.d/

3. Run the following command to install Gluster Management Gateway:

   # yum groupinstall glustermg

4. The following packages are installed if not installed earlier:
   • Java SE runtime version 1.6 – OpenJDK v1.6.0.0
   • Tomcat v5.5.23 or higher
   • wget
5. Run the following command to install Gluster Management Gateway.

   rpm -ivh glustermg-1.0.0-1.x86_64.rpm

Gateway generates SSH keys during installation. These keys are stored in the following location /opt/glustermg/keys. These keys are used for communication with the storage servers. However, in Amazon Web Services (AWS) environment, SSH communication is done using the private key provided by Amazon. Hence, the AWS genegrated private key (.pem file) must be stored in /opt/glustermg/keys and the file must be named as gluster.pem

Note:

• You can install the Gluster Management Gateway packages on a Gluster Storage Server. However, this can impact performance of the GlusterFS processes on this machine hence this is not recommended.
• The Gluster Management Gateway is shipped with a self-signed SSL certificate, by default. While this ensures that the communication between the console and gateway is encrypted and safe, some browsers may throw security warnings mentioning that the site is not secure. It is highly recommended that you install your own SSL certificate issued by a valid certifying authority in the tomcat5 configuration for the 8443 port. For more information on obtaining your own service certificate, refer to Installing a Certificate from a Certificate Authority from Tomcat documentation.
• Ensure to enable port 8443 (HTTPS), port 24731 (TCP), and port 24729 (UDP) on the gateway.
• Gluster Management Gateway communicates with all storage servers through SSH, using their host names. Make sure all of your storage server's host names (fully qualified domain names) are resolvable by the Gateway and by each other. If you have a properly configured DNS setup, this should work seamlessly.