Mellanox UFM Infiniband Fabric Manager

This role helps you set up a Mellanox UFM Infiniband fabric manager in a Docker container.

You can find the tools to create a compatible container image on Github <https://github.com/stackhpc/docker-mlnx-ufm>.

Requirements

To use this role, your host needs:

• Docker engine
• Python version docker >= 2.0.0

Role Variables

Here are the variables you can set up:

• mlnx_ufm_action: The action to take. Options include build, deploy, destroy, pull, reconfigure, and upgrade. It defaults to deploy.
• mlnx_ufm_enabled: Whether UFM is enabled. It defaults to true.
• mlnx_ufm_image: The name of the Docker image. This is required.
• mlnx_ufm_tag: The tag for the Docker image. It defaults to latest.
• mlnx_ufm_image_full: Full specification of the Docker image.
• mlnx_ufm_restart_policy: Policy for restarting the UFM container. It defaults to unless-stopped.
• mlnx_ufm_restart_retries: How many times to restart the Docker container. It defaults to 10.
• mlnx_ufm_startup_config_path: Path to a script template on your local machine with startup configurations. The default path is /etc/mlnx-ufm/mlnx-ufm-configure.
• mlnx_ufm_licenses_path: Path to a directory on your local machine with Mellanox UFM licenses. The default is /etc/mlnx-ufm/licenses.
• mlnx_ufm_config_path: Path on the remote host to save configurations. The default is /etc/mlnx-ufm.

The following variables are only needed if mlnx_ufm_action is set to build:

• mlnx_ufm_repo_url: URL of the Git repository that has the image. The default is https://github.com/stackhpc/docker-mlnx-ufm.
• mlnx_ufm_repo_version: Version of the Git repository to check out. The default is master.
• mlnx_ufm_repo_checkout_path: Directory path for checking out the Git repository. The default is /tmp.
• mlnx_ufm_version: Version of the UFM software. You need to set this to build the image.
• mlnx_ufm_tarball_url: URL of the UFM software tarball. You need to set this to build the image.
• mlnx_ufm_ofed_repo_url: URL for the OFED package repository. You need to set this to build the image.
• mlnx_ufm_centos_version: Version of CentOS to use (e.g., 7.6.1810). Leave it empty to use the default version.
• mlnx_ufm_push: Whether to push the images after they are built. The default is false.
• mlnx_ufm_force_rebuild: Whether to rebuild the image even if an existing image with the same name and tag is present. The default is false.

Dependencies

None

Example Playbook

Here’s an example of a playbook that configures Mellanox UFM:

---
- hosts: mlnx-ufm
  roles:
    - role: mlnx-ufm

Author Information

• Mark Goddard (mark@stackhpc.com)