Commande managesdk
La commande managesdk fournit les noms des kits de développement logiciels utilisés par le produit.
- 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]](../images/iseries.gif)
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.
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 :
racine_serveur_app/bin/managesdk.sh -help
racine_serveur_app/bin/managesdk -help
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 :
racine_serveur_app/bin/managesdk.sh -listAvailable -verbose
racine_serveur_app/bin/managesdk -listAvailable -verbose
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 :
racine_serveur_app/bin/managesdk.sh -listEnabledProfile -profileName AppSrv02 -verbose
racine_serveur_app/bin/managesdk -listEnabledProfile -profileName AppSrv02 -verbose
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 :
racine_serveur_app/bin/managesdk.sh -listEnabledProfileAll -verbose
racine_serveur_app/bin/managesdk -listEnabledProfileAll -verbose
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 :
Dans l'exemple suivant, les paramètres -enableProfile, -profileName, -sdkname et -enableServers sont utilisés avec la commande managesdk :
app_server_root/bin/managesdk.sh -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
app_server_root/bin/managesdk -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
app_server_root\bin\managesdk.bat -enableProfile -profileName AppSrv02 -sdkname 8.0_64 -enableServers
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 :
Dans l'exemple suivant, les paramètres -enableProfileAll, -sdkname et -enableServers sont utilisés avec la commande managesdk :
app_server_root/bin/managesdk.sh -enableProfileAll -sdkname 8.0_64 -enableServers
app_server_root/bin/managesdk -enableProfileAll -sdkname 8.0_64 -enableServers
app_server_root\bin\managesdk.bat -enableProfileAll -sdkname 8.0_64 -enableServers
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 :
racine_serveur_app/bin/managesdk.sh -getNewProfileDefault -verbose
racine_serveur_app/bin/managesdk -getNewProfileDefault -verbose
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 :
app_server_root/bin/managesdk.sh -setNewProfileDefault -sdkname 8.0_64
app_server_root/bin/managesdk -setNewProfileDefault -sdkname 8.0_64
app_server_root\bin\managesdk.bat -setNewProfileDefault -sdkname 8.0_64
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 :
racine_serveur_app/bin/managesdk.sh -getCommandDefault -verbose
racine_serveur_app/bin/managesdk -getCommandDefault -verbose
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 :
app_server_root/bin/managesdk.sh -setCommandDefault -sdkname 8.0_64
app_server_root/bin/managesdk -setCommandDefault -sdkname 8.0_64
app_server_root\bin\managesdk.bat -setCommandDefault -sdkname 8.0_64
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:
-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]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
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.
- 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
- 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
- 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
- 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.