chvpd

Use the chvpd command to set vital product data (VPD) such as serial number and machine type.

Syntax

Read syntax diagramSkip visual syntax diagram satask chvpd -serialserial_number-type machine_type_model -wwnn wwnn-fcportmapphysical_port_locations_listlegacy_port_mappings_liststandard_map_name-resetclusterid-machinepartnumber mpn -idfile file_namepanel_name

Parameters

-serial serial_number
(Optional) Specifies the serial number for system board or enclosure.
-type machine_type_model
(Optional) Specifies the machine model type.
-wwnn wwnn
(Optional) Specifies the worldwide node name (WWNN).
-fcportmap physical_port_locations_list | legacy_port_mappings_list | standard_map_name
(Optional) Specifies the FC I/O port location on the node that is mapped to a slot or port.
  • Specify -fcportmap physical_port_locations_list to associate physical ports with an FC I/O port ID and to use the port WWPNs that are defined for the FC I/O port ID. The physical port location is made up of 2 digits, which represent the slot number (first digit) and port number (second digit).
    Note: This value is a comma-separated list of physical port locations.
  • Specify -fcportmap legacy_port_mappings_list to associate physical ports with an FC I/O port ID and to use the WWPN value that is defined for the port location of the replaced node. Thus, the WWPN for the port on the new node is the same as the mapped port on the replaced node. A legacy port mapping maps a physical port location on the new system to a physical port location on the replaced system.
    Note: This value is a comma-separated list of legacy port mappings.
  • Specify -fcportmap standard_map_name to specify a standard port mapping.
    Note: The FC I/O port ID of each port is defined by its position in the list.
-machinepartnumber mpn
(Optional) Specifies the machine part number.
-resetclusterid
(Optional) Resets the system ID to 0.
Note:
  • resetclusterid will only work on the current node it is on or the one specified by panel_name.
  • The resetclusterid flag will no longer warm start the partner node.
  • The partner cluster ID is ignored when clustering.
-idfile file_name
(Optional) Specifies the unique node ID file that allows each supported server to become a unique system node.
panel_name
(Optional) Identifies the node that is used.

Description

The command sets vital product data (VPD), including the serial number, WWPN, machine type, and system ID.

For port location management, the first location represents FC I/O port 1, which is the bit position furthest to the right in the port mask value. Any number of locations can be entered (including for adapters that are not yet installed).

The method for assigning WWPNs is different for each node and is selected automatically based on the WWNN of the node. You must set the mapping in the new node before you add it to the existing clustered system.
Note: When you change the mapping, the node restarts to apply the new setting.

If you specify a WWNN for a legacy node, the port location from the original node must also be specified so that the original WWPN can be assigned. If you use port masking, you must specify the ports in ascending slot or port order (from the original node).

A null mapping (specify -fcportmap 00) can be entered, which uses the default mapping. Do not change the port mapping for a node if that node is a member of a clustered system.

Remember: When you specify chvpd, one or more nodes might experience a reset or a restart. For example, these parameters might cause a restart:
  • -fcportmap resets a node or one node canister
  • -idfile resets a node
  • -serial restarts both nodes or node canisters
  • -type restarts both nodes or node canisters
  • -wwnn resets a node or one node canister

An invocation example that changes the WWNN

satask chvpd -wwnn 1111111111111111

The resulting output: 

No feedback

An invocation example that changes the serial number

satask chvpd -serial 8675309

The following output is displayed: 

No feedback

An invocation example that changes the WWNN and the FC I/O port location

satask chvpd -wwnn 500507680f000123 -fcportmap 31,32,33,34,41,42,43,44,61,62,63,64,71,72,73,74

The following output is displayed: 

No feedback

An invocation example that changes the WWNN and the FC I/O port location

satask chvpd -wwnn 5005076801000456 -fcportmap 31-11,32-12,33-13,34-14,41-21,42-22,43-23,44-24,61-31,62-32,63-33,64-34,71-51,72-52,73-53,74-54

The following output is displayed: 

No feedback

An invocation example that changes the WWNN and the FC I/O port location

satask chvpd -wwnn 5005076801000456 -fcportmap default

The following output is displayed: 

No feedback