Using the UCS Manager CLI to Configure the RoCEv2 Interface

Configure Windows SMBDirect RoCEv2 Interface using UCS Manager CLI

Use the following steps to configure the RoCEv2 interface in the Cisco UCS Manager CLI.

Before you begin

You must log in with admin privileges.

Procedure

  Command or Action Purpose

Step 1

Example:

UCS-A # scope service-profile server chassis-id / blade-id or rack_server-id

Enter the service profile for the specified chassis, blade or UCS managed rack server ID.

Step 2

Example:

UCS-A /org/service-profile # show vnic

Display the vNICs available on the server.

Step 3

Example:

UCS-A /org/service-profile # scope vnic vnic name

Enter the vnic mode for the specified vNIC.

Step 4

To configure Windows SMBDirect RoCEv2 Mode 1:

Example:

 UCS-A /org/service-profile/vnic # set adapter-policy Win-HPN-SMBd

Specifies a Windows SMBDirect RoCEv2 adapter policy for RoCEv2 Mode 1.

Step 5

To configure Windows SMBDirect RoCEv2 Mode 2:

Example:

 UCS-A# scope org
UCS-A /org # create vmq-conn-policy policy name
UCS-A /org/vmq-conn-policy* # set multi-queue enabled
UCS-A /org/vmq-conn-policy* # set vmmq-sub-vnic-count 64    
UCS-A /org/vmq-conn-policy* # set vmmq-adaptor-profile-name MQ-SMBd
UCS-A /org/vmq-conn-policy* # commit-buffer
UCS-A /org/vmq-conn-policy #

Configures Windows Mode 2, after creating a VMQ connection policy and assigning the adapter policy MQ-SMBd:

Step 6

Example:

 UCS-A /org/service-profile/vnic* # commit-buffer

Commit the transaction to the system configuration.

This example shows how to configure the RoCEv2 Win-HPN-SMBd adapter policy:

UCS-A# scope service-profile server 1/1 
UCS-A /org/service-profile # show vnic

vNIC:

Name    Fabric ID        Dynamic MAC Addr  Virtualization Preference 
--------   -------------       ----------------------------  ----------------------------------
eth00          A B            00:25:B5:3A:84:00          NONE 
eth01          A               00:25:B5:3A:84:01           NONE 
eth02          B               00:25:B5:3A:84:02            NONE


UCS-A /org/service-profile # scope vnic eth01 
UCS-A /org/service-profile/vnic # set adapter-policy Win-HPN-SMBd
UCS-A /org/service-profile/vnic* # commit-buffer
UCS-A /org/service-profile/vnic #

Configuring the Linux RoCEv2 Interface Using the UCS Manager CLI

Use the following steps to configure the RoCEv2 interface for Linux in the Cisco UCS Manager CLI.

Before you begin

You must log in with admin privileges.

Procedure

  Command or Action Purpose

Step 1

Example:

UCS-A # scope service-profile server chassis-id / blade-id or rack_server-id

Enter the service profile for the specified chassis, blade or UCS managed rack server ID.

Step 2

Example:

UCS-A /org/service-profile # show vnic

Display the vNICs available on the server.

Step 3

Example:

UCS-A /org/service-profile # scope vnic vnic name

Enter the vnic mode for the specified vNIC.

Step 4

Example:

 UCS-A /org/service-profile/vnic # set adapter-policy Linux-NVMe-RoCE

Specify Linux-NVMe-RoCE as the adapter policy for the vNIC that you want to use for NVMeoF.

Step 5

Example:

 UCS-A /org/service-profile/vnic* # commit-buffer

Commit the transaction to the system configuration.

This example shows how to configure the RoCEv2 Linux adapter policy on the eth01 vNIC:

Example

UCS-A# scope service-profile server 1/1
UCS-A /org/service-profile # show vnic

vNIC:
    Name               Fabric ID Dynamic MAC Addr   Virtualization Preference
    ------------------ --------- ------------------ -------------------------
    eth00              A B       00:25:B5:3A:84:00  NONE
    eth01              A         00:25:B5:3A:84:01  NONE
    eth02              B         00:25:B5:3A:84:02  NONE
UCS-A /org/service-profile # scope vnic eth01
UCS-A /org/service-profile/vnic # set adapter-policy Linux-NVMe-RoCE
UCS-A /org/service-profile/vnic* # commit-buffer
UCS-A /org/service-profile/vnic #

Deleting the Windows RoCEv2 Interface Using the CLI for UCS Manager

Use the following steps to delete the Windows RoCEv2 interface in the Cisco UCS Manager CLI.

Before you begin

You must log in with admin privileges.

Procedure

  Command or Action Purpose

Step 1

Example:

UCS-A # scope service-profile server chassis-id / blade-id or rack_server-id

Enter the service profile for the specified chassis, blade or UCS managed rack server ID.

Step 2

Example:

UCS-A /org/service-profile # show vnic

Display the vNICs available on the server.

Step 3

Example:

UCS-A /org/service-profile # scope vnic vnic name

Enter the vnic mode for the specified vNIC.

Step 4

Example:

 UCS-A /org/service-profile/vnic # set adapter-policy Windows

Removes the Windows RoCEv2 adapter policy by setting the default Windows adapter policy.

Step 5

Example:

 UCS-A /org/service-profile/vnic* # commit-buffer

Commit the transaction to the system configuration.

What to do next

This example shows how to remove the RoCEv2 interface on the eth01 vNIC on Windows.

UCS-A# scope service-profile server 1/1 
UCS-A /org/service-profile # show vnic

vNIC:

