Befehl "managesdk"

Der Befehl managesdk gibt die Namen der SDKs (Software Development Kits) zurück, die vom Produkt verwendet werden.

Verwenden Sie den Befehl managesdk für folgende Aufgaben:
  • Namen der SDKs auflisten, die für eine Produktinstallation verfügbar sind
  • SDK-Namen auflisten, die ein angegebenes Profil verwendet
  • SDK-Namen für jedes Profil in einer Produktinstallation auflisten, die das Profil verwendet
  • Ein Profil für die Verwendung eines angegebenen SDK-Namens aktivieren
  • Alle Profile für die Verwendung eines angegebenen SDK-Namens aktivieren
  • Namen des SDK abrufen, das für die Konfiguration neuer Befehle verwendet wird
  • Namen des von Profilen verwendeten Standard-SDK ändern
  • Namen des SDK ändern, das von Scripts verwendet wird, die im Verzeichnis bin eines Produkts aufgerufen werden.
  • Namen des SDK ändern, das Scripts im Verzeichnis bin des Produkts standardmäßig verwenden. Der SDK-Name wird verwendet, wenn kein vorhandenes Profil angegeben und der Standardprofilname nicht zutreffend ist.

Die Befehlsdatei befindet sich im Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin und im Verzeichnis Stammverzeichnis_des_Anwendungsclients/bin.

[IBM i]Achtung: Der Befehl managesdk stellt Funktionen des Befehls enableJvm bereit, wodurch dieser ersetzt wird. Der Befehl enableJvm ist veraltet. Verwenden Sie den Befehl managesdk anstelle des Befehls enableJvm.
Achtung: Wenn Sie den Befehl managesdk in einer eingebundenen Zelle verwenden und ein SDK auf einem Knoten aktivieren, wird das SDK nur vom Befehl gefunden, wenn der Node Agent erneut gestartet wird.

[z/OS]Wenn Sie ein neues SDK in eine vorhandene Kopie von WebSphere Application Server for z/OS installieren, muss jeder Anwendungsserverknoten bzw. Verwaltungsknoten erneut gestartet werden, bevor das SDK auf dem betreffenden Knoten verwendet werden kann. Wenn der Knoten erneut gestartet wird, erstellt das Installationsnachbereitungsprogramm die erforderlichen symbolischen Links vom Konfigurationsdateisystem zu dem Produktdateisystem, in dem das neue SDK enthalten ist.

Anmerkung: Nach der Installation wählt WebSphere Application Server aus den installierten Java™-SDKs die höchste Java-SDK-Version aus. Diese wird in neu erstellten Profilen standardmäßig für Befehle verwendet. Nach dieser Erstkonfiguration kann mit dem Befehl managesdk zu einem anderen SDK gewechselt werden, falls vorhanden.

Syntax

Verwenden Sie die folgende Befehlssyntax für den Befehl managesdk:

managesdk -task [-Parameter] [Wert]

Das Befehlszeilentool prüft, ob die angeforderte Task die erforderlichen Parameter und Werte enthält. Bei der Eingabe der Parameter muss die Groß-/Kleinschreibung nicht beachtet werden. Die Groß-/Kleinschreibung muss bei Werten jedoch beachtet werden. Sie müssen Werte in der richtigen Groß-/Kleinschreibung eingeben, weil das Befehlszeilentool die Groß-/Kleinschreibung der Parameterwerte nicht prüft. Es können falsche Ergebnisse ausgegeben werden, wenn der Parameterwert nicht korrekt eingegeben wird.

Parameter

Die folgenden Optionen für -task sind für den Befehl managesdk verfügbar:

-help
Zeigt detaillierte Informationen zu den Parametern bzw. Werten jeder Task von managesdk an. Im folgenden Beispiel wird der Parameter "help" mit dem Befehl managesdk verwendet:
[AIX][HP-UX][Linux][Solaris][z/OS]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -help
[IBM i]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -help
[Windows]
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -help

Die Ausgabe der Option "help" beschreibt die erforderlichen und optionalen Parameter.

-listAvailable [-verbose]
Zeigt eine Liste aller SDK-Namen an, die für die Produktinstallation verfügbar sind. Wenn Sie zusätzlich die Option -verbose angeben, wird auch eine Liste der Eigenschaften für jeden SDK-Namen angezeigt. Im folgenden Beispiel werden die Parameter -listAvailable -verbose mit dem Befehl managesdk verwendet:
[AIX][HP-UX][Linux][Solaris][z/OS]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -listAvailable -verbose
[IBM i]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -listAvailable -verbose
[Windows]
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -listAvailable -verbose

