refdev also refreshes the virtual SCSI and virtual Fibre Channel (FC) adapter data collected from the Virtual I/O Server (VIOS) partitions hosting the specified partition’s client adapters. This data is used during partition migration when one or more of the VIOS partitions hosting the migrating partition’s client adapters on the source managed system are shutdown. This data is stored on the HMC hard disk and is collected for all AIX, Linux, and IBM i partitions in the managed system when data collection is enabled for the managed system.
The HMC always attempts to automatically keep the remote restart data and the storage adapter data for a partition up to date. However, there may be times when the HMC is unable to update the data for a partition. If that happens, the user can run this command to force the data to be refreshed.
| -m | The name of the managed system on 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. |
| -p |
The name of the partition for which to perform the operation.
You must either use this option to specify the name of the partition, 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.
You must either use this option to specify the ID of the partition, or use the -p option to specify the partition’s name. The --id and the -p options are mutually exclusive. |
| --viosfcportlabel |
Use this option to specify whether VIOS Fibre Channel (FC) port labels are to be used when refreshing virtual FC adapter data.
Valid values are 1 if VIOS FC port labels are required to be used, or 2 if VIOS FC port labels are to be used if possible.
If this option is not specified, it defaults to the value of the VIOS FC port label override option for the managed system (see the labelvios and lslabelvios commands).
If VIOS FC port labels are required to be used and the partition has a virtual FC adapter hosted by a VIOS partition which does not support FC port labels, the virtual FC adapter data will not be collected. Specify 2 with this option to collect the virtual FC adapter data. |
| -w |
The maximum time, in minutes, to wait for VIOS commands issued by the HMC to complete. If a VIOS command does not complete within the time specified, the refresh operation will be stopped.
wait-time must be a whole number. If wait-time is 0, the refresh operation will not be timed out. If this option is not specified, a default value of 3 minutes is used. |
| -d |
The level of detail requested from VIOS commands issued by the HMC. Valid values are 0 (none) through 5 (highest).
If this option is not specified, a default value of 1 is used. |
| -v | Specify this option to enable verbose mode for the refresh operation. When verbose mode is enabled, detail messages and warning messages are displayed for a successful operation. Detail messages and warning messages are always displayed for a refresh operation that fails, regardless of whether this option is specified. |
| --help | Display the help text for this command and exit. |
refdev -m sys1 -p remoteRestartPartition
| None | |
| None | |
| Linux | REFDEV (1) | December 2022 |