VIOS FC port labels are used for partition migration and partition remote restart operations. The same label names must be defined on both the source and destination VIOS FC ports used in the operation.
VIOS group labels are also used for partition migration and partition remote restart operations. The same label names must be defined on both the source and destination managed systems used in the operation.
| -o | The operation to perform. Valid values are a to add a VIOS group label, r to remove a VIOS FC port label or one or more VIOS group labels, and s to configure a VIOS FC port label, to change the attributes of a VIOS group label, or to change the default VIOS label override settings for the managed system. |
| -m | The name of the managed system for which to perform the operation. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name. |
| -l |
The name of the VIOS FC port label to set, or the name of the VIOS group label to add, remove, or set.
When removing a VIOS group label, you can use this option to specify the name of the label to remove, or you can specify the resource attribute to remove all labels of the specified resource type. This option is required when setting a VIOS FC port label, when adding a VIOS group label, and when changing the attributes of a VIOS group label. This option is optional when removing a VIOS group label. This option is not valid when removing a VIOS FC port label or changing the default VIOS label override settings. |
| -f |
The name of the file containing the input data for this command. The input data consists of attribute name/value pairs, which are in comma separated value (CSV) format.
The format of the input data is as follows: attribute-name=value,attribute-name=value,... Note that certain attributes accept a comma separated list of values, as follows: attribute-name=value,value,... ,... When a list of values is specified, the attribute name/value pair must be enclosed in double quotes. Depending on the shell being used, nested double quote characters may need to be preceded by an escape character, which is usually a ’#146; character. If ’+=’ is used in the attribute name/value pair instead of ’=’, the specified value is added to the existing list. += can be used in set operations only. If ’-=’ is used in the attribute name/value pair instead of ’=’, the specified value is deleted from the existing list. -= can be used in set operations only.
Attribute names for setting or removing a VIOS FC port label:
Attribute names for adding a VIOS group label:
VIOS-name[/VIOS-IP-addresses]
The ’/’ character is optional, but it must be present
VIOS-IP-addresses is a comma separated list of one
Either vios_names or vios_ids is required.
VIOS-ID[/VIOS-IP-addresses]
The ’/’ character is optional, but it must be present
VIOS-IP-addresses is a comma separated list of one
Either vios_names or vios_ids is required.
Attribute names for setting a VIOS group label:
VIOS-name[/VIOS-IP-addresses]
The ’/’ character is optional, but it must be present
VIOS-IP-addresses is a comma separated list of one
VIOS-ID[/VIOS-IP-addresses]
The ’/’ character is optional, but it must be present
VIOS-IP-addresses is a comma separated list of one
Attribute names for removing a VIOS group label:
Attribute names for changing the default VIOS label override settings:
Input data for this command can be specified with this option or the -i option. The -f and the -i options are mutually exclusive. Input data is required when setting and removing a VIOS FC port label, adding a VIOS group label, changing the attributes of a VIOS group label, or changing the default VIOS label override settings for the managed system. Input data is optional when removing VIOS group labels. |
| -i |
This option allows you to enter input data on the command line, instead of using a file. Data entered on the command line must follow the same format as data in a file, and must be enclosed in double quotes.
Input data for this command can be specified with this option or the -f option. The -i and the -f options are mutually exclusive. Input data is required when setting and removing a VIOS FC port label, adding a VIOS group label, changing the attributes of a VIOS group label, or changing the default VIOS label override settings for the managed system. Input data is optional when removing VIOS group labels. |
| --help | Display the help text for this command and exit. |
Set a VIOS FC port label:
labelvios -m sys1 -o s -l fcportA -i "resource=fcport,port_name=fc0,
vios_names=vios1"
Add a VIOS vSCSI group label:
labelvios -m sys1 -o a -l vscsiGroupA -i "resource=vscsi,
vios_names=vios1"
Add a VIOS vFC group label:
labelvios -m sys1 -o a -l vfcGroup1 -i "resource=vfc,\"vios_ids=1,2\""
Add a VIOS MSP exclude group label:
labelvios -m sys1 -o a -l msps1 -i "resource=msp,type=exclude,
\"vios_names=\"\"vios1/9.1.2.3,9.1.2.4\"\",vios2/9.1.2.5\""
Add VIOSs to a VIOS group label:
labelvios -m sys1 -o s -l vcsiGroupA -i "\"vios_names+=vios2,vios3\""
Remove an IP address from a VIOS MSP group label:
labelvios -m sys1 -o s -l msps1 -i "vios_names-=vios1/9.1.2.3"
Change the name of a VIOS group label:
labelvios -m 9080-HEX*1234567 -o s -l label1 -i "new_name=vfclabel"
Change the default VIOS MSP group label override:
labelvios -m sys1 -o s -i "msp_label_override=1"
Remove the FC port label for FC port fc0 on the VIOS with ID 1:
labelvios -m sys -o r -i "resource=fcport,port_name=fc0,vios_ids=1"
Remove the VIOS group label msps1:
labelvios -m sys1 -o r -l msps1
Remove all VIOS MSP group labels:
labelvios -m sys1 -o r -i "resource=msp"
| None | |
| None | |
| Linux | LABELVIOS (1) | December 2022 |