Locating hardware components
You can use the ap locate command to view the physical location of a specific hardware component, such as a switch, or a node.
Procedure
- For version 1.0.7.8 and later: Use the ap locate
<component_name> command. Specify the component that you want to find as a
parameter. For example,
enclosure1,enclosure2.node1,mgtsw1a:[root@e1n1 ~]# ap locate enclosure1 Component name: enclosure1 Rack ID : 1234 Location Description : 12 Rack Location : Krakow Rack UID : 1[root@e1n1 ~]# ap locate enclosure2.node1 Component name: enclosure2.node1 Rack Location : Location Description : Rack ID : 2E-R1 Rack UID : 26 Generated: 2022-03-14 12:52:03[root@e1n1 ~]# ap locate mgtsw1a Component name: mgtsw1a Rack Location : Location Description : Rack ID : 2E-R1 Rack UID : 34 Generated: 2022-03-14 14:08:52 - For version 1.0.8 and later: To modify the location of the component, use the sys_hw_config bom command.
- You can configure the component location information by using the sys_hw_config
bom
command. Example:
In this command, the/opt/ibm/appliance/platform/hpi/sys_hw_config bom --modify-comp --sn 1234567 --rack-id "5678" --rack-loction "Dallas" --location-description "13" --rack-u-id "2"snis the serial number of the rack-mounted component. Refer to the following step to know how to get the serial number of the rack-mounted component. The ap locate returns the following output after running the sys_hw_config bom command:[root@e1n1 ~]# ap locate enclosure1 Component name: enclosure1 Rack ID : 5678 Location Description : 13 Rack Location : Dallas Rack UID : 2 - Use the ap info command or ap hw command to
get the serial number of the rack-mounted component. Example of ap info command:
For integrated rack components, add the location also to the ap info command:[root@e1n1 ~]# ap info +-------------------------------------+ | General information | +-----------------+-------------------+ | MTM | 3458-A1A | | Serial | 781A8M1 | +-----------------+-------------------+ +-----------------------------------+ | System information | +-----------------------+-----------+ | Description | | | Location | | | Country Code | | | Model | | +-----------------------+-----------+ +--------------------------------+ | Customer information | +--------------------+-----------+ | Company | | | Address 1 | | | Address 2 | | | Address 3 | | | ICN | | +--------------------+-----------+ +------------------------------------------------------------+ | Entitled MTMs information | +---------------------+-------------------+------------------+ | Location | MTM | Serial | +---------------------+-------------------+------------------+ | rack1 | 3458-A1A | 781A8M1 | | enclosure3 | 3453-C2E | 7863477 | | enclosure4 | 3453-C2E | 7863479 | | enclosure5 | 3453-F7E | 786A6R1 | +---------------------+-------------------+------------------+[root@e1n1 ~]# ap info -r rack1 +------------------------------------------------------------------+ | Integrated rack components MTMs information | +---------------------------+-------------------+------------------+ | Location | MTM | Serial | +---------------------------+-------------------+------------------+ | rack1 | 3458-A1A | 781A8M1 | | rack1.enclosure1 | 3453-C2E | 7863475 | | rack1.enclosure2 | 3453-C2E | 7863476 | | rack1.pdu1 | 3454-FCE | N03E1H3 | | rack1.pdu2 | 3454-FCE | N0371AV | | rack1.pdu3 | 3454-FCE | N03E1GW | | rack1.pdu4 | 3454-FCE | N03E1H1 | | rack1.fabsw1a | 3454-B8C | 10MM16K | | rack1.fabsw1b | 3454-B8C | 10NB0H8 | | rack1.mgtsw1a | 3454-A3C | MM01541 | | rack1.mgtsw2a | 3454-A3C | MM01548 | +---------------------------+-------------------+------------------+Example of ap hw command:[root@e1n1 ~]# ap hw +-----------------------------+------------------+--------+----------+------------+--------------+ | Name | Location | Status | SN | Model | FW | +-----------------------------+------------------+--------+----------+------------+--------------+ | modular thinksystem chassis | enclosure1 | OK | 7863475 | 3453-C2E | 1.25 | | Compute Node | enclosure1.node1 | OK | J102CMY5 | 7X21CTO1WW | TEE180H-3.41 | | Compute Node | enclosure1.node2 | OK | J102CMY0 | 7X21CTO1WW | TEE180H-3.41 | | Compute Node | enclosure1.node3 | OK | J102CMZZ | 7X21CTO1WW | TEE180H-3.41 | | Compute Node | enclosure1.node4 | OK | J102CP6Z | 7X21CTO1WW | TEE180H-3.41 | | modular thinksystem chassis | enclosure2 | OK | 7863476 | 3453-C2E | 1.25 | | Compute Node | enclosure2.node1 | OK | J102CMY8 | 7X21CTO1WW | TEE180H-3.41 | | Compute Node | enclosure2.node2 | OK | J102CP5F | 7X21CTO1WW | TEE180H-3.41 | | Compute Node | enclosure2.node3 | OK | J102CN0G | 7X21CTO1WW | TEE180H-3.41 | | Compute Node | enclosure2.node4 | OK | J102CMZH | 7X21CTO1WW | TEE180H-3.41 | | modular thinksystem chassis | enclosure3 | OK | 7863477 | 3453-C2E | 1.25 | | Compute Node | enclosure3.node1 | OK | J102CN00 | 7X21CTO1WW | TEE180H-3.41 | | Compute Node | enclosure3.node2 | OK | J102CMZF | 7X21CTO1WW | TEE180H-3.41 | | Compute Node | enclosure3.node3 | OK | J102CMZG | 7X21CTO1WW | TEE180H-3.41 | | Compute Node | enclosure3.node4 | OK | J102CMZL | 7X21CTO1WW | TEE180H-3.41 | | modular thinksystem chassis | enclosure4 | OK | 7863479 | 3453-C2E | 1.25 | | Compute Node | enclosure4.node1 | OK | J102CMY3 | 7X21CTO1WW | TEE180H-3.41 | | Compute Node | enclosure4.node2 | OK | J102CN09 | 7X21CTO1WW | TEE180H-3.41 | | Compute Node | enclosure4.node3 | OK | J102CMY4 | 7X21CTO1WW | TEE180H-3.41 | | Compute Node | enclosure4.node4 | OK | J102CMY7 | 7X21CTO1WW | TEE180H-3.41 | | thinksystem chassis | enclosure5 | OK | 786A6R1 | 3453-F7E | | | Compute Node | enclosure5.node1 | OK | J102FB96 | 7X06CTO1WW | IVE156L-2.61 | | Fabric Switch | fabsw1a | OK | 10MM16K | 3454-B8C | 3.7.16 | | Fabric Switch | fabsw1b | OK | 10NB0H8 | 3454-B8C | 3.7.16 | | Management Switch | mgtsw1a | OK | MM01541 | 3454-A3C | 3.7.16 | | Management Switch | mgtsw2a | OK | MM01548 | 3454-A3C | 3.7.16 | +-----------------------------+------------------+--------+----------+------------+--------------+