/
PowerVM - How to resolve the name of the Managed System from the UUID

PowerVM - How to resolve the name of the Managed System from the UUID

30.01.24

About this task

For Troubleshooting reasons it is helpful to read the logs of a specific scanner 

see also 

 

In some cases the Topology or Performance Scanner may fail due to a communication problem between HMC and VIOS or an error in VIOS. The error message in the Scan Log is not that informative to quickly identify the originator and fix the error. The log provides the UUID of the Managed System, which must then be resolved to the name of the Managed System.

Since BVQ Release 2023.H1. the output in log files has been extended by the readable names of Managed Systems, Logical Partitions and also the name of the queried HMC.  

2022-10-11T17:51:47,022 INFO  [topology-scan_Worker-1]: Error executing call to [/rest/api/uom/ManagedSystem/72cXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXd1/NetworkBridge], got status [500 INTERNAL_SERVER_ERROR] with message [ <entry xmlns="[http://www.w3.org/2005/Atom"|http://www.w3.org/2005/Atom%22] xmlns:ns2="[http://a9.com/{-}/spec/opensearch/1.1/"|http://a9.com/{-}/spec/opensearch/1.1/%22] xmlns:ns3="[http://www.w3.org/1999/xhtml">|http://www.w3.org/1999/xhtml%22%3E]     <id>ed663291-e9c7-48b4-8922-e28c5691dda3</id>     <title>HttpErrorResponse</title>     <published>2022-10-11T17:51:46.999+02:00</published>     <author>         <name>IBM Power Systems Management Console</name>     </author>     <content type="application/vnd.ibm.powervm.web+xml; type=HttpErrorResponse">         <HttpErrorResponse:HttpErrorResponse xmlns:HttpErrorResponse="[http://www.ibm.com/xmlns/systems/power/firmware/web/mc/2012_10/"|http://www.ibm.com/xmlns/systems/power/firmware/web/mc/2012_10/%22] xmlns="[http://www.ibm.com/xmlns/systems/power/firmware/web/mc/2012_10/"|http://www.ibm.com/xmlns/systems/power/firmware/web/mc/2012_10/%22] xmlns:ns2="[http://www.w3.org/XML/1998/namespace/k2"|http://www.w3.org/XML/1998/namespace/k2%22] schemaVersion="V1_0">     <Metadata>         <Atom/>     </Metadata>     <HTTPStatus kxe="false" kb="ROR">500</HTTPStatus>    <RequestURI kb="ROR" kxe="false">/rest/api/uom/ManagedSystem/72cXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXd1/NetworkBridge</RequestURI>     <ReasonCode kxe="false" kb="ROR">Unknown internal error.</ReasonCode>     <Message kxe="false" kb="ROO">com.ibm.pmc.rest.provider.exceptions.RESTProviderException:  Exception While getting SEA::  Unable to connect to Database. </Message>

Applies to

BVQ Version: any

Procedure

A simple way to resolve this UUID to the readable name of the Managed System can be implemented via a direct REST query of the HMC via a browser.

Insert UUID into a simple URL pattern to query the HMC for this specific Managed System:
https://hmcXXX.de:12443/rest/api/pcm/ManagedSystem/38XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX77/preferences

Alternatively, all Managed Systems of HMC can be queried and then searched for the corresponding entry:
https://hmc.XXX.de:12443/rest/api/pcm/preferences

HMC can be the IP address of the HMC or the host name of the HMC.

 

The generated result file contains one paragraph per Managed System, which then also contains the name of the Managed System.

<Metadata>         <Atom>             <AtomID>81XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX900</AtomID>             <AtomCreated>1674552062391</AtomCreated>         </Atom>     </Metadata>     <SystemName kb="ROR" kxe="false">pXXXX</SystemName>     <MachineTypeModelSerialNumber kxe="false" kb="ROR" schemaVersion="V1_0">         <Metadata>             <Atom/>         </Metadata>         <MachineType kxe="false" kb="ROR">9009</MachineType>         <Model kxe="false" kb="ROR">22G</Model>         <SerialNumber kxe="false" kb="ROR">78BDC20</SerialNumber>     </MachineTypeModelSerialNumber>     <EnergyMonitoringCapable kxe="false" kb="ROO">true</EnergyMonitoringCapable>     <LongTermMonitorEnabled kb="UOD" kxe="false">true</LongTermMonitorEnabled>     <AggregationEnabled kxe="false" kb="UOD">true</AggregationEnabled>     <ShortTermMonitorEnabled kxe="false" kb="UOD">false</ShortTermMonitorEnabled>     <ComputeLTMEnabled ksv="V1_1_0" kxe="false" kb="UOD">false</ComputeLTMEnabled>     <EnergyMonitorEnabled kxe="false" kb="UOD">true</EnergyMonitorEnabled>     <AssociatedManagedSystem kxe="false" kb="ROO" href="https://hmc.XXX.de:12443/rest/api/uom/ManagedSystem/81XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX900"  rel="related"/> </ManagedSystemPcmPreference:ManagedSystemPcmPreference>

With the now uniquely determined name of the Managed System, the recommended actions can then be executed on the VIOS of the affected system.