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 --+-----------------------------+-------------->
                   '- -serial  -- serial_number -'   

>--+--------------------------------+--+-------------------+---->
   '- -type --  machine_type_model -'  '-  -wwnn --  wwnn -'   

>--+--------------------------------------------------+--------->
   '- -fcportmap --+- physical_port_locations_list -+-'   
                   +- legacy_port_mappings_list ----+     
                   '- standard_map_name ------------'     

>--+-------------------+--+------------------------------+------>
   '- -resetclusterid -'  '- -machinepartnumber --  mpn -'   

>--+-----------------------------+--+--------------+-----------><
   '-  -idfile --  -- file_name -'  '- panel_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 is 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. This means that 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 clustered system (system) ID to 0.
-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 adding it to the existing clustered system.
Note: When you change the mapping the node reboots 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 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 reboot. For example, these parameters might cause a reboot:
  • -idfile resets a node
  • -serial reboots both nodes or node canisters
  • -type reboots both nodes or node canisters
  • -wwnn resets a node or one node canister

An invocation example

satask chvpd -wwnn 1111111111111111 

The resulting output:

No feedback

An invocation example

satask chvpd -serial 8675309

The resulting output:

No feedback

An invocation example

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

The resulting output:

No feedback

An invocation example

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 resulting output:

No feedback

An invocation example

satask chvpd -wwnn 5005076801000456 -fcportmap default

The resulting output:

No feedback