4.3. Configuring Red Hat Gluster Storage Console

When package installation is complete, the Red Hat Gluster Storage Console must be configured. The rhsc-setup script is provided to assist with this task. The script asks you a series of questions, and configures the environment based on the answers. When required values are provided, the updated configuration is applied and the Red Hat Gluster Storage Console services are started. The rhsc-setup script guides you through several distinct configuration stages. The script suggests possible configuration defaults in square brackets. No additional input is required wherever the default values are acceptable.

Procedure 4.5. Configuring the Console

  1. Start console setup

    #rhsc-setup
    The script then checks whether it is performing an upgrade or an installation before proceeding.
    Checking for product updates...
    No product updates found
  2. Check hostname configuration

    The rhsc-setup script automatically detects the hostname. Correct the detected hostname if required. The fully qualified domain name should have both forward and reverse lookup records in DNS.
    Host fully qualified DNS name of this server [autodetected domain-based name]:
  3. Configure firewall

    The rhsc-setup script looks for firewall managers which are both active and enabled in the environment and you can choose to configure the firewall.
    Setup can automatically configure the firewall on this system.
    Note: automatic configuration of the firewall may overwrite current settings.
    Do you want Setup to configure the firewall? (Yes, No) [Yes]: yes
    [INFO] iptables will be configured as firewall manager.
  4. Configure database

    You can use either a local or remote PostgreSQL database. The script can automatically configure the database, including adding a user and a database, or use the values that you provide.
    Where is the database located? (Local, Remote) [Local]: Local
    Setup can configure the local postgresql server automatically for the engine to run. This may conflict with existing applications.
    Would you like Setup to automatically configure postgresql, or prefer to perform that manually? (Automatic, Manual) [Automatic]: Automatic
    For information on how to prepare a PostgreSQL database, see Chapter 8, Use a PostgreSQL Database Server with Red Hat Gluster Storage Console
  5. Configure administrator credentials

    You need to set an administrator password for the automatically created administrative user of the Red Hat Gluster Storage Console: admin@internal.
    Engine admin password:
    Confirm engine admin password:
    A message appears on the terminal if the password you have set is weak.
  6. Configure certificates

    The Console uses certificates to communicate securely with its hosts. You need to provide the organization name for the certificate. This certificate can also optionally be used to secure HTTPS communications with the Console.
    Organization name for certificate [autodetected domain-based name]:
  7. Configure web server

    The external SSL (HTTPS) communications with the Console are secured with the self-signed certificate created in the PKI configuration stage by default, to securely communicate with hosts. You may choose to use another certificate for external HTTPS connections, without affecting how the Console communicates with hosts.
    Setup can configure apache to use SSL using a certificate issued from the internal CA.
    Do you wish Setup to configure that, or prefer to perform that manually? (Automatic, Manual) [Automatic]: Automatic
    The Red Hat Gluster Storage Console uses the Apache web server to present a landing page to users. rhsc-setup script can make the Console's landing page the default page presented by Apache.
    Setup can configure the default page of the web server to present the application home page. This may conflict with existing applications.
    Do you wish to set the application as the default page of the web server?
    (Yes, No) [Yes]:
  8. Configure console settings

    The rhsc-setup script by default uses the GlusterFS application mode and skips the NFS configuration.
    [ INFO ] NFS configuration skipped with application mode Gluster
    The rhsc-setup script validates all the inputs, and warns you of any possible problem. Further input is only required if any of the inputs you provided would adversely impact the environment.
    The rhsc-setup script prompts to confirm whether to connect to the Red Hat Access Plug-in.
    On agreeing to configure the proxy server, you are prompted to enter the IP address and the port number of the proxy server. You also have the option to set a user name for the proxy server with a password.
    Would you like transactions from the Red Hat Access Plug-in sent from the Red Hat Gluster Storage Console to be brokered through a proxy server? (Yes, No) [No]: No
    The rhsc-setup script prompts to confirm whether to enable or disable monitoring by entering Yes or No
    For information on how to configure Nagios, see Configuring Nagios for Red Hat Gluster Storage Console in Red Hat Gluster Storage Console 3.4 Administration Guide
    Would you like external monitoring to be enabled? (Yes, No) [Yes]:
     --== CONFIGURATION PREVIEW ==--
    
            Application mode                        : gluster
            Firewall manager                        : iptables
            Update Firewall                         : True
            Host FQDN                               : rhsc.example.com
            Engine database name                    : engine
            Engine database secured connection      : False
            Engine database host                    : localhost
            Engine database user name               : engine
            Engine database host name validation    : False
            Engine database port                    : 5432
            Engine installation                     : True
            PKI organization                        : redhat
            Configure local Engine database         : True
            Set application as default page         : True
            Configure Apache SSL                    : True
            Nagios monitoring enabled for gluster hosts: True
    
            Please confirm installation settings (OK, Cancel) [OK]: OK
    [ INFO  ] Stage: Transaction setup
    [ INFO  ] Stopping engine service
    [ INFO  ] Stage: Misc configuration
    [ INFO  ] Stage: Package installation
    [ INFO  ] Stage: Misc configuration
    [ INFO  ] Initializing PostgreSQL
    [ INFO  ] Creating PostgreSQL 'engine' database
    [ INFO  ] Configuring PostgreSQL
    [ INFO  ] Creating Engine database schema
    [ INFO  ] Creating CA
    [ INFO  ] Generating post install configuration file '/etc/ovirt-engine-setup.conf.d/20-setup-ovirt-post.conf'
    [ INFO  ] Stage: Transaction commit
    [ INFO  ] Stage: Closing up
    • To confirm the displayed configuration values, type OK and press Enter.
    • To correct one or more configuration values, type cancel, this causes the set-up to fail. Run the setup again to provide the correct values.
  9. Confirm summary

    When all the required values are provided, the script lists the values for a final confirmation.
    When the script completes, note the additional information provided. Copy the SSH Certificate fingerprint, SSH Public key fingerprint, and Red Hat Gluster Storage Console URL for later reference.
     --== SUMMARY ==--
    
    [ INFO  ]  To enable monitoring, ensure the managed nodes are migrated to Red Hat Gluster Storage 3.4. Also make sure the auto discovery tool is executed to start monitoring the Red Hat Gluster Storage Nodes, after the cluster nodes are added to Red Hat Gluster Storage Console. For detail, refer to Red Hat Gluster Storage Console Administration Guide.
    [WARNING] Less than 16384MB of memory is available
            SSH fingerprint:
            Internal CA
            Web access is enabled at:
                http://HostURL:portnumber/ovirt-engine
                https://HostURL:portnumber/ovirt-engine
            Please use the user "admin" and password specified in order to login.
    
    [ INFO  ] To enable monitoring, ensure that the managed nodes are migrated to Red Hat Gluster Storage 3.0 or above. Also ensure that the auto-discovery command (configure-gluster-nagios) is executed to start monitoring the Red Hat Gluster Storage Nodes after the nodes are added to Red Hat Gluster Storage Console. For more details, refer Red Hat Gluster Storage Console Administration Guide.
    [WARNING] Less than 16384MB of memory is available
                Engine database resources:
                Database name:
                Database user name:
                SSH fingerprint:
                Internal CA
                Web access is enabled at:
                http://HostURL:portnumber/ovirt-engine
                https://HostURL:portnumber/ovirt-engine
            Please use the user "admin" and password specified in order to login
    At this stage, the engine service and httpd daemon are started.
              --== END OF SUMMARY ==--
    
    
    [ INFO  ] Starting engine service
    [ INFO  ] Restarting httpd
    [ INFO  ] Stage: Clean up
            Log file is located at /var/log/ovirt-engine/setup/ovirt-engine-setup-20150722181911-5zsqnr.log
    [ INFO  ] Generating answer file '/var/lib/ovirt-engine/setup/answers/20150722182856-setup.conf'
    [ INFO  ] Stage: Pre-termination
    [ INFO  ] Stage: Termination
    [ INFO  ] Execution of setup completed successfully
Result:

The Red Hat Gluster Storage Console is installed and configured. You can connect to the Administration Portal using the instructions in Chapter 7, Connecting to the Administration Portal.

Note

Red Hat periodically provides updates for the Red Hat Gluster Storage Console.

4.3.1. Enabling SELinux

To enable SELinux on Console and the storage nodes refer Red Hat Gluster Storage 3.4 Administration Guide which provides more information on enabling SELinux.

Note

Ensure to place the nodes into maintenance mode before enabling SELinux on the Red Hat Gluster Storage nodes managed via Console.
On the upgraded Red Hat Gluster Storage Console and Red Hat Gluster Storage nodes, set following SELinux booleans:
  • If Nagios server is installed on the Console node, set the following boolean:
    # setsebool -P nagios_run_sudo on
  • Set the following booleans on Red Hat Gluster Storage node for Nagois to function:
    # setsebool -P nagios_run_sudo on
    # setsebool -P logging_syslogd_run_nagios_plugins on