Integrated Manager for Lustre software Installation

Software Installation Guide Table of Contents

In this Chapter:

This section describes how to install the Integrated Manager for Lustre software and the Integrated Manager for Lustre software on the manager server.

After the Integrated Manager for Lustre software is installed, point your web browser to the Integrated Manager for Lustre software dashboard. Use Chrome or Firefox. A display monitor with a minimum resolution of 1024 X 768 pixels is recommended, to adequately display the Integrated Manager for Lustre software GUI.

Note: Later, when adding storage servers to your Lustre file system, the Integrated Manager for Lustre software agent, Integrated Manager for Lustre software, and specific dependencies (e.g.: for Corosync and Pacemaker) are automatically deployed to the storage server. This avoids the need to manually install the Integrated Manager for Lustre software on storage servers and avoids possible errors.

Note: Some installations may opt to deploy and configure a Lustre file system manually, without Integrated Manager for Lustre software. Other installations may opt to deploy and configure a Lustre file system and then later install Integrated Manager for Lustre software to be used in Monitor-only mode. To deploy and configure Lustre manually, see Installing and Configuring Lustre Manually.

For information regarding installing and configuring Lustre, see Part II of the Lustre Operations Manual. This information is available at the following URL. If this page does not load, copy and paste it into your browser.

http://doc.lustre.org/lustre_manual.xhtml#part.installconfig

Installing Integrated Manager for Lustre software

You will need the following information to perform this installation:

To install the software, complete these steps:

  1. Pull the repo file for a tagged release on github:

    yum-config-manager --add-repo=https://github.com/whamcloud/integrated-manager-for-lustre/releases/download/v6.3.0/chroma_support.repo

  2. Install the manager via yum:

    yum install -y python2-iml-manager

  3. Once the install completes run chroma-config setup. When the following prompts appear, enter your parameters for the first superuser of Integrated Manager for Lustre software:

    Username: <Enter the name of the superuser>

    Password: <Enter a password>

    Confirm password: <Enter the password again>

    Email: <Enter an email address for the superuser>

    Note: Additional Integrated Manager for Lustre software superusers as well as file system administrators and users can be created in the manager GUI.

    When configuration is complete, a message is displayed indicating the installation was successful.

  4. When the prompt NTP Server [localhost] appears, respond with one of these options:

    • Option 1: To designate the NTP server (internal or external) used for your site, enter the FQDN or IP address of the NTP server and press the <Enter> key.

    • Option 2: To use the Integrated Manager for Lustre software server’s clock as the time source, press the <Enter> key.

  5. Using ifconfig, obtain the IP address of the administrative network interface for the server hosting Integrated Manager for Lustre software. The default network interface for Integrated Manager for Lustre software is eth0.

  6. Open a web browser and access the Integrated Manager for Lustre software GUI using the server IP address obtained in the previous step. Enter in the address field of your browser:

    https://<command_center_server_IP_address>

    Note: If the IP address of the server has an associated FQDN, you can connect to the Integrated Manager for Lustre software GUI user interface using:

    https://<command_center_server_fqdn>

    Note: The GUI uses a self-signed SSL certificate to secure communications between the browser and the server. You will need to accept this certificate in order to connect to the Integrated Manager for Lustre software GUI. A certificate can be downloaded from (example only):

    https://<manager-addr>/certificate/

    Make sure to trust this certificate for SSL traffic.

    After Integrated Manager for Lustre software is installed, point your web browser to the Integrated Manager for Lustre software dashboard. Use Chrome or Firefox.

Integrated Manager for Lustre software Configuration Settings

The following Integrated Manager for Lustre software configuration settings can be modified. See the instructions for modifying these settings following the descriptions.

ALLOW_ANONYMOUS_READ

Default: True (Uppercase first letter required.)

Description: Allows anonymous (unauthenticated) users to view statistics, logs and status of a system in the Integrated Manager for Lustre software GUI but not to make any changes. If set to False, anonymous users will be presented with a login prompt and no data.

DISABLE_POWER_CONTROL_DEVICE_MONITORING

Default: False (Uppercase first letter required.)

Description: The default state is False, allowing automatic monitoring of power control devices. When set to True, this setting disables the manager software’s monitoring of your power control devices (eg, BMC, PDU outlets, etc.) This is necessary for sites where the manager server does not have access to the power control devices itself. However, Integrated Manager for Lustre software will then NO LONGER REPORT ANY FAILURE IN ANY POWER CONTROL DEVICES. If power control becomes non-operational, automatic failover will not occur on failure, and manual intervention will be required to restore service to your file system. If you chose to set this value to True, we recommend implementing an alternate mechanism to monitor your power control devices, outside of Integrated Manager for Lustre software.

Other Settings:

Setting Default Description
EMAIL_HOST None SMTP server hostname (Example: 'server1.test.com')
EMAIL_PORT 25 SMTP server port number.
EMAIL_HOST_USER ' ' SMTP server username (or ' ').
EMAIL_HOST_PASSWORD ' ' SMTP server username (or ' ').
EMAIL_USE_TLS False (Uppercase first letter required.) True indicates that TLS/SSL is to be used. False indicates it is not to be used.
EMAIL_SENDER noreply@<command_center server_fqdn> The address that appears in the From field on alert emails.

Editing Integrated Manager for Lustre software Configuration Settings

To change these configuration settings:

  1. Use a text editor to create or modify a file local_settings.py in the directory /usr/share/chroma-manager/

    For example, add the following setting to the local_settings.py file to restrict view of system statistics, logs, and status to only users who are logged in:

    ALLOW_ANONYMOUS_READ=False

    In this example, the first letter of False must be capitalized.

    Note: Entries must follow Python syntax rules. For example, all strings must be enclosed in single or double quotes (double quotes must be used if the string includes a single quote). For example, EMAIL_HOST=server1.test.com will result in an error, while EMAIL_HOST='server1.test.com' is a valid entry.

    Warning: If you edit the file settings.py instead of creating a local_settings.py file, your changes will be overwritten without warning when the Integrated Manager for Lustre software is updated.

  2. To configure email alerts, complete one of the options below. By default, email alerts from the Integrated Manager for Lustre software are disabled (EMAIL_HOST set to None).

    • Option 1: Set up an external mail server. Create or modify the file /usr/share/chroma-manager/local_settings.py to provide appropriate values for these settings:

      a. Set EMAIL_SENDER to an address suitable for your site.

      b. Modify EMAIL_HOST (and other server settings if necessary) to point to an existing SMTP server on your network.

    • Option 2: Use a local mail server. If a suitable SMTP server is not available, you can configure the Integrated Manager for Lustre software server to act as an SMTP server:

      a. Set EMAIL_SENDER to an address suitable for your site.

      b. Set up a local mail daemon using standard procedures for Red Hat Enterprise Linux or CentOS such as those described in the Red Hat documentation at: Mail Servers

      c. Set EMAIL_HOST to localhost

  3. Run the chroma configuration tool in order to load changes made to local_settings.py.

    # chroma-config restart

For configuring user accounts, see the online Help in the Integrated Manager for Lustre software. The online Help also provides instructions for creating, monitoring, and managing your Lustre file systems.