Die Ausgabe ist eine Liste mit allen SDK-Namen, die die Produktinstallation verwenden kann, zusammen mit einer Liste der Eigenschaften, die jedem SDK-Namen zugeordnet sind.

-listEnabledProfile [-profileName Profilname] [-verbose]
Zeigt eine Liste aller SDK-Namen an, für deren Verwendung ein angegebenes Profil und die zugehörigen Knoten und Server konfiguriert sind. Wenn Sie zusätzlich die Option -verbose angeben, wird auch eine Liste der Eigenschaften für jeden SDK-Namen angezeigt. Im folgenden Beispiel werden die Parameter -listEnabledProfile -profileName und -verbose mit dem Befehl managesdk verwendet:
[AIX][HP-UX][Linux][Solaris][z/OS]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -listEnabledProfile -profileName AppSrv02 -verbose
[IBM i]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -listEnabledProfile -profileName AppSrv02 -verbose
[Windows]
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -listEnabledProfile -profileName AppSrv02 -verbose

Die Ausgabe ist eine Liste mit allen SDK-Namen, die das angegebenen Profile verwenden kann, zusammen mit einer Liste der Eigenschaften, die jedem SDK-Namen zugeordnet sind.

-listEnabledProfileAll [-verbose]
Zeigt eine Liste aller Profile in einer Installation an sowie die SDK-Namen, für deren Verwendung jedes Profil und die zugehörigen Knoten und Server konfiguriert sind. Wenn Sie zusätzlich die Option -verbose angeben, wird auch eine Liste der Eigenschaften für jeden SDK-Namen angezeigt. Im folgenden Beispiel werden die Parameter -listEnabledProfileAll und -verbose mit dem Befehl managesdk verwendet:
[AIX][HP-UX][Linux][Solaris][z/OS]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -listEnabledProfileAll -verbose
[IBM i]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -listEnabledProfileAll -verbose
[Windows]
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -listEnabledProfileAll -verbose

Die Ausgabe ist eine Liste aller Profile in einer Produktinstallation mit allen SDK-Namen, die jedes Profil verwenden kann, zusammen mit einer Liste der Eigenschaften, die jedem SDK-Namen zugeordnet sind.

-enableProfile [-profileName Profilname] [-sdkname SDK-Name] [-enableServers] [-user Benutzername] [-password Kennwort]
Aktiviert ein Profil für die Verwendung eines angegebenen SDK-Namens. Der Parameter -profileName gibt das Profil und der Parameter -sdkname den SDK-Namen an. Der Befehl aktiviert das Profil und das zugehörige Standard-SDK auf Knotenebene für die Verwendung des angegebenen SDK-Namens. Sofern nicht die Option -enableServers verwendet wird, ändert der Befehl keine SDK-Einstellungen auf Serverebene. Wenn die Option -enableServers verwendet wird, werden alle SDK-Einstellungen auf Serverebene gelöscht, sodass alle Server für die Verwendung des Standard-SDK auf Knotenebene aktiviert werden.
Für die Ausführung des Befehls managesdk gelten die folgenden Bedingungen:
  • Wenn das Profil ein eingebundener Knoten eines Deployment Manager ist, muss der Deployment Manager aktiv sein, wenn der Befehl managesdk versucht, das Profil zu aktualisieren.
  • Wenn das Profil ein eigenständiger Anwendungsserver, ein eigenständiger sicherer Proxy-Server, Job-Manager, Verwaltungsagent oder Deployment Manager ist, darf der Profilserver (Knoten) nicht aktiv sein, wenn der Befehl managesdk versucht, das Profil zu aktualisieren. Stoppen Sie den Server, bevor Sie den Befehl managesdk ausführen.
  • Wenn Sie das SDK für einen Knoten aktivieren, führen Sie den Befehl managesdk aus dem Verzeichnis /bin der Produktinstallation aus, zu der der Knoten gehört, oder aus dem Verzeichnis /bin des Profils, das den Knoten enthält, den Sie aktualisieren möchten.
  • Es muss eine Verbindung zum Deployment Manager vorhanden sein. Hierfür sollten Sie ein unterstütztes Verbindungsprotokoll verwenden, und zwar in der nachfolgenden genannten bevorzugten Reihenfolge:
    1. SOAP
    2. Inter-Process Communications (IPC)
    3. Remote Method Invocation (RMI)
    Wenn das SOAP-Protokoll aktiviert ist, verwendet der Befehl managesdk das SOAP-Protokoll. Wenn das SOAP-Protokoll nicht aktiviert ist, jedoch stattdessen das IPC-Protokoll aktiviert ist, verwendet der Befehl das IPC-Protokoll. Wenn weder das SOAP- noch das IPC-Protokoll aktiviert sind, verwendet der Befehl das RMI-Protokoll.
  • Sie müssen für jedes Profil, das einen eingebundenen Knoten oder Deployment-Manager-Knoten in einer Zelle mit aktivierter Sicherheit enthält, die ID des Benutzers mit Verwaltungsaufgaben und das Kennwort mit dem Befehl managesdk angeben. Wenn Sie die Parameter -user und -password im Befehl managesdk nicht angeben, kann die Verarbeitung fehlschlagen oder stoppen. Der Artikel zur Konfiguration von Sicherheit mit Scripting enthält spezifische Anweisungen darüber, wie Sie die Werte für den Benutzernamen und das Kennwort für das Connector-Protokoll speichern können.
  • Wenn Sie das SDK für einen Deployment Manager aktivieren, wird nur der Deployment-Manager-Server aktiviert. Keiner der vom Deployment Manager verwalteten Knoten ist für die Verwendung dieses SDK aktiviert.

