IVM rsthwres command

Purpose

Restores hardware resources. This command is operable only in an Integrated Virtualization Manager environment.

Syntax

rsthwres -rhea | -m <managed system>] [-p <partition name> | --id <partition ID>] [-l<HEA DRC index>] [-g <port group ID>] --logport <logical port ID>]--help]

To restore memory or processing resources

rsthwres -r {mem | proc} [{-p partition-name | --id partition-ID}]

To restore physical I/O slots

rsthwres -r io [{-p partition-name | --id partition-ID}] [-l slot-DRC-index]

To restore Host Ethernet Adapter resources

rsthwres -r hea [{-p partition-name | --id partition-ID}] [-lHEA-adapter-ID] [-g port-group --logport logical-port-ID]

To restore memory pool resources

rsthwres -r mempool [-a "<attributes>"] [--help]

Description

The rsthwres command restores the hardware resource configuration in the managed system. This operation may need to be performed after a dynamic LPAR operation fails.

You also need to perform this operation to restore memory pool resources in the following situations:

When you reinstall the VIOS base code and applied fix packs from original VIOS media.
When you restore the VIOS from backup media prior to the time you created the memory pool, but the firmware still has a memory pool configured.

Flags

Flag name	Description
-r	Shows the type of hardware resources to restore: io I/O slot (physical) hea Host Ethernet Adapter mem Memory mempool Memory pools proc Processing virtualio Virtual I/O
-m <managed system>	Indicates the name of the managed system which has the partitions for which to restore the hardware resources. The name may either be the user-defined name for the managed system, or be in the form tttt-mmmssssssss, where tttt* is the machine type, mmm is the model, and ssssssss is the serial number of the managed system.
-p< partition name>	Indicates the name of the partition for which to restore the hardware resources. To restore hardware resources for a single partition, you must either use this option to specify the name of the partition, or use the --id option to specify the partition's ID. Otherwise, hardware resources for all partitions in the managed-system will be restored. The -p and the --id options are mutually exclusive.
--id<partition ID>	Indicates the ID of the partition for which to restore the hardware resources. To restore hardware resources for a single partition, you must either use this option to specify the ID of the partition, or use the -p option to specify the partition's name. Otherwise, hardware resources for all partitions in the managed-system will be restored. The --id and the -p options are mutually exclusive.
-l <DRC index>	Indicates the DRC index of the physical I/O slot to restore. This option is only valid when restoring physical I/O slots. This option is also used to specify the physical Host Ethernet Adapter to restore.
-s <virtual slot>	Indicates the slot number of the virtual I/O.
-a "<attributes>"	The configuration data needed to set hardware resource related attributes. The configuration data consists of attribute name/value pairs, which are in comma separated value (CSV) format. The configuration data must be enclosed in quotation marks. Possible values are: paging_storage_pool Note: If you intend to use a paging storage pool, you must specify the value here. After you run the rsthwres command, you cannot set or change the paging storage pool value without deleting your memory pool and recreating it. The -a parameter is valid only with -r mempool, and the only supported attribute is paging_storage_pool.
-g port group ID	Indicates the logical ports that are part of the specified port group that will be restored.
--logport <virtual slot>	Indicates the ID of the logical port to recover.
--help	Displays the help text for this command and exit.

Exit Status

This command has a return code of 0 on success.

Examples

To restore the physical I/O slots for all partitions, type the following command:
```
rsthwres -r io -m mySystem
```
To restore the physical I/O slot with DRC index 21010003, type the following command:
```
rsthwres -r io -m 9406-570*12345678 -l 21010003
```
To restore memory resources for partition pl, type the following command:
```
rsthwres -r mem -m 9406-570*12345678 -p p1
```
To restore processing resources for the partition with ID 1, type the following command:
```
rsthwres -r proc -m mySystem --id 1
```
To clean up all recoverable Host Ethernet Adapter resources, type the following command:
```
rsthwres -r hea
```

To clean up a specific logical port with a given partition, type the following command:

rsthwres -r hea -l <HEA DRC> -g <PORT GROUP> 
--logport <LP ID> {-p <LPAR NAME | --id <LPAR ID>}

To recover a memory pool using rootvg as the paging storage pool, type the following command:
```
rsthwres -r mempool -a paging_storage_pool=rootvg
```
Note: If you intend to use a paging storage pool, you must specify the value here. After you run the rsthwres command, you cannot set or change the paging storage pool value without deleting your memory pool and recreating it.

Last updated: Wed, November 18, 2020