This repository provides tooling to build a Docker image for the Mellanox UFM Infiniband fabric manager.
The image is based on the centos/systemd image, in order to run multiple
UFM services in a single container, using the existing UFM init scripts.
If the running kernel does not match the kernel on which the UFM packages were built, it may be necessary to rebuild the UFM packages from source. A script is provided to rebuild the packages using a Docker container. Set the following environment variables to configure the script:
$KERNEL_VERSION: optional kernel version to compile against$UFM_VERSION: required UFM software version, for example 5.9.6-8.el7.x86_64$UFM_TARBALL_URL: required UFM tarball URL$UFM_COMPILE_IMAGE_TAG:: optional UFM compilation image tag
The image uses a centos:7 base container image. If this does not match the
kernel running on the host, the build will fail. In this case, you can
configure Yum to use the CentOS Vault repositories for an older version.
To do this, set $CENTOS_VERSION to the required version, e.g. 7.6.1810.
The Dockerfile expects a tarball containing the UFM software to be available
via HTTP. The URL of this tarball should be set via $UFM_TARBALL_URL.
The UFM software version should be set via $UFM_VERSION.
A Mellanox OFED yum repository should be made available via HTTP and set via
$OFED_REPO_URL.
By default, the built image will be tagged as mlnx-ufm:latest. To use a
different tag, set $UFM_IMAGE_TAG.
The image uses a centos/systemd:latest base container image. If this does not
match the kernel running on the host, the build will fail. In this case, you
can configure Yum to use the CentOS Vault repositories for an older version.
To do this, set $CENTOS_VERSION to the required version, e.g. 7.6.1810.
Run the build.sh script to build a Docker image.
By default the image tagged as mlnx-ufm:latest will be used to create the
container. To use a different image, set $UFM_IMAGE_NAME.
By default, the container will be named mlnx_ufm. To use a different name,
set $UFM_CONTAINER_NAME.
One or more UFM licenses should be made available in a directory on the host
running docker. The path to this directory should be set via
$UFM_LICENSES_PATH.
It may be desirable to apply additional configuration to UFM prior to running
the ufmd service. This can be done by setting $UFM_STARTUP_CONFIG_PATH to
the path of a script.
Run the run.sh script to create a Docker container. The container will be
privileged, and use host networking.
Alternatively, use the mlnx-ufm Ansible role to deploy the container.