Im folgenden Beispiel werden die Parameter -enableProfile, -profileName, -sdkname und -enableServers mit dem Befehl managesdk verwendet:

[AIX][HP-UX][Linux][Solaris]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
[IBM i]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
[Windows]
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
[z/OS]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers

In einer Nachricht wird angezeigt, ob das angegebene Profil erfolgreich aktualisiert wurde und jetzt für die Verwendung des angegebenen SDK aktiviert ist oder ob Fehler aufgetreten sind, durch die das Profil nicht erfolgreich aktualisiert werden konnte.

-enableProfileAll [-sdkname SDK-Name] [-enableServers] [-user Benutzername] [-password Kennwort]
Aktiviert alle Profile in einer Installation für die Verwendung eines angegebenen SDK-Namens. Der Parameter -sdkname gibt den SDK-Namen an. Der Befehl aktiviert alle Profile und den zugehörigen Standard-SDK auf Knotenebene für die Verwendung des angegebenen SDK-Namens. Sofern nicht die Option -enableServers verwendet wird, ändert der Befehl keine SDK-Einstellungen auf Serverebene. Wenn die Option -enableServers verwendet wird, werden alle SDK-Einstellungen auf Serverebene gelöscht, sodass alle Server für die Verwendung des Standard-SDK auf Knotenebene aktiviert werden.
Für die Ausführung des Befehls managesdk gelten die folgenden Bedingungen:
  • Wenn das Profil ein eingebundener Knoten eines Deployment Manager ist, muss der Deployment Manager aktiv sein, wenn der Befehl managesdk versucht, das Profil zu aktualisieren.
  • Wenn das Profil ein eigenständiger Anwendungsserver, ein eigenständiger sicherer Proxy-Server, Job-Manager, Verwaltungsagent oder Deployment Manager ist, darf der Profilserver (Knoten) nicht aktiv sein, wenn der Befehl managesdk versucht, das Profil zu aktualisieren. Stoppen Sie den Server, bevor Sie den Befehl managesdk ausführen.
  • Wenn Sie das SDK für einen Knoten aktivieren, führen Sie den Befehl managesdk aus dem Verzeichnis /bin der Produktinstallation aus, zu der der Knoten gehört, oder aus dem Verzeichnis /bin des Profils, das den Knoten enthält, den Sie aktualisieren möchten.
  • Es muss eine Verbindung zum Deployment Manager vorhanden sein. Hierfür sollten Sie ein unterstütztes Verbindungsprotokoll verwenden, und zwar in der nachfolgenden genannten bevorzugten Reihenfolge:
    1. SOAP
    2. Inter-Process Communications (IPC)
    3. Remote Method Invocation (RMI)
    Wenn das SOAP-Protokoll aktiviert ist, verwendet der Befehl managesdk das SOAP-Protokoll. Wenn das SOAP-Protokoll nicht aktiviert ist, jedoch stattdessen das IPC-Protokoll aktiviert ist, verwendet der Befehl das IPC-Protokoll. Wenn weder das SOAP- noch das IPC-Protokoll aktiviert sind, verwendet der BEfehl das RMI-Protokoll.
  • Sie müssen für jedes Profil, das einen eingebundenen Knoten oder Deployment-Manager-Knoten in einer Zelle mit aktivierter Sicherheit enthält, die ID des Benutzers mit Verwaltungsaufgaben und das Kennwort mit dem Befehl managesdk angeben. Wenn Sie die Parameter -user und -password im Befehl managesdk nicht angeben, kann die Verarbeitung fehlschlagen oder stoppen. Der Artikel zur Konfiguration von Sicherheit mit Scripting enthält spezifische Anweisungen darüber, wie Sie die Werte für den Benutzernamen und das Kennwort für das Connector-Protokoll speichern können.
    Fehler vermeiden Fehler vermeiden: Verwenden Sie nicht die Option -enableProfileAll, es sei denn, die automatische Aufforderung für SOAP-, IPC- und RMI-Verbindungen mit Deployment Managern der Zellen mit eingebundenen Knoten oder einem Deployment Manager mit aktivierter Sicherheit ist inaktiviert. Der Befehl managesdk schlägt fehl oder die Verarbeitung stoppt bei aktivierter automatischer Aufforderung. gotcha
  • Wenn Sie das SDK für einen Deployment Manager aktivieren, wird nur der Deployment-Manager-Server aktiviert. Keiner der vom Deployment Manager verwalteten Knoten ist für die Verwendung dieses SDK aktiviert.

