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

Language:

How to Add a Fibre Channel 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 either 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. Stop the domain and then add the virtual function.
```
primary# ldm stop-domain 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. Restart the domain.
```
primary# ldm start-domain domain-name
```

Example 29 Adding a Fibre Channel Virtual Function

This example shows how to dynamically add the /SYS/MB/PCIE7/IOVFC.PF0.VF0 virtual function to the ldg2 domain.

primary# ldm add-io /SYS/MB/PCIE7/IOVFC.PF0.VF0 ldg2

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

primary# ldm stop-domain ldg2
primary# ldm add-io /SYS/MB/PCIE7/IOVFC.PF0.VF0 ldg2
primary# ldm start-domain ldg2

How to Remove a Fibre Channel SR-IOV Virtual Function From an I/O Domain

If you cannot use this dynamic method, use the static method instead. 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 30 Dynamically Removing a Fibre Channel Virtual Function

This example shows how to dynamically remove the /SYS/MB/PCIE7/IOVFC.PF0.VF0 virtual function from the ldg2 domain.

primary# ldm remove-io /SYS/MB/PCIE7/IOVFC.PF0.VF0 ldg2

If the command succeeds, the virtual function is removed from the ldg2 domain. When ldg2 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 ldg2
primary# ldm remove-io /SYS/MB/PCIE7/IOVFC.PF0.VF0 ldg2
primary# ldm start-domain ldg2