Project URL: https://github.com/jumanjihouse/docker-opensm
Docker hub: https://registry.hub.docker.com/u/jumanjiman/opensm/
Table of Contents
OpenSM is an infiniband subnet manager from the OpenFabrics Enterprise Distribution (OFED). This repo provides a way to build OpenSM into a docker image and run it as a container.
The repo is set up to build the image on CircleCI.
An unattended test harness runs simple test scripts. If all tests pass on master branch in the unattended test harness, it pushes the built images to the Docker hub.
On a host with Docker:
docker build --rm -t opensm src/
These images are built as part of the test harness on CircleCI. If all tests pass on master branch, then the image is pushed into the docker hub.
docker pull jumanjiman/opensm:latest
The latest tag always points to the latest version.
Additional tags include 7-${build_datetime}-${git_hash}
to correlate any image to both the opensm version and a git commit from this repo.
The 7 in the tag refers to the fact that this image is based on Centos 7.
We push the tags automatically from the test harness, and we occasionally delete old tags from the Docker hub by hand.
On a host with Docker:
docker run -d \
--name opensm.service
--read-only \
--memory=10G \
--privileged \
--net=host \
-v /lib/modules:/lib/modules:ro \
jumanjiman/opensm
On a host with IB, docker logs <cid> could show output
similar to test/opensm.log, which was
obtained on an unconfigured, tiny test fabric.
The image contains useful infiniband diagnostic utilities from these packages:
- ibutils
- infiniband-diags
- qperf
You can run the tools in two ways:
-
Enter a running opensm container via
docker exec -it <cid> bashand call the utils directly. -
Start a fresh container with something like:
docker run --rm -it --net=host --privileged --entrypoint bash jumanjiman/opensm
Sample output from ibnetdiscover (one of the utils) is shown at
test/ibnetdiscover.out.
Run the test harness:
ci/test
The test harness requires:
- BATS
- Python and the
pipcommand
Output resembles:
[yamllint] yamllint..........................................................................Passed
[check-added-large-files] Check for added large files........................................Passed
[check-case-conflict] Check for case conflicts...............................................Passed
[check-executables-have-shebangs] Check that executables have shebangs.......................Passed
[check-symlinks] Check for broken symlinks...............................(no files to check)Skipped
[check-vcs-permalinks] Check vcs permalinks..................................................Passed
[detect-private-key] Detect Private Key......................................................Passed
[forbid-crlf] CRLF end-lines checker.........................................................Passed
[forbid-tabs] No-tabs checker................................................................Passed
[forbid-binary] Forbid binaries..........................................(no files to check)Skipped
[git-check] Check for conflict markers and core.whitespace errors............................Passed
[git-dirty] Check if the git tree is dirty...................................................Passed
[shellcheck] Test shell scripts with shellcheck..............................................Passed
[shfmt] Check shell style with shfmt.........................................................Passed
✓ LICENSE file exists
✓ image exists
✓ image contains opensm package
✓ RDMA config allows IPoIB
✓ RDMA config does not load iSCSI over RDMA
✓ image contains infiniband-diags package
✓ image does not contain doc files
✓ image contains ibutils package
✓ ibdiagnet is in path
✓ image contains qperf package
✓ qperf is in path
✓ userspace ib driver "infinipath-psm" is installed
✓ connection mgmt library "librdmacm" is installed
✓ connection mgmt library "librdmacm-utils" is installed
✓ connection mgmt library "ibacm" is installed
✓ "libibverbs" is installed
✓ "libibverbs-utils" is installed
✓ "ibv_devinfo" is in path
✓ "libibcommon" is installed
✓ "dapl" is installed
✓ "compat-dapl" is installed
✓ "dapl-utils" is installed
✓ "compat-dapl-utils" is installed
✓ "mstflint" is installed
✓ sminfo poll interval is 5 seconds
25 tests, 0 failures
ci/test OK
See LICENSE.