Im folgenden Beispiel werden die Parameter -enableProfileAll, -sdkname und -enableServers mit dem Befehl managesdk verwendet:

[AIX][HP-UX][Linux][Solaris]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -enableProfileAll -sdkname 8.0_64 -enableServers
[IBM i]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -enableProfileAll -sdkname 8.0_64 -enableServers
[Windows]
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -enableProfileAll -sdkname 8.0_64 -enableServers
[z/OS]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -enableProfileAll -sdkname 8.0_64 -enableServers

Es wird eine Nachricht für jedes Profil ausgegeben, aus der hervorgeht, ob das Profil erfolgreich aktualisiert wurde und jetzt für die Verwendung des angegebenen SDK aktiviert ist, oder ob Fehler aufgetreten sind, durch die das Profil nicht erfolgreich aktualisiert werden konnte.

-getNewProfileDefault [-verbose]
Zeigt den SDK-Namen an, der für alle Profile konfiguriert ist, die mit dem Befehl manageprofiles erstellt werden. Wenn die Option -verbose auch angegeben wird, werden auch Eigenschafteninformationen für den einzelnen SDK-Namen angezeigt.

Im folgenden Beispiel werden die Parameter -getNewProfileDefault -verbose mit dem Befehl managesdk verwendet:

[AIX][HP-UX][Linux][Solaris][z/OS]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -getNewProfileDefault -verbose
[IBM i]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -getNewProfileDefault -verbose
[Windows]
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -getNewProfileDefault -verbose

Nach der Ausführung des Befehls wird der neue Standard-SDK-Name für das Profil angezeigt.

-setNewProfileDefault [-sdkname SDK-Name]
Ändert den SDK-Namen, der für alle Profile konfiguriert ist, die mit dem Befehl manageprofiles erstellt werden. Der Parameter -sdkname gibt den zu verwendenden Standard-SDK-Namen an. Der Wert SDK-Name muss ein SDK-Name sein, der für die Produktinstallation aktiviert ist.

Im folgenden Beispiel werden die Parameter -setNewProfileDefault -sdkname mit dem Befehl managesdk verwendet:

[AIX][HP-UX][Linux][Solaris]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -setNewProfileDefault -sdkname 8.0_64
[IBM i]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -setNewProfileDefault -sdkname 8.0_64
[Windows]
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -setNewProfileDefault -sdkname 8.0_64
[z/OS]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -setNewProfileDefault -sdkname 8.0_64

Nach der Ausführung des Befehls wird der neue Standard-SDK-Name für das Profil angezeigt.

-getCommandDefault [-verbose]
Zeigt den SDK-Namen an, den Scriptbefehle im Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin, Stammverzeichnis_des_Anwendungsclients/bin oder Stammverzeichnis_für_Plug-ins/bin verwenden können, wenn der Befehl kein vorhandenes Profil angibt oder kein Standardprofil festlegt. Wenn die Option -verbose auch angegeben wird, werden auch Eigenschafteninformationen für den einzelnen SDK-Namen angezeigt.

