18.16. Configuring an IPoIB connection by using the network RHEL system role

Procedure

1. Create a playbook file, for example, ~/playbook.yml, with the following content:

   ---
   - name: Configure the network
     hosts: managed-node-01.example.com
     tasks:
       - name: IPoIB connection profile with static IP address settings
         ansible.builtin.include_role:
           name: redhat.rhel_system_roles.network
         vars:
           network_connections:
             # InfiniBand connection mlx5_ib0
             - name: mlx5_ib0
               interface_name: mlx5_ib0
               type: infiniband
   
             # IPoIB device mlx5_ib0.8002 on top of mlx5_ib0
             - name: mlx5_ib0.8002
               type: infiniband
               autoconnect: yes
               infiniband:
                 p_key: 0x8002
                 transport_mode: datagram
               parent: mlx5_ib0
               ip:
                 address:
                   - 192.0.2.1/24
                   - 2001:db8:1::1/64
               state: up

   The settings specified in the example playbook include the following:

   type: <profile_type>

   Sets the type of the profile to create. The example playbook creates two connection profiles: One for the InfiniBand connection and one for the IPoIB device.

   parent: <parent_device>

   Sets the parent device of the IPoIB connection profile.

   p_key: <value>

   Sets the InfiniBand partition key. If you set this variable, do not set interface_name on the IPoIB device.

   transport_mode: <mode>

   Sets the IPoIB connection operation mode. You can set this variable to datagram (default) or connected.

   For details about all variables used in the playbook, see the /usr/share/ansible/roles/rhel-system-roles.network/README.md file on the control node.

2. Validate the playbook syntax:

   $ ansible-playbook --syntax-check ~/playbook.yml

   Note that this command only validates the syntax and does not protect against a wrong but valid configuration.

3. Run the playbook:

   $ ansible-playbook ~/playbook.yml

Verification

1. Display the IP settings of the mlx5_ib0.8002 device:

   # ansible managed-node-01.example.com -m command -a 'ip address show mlx5_ib0.8002'
   managed-node-01.example.com | CHANGED | rc=0 >>
   ...
   inet 192.0.2.1/24 brd 192.0.2.255 scope global noprefixroute ib0.8002
      valid_lft forever preferred_lft forever
   inet6 2001:db8:1::1/64 scope link tentative noprefixroute
      valid_lft forever preferred_lft forever

2. Display the partition key (P_Key) of the mlx5_ib0.8002 device:

   # ansible managed-node-01.example.com -m command -a 'cat /sys/class/net/mlx5_ib0.8002/pkey'
   managed-node-01.example.com | CHANGED | rc=0 >>
   0x8002

3. Display the mode of the mlx5_ib0.8002 device:

   # ansible managed-node-01.example.com -m command -a 'cat /sys/class/net/mlx5_ib0.8002/mode'
   managed-node-01.example.com | CHANGED | rc=0 >>
   datagram