Creating and Removing IB Partition Links

Language:

You can create one or more IB partition data links on top of IB physical links with the same P_Key. You use the partition data links for data transfers.

Use the following command syntax to create an IB partition link:

# 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 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. If the partition key is not configured on the port or the port is marked as down, use the following command:

# 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.

How to Create IB Partition Links

Become an administrator.
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.
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(8) man page.

Example 30 Configuring a Partition Link

This example shows how to configure a partition link. It creates partition links over the physical links ibp0 and ibp2 and configures on IPoIB interface 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.
Remove the 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---
```