PowerEdge: Utforska WSMAN bortom uppräkning

WSMAN är det valda hanterings-API:et för Dell iDRAC och omfattande arbete pågår för att göra fjärrsystemhanteringen så omfattande och som möjligt. Efter att ha studerat WSMAN-protokollet för ett plugin
fann jag att det blir komplext efter den första uppräkningsåtgärden. Det finns ingen dokumentation eller exempel på hur du anropar get/put/create/delete/custom Actions med rätt nyckelegenskaper. Den primära källan för denna information är DMTF:s WSMAN-specifikation och WSMAN-CIM-bindningsspecifikation som är smärtsamt långa att följa. Återigen kommer det mesta av innehållet i den här artikeln från DMTF-specifikationsdokumenten. Detta är ett försök att få den informationen att smälta med några exempel (på Linux).

 Jag har redan postat ett whitepaper om hur man kommer igång med SFCB och openwsman på https://linux.dell.com/files/whitepapers/WBEM_based_management_in_Linux.pdf. Om du är ny på WSMAN och SFCB skulle pdf:en vara en bättre utgångspunkt än den här artikeln. Som i ovanstående whitepaper handlar främst om openwsman- och SFCB CIMOM-implementeringar i den här artikeln

Nu, med tanke på en WSMAN-server, finns det något sätt att lista alla komponenter som kan hanteras av wsman API? De flesta WSMAN-servrarna pratar med en CIMOM på backend och exponerar CIMOM:ernas hanteringsfunktioner. Det innebär att hanteringsfunktionerna för en WSMAN-server beror på de CIM-leverantörer som är registrerade i CIMOM på serverdelen. CIMOM har en inbyggd funktion med namnet EnumerateClassNames definierad som kan anropas för att lista alla klasser som är registrerade i CIMOM.

Eftersom det inte finns någon en-till-en-mappning för EnumerateClassNames i WSMAN-specifikationen anropas den här metoden som andra anpassade funktioner i WSMAN. Observera att detta är implementeringsspecifikt och gäller för wsmancli-implementering. Detta kan vara annorlunda eller uppdateras i framtida versioner.

CIMOM:s inneboende EnumerateClassNames funktionen kan anropas på följande sätt med wsmancli:

 

wsman invoke -a EnumerateClassNames --hostname=test_host --port=5985 --username=abc --password=password http://schemas.openwsman.org/wbem/wscim/1/instrinsic  --namespace=root/cimv2

 

 <s:Body>

    <n1:EnumerateClassNames>

      <n1:name>root/cimv2:CIM_Service</n1:name>

      <n1:name>root/cimv2:Syslog_RecordInLog</n1:name>

      <n1:name>root/cimv2:Linux_SambaValidUsersForShare</n1:name>

       <n1:name>root/cimv2:Linux_BaseBoard</n1:name>

      <n1:name>root/cimv2:Linux_SambaForceUserForShare</n1:name>

      <n1:name>root/cimv2:Linux_Processor</n1:name>

      <n1:name>root/cimv2:CIM_RecordForLog</n1:name>

      <n1:name>root/cimv2:Linux_SambaShareForService</n1:name>

      <n1:name>root/cimv2:Linux_SambaServiceConfigurationForService</n1:name>

      <n1:name>root/cimv2:Linux_SambaHostsForService</n1:name>

      <n1:name>root/cimv2:Linux_SambaForceUserForGlobal</n1:name>

      <n1:name>root/cimv2:CIM_OSProcess</n1:name>

      <n1:name>root/cimv2:CIM_RunningOS</n1:name>...................

Utdata ser ut som ovan, vilket indikerar att i namnområdet root/cimv2, Linux_Processor är en av de anmälda klasserna. Flera CIM-klasser ärvs när nya klasser registreras i root eller cimv2, och kommandot listar alla dessa klassnamn. I allmänhet kan du ignorera alla klasser med CIM_ prefixet. Alla klasser med Linux_ prefix är de klasser som registrerats av leverantörer som är installerade på ett Linux-system.
När du arbetar med Dells iDRAC är du mest intresserad av lektioner med DCIM_ prefix.

 Med listan med klassnamn använder du getClass funktion för att extrahera Linux_Processor klassdefinition enligt följande:

 