Im folgenden Beispiel werden die Parameter -getCommandDefault -verbose mit dem Befehl managesdk verwendet:

[AIX][HP-UX][Linux][Solaris][z/OS]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -getCommandDefault -verbose
[IBM i]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -getCommandDefault -verbose
[Windows]
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -getCommandDefault -verbose
-setCommandDefault [-sdkname SDK-Name]
Ändert den SDK-Namen, den Scriptbefehle im Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin, Stammverzeichnis_des_Anwendungsclients/bin oder Stammverzeichnis_für_Plug-ins/bin verwenden können, wenn der Befehl kein vorhandenes Profil angibt oder kein Standardprofil festlegt. Der Parameter -sdkname gibt den SDK-Namen an, der für die Befehle verwendet werden soll. Der Wert SDK-Name muss ein SDK-Name sein, der für die Produktinstallation aktiviert ist.

Im folgenden Beispiel werden die Parameter -getCommandDefault -sdkname mit dem Befehl managesdk verwendet:

[AIX][HP-UX][Linux][Solaris]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -setCommandDefault -sdkname 8.0_64
[IBM i]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -setCommandDefault -sdkname 8.0_64
[Windows]
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -setCommandDefault -sdkname 8.0_64
[z/OS]
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -setCommandDefault -sdkname 8.0_64

Die folgenden Sonderparameteroptionen sind für die Taskparameter des Befehls managesdk verfügbar:

-debug
Verwenden Sie diese Option mit einem Parameter des Typs -task, um weitere Debuginformationen in der Befehlsausgabe zu aktivieren.
-quiet
Verwenden Sie diese Option mit einem Parameter des Typs -task, um die meisten Nachrichten in der Befehlsausgabe zu unterdrücken.
-sdkname
Verwenden Sie diese Option mit einem Parameter des Typs -set task, um einen SDK-Namen anzugeben, der für die Produktinstallation aktiviert ist, z. B.:
  • [AIX][HP-UX][IBM i][Linux][Solaris][Windows]-sdkname 8.0_64
-verbose
Verwenden Sie diese Option mit einem der Taskparameter -list oder -get, um weitere Informationen anzugeben, z. B. SDK-Eigenschaften in der Befehlsausgabe.
[AIX Solaris HP-UX Linux Windows][IBM i]

Einsatzszenario

Das folgende Beispiel veranschaulicht die korrekte Syntax für die Ausführung des Befehls managesdk:

managesdk -listAvailable -verbose
managesdk -listEnabledProfile -profileName AppSrv02 -verbose
managesdk -listEnabledProfileAll -verbose
managesdk -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
managesdk -enableProfileAll -sdkname 8.0_64 -enableServers
managesdk -getNewProfileDefault -verbose
managesdk -setNewProfileDefault -sdkname 8.0_64
managesdk -getCommandDefault -verbose
managesdk -setCommandDefault -sdkname 8.0_64

Das folgende Beispiel zeigt die Befehlsfolge, die Sie verwenden müssen, um die verfügbaren SDKs aufzulisten, das Standard-SDK in ein SDK der Version 8.0 zu ändern und, falls bereits Profile vorhanden sind, die Profile für die Verwendung des SDK der Version 8.0 aktivieren.

  1. Optional eine Liste der verfügbaren SDK-Namen für die Produktinstallation anzeigen:
    managesdk -listAvailable
  2. Als Standardeinstellung für den Befehl das SDK der Version 8.0 festlegen:
    managesdk -setCommandDefault -sdkname 8.0_64
  3. Als Standardeinstellung für das neue Profil das SDK der Version 8.0 festlegen:
    managesdk -setNewProfileDefault -sdkname 8.0_64
  4. Wenn die Profile bereits vorhanden sind, die Profile für die Verwendung des SDK der Version 8.0 aktivieren:
    managesdk -enableProfileAll -sdkname 8.0_64 -enableServers

    Damit eingebundene Profile in einer Network-Deployment-Installation geändert werden können, muss der Network Deployment aktiv sein. Der Befehl managesdk aktualisiert das Masterkonfigurationsrepository. Nach Ausführung des Befehls muss eine Synchronisationsoperation ausgeführt werden, damit das neue SDK für die eingebundenen Profile verwendet werden kann.


Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_managesdk
Dateiname:rxml_managesdk.html