{"id":50385254,"url":"https://github.com/stackhpc/ansible-role-ofed","last_synced_at":"2026-05-30T14:31:15.223Z","repository":{"id":42372767,"uuid":"276948010","full_name":"stackhpc/ansible-role-ofed","owner":"stackhpc","description":"Installs OFED from Mellanox Repositories ","archived":false,"fork":false,"pushed_at":"2022-04-08T08:33:02.000Z","size":22,"stargazers_count":4,"open_issues_count":2,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-04-14T22:50:17.258Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stackhpc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGEME.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-07-03T16:54:27.000Z","updated_at":"2024-03-10T12:50:29.000Z","dependencies_parsed_at":"2022-08-28T21:22:21.980Z","dependency_job_id":null,"html_url":"https://github.com/stackhpc/ansible-role-ofed","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/stackhpc/ansible-role-ofed","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackhpc%2Fansible-role-ofed","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackhpc%2Fansible-role-ofed/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackhpc%2Fansible-role-ofed/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackhpc%2Fansible-role-ofed/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stackhpc","download_url":"https://codeload.github.com/stackhpc/ansible-role-ofed/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackhpc%2Fansible-role-ofed/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33696681,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-30T14:31:13.469Z","updated_at":"2026-05-30T14:31:15.218Z","avatar_url":"https://github.com/stackhpc.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ofed\n\nInstalls OFED via Mellanox Repositories\n\n# Requirements\n\nNone\n\n# Role Variables\n\nPlease see `defaults/main.yml`.\n\n* `ofed_repository_url` Gives a URL to the repository holding the OFED driver packages. Defaults to the [Mellanox public package repository](https://linux.mellanox.com/public/repo/mlnx_ofed)\n* `ofed_version` Specifies the OFED driver version to be installed, default is `latest`\n* `ofed_target_release` Specifies the Linux distribution for the install of the OFED drivers, default is `rhel7.8`\n\n# Dependencies\n\nNone\n\n# Example Playbook\n\n## Default settings\n\n```\n    - hosts: servers\n      tasks:\n        - include_role: stackhpc.ofed\n```\n\n## Using custom settings\n\nThese settings will install the OFED drivers from a local repository, and target version and the RHEL8.3 release\n\n```\n    - hosts: servers\n      vars:\n        ofed_repository_url: http://repo.local\n        ofed_version: '5.2-2.2.0.0'\n        ofed_target_release: rhel8.3\n      tasks:\n        - include_role: stackhpc.ofed\n```\n\n## Disable kernel update\n\nThis should skip the kernel updates:\n\n```\n    - hosts: servers\n      vars:\n        ofed_update_kernel: false\n      tasks:\n        - include_role: stackhpc.ofed\n```\n\n## Packaged dependency conflicts\n\nIf the OFED drivers fail to install with conflicts over `libibverbs` with an error similar to the following:\n\n```\n\"Depsolve Error occured: \\n Problem: cannot install both libibverbs-55mlnx37-1.55103.x86_64 and libibverbs-35.0-1.el8.x86_64\\n  - package perftest-4.5-1.el8.x86_64 requires libefa.so.1()(64bit), but none of the providers can be installed\\n  - package perftest-4.5-1.el8.x86_64 requires libefa.so.1(EFA_1.1)(64bit), but none of the providers can be installed\\n  - cannot install the best candidate for the job\"\n```\n\nThis can be resolved from the command line by passing `--nobest` to `yum` or `dnf`, or with this playbook with the `ofed_nobest` variable.\n\n```\n    - hosts: servers\n      vars:\n        ofed_nobest: true\n      tasks:\n        - include_role: stackhpc.ofed\n```\n\n## Failure backing up Grub config\n\nThe kernel update updates the grub configuration to include the new kernel modules, however if a host is missing either grub configuration file `/etc/grub2.cfg` or `/etc/grub2-efi.cfg` this task can fail. The backup can be disabled with the `ofed_grub_backup` variable.\n\n**NOTE:** It's recommended to test that the host successfully boots with the OFED Kernel Modules first before disabling the config backup, as this setting destroys the previous configuration.\n\n```\n    - hosts: servers\n      vars:\n        ofed_grub_backup: false\n      tasks:\n        - include_role: stackhpc.ofed\n```\n## Incorrect Kernel Modules\n\nOn installing the Mellanox OFED Drivers, the `openibd` daemon may not start with the following errors:\n\n```\nopenibd: ERROR: Module mlx5_ib belong to kernel-modules which is not a part of MLNX_OFED, skipping\nopenibd: ERROR: Module mlx5_core belong to kernel-core which is not a part of MLNX_OFED, skipping\nopenibd: ERROR: Module ib_umad belong to kernel-modules which is not a part of MLNX_OFED, skipping\nopenibd: ERROR: Module ib_uverbs belong to kernel-modules which is not a part of MLNX_OFED, skipping\nopenibd: ERROR: Module ib_ipoib belong to kernel-modules which is not a part of MLNX_OFED, skipping\nopenibd: ERROR: Module rdma_cm belong to kernel-modules which is not a part of MLNX_OFED, skipping\nopenibd: ERROR: Module rdma_ucm belong to kernel-modules which is not a part of MLNX_OFED, skipping\n```\n\nThis can be due to the kernel modules included in the packages from the repository not matching the kernel, while it is recommended that the [kernel modules be recompiled to match the kernel](https://docs.nvidia.com/networking/display/MLNXOFEDv531001/Installing+Mellanox+OFED#InstallingMellanoxOFED-additionalinstallationproceduresAdditionalInstallationProcedures) and provided via a local package repositry there is a workaround by enabling `FORCE_MODE` and disabling `RDMA_UCM_LOAD` in `/etc/infiniband/openib.conf`. The role can implement this with the following variables:\n\n```\n    - hosts: servers\n      vars:\n        ofed_manage_openib_conf: true\n        ofed_force_mode: true\n        ofed_rdma_ucm_load: false\n      tasks:\n        - include_role: stackhpc.ofed\n```\n\n\nLicense\n-------\n\nApache\n\nAuthor Information\n------------------\n\nWill Szumski\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackhpc%2Fansible-role-ofed","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstackhpc%2Fansible-role-ofed","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackhpc%2Fansible-role-ofed/lists"}