wsman invoke -a GetClass --hostname=test_host --port=5985 --username=abc --password=password http://schemas.openwsman.org/wbem/wscim/1/intrinsic/Linux_Processor  --namespace=root/cimv2

 Kommandot ovan visar en lista över alla egenskaper som definieras i Linux_Processor lokalt. Det vill säga någon av de egenskaper som ärvs från andra CIM_* Klasser visas inte med den aktuella implementeringen. Klassdefinitioner visar metoder, parametrar och nyckelegenskaper, men kommandot returnerar bara lokala egenskaper, vilket gör nyckelegenskaper oidentifierbara. Återigen är detta en implementeringsbegränsning i wsmancli. – Herr talman,

Även om GetClass är en bra början, dess utdata räcker inte för att identifiera nyckelegenskaper för att anropa get eller put eller create eller anpassade åtgärder.
Så, vilka andra tekniker kan användas för att åstadkomma detta? Det är här EPR kan vara till hjälp.


Slutpunktsreferens (EPR) är en pekare till en instans med två typer av information: ResourceURI och en väljaruppsättning. Via ResourceURI har det klassnamn som instansen skapas från och väljaruppsättningen visar de egenskaper som en instans kan identifieras unikt med. EPR:er för en viss klass kan räknas upp med ett kommando som liknar:

wsman enumerate -M epr  http://sblim.sf.net/wbem/wscim/1/cim-schema/2/Linux_Processor -h test_host-P 5985 -u abc -p password -O out

 <?xml version="1.0" encoding="UTF-8"?>

<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing" xmlns:wsen="http://schemas.xmlsoap.org/ws/2004/09/enumeration" xmlns:wsman="http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd">

  <s:Header>

    <wsa:To>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:To>

    <wsa:Action>http://schemas.xmlsoap.org/ws/2004/09/enumeration/PullResponse</wsa:Action>

    <wsa:RelatesTo>uuid:ca52c9e9-cd47-1d47-8003-a52924d9bed4</wsa:RelatesTo>

    <wsa:MessageID>uuid:ca622bb3-cd47-1d47-8097-a52924d9bed4</wsa:MessageID>

  </s:Header>

  <s:Body>

    <wsen:PullResponse>

      <wsen:EnumerationContext>ca4fdd21-cd47-1d47-8095-a52924d9bed4</wsen:EnumerationContext>

      <wsen:Items>

        <wsa:EndpointReference>

          <wsa:Address>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:Address>

          <wsa:ReferenceParameters>

            <wsman:ResourceURI>http://sblim.sf.net/wbem/wscim/1/cim-schema/2/Linux_Processor</wsman:ResourceURI>

            <wsman:SelectorSet>

              <wsman:Selector Name="__cimnamespace">root/cimv2</wsman:Selector>

              <wsman:Selector Name="SystemCreationClassName">Linux_ComputerSystem</wsman:Selector>

              <wsman:Selector Name="SystemName">localhost.localdomain</wsman:Selector>

              <wsman:Selector Name="CreationClassName">Linux_Processor</wsman:Selector>

              <wsman:Selector Name="DeviceID">0</wsman:Selector>

            </wsman:SelectorSet>

          </wsa:ReferenceParameters>

        </wsa:EndpointReference>

      </wsen:Items>

    </wsen:PullResponse>

  </s:Body>

</s:Envelope>

Av alla processorer i målsystemet är ovanstående utdata från en processor.
I utdata visas resourceURI som https://sblim.sourceforge.net/wbem/wscim/1/cim-schema/2/Linux_Processor och SelectorSet Visar en lista över värdena för __cimnamespace, SystemCreationClassName, SystemName, CreationClassName, and DeviceID. Det innebär att av alla egenskaper i klassen som ärvs och definieras lokalt) kan dessa egenskaper användas för att unikt identifiera en instans.

 Så du kan förvänta dig ett giltigt svar från ett kommando som:

wsman get  http://sblim.sf.net/wbem/wscim/1/cim-schema/2/Linux_Processor?SystemCreationClassName="Linux_ComputerSystem",SystemName="localhost.localdomain",CreationClassName="Linux_Processor",DeviceID="3",__cimnamespace="root/cimv2" -h test_host -P 5985 -u abc -p password -O get

 Om andra egenskaper används i ovanstående begäran kan CIMOM i serverdelen inte identifiera en instans unikt. Om du vill köra anpassade metoder på en instans använder du klassens EPR för att identifiera nyckelegenskaper för metodanrop.

