Creating or Destroying IB Links

Language:

This section contains procedures for creating IB partition links or removing them.

How to Create IB Partition Links

One or more IB partition data links can be created on the top of the IB physical links with the same P_Key. The partition data links are used for data transfers.

Become an administrator.
For more information, see Using Your Assigned Administrative Rights in Securing Users and Processes in Oracle Solaris 11.3.
Create new IB partition links.
```
# dladm create-part -l link -P key partition
```
link

Name of the physical data link.

key

Value of the partition key (P_key).

partition

Name of the partition link and using the format P_key.link

The command assumes that the port is up, the P_Key is present on the port, and IPoIB is successfully initialized. If these three conditions do not exist, the command fails.
Note - Even if the conditions do not exist, you can still create a partition link by using the –f option. Suppose that the partition key is not configured on the port or the port is marked as down. To create the partition link, type the following:
```
# dladm create-part -f -l link -P key name
```
In this case, the link state transitions to up when the partition key is added to the port and the port is activated.
Display the IB partition link information.
```
# dladm show-part
```
Plumb and assign an IP address to an IB partition link.
```
# ipadm create-ip name
# ipadm create-addr -a address [address-object]
```
name

Name of the partition link.

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 ip-name/protocol

For more information about the ipadm command, see the ipadm(1M) man page.

Example 26 Configuring a Partition Link

This example show how to perform the following task:

Create partition links over the physical links ibp0 and ibp2
Configure an IPoIB interface is over ibp2.

The values of P_key are 0x8001 for ibp0 and 0x9000 for ibp2.

# dladm create-part -l ibp0 -P 0x8001 p8001.ibp0
# dladm create-part -l ibp0 -P 0x9000 p9000.ibp2

# dladm show-part
LINK           P_Key      OVER       STATE      FLAGS
p8000.ibp0       8001      ibp0      unknown     ----
p9000.ibp2       9000      ibp2      unknown     ----

# ipadm create-ip p9000.ibp2
# ipadm create-addr -a 1.1.1.1 p9000.ibp2/ipv4
# ipadm show-addr
ADDROJB           TYPE      STATE   ADDR
p9000.ibp2/ipv4   static    ok      1.1.1.1/24

# dladm show-part
LINK           P_Key      OVER       STATE      FLAGS
p8000.ibp0       8001      ibp0      unknown     ----
p9000.ibp2       9000      ibp2           up     ----

How to Remove an IB Partition Link

Before You Begin

Make sure that no IPoIB interface is configured over the partition link. If an interface exists, remove it first.

Become an administrator.
For more information, see Using Your Assigned Administrative Rights in Securing Users and Processes in Oracle Solaris 11.3.
Remove an IB partition link.
```
# dladm delete-part partition
```
In this example, the partition link p8001.ibp0 is removed after ensuring that it has no existing interface.
```
# dladm delete-part p8001.ibp0
```
Review the partition link information.
The following example shows the remaining partition link on the system after p8001.ibp0 is removed.
```
# dldam show-part
LINK        P_Key      OVER     STATE      FLAGS
p9000.ibp2   9000      ibp2      down      f---
```