Quick Start Guide

1. Minimum hardware requirements.

   Note

   For more information, see the knowledge base article on Red Hat Gluster Storage Hardware Compatibility.

2. Network Time Protocol (NTP) setup
3. Firewall access to ports
4. Red Hat Gluster Storage Server
5. Red Hat Enterprise Linux 7.4

1. Enable the following repositories on the Web Administration server:

   # subscription-manager repos --enable=rhel-7-server-rpms
   # subscription-manager repos --enable=rh-gluster-3-web-admin-server-for-rhel-7-server-rpms

   Copy to Clipboard

2. Enable the following repositories on the Gluster storage server:

   # subscription-manager repos --enable=rhel-7-server-rpms --enable=rh-gluster-3-for-rhel-7-server-rpms
   # subscription-manager repos --enable=rh-gluster-3-web-admin-agent-for-rhel-7-server-rpms

   Copy to Clipboard

3. Set up SSH password-less connection from the Web Administration server system to the remote Gluster servers in addition to itself (SSH to localhost).

   Note

   For information on how to set up SSH key-based authentication, see the Using Key-based Authentication section in the Red Hat Enterprise Linux System Administrator’s Guide.

4. The Web Administration server and the Gluster Storage servers must have properly configured Fully Qualified Domain Name (FQDN) and should be resolved from the rest of the nodes.

1. Installing the latest version of Ansible and tendrl-ansible.
2. Creating inventory file with the required groups: tendrl-server and gluster-servers.
3. Creating a site.yml playbook based on site.yml.sample from tendrl-ansible package.
4. Executing the site.yml playbook and accessing the Web Administration environment.

1. tendrl-server: contains one machine acting as Web Administration server.
2. gluster-servers: contains all the Red Hat Gluster Storage nodes.

1. tendrl-ansible.tendrl-server: contains tasks for Web Administration server belonging to the tendrl-server group in the inventory file.

   Note

   For more information on this role and the variables, see the README file from tendrl-ansible package available on the following path: /usr/share/ansible/roles/tendrl-ansible.tendrl-server/README.md

2. tendrl-ansible.tendrl-storage-node: contains tasks for Red Hat Gluster Storage nodes belonging to the gluster-servers group in inventory file.

Procedure. Installing Web Administration

1. Install the latest version of Ansible and tendrl-ansible:

   # yum -y install ansible tendrl-ansible

   Copy to Clipboard
   Note

   Verify the version installed by running ansible --version.

2. Create an Ansible inventory file with two Ansible groups: tendrl-server and gluster-servers. Ensure to use FQDNs for tendrl-server and gluster-servers in the inventory file.

   Note

   For instructions on setting up an inventory file, see Ansible Inventory information in Ansible documentation.

3. Create a site.yml file based on the site.yml.sample file:

   # cp /usr/share/doc/tendrl-ansible-*/site.yml.sample site.yml

   Copy to Clipboard

4. Edit the site.yml file using a preferred text editor and prospectively update the ansible variables in the playbook if required.

   Note

   The site.yml.sample file contains ansible variables with pre-defined default values. If required, edit the variables based on the system parameters and preferences.

   Note

   To configure TLS-based security for etcd, follow the instructions in the TLS Encryption Configuration chapter. After TLS encryption is configured, continue with the remaining steps below

5. Verify SSH connection to all the nodes from the inventory file without asking for password or validation of public key by running:

   # ansible -i <inventory_file> -m ping all

   Copy to Clipboard

   Example

   # ansible -i <inventory_file> -m ping all
   gl3.example.com | SUCCESS => {
       "changed": false,
       "failed": false,
       "ping": "pong"
   }

   Copy to Clipboard
   Note

   Ansible should return SUCCESS and pong message for all the nodes like shown in the example above. Do not proceed unless the SSH connection is successfully established.

6. Run the prepared site.yml playbook using the following command to set up the Web Administration server and the Storage nodes:

   # ansible-playbook -i <inventory_file> site.yml

   Copy to Clipboard
7. Log in to the Web Administration environment. For login instructions, see Chapter 4. Web Administration Login of this Guide.

Configuring TLS

1. Open the site.yml playbook file.
2. Set the value for etcd_tls_client_auth variable to True for both the Ansible roles: tendrl-server and gluster-servers. By default, the value of this variable is False.
3. Edit the file path for the etcd_cert_file variable as per required. The default value is: /etc/pki/tls/certs/etcd.crt
4. Edit the file path for etcd_key_file variable as per required. The default value is: /etc/pki/tls/private/etcd.key
5. Edit the file path for the etcd_trusted_ca_file variable. The default value is: /etc/pki/tls/certs/ca-etcd.crt
6. Continue the Web Administration installation process by following the Web Administration Installation chapter, from step 5 onward - verifying SSH connection.

1. Click on the user icon from the menu bar.

   

2. Click My Settings.

   
3. A dialog window is opened. Enter the new password twice and click Save. Email notifications are disabled by default. To enable, check the Email Notifications box.

1. Click on the user icon from the menu bar.
2. Click Logout.