Commande managesdk

La commande managesdk fournit les noms des kits de développement logiciels utilisés par le produit.

Utilisez la commande managesdk pour :
  • Répertorier les noms des kits de développement logiciel (SDK) disponibles pour une installation du produit.
  • Répertorier les noms des kits de développement logiciel (SDK) que la configuration d'un profil donné nécessite d'utiliser.
  • Pour chaque profil d'une installation de produit, répertorier les noms des kits de développement logiciel que la configuration du profil nécessite d'utiliser.
  • Permettre à un profil d'utiliser un nom de kit SDK donné.
  • Permettre à tous les profils d'une installation d'utiliser un nom de kit SDK donné.
  • Obtenir le nom du SDK utilisé pour configurer les nouveaux profils.
  • Modifier le nom du SDK par défaut utilisé par les profils.
  • Obtenir le nom du SDK utilisé par les scripts, appelé d'un répertoire bin du produit.
  • Modifier le nom du SDK que les scripts d'un répertoire bin du produit utilisent par défaut. Le nom du SDK est utilisé lorsqu'aucun nom de profil existant n'est spécifié et que le nom du profil par défaut n'est pas applicable.

Le fichier de commandes se trouve dans le répertoire racine_serveur_app/bin et le répertoire app_client_root/bin.

[IBM i]Avertissement : La commande managesdk fournit une fonction qui remplace la commande enableJvm. La commande enableJvm est obsolète. Utilisez la commande managesdk à la place de la commande enableJvm.
Avertissement : Si vous utilisez la commande managesdk dans une cellule fédérée, et activez un SDK sur un noeud, la commande ne trouve pas le SDK, sauf si l'agent du noeud est redémarré.

[z/OS]If you install a new SDK onto an existing copy of WebSphere Application Server for z/OS, each application server node or management node must be restarted before you can use the SDK on that node. Lorsque le noeud est redémarré, l'utilitaire de post-installation crée les liens symboliques requis entre le système de fichiers de configuration et le système de fichiers du produit qui contient le nouveau kit de développement de logiciels.

Remarque : After installation, the WebSphere Application Server looks at the installed Java™ SDKs, and chooses the highest level of Java SDK that is installed and that is used as the default for commands of newly created profiles. With this initial setting in place, the managesdk command can be used to change to another SDK, if one is available.

Syntaxe

Utilisez la syntaxe de commande suivante avec la commande managesdk :

managesdk -task [-parameter] [value]

L'outil de ligne de commande valide que la tâche demandée contient les paramètres et valeurs requis. Les paramètres ne sont pas sensibles à la casse. En revanche, les valeurs le sont. Vous devez taper des valeurs correctement mises en majuscules car l'outil de ligne de commande ne valide pas la capitalisation des valeurs de paramètre. Si la valeur de paramètre n'est pas tapée correctement, des résultats incorrects peuvent être produits.

Paramètres

Les options -task suivantes sont disponibles pour la commande managesdk :

-help
Affiche des informations détaillées sur les paramètres ou les valeurs de chaque tâche managesdk. Dans l'exemple suivant, le paramètre help est utilisé avec la commande managesdk :
[AIX][HP-UX][Linux][Solaris][z/OS]
racine_serveur_app/bin/managesdk.sh -help
[IBM i]
racine_serveur_app/bin/managesdk -help
[Windows]
racine_serveur_app\bin\managesdk.bat -help

Le résultat de l'option help décrit les paramètres obligatoires et facultatifs.

-listAvailable [-verbose]
Affiche une liste de tous les noms des logiciels SDK disponibles pour l'installation du produit. Lorsque l'option -verbose est également spécifiée, une liste de propriétés pour chaque nom de kit de développement de logiciels est également affichée. Dans l'exemple suivant, les paramètres -listAvailable -verbose sont utilisés avec la commande managesdk :
[AIX][HP-UX][Linux][Solaris][z/OS]
racine_serveur_app/bin/managesdk.sh -listAvailable -verbose
[IBM i]
racine_serveur_app/bin/managesdk -listAvailable -verbose
[Windows]
racine_serveur_app\bin\managesdk.bat -listAvailable -verbose

La sortie est une liste de tous les noms de kit de développement de logiciels utilisables par l'installation du produit, ainsi qu'une liste des propriétés associées à chaque nom de kit de développement de logiciels.