Du kan också räkna upp EPR:er för en förening. Givet ett klassnamn kan man inte räkna ut om det är ett standardklassnamn eller en associationsklass. En associationsinstans pekar på två instanser, så dess EPR inkluderar EPR:erna för de instanser eller objekt som den refererar till. Följande är ett exempel på samma sak:

wsman enumerate -M epr  http://sblim.sf.net/wbem/wscim/1/cim-schema/2/Linux_CSProcessor -h test_host -P 5985 -u abc -p password -O out

 <?xml version="1.0" encoding="UTF-8"?>

<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing" xmlns:wsen="http://schemas.xmlsoap.org/ws/2004/09/enumeration" xmlns:wsman="http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd">

  <s:Header>

    <wsa:To>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:To>

    <wsa:Action>http://schemas.xmlsoap.org/ws/2004/09/enumeration/PullResponse</wsa:Action>

    <wsa:RelatesTo>uuid:2efbfcad-cd4b-1d4b-8003-a52924d9bed4</wsa:RelatesTo>

    <wsa:MessageID>uuid:2efc1c6f-cd4b-1d4b-80b3-a52924d9bed4</wsa:MessageID>

  </s:Header>

  <s:Body>

    <wsen:PullResponse>

      <wsen:EnumerationContext>2ef7f6f5-cd4b-1d4b-80b1-a52924d9bed4</wsen:EnumerationContext>

      <wsen:Items>

        <wsa:EndpointReference>

          <wsa:Address>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:Address>

          <wsa:ReferenceParameters>

            <wsman:ResourceURI>http://sblim.sf.net/wbem/wscim/1/cim-schema/2/Linux_CSProcessor</wsman:ResourceURI>

            <wsman:SelectorSet>

              <wsman:Selector Name="__cimnamespace">root/cimv2</wsman:Selector>

              <wsman:Selector Name="GroupComponent">

                <wsa:EndpointReference>

                  <wsa:Address>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:Address>

                  <wsa:ReferenceParameters>

                    <wsman:ResourceURI>http://sblim.sf.net/wbem/wscim/1/cim-schema/2/Linux_ComputerSystem</wsman:ResourceURI>

                    <wsman:SelectorSet>

                      <wsman:Selector Name="CreationClassName">Linux_ComputerSystem</wsman:Selector>

                      <wsman:Selector Name="Name">localhost.localdomain</wsman:Selector>

                      <wsman:Selector Name="__cimnamespace">root/cimv2</wsman:Selector>

                    </wsman:SelectorSet>

                  </wsa:ReferenceParameters>

                </wsa:EndpointReference>

              </wsman:Selector>

              <wsman:Selector Name="PartComponent">

                <wsa:EndpointReference>

                  <wsa:Address>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:Address>

                  <wsa:ReferenceParameters>

                    <wsman:ResourceURI>http://sblim.sf.net/wbem/wscim/1/cim-schema/2/Linux_Processor</wsman:ResourceURI>

                    <wsman:SelectorSet>

                      <wsman:Selector Name="SystemCreationClassName">Linux_ComputerSystem</wsman:Selector>

                      <wsman:Selector Name="SystemName">localhost.localdomain</wsman:Selector>

                      <wsman:Selector Name="CreationClassName">Linux_Processor</wsman:Selector>

                      <wsman:Selector Name="DeviceID">0</wsman:Selector>

                      <wsman:Selector Name="__cimnamespace">root/cimv2</wsman:Selector>

                    </wsman:SelectorSet>

                  </wsa:ReferenceParameters>

                </wsa:EndpointReference>

              </wsman:Selector>

            </wsman:SelectorSet>

          </wsa:ReferenceParameters>

        </wsa:EndpointReference>

      </wsen:Items>

    </wsen:PullResponse>

  </s:Body>

</s:Envelope>

Linux_CSProcessor Länkar Linux_ComputerSystem och Linux_Processor, som visar att processorer finns i datorsystem, med information om GroupComponent och PartComponent avsnitt.

Jag ägnade tid åt att förstå EPR och deras användning för att komma åt instanser, och tänkte att det kunde hjälpa andra. Lämna gärna dina kommentarer eller förslag nedan.

Ansvarsfriskrivning:

Ovanstående artikel är endast i informationssyfte. Innehållet är från min tolkning av de nämnda teknikerna och terminologierna. Denna information tillhandahålls i befintligt skick och kan innehålla vissa typografiska fel och/eller tekniska felaktigheter.