REST-API-Connectorquellen für Turbonomic generieren

Verwenden Sie den Connector REST API, um in Ihrer Anwendungsumgebung Verbindungen zu REST-konformen Turbonomic-Services herzustellen. Es werden nur die REST-APIs users, groups und entities unterstützt.

Umsetzungsscriptdatei erstellen.

• Führen Sie die folgenden Schritte aus, um eine Umsetzungsscriptdatei zu erstellen:
  1. Wechseln Sie in das folgende Verzeichnis, in dem sich die Beispielscriptdatei restapi_sample_response_t12n.txt für die Umsetzung befindet:

     $installationsverzeichnis/wlp/usr/servers/prdapp/restapi_t12n

  2. Erstellen Sie eine Kopie dieser Datei, benennen Sie die Datei um und öffnen Sie diese Datei in einem beliebigen Texteditor.
  3. Löschen Sie den Inhalt der Datei, kopieren Sie das folgende Script und fügen Sie es in die Datei ein:

     var input;
     var finalJson;
     var output;	
     var outArr=[]
     
     // Parse the input in JSON format
     input = JSON.parse(transformationInput)
     
     if(input instanceof Array)
     {
     	outArr= input;
     
     }
     else
     {
     	outArr.push(input);
     }
     finalJson=outArr;  
     output = JSON.stringify(finalJson);

  4. Speichern Sie die Datei als JavaScript-Datei mit der Dateierweiterung .js.
     Die Scriptdatei für die Umsetzung wurde erstellt.

JSESSION-Cookie generieren

• Führen Sie die folgenden Schritte aus, um ein JSESSION-Cookie zu generieren:
  1. Verwenden Sie PuTTY, um sich bei der VM anzumelden, auf der Turbonomic installiert ist.
  2. Führen Sie den folgenden Befehl aus, um ein JSESSION-Cookie zu generieren. Die Cookiedatei wird an der Position generiert, an der Sie den Befehl ausführen.

     curl -k -v 'https://server_IP_or_HOSTNAME/vmturbo/rest/login' --data
     'username=<user_name>&password=<password>'

     Dabei gilt Folgendes:

     • server-IP_oder_hostname ist die IP-Adresse oder der Hostname des Servers, auf dem der Turbonomic-Web-Service gehostet wird.
     • <user_name> ist der Benutzername des Administratorkontos.
     • <password> ist das Kennwort für das Administratorkonto.
  3. Führen Sie den folgenden Befehl aus, um den Cookiespeicher anzuzeigen:
     cat /<directory_name>/cookies
     Im Folgenden sehen Sie ein Beispiel für die Ausgabe, die angezeigt wird:

     # Netscape HTTP Cookie File
     # http://curl.haxx.se/docs/http-cookies.html
     # This file was generated by libcurl! Edit at your own risk.
     
     #HttpOnly_server_IP_or_HOSTNAME FALSE / TRUE 0 JSESSIONID node0orh922baxbyyj4lrgd0nv5pl38.node0
     

     Das JSESSION-Cookie wird als node0orh922baxbyyj4lrgd0nv5pl38.node0 angezeigt.

     Dieses Cookie verfällt nach wenigen Minuten; daher müssen Sie das Cookie erneut erstellen und dies in alle Quellen und Datendefinitionen eingeben. Wenden Sie sich an Ihren Ansprechpartner bei IBM Professional Services, um diese sich wiederholenden Schritte zu vermeiden.

REST-konforme Turbonomic-Web-Services mithilfe des Connectors REST API hinzufügen

• Führen Sie die folgenden Schritte aus, um REST-konforme Turbonomic-Web-Services mithilfe des Connectors REST API hinzuzufügen:
  1. Öffnen Sie Dashboard Designer.
  2. Rufen Sie im Navigationsbereich Connectors & Quellen > Connectorquellen auf.
  3. Klicken Sie auf der Seite 'Alle Connectorquellen' auf Quelle hinzufügen.

     Das Fenster Connectorquelle hinzufügen wird angezeigt.

  4. Wählen Sie in der Liste Connectortyp den Connector REST-API aus.
  5. Geben Sie in das Feld Name der Connectorquelle einen Namen für die Quelle ein.

     Der Quellenname kann alphanumerische Zeichen und Unterstreichungszeichen enthalten.

  6. Geben Sie in das Feld Endpunkt-URL die URL-Details für den Web-Service in einem der folgenden Formate ein:

     http://server-IP_oder_hostname/vmturbo/rest/

     Dabei gilt Folgendes:

     • server-IP_oder_hostname ist die IP-Adresse oder der Hostname des Servers, auf dem der Web-Service gehostet wird.
  7. Wählen Sie in der Liste Authentifizierungstyp die Option Keiner aus.
  8. Geben Sie den Namen der Umsetzungsscriptdatei im Feld Name des Scripts für die Antwortumwandlung ein, wenn Sie die Antwort umsetzen wollen.
  9. Klicken Sie auf Weiter.
  10. Wählen Sie in der Liste Methode eine Methode aus und führen Sie basierend auf der ausgewählten Methode einen der folgenden Schritte aus:
      • Geben Sie für die Methode GET im Feld URI den URI (Uniform Resource Identifier) für die Quelle ein.
      • Geben Sie für die Methode POST im Feld URI den URI für die Quelle ein und im Feld Anforderungshauptteil die POST-Anforderung.

      Beispiel-URI für die Methode GET: users

  11. Geben Sie unter Angepasste Header den folgenden Header und den folgenden Wert ein:
      • Name des angepassten Headers: Geben Sie Cookie ein.
      • Wert: Geben Sie das zuvor von Ihnen generierte JSESSION-Cookie ein.

        Beispiel: node0orh922baxbyyj4lrgd0nv5pl38.node0

  12. Klicken Sie auf Verbindung testen, um sicherzustellen, dass die Verbindung zur Datenquelle erfolgreich war.
      Wenn die Quellendetails und die Beispielanforderung gültig und vollständig sind, wird eine Nachricht angezeigt, die besagt, dass die Verbindung erfolgreich hergestellt wurde. Wird eine Nachricht ausgegeben, die besagt, dass ein Verbindungsfehler aufgetreten ist, müssen Sie die in der Nachricht beschriebenen Fehler beheben und die Verbindung erneut testen.

      Anmerkung: Auch wenn die Quellendetails gültig sind, kann es vorkommen, dass eine Verbindungsfehlernachricht angezeigt wird. Dies ist der Fall, wenn für die Beispielanforderung eine ungültige Antwort empfangen wird.
  13. Klicken Sie auf Speichern.