-listEnabledProfile [-profileName nom_profil] [-verbose]
Affiche une liste de tous les noms des kits de développement de logiciels que la configuration d'un profil donné, de son noeud et de ses serveurs nécessite d'utiliser. Lorsque l'option -verbose est également spécifiée, une liste de propriétés pour chaque nom de kit de développement de logiciels est également affichée. Dans l'exemple suivant, les paramètres -listEnabledProfile -profileName et -verbose sont utilisés avec la commande managesdk :
[AIX][HP-UX][Linux][Solaris][z/OS]
racine_serveur_app/bin/managesdk.sh -listEnabledProfile -profileName AppSrv02 -verbose
[IBM i]
racine_serveur_app/bin/managesdk -listEnabledProfile -profileName AppSrv02 -verbose
[Windows]
racine_serveur_app\bin\managesdk.bat -listEnabledProfile -profileName AppSrv02 -verbose

La sortie est une liste de tous les noms de kits de développement de logiciels utilisables par le profil spécifié, ainsi qu'une liste des propriétés associées à chaque nom de kit de développement de logiciels.

-listEnabledProfileAll [-verbose]
Affiche une liste de tous les profils d'une installation et des noms des kits de développement de logiciels que la configuration de chaque profil, de son noeud et de ses serveurs nécessite d'utiliser. Lorsque l'option -verbose est également spécifiée, une liste de propriétés pour chaque nom de kit de développement de logiciels est également affichée. Dans l'exemple suivant, les paramètres -listEnabledProfileAll et -verbose sont utilisés avec la commande managesdk :
[AIX][HP-UX][Linux][Solaris][z/OS]
racine_serveur_app/bin/managesdk.sh -listEnabledProfileAll -verbose
[IBM i]
racine_serveur_app/bin/managesdk -listEnabledProfileAll -verbose
[Windows]
racine_serveur_app\bin\managesdk.bat -listEnabledProfileAll -verbose

La sortie est une liste de tous les profils d'une installation de produit avec tous les noms de kits de développement de logiciels utilisables par chaque profil, ainsi qu'une liste des propriétés associées à chaque nom de kit de développement de logiciels.

-enableProfile [-profileName nom_profil] [-sdkname sdkName] [-enableServers] [-user nom_utilisateur] [-password mot_de_passe]
Permet à un profil d'utiliser un nom de kit SDK donné. Le paramètre -profileName spécifie le profil et le paramètre -sdkname spécifie le nom de kit de développement de logiciels. La commande permet au profil et à son SDK par défaut de niveau noeud d'utiliser le nom de SDK spécifié. La commande ne modifie pas les paramètres SDK de niveau serveur, sauf si l'option -enableServers est utilisée. Si l'option -enableServers est utilisée, tous les paramètres SDK de niveau serveur sont effacés, ce qui permet ainsi à tous les serveurs d'utiliser le SDK par défaut de niveau noeud.
Les conditions suivantes s'appliquent lorsque la commande managesdk est exécutée :
  • Si le profil est un noeud fédéré d'un gestionnaire de déploiement, le gestionnaire de déploiement doit être en cours d'exécution lorsque la commande managesdk tente de mettre à jour le profil.
  • Si le profil est un serveur d'applications autonome, un serveur proxy sécurisé autonome, un gestionnaire de travaux, un agent d'administration ou un gestionnaire de déploiement, le serveur de profil (noeud) ne doit pas être en cours d'exécution lorsque la commande managesdk tente de mettre à jour le profil. Arrêtez le serveur pour pouvoir exécuter la commande managesdk.
  • Lorsque vous activez le kit de développement de logiciels, exécutez la commande managesdk à partir du répertoire /bin de l'installation de produit dont fait partie le noeud ou à partir du répertoire /bin du profil contenant le noeud que vous souhaitez mettre à jour.
  • Il faut également qu'il existe une connexion au gestionnaire de déploiement à l'aide d'un protocole de connecteur pris en charge, dans l'ordre suivant de préférence :
    1. SOAP
    2. Inter-Process Communications (IPC)
    3. Remote Method Invocation (RMI)
    Si le protocole SOAP est activé, la commande managesdk utilise le protocole SOAP. Si le protocole SOAP n'est pas activé mais que le protocole IPC l'est, la commande utilise le protocole IPC. Si aucun des protocoles SOAP et IPC n'est activé, la commande utilise le protocole RMI.
  • Vous devez fournir le nom d'administrateur et le mot de passe avec la commande managesdk pour chaque profil contenant un noeud fédéré ou un noeud de gestionnaire de déploiement dans une cellule dont la sécurité est activée. Si vous ne spécifiez pas les paramètres -user et -password, la commande managesdk peut échouer ou arrêter le traitement. The topic on configuring security with scripting provides connector protocol-specific instructions on how to save user name and password values.
  • Lorsque vous activez le logiciel SDK pour un gestionnaire de déploiement, seul le serveur de gestionnaire de déploiement est activé. Aucun des noeuds gérés du gestionnaire de déploiement n'est activé pour utiliser le SDK concerné.