Name    Fabric ID        Dynamic MAC Addr  Virtualization Preference 
--------   -------------       ----------------------------  ----------------------------------
eth00          A B            00:25:B5:3A:84:00          NONE 
eth01          A               00:25:B5:3A:84:01           NONE 
eth02          B               00:25:B5:3A:84:02            NONE


UCS-A /org/service-profile # scope vnic eth01 
UCS-A /org/service-profile/vnic # set adapter-policy Windows
UCS-A /org/service-profile/vnic* # commit-buffer
UCS-A /org/service-profile/vnic #

Deleting the Linux RoCEv2 Interface Using the UCS Manager CLI

Use the following steps to delete the Linux RoCEv2 interface in the Cisco UCS Manager CLI.

Before you begin

You must log in with admin privileges.

Procedure

  Command or Action Purpose

Step 1

Example:

UCS-A # scope service-profile server chassis-id / blade-id or rack_server-id

Enter the service profile for the specified chassis, blade or UCS managed rack server ID.

Step 2

Example:

UCS-A /org/service-profile # show vnic

Display the vNICs available on the server.

Step 3

Example:

UCS-A /org/service-profile # scope vnic vnic name

Enter the vnic mode for the specified vNIC.

Step 4

Example:

 UCS-A /org/service-profile/vnic # set adapter-policy Linux

Removes Linux-NVMe-RoCE policy by setting the default Linux adapter policy.

Step 5

Example:

 UCS-A /org/service-profile/vnic* # commit-buffer

Commit the transaction to the system configuration.

This example shows how to remove the RoCEv2 interface on the eth01 vNIC on Linux.

Example

UCS-A# scope service-profile server 1/1
UCS-A /org/service-profile # show vnic

vNIC:
    Name               Fabric ID Dynamic MAC Addr   Virtualization Preference
    ------------------ --------- ------------------ -------------------------
    eth00              A B       00:25:B5:3A:84:00  NONE
    eth01              A         00:25:B5:3A:84:01  NONE
    eth02              B         00:25:B5:3A:84:02  NONE
UCS-A /org/service-profile # scope vnic eth01
UCS-A /org/service-profile/vnic # set adapter-policy Linux
UCS-A /org/service-profile/vnic* # commit-buffer

Configuring the RoCEv2 VMware ESXi Interface Using the UCS Manager CLI

Use the following steps to configure the RoCEv2 interface for VMware ESXi in the Cisco UCS Manager CLI.

Before you begin

You must log in with admin privileges.

Procedure

  Command or Action Purpose

Step 1

Example:

UCS-A # scope service-profile server chassis-id / blade-id or rack_server-id

Enter the service profile for the specified chassis, blade or UCS managed rack server ID.

Step 2

Example:

UCS-A /org/service-profile # show vnic

Display the vNICs available on the server.

Step 3

Example:

UCS-A /org/service-profile # scope vnic vnic name

Enter the vnic mode for the specified vNIC.

Step 4

Example:

 UCS-A /org/service-profile/vnic # set adapter-policy VMWareNVMeRoCEv2

Specify VMWareNVMeRoCEv2 as the adapter policy for the vNIC that you want to use for NVMeoF.

Step 5

Example:

 UCS-A /org/service-profile/vnic* # commit-buffer

Commit the transaction to the system configuration.

This example shows how to configure the RoCEv2 VMware adapter policy on the eth01 vNIC:

Example

UCS-A# scope service-profile server 1/1
UCS-A /org/service-profile # show vnic

vNIC:
    Name               Fabric ID Dynamic MAC Addr   Virtualization Preference
    ------------------ --------- ------------------ -------------------------
    eth00              A B       00:25:B5:3A:84:00  NONE
    eth01              A         00:25:B5:3A:84:01  NONE
    eth02              B         00:25:B5:3A:84:02  NONE
UCS-A /org/service-profile # scope vnic eth01
UCS-A /org/service-profile/vnic # set adapter-policy VMWareNVMeRoCEv2
UCS-A /org/service-profile/vnic* # commit-buffer
UCS-A /org/service-profile/vnic #

Deleting the ESXi RoCEv2 Interface Using the UCS Manager CLI

Use the following steps to delete the ESXi RoCEv2 interface using the Cisco UCS Manager CLI.

Before you begin

You must log in with admin privileges.

Procedure

  Command or Action Purpose

Step 1

Example:

UCS-A # scope service-profile server chassis-id / blade-id or rack_server-id

Enter the service profile for the specified chassis, blade or UCS managed rack server ID.

Step 2

Example:

UCS-A /org/service-profile # show vnic

Display the vNICs available on the server.

Step 3

Example:

UCS-A /org/service-profile # scope vnic vnic name

Enter the vnic mode for the specified vNIC.

Step 4

Example:

 UCS-A /org/service-profile/vnic # set adapter-policy VMWare

Removes VMWareNVMeRoCEv2 policy by setting the default ESXi adapter policy.

Step 5

Example:

 UCS-A /org/service-profile/vnic* # commit-buffer

Commit the transaction to the system configuration.

This example shows how to remove the RoCEv2 interface on the eth01 vNIC on ESXi.

Example

UCS-A# scope service-profile server 1/1
UCS-A /org/service-profile # show vnic

vNIC:
    Name               Fabric ID Dynamic MAC Addr   Virtualization Preference
    ------------------ --------- ------------------ -------------------------
    eth00              A B       00:25:B5:3A:84:00  NONE
    eth01              A         00:25:B5:3A:84:01  NONE
    eth02              B         00:25:B5:3A:84:02  NONE
UCS-A /org/service-profile # scope vnic eth01
UCS-A /org/service-profile/vnic # set adapter-policy ESXi
UCS-A /org/service-profile/vnic* # commit-buffer