Adding and Removing Ethernet SR-IOV Virtual Functions on I/O Domains

Language:

How to Add an Ethernet SR-IOV Virtual Function to an I/O Domain

If you cannot dynamically remove the virtual function, use the static method. See Static SR-IOV.

Identify the virtual function that you want to add to an I/O domain.
```
primary# ldm list-io
```
Add a virtual function dynamically or statically.
- To dynamically add a virtual function:
```
primary# ldm add-io vf-name domain-name
```
  vf-name is the pseudonym name or the path name of the virtual function. The recommended practice is to use the pseudonym name. domain-name specifies the name of the domain to which you add the virtual function.
  
  The device path name for the virtual function in the domain is the path shown in the list-io -l output.
- To statically add a virtual function:
  1. Initiate a delayed reconfiguration and then add the virtual function.
```
primary# ldm start-reconf root-domain-name
primary# ldm add-io vf-name domain-name
```
    vf-name is the pseudonym name or the path name of the virtual function. The recommended practice is to use the pseudonym name. domain-name specifies the name of the domain to which you add the virtual function. The specified guest domain must be in the inactive or bound state.
    
    The device path name for the virtual function in the domain is the path shown in the list-io -l output.
  2. Reboot the root domain.
    - To reboot the non-primary root domain:
```
primary# ldm stop-domain -r root-domain
```
    - To reboot the primary root domain:
```
primary# shutdown -i6 -g0 -y
```

Example 14 Adding an Ethernet Virtual Function

This example shows how to dynamically add the /SYS/MB/NET0/IOVNET.PF0.VF0 virtual function to the ldg1 domain.

primary# ldm add-io /SYS/MB/NET0/IOVNET.PF0.VF0 ldg1

If you cannot add the virtual function dynamically, use the static method:

primary# ldm stop-domain ldg1
primary# ldm add-io /SYS/MB/NET0/IOVNET.PF0.VF0 ldg1
primary# ldm start-domain ldg1

How to Remove an Ethernet Virtual SR-IOV Function From an I/O Domain

If you cannot dynamically remove the virtual function, use the static method. See Static SR-IOV.

Caution - Before removing the virtual function from the domain, ensure that it is not critical for booting that domain.

Identify the virtual function that you want to remove from an I/O domain.
```
primary# ldm list-io
```
Remove a virtual function either dynamically or statically.
- To dynamically remove a virtual function:
```
primary# ldm remove-io vf-name domain-name
```
  vf-name is the pseudonym name or the path name of the virtual function. The recommended practice is to use the device pseudonym. domain-name specifies the name of the domain from which you remove the virtual function.
- To statically remove a virtual function:
  1. Stop the I/O domain.
```
primary# ldm stop-domain domain-name
```
  2. Remove the virtual function.
```
primary# ldm remove-io vf-name domain-name
```
    vf-name is the pseudonym name or the path name of the virtual function. The recommended practice is to use the device pseudonym. domain-name specifies the name of the domain from which you remove the virtual function. The specified guest domain must be in the inactive or bound state.
  3. Start the I/O domain.
```
primary# ldm start-domain domain-name
```

Example 15 Dynamically Removing an Ethernet Virtual Function

This example shows how to dynamically remove the /SYS/MB/NET0/IOVNET.PF0.VF0 virtual function from the ldg1 domain.

primary# ldm remove-io /SYS/MB/NET0/IOVNET.PF0.VF0 ldg1

If the command succeeds, the virtual function is removed from the ldg1 domain. When ldg1 is restarted, the specified virtual function no longer appears in that domain.

If you cannot remove the virtual function dynamically, use the static method:

primary# ldm stop-domain ldg1
primary# ldm remove-io /SYS/MB/NET0/IOVNET.PF0.VF0 ldg1
primary# ldm start-domain ldg1