Dans l'exemple suivant, les paramètres -enableProfile, -profileName, -sdkname et -enableServers sont utilisés avec la commande managesdk :

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

La sortie est un message qui indique si le profil indiqué a été mis à jour et peut maintenant utiliser le SDK spécifié, ou si des problèmes ont empêché la mise à jour du profil.

-enableProfileAll [-sdkname sdkName] [-enableServers] [-user nom_utilisateur] [-password valeur_motdepasse]
Permet à tous les profils d'une installation d'utiliser un nom de kit SDK donné. Le paramètre -sdkname indique le nom du kit de développement de logiciels. La commande permet à tous les profils et au SDK par défaut de niveau noeud de chaque profil d'utiliser le nom de SDK indiqué. La commande ne modifie pas les paramètres SDK de niveau serveur, sauf si l'option -enableServers est utilisée. Si l'option -enableServers est utilisée, tous les paramètres SDK de niveau serveur sont effacés, ce qui permet ainsi à tous les serveurs d'utiliser le SDK par défaut de niveau noeud.
Les conditions suivantes s'appliquent lorsque la commande managesdk est exécutée :
  • Si le profil est un noeud fédéré d'un gestionnaire de déploiement, le gestionnaire de déploiement doit être en cours d'exécution lorsque la commande managesdk tente de mettre à jour le profil.
  • Si le profil est un serveur d'applications autonome, un serveur proxy sécurisé autonome, un gestionnaire de travaux, un agent d'administration ou un gestionnaire de déploiement, le serveur de profil (noeud) ne doit pas être en cours d'exécution lorsque la commande managesdk tente de mettre à jour le profil. Arrêtez le serveur pour pouvoir exécuter la commande managesdk.
  • Lorsque vous activez le kit de développement de logiciels, exécutez la commande managesdk à partir du répertoire /bin de l'installation de produit dont fait partie le noeud ou à partir du répertoire /bin du profil contenant le noeud que vous souhaitez mettre à jour.
  • Il faut également qu'il existe une connexion au gestionnaire de déploiement à l'aide d'un protocole de connecteur pris en charge, dans l'ordre suivant de préférence :
    1. SOAP
    2. Inter-Process Communications (IPC)
    3. Remote Method Invocation (RMI)
    Si le protocole SOAP est activé, la commande managesdk utilise le protocole SOAP. Si le protocole SOAP n'est pas activé mais que le protocole IPC l'est, la commande utilise le protocole IPC. Si ni le protocole SOAP, ni le protocole IPC n'est activé, la commande utilise le protocole RMI.
  • Vous devez fournir le nom d'administrateur et le mot de passe avec la commande managesdk pour chaque profil contenant un noeud fédéré ou un noeud de gestionnaire de déploiement dans une cellule dont la sécurité est activée. Si vous n'indiquez pas les paramètres -user et -password, la commande managesdk risque d'échouer ou de s'arrêter. The topic on configuring security with scripting provides connector protocol-specific instructions on how to save user name and password values.
    Eviter les incidents Eviter les incidents: N'utilisez pas l'option -enableProfileAll sauf si l'envoi d'une invite automatique est désactivé pour les connexions SOAP, IPC et RMI aux gestionnaires de déploiement de cellules sur lesquelles la sécurité est activée pour un noeud fédéré ou un gestionnaire de déploiement. L'envoi d'une invite automatique provoque l'échec ou l'arrêt de la commande managesdk.gotcha
  • Lorsque vous activez le logiciel SDK pour un gestionnaire de déploiement, seul le serveur de gestionnaire de déploiement est activé. Aucun des noeuds gérés du gestionnaire de déploiement n'est activé pour utiliser le SDK concerné.

Dans l'exemple suivant, les paramètres -enableProfileAll, -sdkname et -enableServers sont utilisés avec la commande managesdk :

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

La sortie est un message qui indique pour chaque profil si ce dernier a été mis à jour et peut maintenant utiliser le SDK spécifié, ou si des problèmes ont empêché la mise à jour du profil.

-getNewProfileDefault [-verbose]
Affiche le nom du kit de développement de logiciels configuré pour tous les profils créés à l'aide de la commande manageprofiles. Lorsque l'option -verbose est également spécifiée, des informations sur les propriétés du nom de kit de développement de logiciels unique sont également affichées.

