mkiba Command
Purpose
Configures an IPv4 address or IPv6 address over the InfiniBand interface.
Syntax
mkiba { -i Interface -a address | -v address6 -A ib_adapter -p ib_port [ -P P_KEY ] [ -V ipv6prefix ] [ -m subnet_mask ] [ -S state ] [ -M mtu ] [ -q queue_pair_size ] [ -Q Q_KEY ] [-k superpacket ] }
Description
The mkiba command sets the minimal values required for using the IPv4 address or IPv6 address over the InfiniBand interface on a host machine. These values are written to the configuration database. This command also parses the information and verifies if the parameters are correct. If the interface is not defined, this command defines it, and calls the chdev command to configure it.
The following list details the functions of the mkiba command:
- Defining the interface name in the configuration database if it is not already defined
- Setting the host name in both the configuration database and the running machine
- Setting the IP address of the interface in the configuration database
- Setting the subnetwork mask, if applicable
- Setting the prefix length, if applicable
- Setting InfiniBand-specific parameters (such as host channel adapter (HCA), port, and so on)
You can use the smit mkinetib fast path in the System Management Interface Tool (SMIT) to run this command.
At least one IPv4 address or IPv6 address must be included to configure the interface.
Use the ifconfig ibX to check the state of the interface after the configuration.
The ifconfig command indicates that if the InfiniBand multicast group is pending, then there is an adapter malfunction or the physical port is down. If there is an adapter malfunction, you must perform manual HCA device driver reconfiguration to recover the InfiniBand stack. If the port is down, you must check the cabling and switches. If multicast is pending, check the InfiniBand Subnet Manager for errors. To troubleshoot the InfiniBand interface issues, use the ibstat command.
Flags
| Item | Description |
|---|---|
| -A ib_adapter | Specifies the HCA. For example, iba0. |
| -a address | Sets the Internet address of the host. Specify the address in dotted decimal notation. Each network interface on the host must have a unique Internet address. For example, a standard format for setting the Internet address is 127.10.31.2. |
| -i Interface | Specifies a particular InfiniBand interface. For example, ib0. |
| -k superpacket | Superpacket is a proprietary algorithm that allows the interface to receive large MTU (Maximum Transmit Unit) packets and fragment them in the interface layer to fit in the maximum MTU of the adapter. Enabling the superpacket automatically changes the tcp_sendspace attribute which specifies the number of bytes of data that the sending application can buffer in the kernel before the application is blocked on a send call, and the tcp_recvspace attribute which specifies the number of bytes of data that the receiving system can buffer in the kernel on the receiving sockets queue, with optimized values for the superpacket use. |
| -M mtu | Specifies the MTU for the interface. The IPv4 address or IPv6 address uses this MTU to fragment the packets. |
| -m subnet_mask | Specifies the mask that the gateway must use to determine the appropriate subnetwork for routing. The subnet mask is a set of 4 bytes. The subnet mask consists of high bits (1s) corresponding to the bit positions of the network and subnetwork address, and low bits (0s) corresponding to the bit positions of the host address. |
| -P P_KEY | Specifies the partition key. The common partition keys are 0xFFFF and 0x7FFF. |
| -p ib_port | Specifies the HCA ports that you must use to configure the InfiniBand interface. |
| -q queue_pair_size | Specifies the size of the software queue. The range is from 256 to 32000. |
| -Q Q_KEY | Specifies the multicast qkey used to create a broadcast multicast group if there is no group previously created in the Subnet Manager. The common keys are 1, 0, and 0x1E. |
| -S state | Specifies whether the interface is active. When an interface is marked as inactive, any attempt to transmit messages through that interface fails. This action does not automatically disable routes using the interface. |
| -V ipv6prefix | Specifies the number of high-order bits used by routing protocols. The prefix is usually denoted following the IPv6 address and a slash (/). For example, the notation ff12::/16 represents a 16-bit prefix with a value of 1111111100010010. |
| -v address6 | Specifies the IPv6 address. The address is a 128-bit address represented as eight 16-bit integers separated by colons. Each integer is represented by 4 hex digits. Leading zeros can be skipped, and consecutive null 16-bit integers can be replaced by two colons (one per address). For example, fe80:abcd:0000:0000:0000:0000:0260:8c2e:00a4. |
Example
- To set the required values to configure the IPv4 address over
the InfiniBand interface,
enter:
mkiba -a 192.9.200.9 -i ib0 -A iba0 -p 1 -P -1 -q 4000 -M 2044 -m 255.255.255.0 - To set the required values to configure the IPv6 address over
the InfiniBand interface,
enter:
mkiba -v fe80::2:c903:1:1b40 -i ib0 -A iba0 -p 1 -P -1 -q 4000 -M 2044