How to Create and Configure an EoIB Datalink

Language:

You can create EoIB datalinks over IB physical links on the system, one for each GWPORT discovered on the HCA port corresponding to the IB physical link. You can configure IP, VNIC, and VLAN interfaces over these EoIB datalinks and use them for data transfer, similar to the way regular Ethernet datalinks are used.

Become an administrator.
Display information about a chosen IB physical link.
```
# dladm show-ib link
```
If the output shows that the link's port is down, you can still proceed with the datalink creation and configuration. Then when the causes of the down state are resolved, the datalink will automatically transition to the up state. For more information about the information that this command displays, see Displaying Physical Data Link Information.
Create a new EoIB datalink.
```
# dladm create-eoib -l link -g gway -c gway-port eoib-link
```
link

Name of the physical link.

gway

Gateway name.

gway-port

Gateway Ethernet port.

eoib-link

Name of the EoIB datalink.

The command creates an EoIB datalink and binds the host IB port to the Ethernet port on the EoIB gateway.
Create an IP interface over the datalink and assign an IP address to the interface.
```
# ipadm create-ip name
# ipadm create-addr -a address [address-object]
```
name

Name of the EoIB interface.

address

A valid IP address. By default, this address is assumed to be a static address.

address-object

A name that identifies the IP address in association with the IP interface. If address-object is not specified, the OS automatically assigns a name using the format name/protocol
(Optional) Display the interface information.
```
# ipadm show-addr
```
Display EoIB datalink information.
In the following two commands, the second shows more IB related information about the link than the first command that shows general information.
```
# dladm show-link [eoib-link]

# dladm show-eoib [eoib-link]
```
A typical output of the dladm show-eoib command would be similar to the following:
```
LINK    GWNAME  GWPORT   GWID FLAGS  SPEED MACADDRESS     OVER 
eib1    nm2gw-1 0a-eth-2 1A8  aHnU-- 10000 0:25:8b:60:2:3 ibp1
```
The GWID value 1A8 is the unique identifier associated with the gateway and Ethernet port {nm2gw-1, 0a-eth-2} on the IB fabric. The MAC address is the address specified as a parameter when the vnic associated with this datalink was created on the gateway. For more detailed explanation of the meaning of the rest of the information provided in the output, refer to the dladm(1M) man page.

Note - The vnic in this context refers to the entity created on the gateway switch using the createvnic gateway command. This vnic is different from the entity that is created with Oracle Solaris dladm subcommands.
For details about the createvnic command, see the Sun Network QDR InfiniBand Gateway Switch Command Reference.

Example 3-14 Creating and Configuring an EoIB Datalink

In this example, an EoIB link is configured over ibp1.

# dladm show-ib ibp1
LINK    HCAGUID        PORTGUID       PORT STATE GWNAME  GWPORT   PKEYS
ibp1    212800013F2F5A 212800013F2F5C 1    up    nm2gw-1 0a-eth-1 FFFF,8001
                                                 nm2gw-1 0a-eth-2
                                                 nm2gw-1 0a-eth-3
                                                 nm2gw-1 0a-eth-4

# dladm create-eoib -l ibp1 -g nm2gw-1 -c 0a-eth-2 eib1

# ipadm create-ip eib1
# ipadm create-addr -a=192.168.99.142/24
# ipadm show-addr eib1
ADDROBJ   STATE    TYPE   ADDR
eib1/v4   static   ok     192.168.99.142.24

# dladm show-link eib1
LINK    CLASS  MTU   STATE  OVER
eib1    eoib   1500  up     ibp1

# dladm show-eoib eib1
LINK    GWNAME  GWPORT   GWID FLAGS  SPEED MACADDRESS     OVER 
eib1    nm2gw-1 0a-eth-2 1A8  aHnU-- 10000 0:25:8b:60:2:3 ibp1