Dans l'exemple suivant, les paramètres -getNewProfileDefault -verbose sont utilisés avec la commande managesdk :

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

Une fois la commande exécutée, le nom de SDK par défaut du nouveau profil est affiché.

-setNewProfileDefault [-sdkname sdkName]
Modifie le nom du kit de développement de logiciels configuré pour tous les profils créés à l'aide de la commande manageprofiles. Le paramètre -sdkname spécifie le nom de kit de développement de logiciels par défaut à utiliser. La valeur du paramètre sdkName doit être un nom de SDK activé pour l'installation du produit.

Dans l'exemple suivant, les paramètres -setNewProfileDefault -sdkname sont utilisés avec la commande managesdk :

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

Une fois la commande exécutée, le nom de SDK par défaut du nouveau profil est affiché.

-getCommandDefault [-verbose]
Affiche le nom de SDK que les commandes de script du répertoire racine_serveur_app/bin, racine_client_app/bin, ou racine_plugins/bin doivent utiliser lorsqu'aucun profil n'est spécifié par la commande et qu'aucun profil par défaut n'est utilisé. Lorsque l'option -verbose est également spécifiée, des informations sur les propriétés du nom de kit de développement de logiciels unique sont également affichées.

Dans l'exemple suivant, les paramètres -getCommandDefault -verbose sont utilisés avec la commande managesdk :

[AIX][HP-UX][Linux][Solaris][z/OS]
racine_serveur_app/bin/managesdk.sh -getCommandDefault -verbose
[IBM i]
racine_serveur_app/bin/managesdk -getCommandDefault -verbose
[Windows]
racine_serveur_app\bin\managesdk.bat -getCommandDefault -verbose
-setCommandDefault [-sdkname sdkName]
Modifie le nom de SDK que les commandes de script du répertoire racine_serveur_app/bin, racine_client_app/bin, ou racine_plugins/bin doivent utiliser lorsqu'aucun profil n'est spécifié par la commande et qu'aucun profil par défaut n'est utilisé. Le paramètre -sdkname spécifie le nom de kit de développement de logiciels à utiliser pour les commandes. La valeur du paramètre sdkName doit être un nom de SDK activé pour l'installation du produit.

Dans l'exemple suivant, les paramètres -getCommandDefault -sdkname sont utilisés avec la commande managesdk :

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

Les options de paramètre spéciales suivantes sont disponibles avec les paramètres de tâche de la commande managesdk :

-debug
Use this option with any -task parameter to enable additional debugging information in the command output.
-quiet
Use this option with any -task parameter to suppress most messages in the command output.
-sdkname
Use this option with a -set task parameter to specify an SDK name that is enabled for the product installation; for example:
  • [AIX][HP-UX][IBM i][Linux][Solaris][Windows]-sdkname 8.0_64
-verbose
Utilisez cette option avec un paramètre de tâche -list ou -get pour fournir des informations supplémentaires, telles que des propriétés SDK, dans le résultat de la commande.
[AIX Solaris HP-UX Linux Windows][IBM i]

Scénario d'utilisation

Les exemples ci-dessous présentent la syntaxe correcte à utiliser lorsque vous exécutez la commande 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

L'exemple suivant présente la séquence de commandes à utiliser pour répertorier les kits de développement de logiciels disponibles, modifier le kit de développement de logiciels par défaut pour un kit de développement de logiciels version 8.0 et, s'il existe déjà des profils, permettre aux profils d'utiliser le kit de développement de logiciels version 8.0.

  1. Si vous le souhaitez, vous pouvez afficher une liste des noms des kits de développement de logiciels disponibles pour l'installation du produit :
    managesdk -listAvailable
  2. Affectez à la commande la valeur par défaut correspondant au kit de développement de logiciels version 8.0 :
    managesdk -setCommandDefault -sdkname 8.0_64
  3. Affectez au nouveau profil la valeur par défaut correspondant au kit de développement de logiciels version 8.0 :
    managesdk -setNewProfileDefault -sdkname 8.0_64
  4. S'il existe déjà des profils, autorisez-les à utiliser le kit de développement de logiciels version 8.0 :
    managesdk -enableProfileAll -sdkname 8.0_64 -enableServers

    Pour pouvoir modifier des profils fédérés dans une installation de déploiement réseau, le gestionnaire de déploiement doit être en cours d'exécution. La commande managesdk met à jour le référentiel de configuration principale. Après l'exécution de la commande, une opération de synchronisation doit être effectuée pour que le nouveau kit de développement de logiciels puisse être utilisé pour les profils fédérés.


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_managesdk
Nom du fichier : rxml_managesdk.html