Befehl "managesdk"
Der Befehl managesdk gibt die Namen der SDKs (Software Development Kits) zurück, die vom Produkt verwendet werden.
- 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]](../images/iseries.gif)
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.
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:
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -help
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -help
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:
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -listAvailable -verbose
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -listAvailable -verbose
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:
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -listEnabledProfile -profileName AppSrv02 -verbose
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -listEnabledProfile -profileName AppSrv02 -verbose
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:
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -listEnabledProfileAll -verbose
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -listEnabledProfileAll -verbose
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:
Im folgenden Beispiel werden die Parameter -enableProfile, -profileName, -sdkname und -enableServers mit dem Befehl managesdk verwendet:
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
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:
Im folgenden Beispiel werden die Parameter -enableProfileAll, -sdkname und -enableServers mit dem Befehl managesdk verwendet:
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -enableProfileAll -sdkname 8.0_64 -enableServers
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -enableProfileAll -sdkname 8.0_64 -enableServers
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -enableProfileAll -sdkname 8.0_64 -enableServers
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:
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -getNewProfileDefault -verbose
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -getNewProfileDefault -verbose
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:
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -setNewProfileDefault -sdkname 8.0_64
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -setNewProfileDefault -sdkname 8.0_64
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -setNewProfileDefault -sdkname 8.0_64
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:
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -getCommandDefault -verbose
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -getCommandDefault -verbose
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:
Stammverzeichnis_des_Anwendungsservers/bin/managesdk.sh -setCommandDefault -sdkname 8.0_64
Stammverzeichnis_des_Anwendungsservers/bin/managesdk -setCommandDefault -sdkname 8.0_64
Stammverzeichnis_des_Anwendungsservers\bin\managesdk.bat -setCommandDefault -sdkname 8.0_64
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.:
-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]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
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.
- Optional eine Liste der verfügbaren SDK-Namen für die Produktinstallation anzeigen:
managesdk -listAvailable
- Als Standardeinstellung für den Befehl das SDK der Version 8.0 festlegen:
managesdk -setCommandDefault -sdkname 8.0_64
- Als Standardeinstellung für das neue Profil das SDK der Version 8.0 festlegen:
managesdk -setNewProfileDefault -sdkname 8.0_64
- 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.