chhwres - change hardware resources
Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also
To add, remove, or move a physical I/O slot:
chhwres -r io -m managed-system -o {a | r | m}
{-p partition-name | --id partition-ID}
[{-t target-partition-name |
--tid target-partition-ID}]
-l slot-DRC-index [-a "attributes"]
[-w wait-time] [-d detail-level] [--force]To set physical I/O attributes:
chhwres -r io -m managed-system -o s
{-p partition-name | --id partition-ID}
--rsubtype {iopool | taggedio}
-a "attributes"To clear a physical I/O slot or bus:
chhwres -r io -m managed-system -o c
[--rsubtype {bus | slot}] [-l slot-DRC-index]To add or remove a virtual I/O adapter:
chhwres -r virtualio -m managed-system -o {a | r}
{-p partition-name | --id partition-ID}
[--rsubtype {eth | fc | scsi | serial | vnic}]
[-s virtual-slot-number] [-a "attributes"]
[-w wait-time] [-d detail-level] [--force] [-v]To change a virtual ethernet adapter or virtual NIC assigned to a partition:
chhwres -r virtualio -m managed-system -o s
--rsubtype {eth | vnic}
{-p partition-name | --id partition-ID}
-s virtual-slot-number -a "attributes"
[-w wait-time] [-d detail-level] [--force]
[--allownetdisrupt]To enable or disable a virtual ethernet adapter or virtual NIC:
chhwres -r virtualio -m managed-system -o {d | e}
--rsubtype {eth | vnic}
{-p partition-name | --id partition-ID}
-s virtual-slot-numberTo set virtual I/O attributes:
chhwres -r virtualio -m managed-system -o s
[{-p partition-name | --id partition-ID}]
--rsubtype {eth | hsl | virtualopti}
-a "attributes"To set virtual NIC backing device attributes:
chhwres -r virtualio -m managed-system -o s
--rsubtype vnicbkdev
{-p partition-name | --id partition-ID}
-s virtual-slot-number --logport logical-port-ID
-a "attributes"To make a virtual NIC backing device active or clear a virtual NIC backing device error:
chhwres -r virtualio -m managed-system -o {act | c}
--rsubtype vnicbkdev
{-p partition-name | --id partition-ID}
-s virtual-slot-number --logport logical-port-IDTo add or remove a virtual network or set virtual network attributes:
chhwres -r virtualio -m managed-system -o {a | r | s}
--rsubtype vnetwork --vnetwork virtual-network
[-a "attributes"]To add or remove a virtual switch:
chhwres -r virtualio -m managed-system -o {a | r}
--rsubtype vswitch --vswitch virtual-switchTo set virtual switch attributes:
chhwres -r virtualio -m managed-system -o s
--rsubtype vswitch --vswitch virtual-switch
[-a "attributes"] [--force]To synchronize the virtual switch mode:
chhwres -r virtualio -m managed-system -o sync
--rsubtype vswitch --vswitch virtual-switchTo add, remove, or move memory:
chhwres -r mem -m managed-system -o {a | r | m | s}
{-p partition-name | --id partition-ID}
[{-t target-partition-name |
--tid target-partition-ID}]
[-q quantity] [--entitled quantity]
[-w wait-time] [-d detail-level] [--force]To set memory attributes for the managed system:
chhwres -r mem -m managed-system -o s
-a "attributes"To set memory attributes for a partition:
chhwres -r mem -m managed-system -o s
{-p partition-name | --id partition-ID}
-a "attributes"
[-w wait-time] [-d detail-level] [--force]To switch over a running shared memory partition to its redundant paging Virtual I/O Server (VIOS) partition:
chhwres -r mem -m managed-system -o so
{-p partition-name | --id partition-ID}To reset I/O entitled memory statistics for a partition:
chhwres -r mem -m managed-system -o rs
{-p partition-name | --id partition-ID}
[-w wait-time] [-d detail-level]To add or remove a shared memory pool, or set shared memory pool attributes:
chhwres -r mempool -m managed-system -o {a | r | s}
[-a "attributes"]To add or remove a device in the shared memory pool (on managed systems that support partition suspend and resume operations, this adds or removes a device in the reserved storage device pool):
chhwres -r mempool -m managed-system -o {a | r}
{-p paging-VIOS-partition-name |
--id paging-VIOS-partition-ID}
--rsubtype pgdev --device device-nameTo add or remove a reserved storage device pool, or set reserved storage device pool attributes (only supported on managed systems that support partition suspend and resume operations):
chhwres -r rspool -m managed-system -o {a | r | s}
[-a "attributes"]To add or remove a device in the reserved storage device pool (only supported on managed systems that support partition suspend and resume operations):
chhwres -r rspool -m managed-system -o {a | r}
{-p VIOS-partition-name | --id VIOS-partition-ID}
--rsubtype rsdev --device device-name [--manual]To add, remove, or move processing resources:
chhwres -r proc -m managed-system -o {a | r | m | s}
{-p partition-name | --id partition-ID}
[{-t target-partition-name |
--tid target-partition-ID}]
[--procs quantity] [--procunits quantity]
[-w wait-time] [-d detail-level] [--force]To set processing attributes for the managed system:
chhwres -r proc -m managed-system -o s -a "attributes"To set processing attributes for a partition:
chhwres -r proc -m managed-system -o s
{-p partition-name | --id partition-ID}
-a "attributes"To set shared processor pool attributes on a managed system that supports multiple shared processor pools:
chhwres -r procpool -m managed-system -o s
{--poolname pool-name | --poolid pool-ID}
-a "attributes"To set shared processor pool attributes for a partition on a managed system that supports multiple shared processor pools:
chhwres -r procpool -m managed-system -o s
{-p partition-name | --id partition-ID}
-a "attributes"To add, remove, or move a Host Ethernet Adapter (HEA) logical port:
chhwres -r hea -m managed-system -o {a | r | m}
{-p partition-name | --id partition-ID}
[{-t target-partition-name |
--tid target-partition-ID}]
-l HEA-adapter-ID
[--physport physical-port-ID]
-g port-group --logport logical-port-ID
[-a "attributes"]
[-w wait-time] [-d detail-level] [--force]To set HEA attributes:
chhwres -r hea -m managed-system -o s
-l HEA-adapter-ID
[--physport physical-port-ID]
-g port-group -a "attributes"
To switch an SR-IOV adapter to shared mode:
chhwres -r sriov -m managed-system --rsubtype adapter
-o a -a "attributes"
To switch an SR-IOV adapter to dedicated mode:
chhwres -r sriov -m managed-system --rsubtype adapter
-o r -a "attributes"
To move the configuration of a failed SR-IOV adapter to a new adapter:
chhwres -r sriov -m managed-system --rsubtype adapter
-o m -a "attributes"
To set SR-IOV physical port attributes:
chhwres -r sriov -m managed-system --rsubtype physport
-o s -a "attributes"
To add or remove an SR-IOV logical port, or to set SR-IOV logical port attributes:
chhwres -r sriov -m managed-system --rsubtype logport
-o {a | r | s}
{-p partition-name | --id partition-ID}
-a "attributes"
[-w wait-time] [-d detail-level] [--force]To reset statistics for an SR-IOV logical or physical port:
chhwres -r sriov -m managed-system -o rs
--rsubtype {logport | physport}
-a "attributes"
chhwres changes the hardware resource configuration of the managed-system. chhwres is used to perform dynamic logical partitioning (DLPAR) operations.When chhwres is used to add a virtual I/O adapter to a Virtual I/O Server (VIOS) partition, chhwres issues the VIOS cfgdev command to configure the device in the VIOS. When chhwres is used to remove a virtual I/O adapter from a VIOS partition, chhwres issues the VIOS rmdev command to remove the device from the VIOS partition.
When chhwres is used to remove memory or processing resources from a shutdown partition, if the amount of memory or processing resources falls below the minimum for the partition, the minimum, assigned, and maximum values for the partition are all set to 0. Also, if the memory values for a partition are set to 0, the processing resource values for the partition will also be set to 0. Likewise, if the processing resource values for a partition are set to 0, the memory values for the partition will also be set to 0.
-r The type of hardware resources to change. Valid values are io for physical I/O, virtualio for virtual I/O, mem for memory, mempool for shared memory pool, rspool for reserved storage device pool, proc for processing resources, procpool for shared processor pool, hea for Host Ethernet Adapter (HEA) resources, and sriov for Single Root I/O Virtualization (SR-IOV) resources. Reserved storage device pool operations are only supported on managed systems that support partition suspend and resume operations.
--rsubtype The subtype of hardware resources to change. Valid physical I/O resource subtypes are slot for I/O slots, bus for I/O buses, iopool for I/O pools, and taggedio for tagged I/O resources. Valid virtual I/O resource subtypes are eth for virtual ethernet, fc for virtual fibre channel, scsi for virtual SCSI, serial for virtual serial, hsl for High Speed Link (HSL) OptiConnect, virtualopti for virtual OptiConnect, vnetwork for virtual network, vnic for virtual NIC, vnicbkdev for virtual NIC backing device, and vswitch for virtual switch resources. Valid SR-IOV resource subtypes are adapter for SR-IOV adapter resources, logport for SR-IOV logical port resources, and physport for SR-IOV physical port resources. The only valid shared memory pool resource subtype is pgdev for paging space devices. The only valid reserved storage device pool resource subtype is rsdev for reserved storage devices. On a managed system that supports Active Memory Sharing and partition suspend and resume operations, the command chhwres -m managed-system -r mempool --rsubtype pgdev -o {a | r} -p VIOS-partition-name --device device-name adds or removes a device in the reserved storage device pool, and is equivalent to the command chhwres -m managed-system -r rspool --rsubtype rsdev -o {a | r} -p VIOS-partition-name --device device-name.
This option is required for physical I/O and virtual I/O set operations, for virtual I/O add operations, for virtual network and virtual switch operations, and for SR-IOV operations. This option is not valid for memory, processor, shared processor pool, or HEA operations.
-m The name of the managed system for which the hardware resource configuration is to be changed. 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. -o The operation to perform. Valid values are a to add hardware resources, r to remove hardware resources, m to move hardware resources from one partition to another, s to set hardware resource related attributes, d to disable a virtual ethernet adapter or virtual NIC, e to enable a virtual ethernet adapter or virtual NIC, rs to reset I/O entitled memory statistics for a partition or to reset statistics for an SR-IOV logical or physical port, so to switch over a running shared memory partition to its redundant paging VIOS partition, sync to synchronize the virtual switch mode, c to clear a physical I/O slot or bus, or clear a virtual NIC backing device error, or act to make a virtual NIC backing device active. The c operation is useful for clearing stale physical I/O slot or bus information after a physical I/O adapter or drawer has been concurrently removed but not replaced.
-p The name of the partition for which to perform the operation. For a move operation, this is the source partition (the partition the resources will be moved from) for the operation. When adding or removing a device in the shared memory pool or the reserved storage device pool, use this option to specify the name of the VIOS partition which has the device. If the device is accessed by more than one VIOS partition, then only one of the VIOS partitions must be specified, and the device name specified with the --device option must be the name of the device on that VIOS partition.
You can either use this option to specify the name of the partition for which to perform the operation, or use the --id option to specify the partition’s ID. The -p and the --id options are mutually exclusive.
--id The ID of the partition for which to perform the operation. For a move operation, this is the source partition (the partition the resources will be moved from) for the operation. When adding or removing a device in the shared memory pool or the reserved storage device pool, use this option to specify the ID of the VIOS partition which has the device. If the device is accessed by more than one VIOS partition, then only one of the VIOS partitions must be specified, and the device name specified with the --device option must be the name of the device on that VIOS partition.
You can either use this option to specify the ID of the partition for which to perform the operation, or use the -p option to specify the partition’s name. The --id and the -p options are mutually exclusive.
-t The name of the target partition for a move operation. You can either use this option to specify the name of the target partition, or use the --tid option to specify the ID of the partition. The -t and the --tid options are mutually exclusive.
A target partition is required to be specified with this option or the --tid option for a move operation. This option is not valid for any other operation.
--tid The ID of the target partition for a move operation. You can either use this option to specify the ID of the target partition, or use the -t option to specify the name of the target partition. The --tid and the -t options are mutually exclusive.
A target partition is required to be specified with this option or the -t option for a move operation. This option is not valid for any other operation.
--poolname The name of the shared processor pool for which to set attributes. You can either use this option to specify the name of the shared processor pool, or use the --poolid option to specify the ID of the shared processor pool. The --poolname and the --poolid options are mutually exclusive.
A shared processor pool is required to be specified with this option or the --poolid option when setting the attributes for a shared processor pool. This option is not valid for any other operation.
--poolid The ID of the shared processor pool for which to set attributes. You can either use this option to specify the ID of the shared processor pool, or use the --poolname option to specify the name of the shared processor pool. The --poolid and the --poolname options are mutually exclusive.
A shared processor pool is required to be specified with this option or the --poolname option when setting the attributes for a shared processor pool. This option is not valid for any other operation.
-l When adding, removing, moving, or clearing a physical I/O slot, use this option to specify the DRC index of the slot. When performing an HEA operation, use this option to specify the adapter ID of the HEA for which the operation is to be performed.
This option is not valid for any other operation.
-s The virtual slot number of the virtual I/O adapter to add, change, disable, enable, or remove. When performing an operation on a virtual NIC backing device, this is the virtual slot number of the virtual NIC. When adding a virtual I/O adapter, if this option is not specified then the next available virtual slot number will be assigned to the virtual I/O adapter.
When changing, disabling, enabling, or removing a virtual I/O adapter, or when performing an operation on a virtual NIC backing device, this option is required.
-q The quantity of memory to add, remove, move, or set. The quantity specified must be in megabytes and it must be a multiple of the memory region size for the managed-system. For a partition using shared memory, this is the quantity of logical memory to add, remove, or set. Memory move operations are not supported for partitions using shared memory.
When adding memory to a partition or removing memory from a partition, you can either specify an add or remove operation and specify the amount of memory you want to add or remove, or you can specify a set operation and specify the total amount of memory you want the partition to have when the operation completes.
When the current, pending, and runtime memory values for a partition are not the same and an add or remove operation is being performed, the quantity of memory specified with this option is added to or removed from the current value.
--entitled The quantity of I/O entitled memory to add, remove, or set. The quantity specified must be in megabytes, or quantity can be auto. If quantity is a number, then automatic I/O entitled memory management will no longer be provided for the partition after the quantity of I/O entitled memory is added, removed, or set. If quantity is auto, then the partition will be set to have automatic I/O entitled memory management, and if necessary, I/O entitled memory will be added or removed at this time so that the partition has the amount of memory required with automatic I/O entitled memory management. When adding I/O entitled memory to a partition or removing I/O entitled memory from a partition, you can either specify an add or remove operation and specify the amount of I/O entitled memory you want to add or remove, or you can specify a set operation and specify the total amount of I/O entitled memory you want the partition to have when the operation completes.
This option is only valid for partitions using shared memory.
--procs When adding or removing processing resources to or from a partition using dedicated processors, or when moving processing resources from a partition using dedicated processors to another partition using dedicated processors, use this option to specify the quantity of dedicated processors to add, remove, move, or set. When adding or removing processing resources to or from a partition using shared processors, or when moving processing resources from a partition using shared processors to another partition using shared processors, use this option to specify the quantity of virtual processors to add, remove, move, or set.
When moving processing resources from a partition using dedicated processors to a partition using shared processors, use this option to specify the quantity of dedicated processors to be moved from the source partition and added as shared processors to the target partition.
This option is not valid when moving processing resources from a partition using shared processors to a partition using dedicated processors. The --procunits option must be used instead.
The quantity of processing resources specified with this option must be a whole number.
When adding processing resources to a partition or removing processing resources from a partition, you can either specify an add or remove operation and specify the number of processing resources you want to add or remove, or you can specify a set operation and specify the total number of processing resources you want the partition to have when the operation completes.
When the current, pending, and runtime processing resource values for a partition are not the same and an add or remove operation is being performed, the quantity of processing resources specified with this option is added to or removed from the current value.
--procunits When adding or removing processing resources to or from a partition using shared processors, or when moving processing resources from a partition using shared processors to another partition using shared processors, use this option to specify the quantity of processing units to add, remove, move, or set. When moving processing resources from a partition using shared processors to a partition using dedicated processors, use this option to specify the quantity of shared processors to be moved from the source partition and added as dedicated processors to the target partition.
This option is not valid when moving processing resources from a partition using dedicated processors to a partition using shared processors. The --procs option must be used instead.
When moving processing resources from a partition using shared processors to a partition using dedicated processors, the quantity of processing units specified with this option must be a whole number. Otherwise, the quantity of processing units specified with this option can have up to 2 decimal places.
When adding processing resources to a partition or removing processing resources from a partition, you can either specify an add or remove operation and specify the number of processing resources you want to add or remove, or you can specify a set operation and specify the total number of processing resources you want the partition to have when the operation completes.
When the current, pending, and runtime processing resource values for a partition are not the same and an add or remove operation is being performed, the quantity of processing resources specified with this option is added to or removed from the current value.
--physport The ID of the HEA physical port. This option is required when adding an HEA logical port to a partition. This option is also required when setting HEA physical port attributes. This option is not valid for any other operation. -g The HEA port group. This option is required for all HEA operations, and is not valid for any other operation. --logport The ID of the HEA logical port to add, remove, or move, or the ID of the SR-IOV logical port of the virtual NIC backing device. This option is required for an HEA add, remove, or move operation and for a virtual NIC backing device operation. This option is not valid for any other operation.
--vnetwork The virtual network name. This option is required for all virtual network operations. This option is not valid for any other operation.
--vswitch The virtual switch name. This option is required for all virtual switch operations. This option is not valid for any other operation.
--device The name of the device to add or remove. This option is required when adding or removing a device in the shared memory pool or the reserved storage device pool. This option is not valid for any other operation.
--manual When adding a device to the reserved storage device pool, specify this option to indicate that the device will only be available for manual assignment to partitions by the user. A reserved storage device that is added to the pool as a manual device cannot be automatically assigned to a partition by the Hardware Management Console (HMC). If this option is not specified when adding a device to the reserved storage device pool, the device will only be available for automatic assignment to partitions by the HMC.
This option is only valid when adding a device to the reserved storage device pool.
-w The maximum time, in minutes, to wait for partition operating system commands issued by the HMC to complete. If a partition operating system command does not complete within the time specified, the operation will be stopped. wait-time must be a whole number. If wait-time is 0, partition operating system commands will not be timed out.
If this option is not specified, a default value of 5 minutes is used.
This option is valid for add, remove, move, and memory and processor set operations for AIX, Linux, and VIOS partitions. In addition, this option is valid for I/O entitled memory statistics reset operations for AIX and Linux partitions. This option is also valid for memory add, remove, move, and set operations for IBM i partitions, and when changing the additional VLAN IDs for a virtual ethernet adapter assigned to a VIOS partition.
-d The level of detail to request from partition operating system commands issued by the HMC. Valid values are 1 (lowest) through 4 (highest). If this option is not specified, a default value of 1 is used.
This option is valid for add, remove, move, and memory and processor set operations for AIX, Linux, and VIOS partitions. In addition, this option is valid for I/O entitled memory statistics reset operations for AIX and Linux partitions. This option is also valid when changing the additional VLAN IDs for a virtual ethernet adapter assigned to a VIOS partition.
--force This option allows you to force a remove or move operation to be performed for a physical I/O slot that is currently in use (varied on) by an IBM i partition. This option also allows you to force an add, remove, move, or memory or processor set operation to be performed for an AIX, Linux, or VIOS partition that does not have an RMC connection to the HMC. If this command completes successfully, you will need to restart your operating system for the change to take affect. You should only use this option if you intentionally configured your LAN to isolate the HMC from the operating system of your partition.
This option also allows you to force the additional VLAN IDs for a virtual ethernet adapter to be changed for a VIOS partition that does not have an RMC connection to the HMC.
This option also allows you to force a virtual switch to be set to VEPA mode when the physical switch does not support the IEEE 802.1Qbg standard.
--allownetdisrupt This option must be specified when adding one or more backing devices to a virtual NIC that currently has only one backing device and its MAC address is the same as the virtual NIC’s MAC address. The HMC will remove the existing backing device and recreate it with a different MAC address after adding the specified backing devices. The recreate will cause a short network disruption for the virtual NIC. -a The configuration data for the command. The configuration data consists of attribute name/value pairs, which are in comma separated value (CSV) format. The configuration data must be enclosed in double quotes. The format of the configuration 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 ’=’, then the specified value is added to the existing value for the attribute if the attribute is numerical. If the attribute is a list, then the specified value(s) is added to the existing list.
If ’-=’ is used in the attribute name/value pair instead of ’=’, then the specified value is subtracted from the existing value for the attribute if the attribute is numerical. If the attribute is a list, then the specified value(s) is deleted from the existing list.
Valid attribute names for attributes that can be set when adding, removing, or moving a physical I/O slot:
slot_io_pool_idValid attribute names for setting I/O pool attributes:
lpar_io_pool_ids
comma separatedValid attribute names for setting tagged I/O resources (IBM i partitions only):
load_source_slot
DRC index of I/O slot, DRC index of SR-IOV logical
port, or virtual slot number
alt_restart_device_slot
DRC index of I/O slot, DRC index of HEA or SR-IOV
logical port, or virtual slot number
console_slot
DRC index of I/O slot, DRC index of HEA or SR-IOV
logical port, virtual slot number, or the value hmc
alt_console_slot
DRC index of I/O slot
op_console_slot
DRC index of I/O slotValid attribute names for adding a virtual ethernet adapter:
ieee_virtual_eth
Valid values:
0 - not IEEE 802.1Q compatible
1 - IEEE 802.1Q compatible
Required
port_vlan_id
Required
addl_vlan_ids
is_trunk
Valid values:
0 - no
1 - yes
trunk_priority
Valid values are integers between 1
and 15, inclusive
Required for a trunk adapter
vswitch
mac_addr
12 hexadecimal characters
If not specified, a unique MAC address will be
automatically generated for the adapter. It is
highly recommended that you use an automatically
generated MAC address.
allowed_os_mac_addrs
1 to 4 comma separated MAC addresses, each specified
as 12 hexadecimal characters. Other valid values:
all - all OS defined MAC addresses are allowed
none - no OS defined MAC addresses are allowed
qos_priority
Valid values are none and integers between 0 and 7,
inclusive
vsi_manager_id
vsi_type_id
vsi_type_versionValid attribute names for adding a virtual fibre channel adapter:
adapter_type
Valid values are client or server
Required
remote_lpar_id | remote_lpar_name
One of these attributes is required
remote_slot_num
Required
wwpns
Optional for a client adapter, and not valid for
a server adapter. If this attribute is not
specified, WWPNs will be automatically generated for
a client adapter. It is highly recommended that
you do not specify WWPNs so that they will be
automatically generated. If you do specify WWPNs,
you must specify exactly two, and they must be comma
separated.Valid attribute names for adding a virtual SCSI adapter:
adapter_type
Valid values are client or server
Required
remote_lpar_id | remote_lpar_name
One of these attributes is required for a
client adapter
remote_slot_num
Required for a client adapterValid attribute names for adding a virtual serial adapter:
adapter_type
Valid values are client or server
Required
remote_lpar_id | remote_lpar_name
One of these attributes is required for a
client adapter
remote_slot_num
Required for a client adapter
supports_hmc
The only valid value is 0 for no.Valid attribute names for adding a virtual NIC:
backing_devices
Required
Comma separated list of virtual NIC backing devices,
with each backing device having the following format:sriov/vios-lpar-name/vios-lpar-ID/
sriov-adapter-ID/sriov-physical-port-ID/
[capacity][/[failover-priority]]The first 5 ’/’ characters must be present. The
6th ’/’ character is optional, but it must be
present if failover-priority is specified.Optional values may be omitted. Optional values
are capacity, either vios-lpar-name or
vios-lpar-ID, and failover-priority.Specify capacity as a percentage with up to
2 decimal places.Specify failover-priority as a value between
1 and 100 inclusive, with 1 being the highest
priority. It defaults to 50 if not specified.For example:
sriov/vios1//1/3/5.5 specifies a virtual NIC backing
device on VIOS vios1 and physical port 3 of SR-IOV
adapter 1 with a capacity of 5.5%.
port_vlan_id
Port VLAN ID or 0 to disable VLAN tag insertions
for untagged frames (default value)
pvid_priority
Valid values are:
An integer between 0 and 7, inclusive.
Default value is 0.
allowed_vlan_ids
Comma separated list of VLAN IDs, or one of the
following values:
all - all VLAN IDs are allowed (default value)
none - no VLAN IDs are allowed
mac_addr
12 hexadecimal characters
If not specified, a unique MAC address will be
automatically generated. It is highly recommended
that you use an automatically generated MAC address.
allowed_os_mac_addrs
Comma separated list of MAC addresses, each specified
as 12 hexadecimal characters. Other valid values are:
all - all OS defined MAC addresses are allowed
(default value)
none - no OS defined MAC addresses are allowed
auto_priority_failover
Valid values:
0 - automatic priority failover is disabled
1 - automatic priority failover is enabled
(default value)Valid attribute names for changing a virtual ethernet adapter assigned to a running partition:
ieee_virtual_eth
Valid values:
0 - not IEEE 802.1Q compatible
1 - IEEE 802.1Q compatible
addl_vlan_ids
qos_priority
Valid values are none and integers between 0 and 7,
inclusive
vsi_manager_id
To remove a VSI profile, specify none
vsi_type_id
To remove a VSI profile, specify none
vsi_type_version
To remove a VSI profile, specify noneValid attribute names for changing a virtual NIC assigned to a partition:
backing_devices
Comma separated list of virtual NIC backing devices,
with each backing device having the following format:sriov/vios-lpar-name/vios-lpar-ID/
sriov-adapter-ID/sriov-physical-port-ID/
[capacity][/[failover-priority]]The first 5 ’/’ characters must be present. The
6th ’/’ character is optional, but it must be
present if failover-priority is specified.Optional values may be omitted. Optional values
are capacity, either vios-lpar-name or
vios-lpar-ID, and failover-priority.Specify capacity as a percentage with up to
2 decimal places.Specify failover-priority as a value between
1 and 100 inclusive, with 1 being the highest
priority. It defaults to 50 if not specified.For example:
sriov/vios1//1/0/6.25/10 specifies a virtual NIC
backing device on VIOS vios1 and physical port 0
of SR-IOV adapter 1 with a capacity of 6.25% and a
failover priority of 10.
port_vlan_id
Port VLAN ID or 0 to disable VLAN tag insertions
for untagged frames
pvid_priority
Valid values are:
An integer between 0 and 7, inclusive.
allowed_vlan_ids
Comma separated list of VLAN IDs
allowed_os_mac_addrs
Comma separated list of MAC addresses, each specified
as 12 hexadecimal characters
auto_priority_failover
Valid values:
0 - automatic priority failover is disabled
1 - automatic priority failover is enabledValid attribute names for changing the backing device for a virtual NIC assigned to a partition:
failover_priority
Valid values are:
An integer between 1 and 100 inclusive, with 1
being the highest priority.Valid attribute names for setting virtual ethernet attributes for the managed-system:
mac_prefixValid attribute names for setting HSL OptiConnect attributes (IBM i partitions only):
hsl_pool_id
Valid values are:
0 - HSL OptiConnect is disabled
1 - HSL OptiConnect is enabledValid attribute names for setting virtual OptiConnect attributes (IBM i partitions only):
virtual_opti_pool_id
Valid values are:
0 - virtual OptiConnect is disabled
1 - virtual OptiConnect is enabledValid attribute names for adding a virtual network:
vlan_id
Required
vswitch
Required
is_tagged
Valid values are:
0 - do not use IEEE 802.1Q VLAN tagging
1 - use IEEE 802.1Q VLAN tagging
RequiredValid attribute names for setting virtual network attributes:
new_nameValid attribute names for setting virtual switch attributes:
new_name
switch_mode
Valid values are:
VEB - Virtual Ethernet Bridge mode
VEPA - Virtual Ethernet Port Aggregator modeValid attribute names for setting memory attributes for the managed-system:
requested_num_sys_huge_pages
mem_mirroring_mode
Valid values are:
none - disable memory mirroring
sys_firmware_only - enable memory mirroring for system
firmware memory only
pend_mem_region_size
Memory region size of the managed-system after it is
restarted. The valid values for the managed-system
are returned by the lshwres -m managed-system -r mem
--level sys -F possible_mem_region_sizes command.Valid attribute names for setting memory attributes for a partition:
mem_weight
mem_expansion
Valid values are from 1.00 to 10.00
hardware_mem_encryption
Valid values are:
0 - disable hardware-accelerated encryption
1 - enable hardware-accelerated encryption
hardware_mem_expansion
Valid values are:
0 - disable hardware-accelerated Active Memory
Expansion
1 - enable hardware-accelerated Active Memory
ExpansionValid attribute names for creating the shared memory pool or setting shared memory pool attributes:
pool_mem
megabytes
max_pool_mem
megabytes
paging_vios_names | paging_vios_ids
specify one or two VIOS partitions
mem_dedup
Valid values are:
0 - disable Active Memory Deduplication
1 - enable Active Memory Deduplication
dedup_table_ratio
Ratio of the deduplication table size to the maximum
memory for the pool. Valid values are displayed
by the lshwres -r mem -m managed-system --level sys
-F possible_dedup_table_ratios command.Valid attribute names for creating the reserved storage device pool or setting reserved storage device pool attributes:
vios_names | vios_ids
specify one or two VIOS partitionsValid attribute names for setting processing attributes for the managed-system:
max_curr_procs_per_lpar
The valid values for the managed-system are returned
by the lshwres -r proc --level sys -m managed-system
-F possible_max_curr_procs_per_lpar command.Valid attribute names for setting processing attributes for a partition:
sharing_mode
Valid values for partitions using
dedicated processors are:
keep_idle_procs - never share
processors
share_idle_procs - share processors only
when partition is inactive
share_idle_procs_active - share
processors only when partition
is active
share_idle_procs_always - always share
processorsValid values for partitions using shared
processors are:
cap - capped
uncap - uncapped
uncap_weightValid attribute names for setting shared processor pool attributes:
new_name
max_pool_proc_units
reserved_pool_proc_unitsValid attribute names for setting shared processor pool attributes for a partition:
shared_proc_pool_name | shared_proc_pool_idValid attribute names when adding an HEA logical port:
vlan_id_list
comma separated
lhea_capabilities
Comma separated list of Logical Host
Ethernet adapter (LHEA) capabilities,
with each capability having one of the
following formats:capability
or
5/ieq/nieq/qp/cq/mr
where ieq (interruptible event queues),
nieq (non-interruptible event queues),
qp (queue pairs), cq (completion
queues), and mr (memory regions) each
specify the resource amount in addition
to the base minimum.Valid values for capability:
0 - base minimum
1 - low
2 - medium
3 - high
4 - dedicatedFor example:
5/22/128/1021/1019/63424
allowed_os_mac_addrs
1 to 4 comma separated MAC addresses, each specified
as 12 hexadecimal characters. Other valid values:
all - all OS defined MAC addresses are allowed
none - no OS defined MAC addresses are allowedValid attribute names for setting HEA physical port attributes:
conn_speed
Valid values are:
auto - system selects automatically
10 - 10 Mbps
100 - 100 Mbps
1000 - 1 Gbps
10000 - 10 Gbps
duplex
Valid values are:
auto - system selects automatically
full - full duplex
max_recv_packet_size
Valid values are:
1500 - 1500 bytes per frame (non-jumbo)
9000 - 9000 bytes per frame (jumbo)
flow_control
Valid values are:
0 - disable flow control
1 - enable flow control
promisc_lpar_name | promisc_lpar_idValid attribute names for setting HEA port group attributes:
pend_port_group_mcs_valueValid attribute names for switching an SR-IOV adapter to shared mode:
slot_id
Required
adapter_id
Valid values are:
1 - 32, inclusiveIf the adapter ID is not specified, the next available
adapter ID will be assigned.Valid attribute names for switching an SR-IOV adapter to dedicated mode:
slot_id
RequiredValid attribute names for moving the configuration of an SR-IOV adapter:
slot_id
Required
DRC index of the I/O slot of the failed SR-IOV adapter
target_slot_id
Required
DRC index of the I/O slot of the new SR-IOV adapterValid attribute names for changing an SR-IOV physical port:
Warning! When an attribute for an SR-IOV physical port
is changed, a short network interruption may occur for
all partitions that share the physical port.adapter_id
Required
phys_port_id
Required
conn_speed
Possible valid values are:
auto
10 - 10 Mbps
100 - 100 Mbps
1000 - 1 Gbps
10000 - 10 Gbps
40000 - 40 Gpbs
100000 - 100 Gbps
max_eth_logical_ports
An integer value less than or equal to the maximum
number of Ethernet logical ports allowed on any
physical port on the adapter
max_recv_packet_size
Valid values are:
1500 - 1500 bytes
9000 - 9000 bytes (Jumbo frames)
phys_port_label
1-16 characters
Specify none to clear the physical port label
phys_port_sub_label
1-8 charaters
Specify none to clear the physical port sublabel
recv_flow_control
Valid values are:
0 - disable
1 - enable
trans_flow_control
Valid values are:
0 - disable
1 - enable
veb_mode
Valid values are:
0 - disable Virtual Ethernet Bridge mode
1 - enable Virtual Ethernet Bridge mode
vepa_mode
Valid values are:
0 - disable Virtual Ethernet Port Aggregator mode
1 - enable Virtual Ethernet Port Aggregator modeValid attribute names for adding an SR-IOV logical port:
adapter_id
Required
phys_port_id
Required
logical_port_type
Required
Valid values are:
eth - ethernet logical port
allowed_os_mac_addrs
Comma separated list of MAC addresses, each specified
as 12 hexadecimal characters. Other valid values are:
all - all OS defined MAC addresses are allowed
(default value)
none - no OS defined MAC addresses are allowed
allowed_priorities
Comma separated list of integers between 0 and 7,
inclusive, or one of the following values:
all - all supported priorities are allowed
none - no priorities are allowed (default value)
allowed_vlan_ids
Comma separated list of VLAN IDs, or one of the
following values:
all - all VLAN IDs are allowed (default value)
none - no VLAN IDs are allowed
capacity
Must be a multiple of min_eth_capacity_granularity
of the physical port, which is displayed by the
lshwres -m managed-system -r sriov
--rsubtype physport --level {eth | ethc}
-F min_eth_capacity_granularity command.
The minimum value and the default value is the
value of min_eth_capacity_granularity, the maximum
value is 100.
config_id
If not specified, the management console will assign
the next available value.
diag_mode
Valid values are:
0 - disable (default value)
1 - enableWarning! If diagnostics mode is enabled, no other
logical port may be attached to the physical port.
If logical ports are already in use on the physical
port, you will have to power off partitions or use
Dynamic Logical Partitioning (DLPAR) to remove the
logical ports that are attached to the physical port.
huge_dma_window_mode
Valid values are:
0 - disable (default value)
1 - enable
logical_port_id
DRC index of an SR-IOV logical port. If not
specified, an SR-IOV logical port will be
automatically assigned.
mac_addr
12 hexadecimal characters
If not specified, a unique MAC address will be
automatically generated for the logical port. It
is highly recommended that you use an automatically
generated MAC address.
port_vlan_id
Port VLAN ID or 0 to disable VLAN tag insertions
for untagged frames (default value)
promisc_mode
Valid values are:
0 - disable (default value)
1 - enable
pvid_priority
Valid values are:
An integer between 0 and 7, inclusive.
Default value is 0.
Valid attribute names for changing an SR-IOV logical port:
adapter_id
Required
logical_port_id
Required
allowed_os_mac_addrs
Comma separated list of MAC addresses, each specified
as 12 hexadecimal characters
allowed_priorities
Comma separated list of integers between 0 and 7,
inclusive
allowed_vlan_ids
Comma separated list of VLAN IDs
diag_mode
Valid values are:
0 - disable (default value)
1 - enableWarning! If diagnostics mode is enabled, no other
logical port may be attached to the physical port.
If logical ports are already in use on the physical
port, you will have to power off partitions or use
Dynamic Logical Partitioning (DLPAR) to remove the
logical ports that are attached to the physical port.
port_vlan_id
Port VLAN ID or 0 to disable VLAN tag insertions
for untagged frames
pvid_priority
Valid values are:
An integer between 0 and 7, inclusive.Valid attribute names for removing an SR-IOV logical port:
adapter_id
Required
logical_port_id
RequiredValid attribute names for resetting statistics for an SR-IOV physical port:
adapter_id
Required
phys_port_id
RequiredValid attribute names for resetting statistics for an SR-IOV logical port:
adapter_id
Required
logical_port_id
Required-v Specify this option to enable verbose mode. When verbose mode is enabled, warning messages and informational messages are displayed for successful virtual NIC operations. Warning messages and informational messages are displayed for virtual NIC operations that fail, regardless of whether this option is specified. --help Display the help text for this command and exit.
Add the I/O slot with DRC index 21010001 to partition p1 and set the I/O pool ID for the slot to 3:chhwres -r io -m sys1 -o a -p p1 -l 21010001
-a "slot_io_pool_id=3"Add I/O pools 2 and 3 to the I/O pools in which partition p1 is participating:
chhwres -r io --rsubtype iopool -m 9406-520*1234321A -o s
-p p1 -a ""lpar_io_pool_ids+=2,3""Clear the physical I/O slot with DRC index 21010207 after the physical I/O adapter in that slot was concurrently removed but not replaced:
chhwres -r io -m sys1 -o c -l 21010207
Add a virtual ethernet adapter to the partition with ID 3:
chhwres -r virtualio -m 9406-520*1234321A -o a --id 3
--rsubtype eth -a "ieee_virtual_eth=1,
port_vlan_id=4,"addl_vlan_ids=5,6",is_trunk=1,
trunk_priority=1"Add a virtual fibre channel client adapter to the partition p1:
chhwres -r virtualio -m sys1 -o a -p p1 --rsubtype fc
-a "adapter_type=client,remote_lpar_name=vios,remote_slot_num=16"Add a virtual NIC to the partition p1:
chhwres -r virtualio -m sys1 -o a -p p1 --rsubtype vnic -v
-a "port_vlan_id=3,backing_devices=sriov/vios1//1/2/"Remove the virtual adapter in slot 3 from partition p1:
chhwres -r virtualio -m sys1 -o r -p p1 -s 3
Add an additional VLAN ID to the virtual ethernet adapter in slot 4 of the partition AIX:
chhwres -r virtualio -m sys1 -o s --rsubtype eth -p AIX -s 4
-a "addl_vlan_ids+=5"Add additional VLAN IDs to the virtual NIC in slot 6 of the partition lp4 and change its port VLAN ID priority:
chhwres -r virtualio -m sys1 -o s --rsubtype vnic -p lp4 -s 6
-a ""allowed_vlan_ids+=10,20,30",pvid_priority=5"Add additional backing devices to the virtual NIC in slot 3 of the partition with ID 4:
chhwres -r virtualio -m sys1 -o s --rsubtype vnic --id 4 -s 3
-a ""backing_devices+=sriov/vios1//1/0/4/50,sriov/vios2//2/0/4/62""
--allownetdisruptRemove a backing device from the virtual NIC in slot 3 of the partition lp4:
chhwres -r virtualio -m sys1 -o s --rsubtype vnic -p lp4 -s 3
-a "backing_devices-=sriov///1/0//"Change the failover priority of the backing device, with logical port ID 27004001, for the virtual NIC in slot 3 of the partition lp4:
chhwres -m sys1 -r virtualio -o s --rsubtype vnicbkdev -p lp4 -s 3
--logport 27004001 -a "failover_priority=75"Make the backing device, with logical port ID 27004001, for the virtual NIC in slot 3 of the partition lp4 active:
chhwres -m sys1 -r virtualio -o act --rsubtype vnicbkdev -p lp4 -s 3
--logport 27004001Disable the virtual ethernet adapter in slot 2 of the partition p5:
chhwres -r virtualio -m sys1 -o d --rsubtype eth -p p5 -s 2
Enable HSL OptiConnect for the IBM i partition i_p1:
chhwres -r virtualio -m sys1 -o s -p i_p1
--rsubtype hsl -a "hsl_pool_id=1"Add the virtual network vnet5:
chhwres -r virtualio --rsubtype vnetwork -m sys1 -o a --vnetwork vnet5
-a "vswitch=ETHERNET0,vlan_id=5,is_tagged=1"Add the virtual switch vs1:
chhwres -r virtualio --rsubtype vswitch -m sys1 -o a --vswitch vs1
Add 128 MB of memory to the partition with ID 1, and time out after 10 minutes:
chhwres -r mem -m sys1 -o a --id 1 -q 128 -w 10
Remove 512 MB of memory from the AIX partition aix_p1 and return a detail level of 5:
chhwres -r mem -m 9406-520*1234321A -o r -p aix_p1 -q 512 -d 5
Set the total amount of memory for the partition p1 to 8192 MB:
chhwres -r mem -m sys1 -o s -p p1 -q 8192
Remove 128 MB of logical memory and 100 MB of I/O entitled memory from the partition smp1:
chhwres -r mem -m sys1 -o r -p smp1 -q 128 --entitled 100
Set the partition smp1 to automatic I/O entitled memory management mode:
chhwres -r mem -m sys1 -o a -p smp1 --entitled auto
Reset I/O entitled memory statistics for partition smp1:
chhwres -r mem -m sys1 -o rs -p smp1
Create the shared memory pool with redundant VIOS partitions (on a managed system that supports partition suspend and resume operations, this command also creates the reserved storage device pool if it does not already exist):
chhwres -r mempool -m sys1 -o a -a "pool_mem=4096,max_pool_mem=
8192,"paging_vios_names=vios_p1,vios_p2""Increase the size of the shared memory pool by 256 MB:
chhwres -r mempool -m sys1 -o s -a "pool_mem+=256"
Add the device hdisk1 on VIOS partition vios_p1 to the shared memory pool (on a managed system that supports partition suspend and resume operations, this command adds the device to the reserved storage device pool):
chhwres -r mempool -m sys1 --rsubtype pgdev -o a -p vios_p1
--device hdisk1Create the reserved storage device pool with a single VIOS partition:
chhwres -r rspool -m sys1 -o a -a "vios_names=vios_p2"
Add the VIOS partition with ID 1 to the reserved storage device pool:
chhwres -r rspool -m sys1 -o s -a "vios_ids+=1"
Remove the device hdisk1 on VIOS partition vios_p1 from the reserved storage device pool:
chhwres -r rspool -m sys1 --rsubtype rsdev -o r -p vios_p1
--device hdisk1Switch over the running shared memory partition smp1 to its redundant paging VIOS partition:
chhwres -r mem -m sys1 -p smp1 -o so
Set the number of pages of huge page memory requested for the managed system to 2 (the managed system must be powered off):
chhwres -r mem -m sys1 -o s -a "requested_num_sys_huge_pages=2"
Move 1 processor from partition p1 to partition p2 (both partitions are using dedicated processors):
chhwres -r proc -m 9406-520*1234321A -o m -p p1 -t p2 --procs 1
Move .5 processing units from the partition with ID 1 to the partition with ID 2 (both partitions are using shared processors):
chhwres -r proc -m sys1 -o m --id 1 --tid 2 --procunits .5
Add .25 processing units to the IBM i partition i_p1:
chhwres -r proc -m sys1 -o a -p i_p1 --procunits .25
Set the number of processors for partition p1 to 2:
chhwres -r proc -m sys1 -o s -p p1 --procs 2
Configure the shared processor pool with ID 1:
chhwres -r procpool -m sys1 -o s --poolid 1 -a "new_name=
pool1,max_pool_proc_units=2,reserved_pool_proc_units=.5"Move the partition sharedlpar1 to shared processor pool pool1:
chhwres -r procpool -m sys1 -o s -p sharedlpar1
-a "shared_proc_pool_name=pool1"Add logical port 4 for physical port 0 belonging to port group 2 of the HEA with an adapter ID of 23000020 to partition p1. Also set the LHEA capabilty level to low:
chhwres -r hea -m mySystem -o a -p p1 -l 23000020
--physport 0 -g 2 --logport 4 -a "lhea_capabilities=1"Remove logical port 1 belonging to port group 2 of the HEA with an adapter ID of 23000020 from the partition with ID 8:
chhwres -r hea -m 9117-MMA*123432C -o r --id 8 -l 23000020
-g 2 --logport 1Set physical port attributes for port group 2 of physical port 1 of the HEA with an adapter ID of 23000020:
chhwres -r hea -m mySystem -o s -l 23000020 -g 2
--physport 1 -a "conn_speed=auto,duplex=auto,
flow_control=1"Set port group attributes for port group 1 of the HEA with an adapter ID of 23000030:
chhwres -r hea -m sys1 -o s -l 23000030 -g 1
-a "pend_port_group_mcs_value=4"Switch an SR-IOV adapter to shared mode:
chhwres -r sriov -m sys1 --rsubtype adapter -o a -a "slot_id=21010202"
Switch an SR-IOV adapter to dedicated mode:
chhwres -r sriov -m sys1 --rsubtype adapter -o r -a "slot_id=21010202"
Set the connection speed for SR-IOV physical port 0 to 100 Gbps:
chhwres -r sriov -m sys1 --rsubtype physport -o s
-a "adapter_id=1,phys_port_id=0,conn_speed=100000"Add an SR-IOV ethernet logical port (using defaults) to partition lpar1:
chhwres -r sriov -m sys1 --rsubtype logport -o a -p lpar1
-a "adapter_id=1,phys_port_id=1,logical_port_type=eth"Remove an SR-IOV ethernet logical port from partition lpar1:
chhwres -r sriov -m sys1 --rsubtype logport -o r -p lpar1
-a "adapter_id=1,logical_port_id=27004001"Change the port VLAN ID for an SR-IOV ethernet logical port in partition lpar1:
chhwres -r sriov -m sys1 --rsubtype logport -o s -p lpar1
-a "adapter_id=1,logical_port_id=27004001,port_vlan_id=2"Reset the statistics for an SR-IOV physical port:
chhwres -r sriov -m sys1 --rsubtype physport -o rs
-a "adapter_id=1,phys_port_id=0"
None
None
IBM Austin
lshwres, rsthwres, chsyscfg, lssyscfg
| Linux | CHHWRES (1) | "November 2016" |