Types de travaux d'administration réalisables à l'aide de l'outil de scriptage wsadmin

Dans un environnement de gestion souple, l'outil wsadmin permet de soumettre des travaux administratifs au gestionnaire de travaux. Cette rubrique contient des informations détaillées sur les travaux administratifs et les paramètres de travail, ainsi que des exemples de syntaxe de commande.

Dans un environnement de gestion souple, vous pouvez configurer un agent d'administration et un gestionnaire de travaux pour soumettre des travaux à plusieurs cibles ou groupes de cibles de la configuration. Vous pouvez ensuite soumettre des travaux administratifs pour mettre en file d'attente ces travaux dans votre environnement géré. Chaque travail administratif correspond à un type de travail définissant les paramètres obligatoires pour soumettre le travail. Vous pouvez utiliser les commandes du groupe AdministrativeJobs pour soumettre des travaux administratifs au gestionnaire de travaux.

Vous pouvez soumettre des travaux administratifs pour gérer vos applications.

Paramètres communs à tous les types de travaux

La commande submitJob permet de soumettre des travaux administratifs. Une soumission de travail comprend les informations suivantes :
Paramètres requis
Chaque commande submitJob requiert au moins un paramètre jobType. Un grand nombre de commandes submitJob requièrent également les paramètres targetList ou jobParams :
Tableau 1. Descriptions des paramètres requis submitJob. Exécutez une commande submitJob avec ses paramètres requis.
Paramètre Description Type
jobType Indique le type de travail à effectuer. Il existe de nombreux types de travaux dans l'environnement de gestion souple, notamment des travaux de gestion d'application, de maintenance du produit, de configuration et de contrôle d'exécution du serveur d'applications. String (chaîne)
targetList Indique une ou plusieurs cibles gérées où s'exécute le travail. String (chaîne)
jobParams Indique les informations de configuration, en plus du type de travail et de la cible, pour exécuter le travail. Les paramètres de travail sont spécifiques à chaque type de travail. String (chaîne)
Paramètres génériques facultatifs
Outre les paramètres spécifiques au travail, vous pouvez inclure l'un des paramètres facultatifs suivants lors de la soumission du travail :
Tableau 2. Description des paramètres génériques facultatifs submitJob. Exécutez une commande submitJob avec ses paramètres requis et avec les paramètres facultatifs correspondant à votre situation.
Paramètre Description Type
groupe Indique le nom du groupe de cibles gérées où s'exécute le travail. String (chaîne)
nom_utilisateur Indique le nom d'utilisateur à employer sur les cibles au moment de l'exécution du travail. Si vous n'indiquez ni nom d'utilisateur ni mot de passe et que la sécurité est activée, l'ID utilisateur est utilisé dans le gestionnaire de travaux. String (chaîne)
mot_de_passe Indique le mot de passe pour le nom d'utilisateur à employer sur les cibles au moment de l'exécution du travail. Si vous n'indiquez ni nom d'utilisateur ni mot de passe et que la sécurité est activée, l'ID utilisateur est utilisé dans le gestionnaire de travaux. String (chaîne)
privateKeyFile Indique le fichier de clé privée qualifié complet à utiliser sur les cibles au moment de l'exécution du travail. Spécifiez le chemin d'accès complet du magasin de clés. String (chaîne)
passphrase Indique la phrase passe qualifiée complète à utiliser sur les cibles au moment de l'exécution du travail. Spécifiez une phrase passe si le magasin de clés en exige une. String (chaîne)
useSudo Indique qu'il convient de permettre à autre utilisateur d'exécuter des commandes sur l'hôte cible. Par défaut, sudo n'est pas utilisé. L'option sudo est prise en charge uniquement sur les systèmes d'exploitation AIX, HP-UX, Linux et Solaris.

Activez useSudo pour changer d'utilisateur avant l'exécution d'un travail et indiquez ensuite le nom d'utilisateur et le mot de passe de l'autre utilisateur. sudo signifie "exécuter en se substituant à l'utilisateur". S'il n'est pas nécessaire d'indiquer de mot de passe pour l'hôte cible, laissez ces zones vides. Les combinaisons de sélection suivantes sont valides :

  • Activez useSudo et ne spécifiez pas de valeurs pour sudoUsername et sudoPassword. Dans ce cas, l'utilisateur par défaut défini dans le fichier /etc/sudoers et le mot de passe de l'utilisateur s'étant connecté sont utilisés.
  • Activez useSudo et spécifiez une valeur pour sudoUsername, mais pas pour sudoPassword. Dans ce cas, l'utilisateur spécifié ainsi que le mot de passe de l'utilisateur s'étant connecté sont utilisés.
  • Activez useSudo et spécifiez une valeur pour sudoUsername et pour sudoPassword. Dans ce cas, l'utilisateur spécifié et le mot de passe sudo sont utilisés.
Booléenne
sudoUsername Indique un nom d'utilisateur pour l'autre utilisateur. Pour savoir quand spécifier une valeur pour sudoUsername, voir la description de useSudo. String (chaîne)
sudoPassword Indique un mot de passe pour l'autre utilisateur. Pour savoir quand spécifier une valeur pour sudoPassword, voir la description de useSudo. String (chaîne)
description Indique la description du travail. String (chaîne)
activationDateTime Indique la date et l'heure auxquelles activer le travail, dans le format suivant : 2006-05-03T10:30:45-0000. La section -0000 de la valeur du paramètre activationDateTime représente le format RFC 822. La lettre de raccourci Z permet d'indiquer le temps moyen de Greenwich (GMT). Par exemple : 2006-05-03T10:30:45Z. Par défaut, le système utilise le fuseau horaire du gestionnaire de travaux. String (chaîne)
expirationDateTime Indique la date d'expiration du travail, dans le format 2006-05-03T10:30:45-0000. La section -0000 de la valeur du paramètre activationDateTime représente le format RFC 822. La lettre de raccourci Z permet d'indiquer le temps moyen de Greenwich (GMT). Par exemple : 2006-05-03T10:30:45Z. Par défaut, le système utilise le fuseau horaire du gestionnaire de travaux. String (chaîne)
executionWindow Indique l'intervalle récurrent du travail, le cas échéant. String (chaîne)
executionWindowUnit Indique l'unité de mesure de l'intervalle récurrent. Les valeurs valides sont HOURS, DAYS, WEEKS, MONTHS, CONNECT et ONCE. La valeur par défaut est HOURS. String (chaîne)
email Indique l'adresse électronique à laquelle le système envoie les notifications de travaux. String (chaîne)

Entrez les commandes wsadmin à partir du répertoire bin du profil de gestionnaire de travaux. Cette rubrique présente des exemples en langage de script Jython.

Exemple de syntaxe :

AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
 -jobParams [applicationName MyApp] -email admin@company.com ')

Exemple d'utilisation en mode interactif :

AdminTask.submitJob('-interactive')

Exemple d'utilisation en résultat de travail :

L'exécution d'une commande submitJob renvoie un jeton de travail tel que 124231200726586682. Pour plus d'informations sur le jeton de travail, exécutez une commande getJobTargetStatus :

AdminTask.getJobTargetStatus('[-jobToken 124231200726586682]')
Un travail administratif consigne les résultats de la manière suivante :
  • NOT_ATTEMPTED indique que le système n'a pas tenté d'exécuter le travail.
  • DISTRIBUTED indique que l'agent de la cible a reçu le travail, mais que le travail ne s'est pas terminé.
  • La valeur ASYNC_IN_PROGRESS indique que la cible exécute le travail en même temps que d'autres travaux.
  • FAILED indique que le travail a échoué.
  • La valeur REJECTED indique que la cible a rejeté le travail parce que, par exemple, la cible ne prend pas en charge ce type de travail.
  • SUCCEEDED indique que le travail a abouti.
  • PARTIALLY_SUCCEEDED indique que le travail a partiellement abouti. Un succès partiel peut se produire, par exemple, lorsqu'une cible représente plusieurs serveurs et que seuls certains de ces serveurs terminent le travail correctement.

Les résultats de statut de travail évoluent en général de DISTRIBUTED en ASYNC_IN_PROGRESS en SUCCEEDED. Vous pouvez être amené à exécuter une commande getJobTargetStatus plusieurs fois, jusqu'à ce que le résultat soit FAILED, REJECTED ou SUCCEEDED.

Par défaut, un travail reste actif pendant une journée (24 heures).

Soumission d'un travail de collecte d'inventaire

Le travail d'administration d'inventaire collecte des données d'inventaire sur les cibles. Ces données d'inventaire comprennent les types de travaux disponibles et le statut des ressource gérées, telles que les applications et les serveurs, de chaque cible.

Lorsque la cible est un hôte, les données d'inventaire incluent des informations sur l'hôte, telles que le nom du système d'exploitation et sa version, Installation Manager, le groupe de packages, les packages, les profils et d'autres ressources.

Pour que le travail d'inventaire trouve les ressources du Liberty, les variables WLP_WORKING_DIR, WLP_SHARED_DIR ou WLP_ADDITIONAL_DIRS doivent être définies. Voir Définition des variables des serveurs Liberty.

[IBM i]Remarque : Le gestionnaire d'installation centralisé ne parvient pas à reconnaître les profils Application Client et Plugin sur les plateformes IBM i.

Paramètres de travail

Aucun.

Cas d'utilisation

AdminTask.submitJob('-jobType inventory -targetList [Target1 Target2 Target3]')

Soumission d'un travail de collecte de l'état des cibles

Le travail d'administration de statut collecte des données de statut sur les cibles. Utilisez ce travail plutôt que le travail d'inventaire si vous voulez uniquement régénérer les données des ressource gérées, telles que les applications et les serveurs, de chaque cible.

Lorsqu'un serveur Liberty est la cible, ce travail met à jour uniquement l'état serveur des ressources de serveur Liberty. Il ne découvre pas de nouvelles ressources serveur ni ne supprime aucune d'elles. Pour découvrir de nouvelles ressources serveur, vous devez soumettre à la place un travail d'inventaire.

Paramètres de travail

Aucun.

Cas d'utilisation

AdminTask.submitJob('-jobType status -targetList [Target1 Target2 Target3]')

Soumission de travaux de gestion de fichiers

Vous pouvez utiliser les travaux de gestion de fichiers pour collecter, distribuer et supprimer les fichiers. Par exemple, vous pouvez soumettre le travail collectFile pour transférer un fichier au gestionnaire des travaux. Le travail distributeFile transfère un fichier du gestionnaire de travaux aux cibles pour le travail. Le travail removeFile supprime un fichier précédemment distribué sur la cible :

Vous pouvez utiliser des travaux de gestion de fichiers avec des cibles hôte distantes. Utilisez distributeFile pour envoyer un fichier à des hôtes distants, collectFile pour collecter des fichiers d'hôtes distants et removeFile pour supprimer des fichiers d'hôtes distants.

collectFile

Le travail administratif collectFile collecte un fichier cible et le transfère au gestionnaire de travaux. Si l'emplacement source est un répertoire, et non un fichier, le travail compresse de manière récursive le contenu du répertoire et transfère le fichier zip compressé ainsi généré.

Paramètres de travail

Tableau 3. Description des paramètres de collectFile. Exécutez une commande submitJob collectFile avec au moins des paramètres de source et de destination.
Paramètre Description Type
source Indique l'emplacement source du fichier ou du répertoire qui vous intéresse. Le système détermine si l'emplacement du fichier est relatif au répertoire racine_profil de la cible. String (chaîne)
destination Indique l'emplacement de destination. La valeur est relative à un répertoire intitulé profile_root/config/temp/JobManagerName/jobToken/targetName. String (chaîne)
distributionProvider Permet également d'indiquer le nom du fournisseur de distribution. String (chaîne)

Cas d'utilisation

L'exemple suivant exécute le travail collectFile :
AdminTask.submitJob('[-jobType collectFile -targetList [Target1]
 -jobParams [[source logs][destination targetLocationOfFile]]]')

distributeFile

Le travail administratif distributeFile transfère un fichier du gestionnaire de travaux aux cibles pour le travail. Le système stocke le fichier sur la cible dans l'attente des travaux qui l'utiliseront. Les travaux d'administration installApplication et updateApplication référencent la destination que vous fournissez pour le travail distributeFile en tant qu'emplacement du contenu de l'application de la cible. D'autre part, vous pouvez utiliser ce travail pour distribuer des fichiers script et des fichiers de configuration basée sur des propriétés.

Le fichier à distribuer à partir du gestionnaire de travaux doit se trouver initialement dans le répertoire /config/temp/JobManager du profil du gestionnaire de travaux. Ensuite, le système déplace le fichier dans le répertoire downloadedContent du profil du gestionnaire de déploiement ou de l'agent d'administration. Le paramètre de destination est relatif au répertoire downloadedContent ; il peut s'agir d'un nom de fichier ou d'un nom de chemin relatif. Vous pouvez utiliser un chemin relatif pour créer des sous-répertoires distincts sous le répertoire downloadedContent pour organiser les fichiers téléchargés.

Eviter les incidents Eviter les incidents: Pour soumettre le travail distributeFile avant d'autres travaux, vous devez d'abord placer le fichier à distribuer dans le répertoire JobManager. Pour créer le répertoire JobManager manuellement, procédez comme suit :
  1. A l'aide d'un ID administrateur doté des droits *ALLOBJ et *SECADM, utilisez l'invite de commande pour accéder au répertoire profile_root/JobManagerName/config/temp.
  2. Entrez la commande suivante : mkdir JobManager
  3. Entrez la commande suivante : chown -R QEJBSVR JobManager
  4. Copiez le fichier à distribuer dans le répertoire JobManager.
  5. Dans la console d'administration, soumettez le travail distributeFile.
gotcha

Paramètres de travail

Tableau 4. Description des paramètres de distributeFile. Exécutez une commande submitJob distributeFile avec au moins des paramètres de source et de destination.
Paramètre Description Type
source Indique l'emplacement source du contenu à distribuer. String (chaîne)
destination Indique l'emplacement de destination situé sur la cible dans lequel le système sauvegarde le contenu. String (chaîne)
distributionProvider Permet également d'indiquer le nom du fournisseur de distribution. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType distributeFile -targetList [Target1 Target2 Target3]
-jobParams [[source file:/MyApp.ear][destination MyApp.ear]]')

removeFile

Le travail d'administration removeFile supprime un fichier qui a été distribué à la cible. Le paramètre de l'emplacement est relatif au répertoire downloadedContent. Il doit désigner l'emplacement qui a été spécifié pour le paramètre de destination quand le fichier a été distribué.

Paramètres de travail

Tableau 5. Description des paramètres de removeFile. Exécutez une commande submitJob removeFile avec au moins un paramètre d'emplacement.
Paramètre Description Type
location Indique l'emplacement du fichier à supprimer de la cible. Utilisez la valeur de destination à partir du travail distributeFile. String (chaîne)
distributionProvider Permet également d'indiquer le nom du fournisseur de distribution. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType removeFile -targetList [Target1 Target2 Target3] 
 -jobParams [location MyApp.ear]')

Soumission d'un travail qui exécute un script wsadmin

Vous pouvez soumettre un travail pour exécuter un script wsadmin sur une cible gérée du gestionnaire de travaux. La cible gérée peut être un gestionnaire de déploiement ou un serveur d'applications non fédéré. Avant d'exécuter un script wsadmin sur une cible gérée, transférez ce script et tous les profils de script associés, du gestionnaire de travaux vers la cible gérée, à l'aide d'un travail distributeFile. N'oubliez pas la valeur de destination qui est spécifiée au moment de la distribution du fichier. Puis, utilisez le travail suivant pour exécuter le script wsadmin. Utilisez la valeur de destination pour le paramètre scriptFileLocation. Si vous avez indiqué une valeur de destination de profil, vous pouvez utiliser la valeur de destination de profil pour le paramètre profileLocation.

Le statut renvoyé par un travail runWsadminScript dépend du code retour du script. Si le code retour est égal à zéro, le travail est considéré comme accompli. Si le code retour est différent de zéro, le travail est considéré comme inachevé.

Paramètres de travail

Tableau 6. Description des paramètres du travail. Exécutez une commande submitJob runWsadminScript avec au moins un paramètre scriptFileLocation.
Paramètre Description Type
scriptFileLocation Indique l'emplacement du fichier script à exécuter sur la cible gérée. L'emplacement est la destination qui a été indiquée quand le fichier a été distribué à la cible. String (chaîne)
profileLocation Indique éventuellement l'emplacement du script de profil à exécuter avec le script wsadmin. Ce paramètre correspond au paramètre -profile de wsadmin. L'emplacement est la destination qui est indiquée quand le fichier est distribué à la cible. String (chaîne)
scriptParameters Indique éventuellement les paramètres à associer au script wsadmin. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('[-jobType runWsadminScript -targetList [DmgrManagedNodeName]
 -jobParams [ [scriptFileLocation myScript.py] [profileLocation scriptProfile.py]
 [scriptParameters [param1 param2]] ]]')

Pour les scripts wsadmin traitant plusieurs paires mot de passe/valeur pour les paramètres de commande, comme argv[], utilisez scriptParameters pour indiquer les mots de passe et les valeurs :

AdminTask.submitJob('[-jobType runWsadminScript -targetList [myNode01]
 -jobParams [ [scriptFileLocation myScript.py] [scriptParameters [-keyword1 value1 -keyword2 value2]] ]]')

Soumission de travaux de gestion d'applications

Les travaux de gestion d'application permettent de distribuer, d'installer, de mettre à jour, de supprimer et de contrôler des applications sur le serveur d'applications. Par exemple, vous pouvez soumettre les travaux distributeFile, installApplication et startApplication pour déployer des applications dans votre environnement. Pour supprimer des applications de votre environnement, soumettez les travaux stopApplication, uninstallApplication et removeFile. Les travaux de gestion d'application suivants permettent d'administrer les configurations d'application :

installApplication

Le travail administratif installApplication installe et lie une application ou un élément d'application dans l'environnement cible. Vous devez exécuter le travail distributeFile et distribuer le contenu pouvant être déployé sur les cibles avant de pouvoir installer l'application.

Le travail installApplication ne permet pas d'obtenir des informations sur les liaisons ou d'autres attributs associés au déploiement. Si vous souhaitez obtenir ce type d'informations, utilisez les travaux runWsadminScript ou configureProperties.

Important : Pour pouvoir soumettre ce travail, le répertoire profile_root/downloadedContent doit exister pour le gestionnaire de déploiement ou l'agent d'administration. A défaut, vous devez le créer.

Paramètres de travail

Tableau 7. Description des paramètres de installApplication. Exécutez une commande submitJob installApplication avec au moins un paramètre applicationName.
Paramètre Description Type
applicationName Indique le nom d'application permettant d'identifier l'application à installer. Souvent, il s'agit du nom de fichier de base de l'application d'entreprise (par exemple, MyApp pour MyApp.ear), mais vous pouvez choisir le nom de votre choix. String (chaîne)
appLocation Facultatif. Indique l'emplacement du fichier d'application à installer. Par défaut, le travail installApplication ajoute l'extension de format de fichier .ear au nom de l'application et recherche l'application à l'emplacement de destination par défaut.

Par conséquent, si vous indiquez MyApp pour applicationName, par défaut la valeur appLocation est downloadedContent/MyApp.ear de la cible gérée. Si vous indiquez une valeur pour appLocation, utilisez la valeur de destination indiquée lors de la distribution de l'application.

String (chaîne)
nomServeur Facultatif. Indique le nom du serveur sur lequel le système installe l'application. String (chaîne)
nomNoeud Facultatif. Indique le noeud qui identifie le serveur dans une cellule de WebSphere Application Server, Network Deployment. String (chaîne)
clusterName Facultatif. Indique le nom du cluster dans lequel l'application est installée. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
 -jobParams [[applicationName MyApp]]')

ou :

AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
 -jobParams [[applicationName MyApp][appLocation MyApp.ear][clusterName TestCluster]]')

startApplication

Le travail administratif startApplication démarre une application précédemment installée sur la cible. Le système modifie le statut de l'application sur active ou RUNNING, charge l'application au moment de l'exécution, puis l'ouvre pour recevoir les demandes des clients. Il s'agit de la dernière étape du processus de déploiement d'application.

Paramètres de travail

Tableau 8. Description des paramètres de startApplication. Exécutez une commande submitJob startApplication avec un paramètre applicationName.
Paramètre Description Type
applicationName Indique le nom de l'application à démarrer. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType startApplication -targetList [Target1 Target2 Target3] 
 -jobParams [applicationName MyApp]')

stopApplication

Le travail administratif stopApplication arrête l'application sur la cible. Le système fait passer l'application à l'état d'arrêt et ne reçoit plus les demandes des clients. Vous pouvez utiliser le travail startApplication pour redémarrer l'application. Il s'agit de la première étape du processus de suppression d'application.

Tableau 9. Description des paramètres de stopApplication. Exécutez une commande submitJob stopApplication avec un paramètre applicationName.
Paramètre Description Type
applicationName Indique le nom de l'application à arrêter. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType stopApplication -targetList [Target1 Target2 Target3] 
 -jobParams [applicationName MyApp]')

updateApplication

Le travail administratif updateApplication met à jour une application ou un élément d'application dans l'environnement cible. Vous devez exécuter le travail distributeFile et distribuer le contenu pouvant être déployé sur les cibles avant de pouvoir mettre l'application à jour.

Important : Pour pouvoir soumettre ce travail, le répertoire profile_root/downloadedContent doit exister pour le gestionnaire de déploiement ou l'agent d'administration. A défaut, vous devez le créer.

Paramètres de travail

Tableau 10. Description des paramètres de updateApplication. Exécutez une commande submitJob updateApplication avec au moins un paramètre applicationName.
Paramètre Description Type
applicationName Indique le nom d'application permettant d'identifier l'application à mettre à jour. Souvent, il s'agit du nom de fichier de base de l'application d'entreprise (par exemple, MyApp pour MyApp.ear), mais vous pouvez choisir le nom de votre choix. String (chaîne)
appLocation Facultatif. Indique l'emplacement du fichier d'application à installer. Par défaut, le travail updateApplication ajoute l'extension de format de fichier .ear au nom de l'application et recherche l'application à l'emplacement de destination par défaut.

Par conséquent, si vous indiquez MyApp pour applicationName, par défaut la valeur appLocation est downloadedContent/MyApp.ear de la cible gérée. Si vous indiquez une valeur pour appLocation, utilisez la valeur de destination indiquée lors de la distribution de l'application.

String (chaîne)
nomServeur Facultatif. Indique le nom du serveur sur lequel le système met à jour l'application. String (chaîne)
nomNoeud Facultatif. Indique le noeud qui identifie le serveur dans une cellule de WebSphere Application Server, Network Deployment. String (chaîne)
clusterName Facultatif. Indique le nom du cluster dans lequel l'application est mise à jour. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType updateApplication -targetList [Target1 Target2 Target3] 
 -jobParams [[applicationName MyApp]]')

ou :

AdminTask.submitJob('-jobType updateApplication -targetList [Target1 Target2 Target3] 
 -jobParams [[applicationName MyApp][appLocation MyApp.ear][clusterName TestCluster]]')

uninstallApplication

Le travail d'administration uninstallApplication désinstalle l'application des cibles.

Paramètres de travail

Tableau 11. Description des paramètres de uninstallApplication. Exécutez une commande submitJob uninstallApplication avec un paramètre applicationName.
Paramètre Description Type
applicationName Indique le nom de l'application à supprimer. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType uninstallApplication -targetList [Target1 Target2 Target3]
 -jobParams [applicationName MyApp]')

Soumission de travaux de gestion de serveurs

L'administrateur système peut utiliser les travaux de configuration du serveur d'applications pour modifier la configuration de serveurs d'applications locaux et distants.

createApplicationServer

Le travail administratif createApplicationServer crée un serveur d'applications dans l'environnement cible.

Paramètres de travail

Tableau 12. Description des paramètres de createApplicationServer. Exécutez une commande submitJob createApplicationServer avec au moins les paramètres serverName et nodeName.
Paramètre Description Type
nomServeur Indique le nom du serveur d'applications à créer. Le nom du serveur doit être unique sur le noeud cible. String (chaîne)
nomNoeud Quand la cible est une cellule WebSphere Application Server, Network Deployment, vous devez indiquer sur quel noeud de la cellule le serveur doit être créé. Il est inutile d'indiquer le nom de noeud dans le cas d'un noeud de base. String (chaîne)
templateName Facultatif. Indique le modèle de serveur. String (chaîne)
templateLocation Facultatif. Indique l'emplacement de stockage du modèle. Utilisez l'emplacement par défaut défini par le système à moins que vous ne deviez indiquer un emplacement de modèle. String (chaîne)
genUniquePorts Facultatif. Indique la génération de ports http uniques pour un serveur. Par défaut, le produit génère des numéros de port uniques. Booléenne
[z/OS]specificShortName [z/OS]Pour les environnements z/OS uniquement, indique facultativement le nom abrégé spécifique du serveur. Chaque serveur doit avoir un nom abrégé spécifique unique. Par défaut, le produit affecte un nom abrégé spécifique unique. La valeur ne doit pas comporter plus de 8 caractères, tous écrits en majuscules. [z/OS]String (chaîne)
[z/OS]genericShortName [z/OS]Pour les environnements z/OS uniquement, indique facultativement le nom abrégé générique du serveur. Tous les membres d'un cluster partagent le même nom abrégé générique. Les serveurs individuels doivent avoir des noms abrégés génériques uniques. Par défaut, le produit affecte un nom abrégé générique unique. La valeur ne doit pas comporter plus de 8 caractères, tous écrits en majuscules. [z/OS]String (chaîne)
[z/OS]bitMode [z/OS]Pour les environnements z/OS uniquement, indique facultativement le mode d'octets du serveur. Les valeurs autorisées sont 31 et 64 octets. Si aucune valeur n'est fournie, le produit affecte le mode d'octets par défaut. [z/OS]Entierr

Cas d'utilisation

AdminTask.submitJob('-jobType createApplicationServer -targetList
 [Node1 Node2 Node3] -jobParams [serverName AppServer01]')

deleteApplicationServer

Le travail administratif deleteApplicationServer supprime un serveur d'applications de l'environnement cible.

Paramètres de travail

Tableau 13. Description des paramètres de deleteApplicationServer. Exécutez une commande submitJob deleteApplicationServer avec les paramètres serverName et nodeName.
Paramètre Description Type
nomServeur Indique le nom du serveur d'applications à supprimer. String (chaîne)
nomNoeud Quand la cible est une cellule WebSphere Application Server, Network Deployment, vous devez indiquer sur quel noeud de la cellule le serveur doit être supprimé. Il est inutile d'indiquer le nom de noeud dans le cas d'un noeud de base. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType deleteApplicationServer -targetList 
 [Node1 Node2 Node3] -jobParams [serverName AppServer01]')

createProxyServer

Le travail administratif createProxyServer crée un serveur proxy dans une cellule d'un gestionnaire de déploiement qui est une cible gérée d'un gestionnaire de travaux.

Paramètres de travail

Tableau 14. Description des paramètres de createProxyServer. Exécutez une commande submitJob createProxyServer avec les paramètres serverName et nodeName.
Paramètre Description Type
nomServeur Indique le nom du serveur proxy à créer. String (chaîne)
nomNoeud Indique le noeud dans lequel résidera le serveur proxy. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('[-jobType createProxyServer -jobParams [[serverName 
 testServer1][nodeName testNode1]] ]')

deleteProxyServer

Le travail administratif deleteProxyServer supprime un serveur proxy d'une cellule de gestionnaire de déploiement qui est une cible gérée d'un gestionnaire de travaux.

Paramètres de travail

Tableau 15. Description des paramètres de deleteProxyServer. Exécutez une commande submitJob deleteProxyServer avec les paramètres serverName et nodeName.
Paramètre Description Type
nomServeur Indique le nom du serveur proxy à supprimer. String (chaîne)
nomNoeud Indique le noeud sur lequel se trouve le serveur proxy. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('[-jobType deleteProxyServer -jobParams [[serverName 
 testServer1][nodeName testNode1]] ]')

createCluster

Le travail administratif createCluster crée un cluster. Pour créer un cluster dans une cellule, vous devez enregistrer le gestionnaire de déploiement de la cellule avec un gestionnaire de travaux.

Paramètres de travail

Tableau 16. Description des paramètres de createCluster. Exécutez une commande submitJob createCluster avec au moins le paramètre clusterConfig.clusterName.
Paramètre Description Type
clusterConfig.clusterName Indique le nom du cluster de serveurs. String (chaîne)
clusterConfig.preferLocal Facultatif. Active l'optimisation de l'acheminement dans la portée du noeud pour le cluster. String (chaîne)
clusterConfig.clusterType Facultatif. Indique le type de cluster de serveurs. String (chaîne)
[z/OS]clusterConfig.shortName [z/OS]Facultatif. Indique le nom abrégé du cluster de serveurs. [z/OS]String (chaîne)
replicationDomain.createDomain Facultatif. Crée un domaine de réplication en lui attribuant un nom correspondant à celui du nouveau cluster. String (chaîne)
convertServer.serverNode Facultatif. Indique le nom de noeud du serveur existant qui doit être converti en premier membre du cluster. String (chaîne)
convertServer.serverName Facultatif. Indique le nom du serveur existant qui doit être converti en premier membre du cluster. String (chaîne)
convertServer.memberWeight Facultatif. Indique le poids du nouveau membre du cluster. String (chaîne)
convertServer.nodeGroup Facultativement, indique le nom du groupe de noeuds auquel doivent appartenir tous les noeuds associés aux membres du cluster. String (chaîne)
convertServer.replicatorEntry Facultativement, indique qu'une entrée de réplicateur est créée pour ce membre, dans le domaine de réplication du cluster. L'entrée de réplicateur est utilisée pour la réplication des données de session HTTP. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName] 
 -jobParams [clusterConfig.clusterName newCluster1]]')

Si vous spécifiez des paramètres supplémentaires dans la commande createCluster, utilisez le format [stepName.parameterName parameterValue] dans la liste de paramètres -jobParams.

AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName] 
 -jobParams [ [clusterConfig.clusterName newCluster1] [clusterConfig.clusterType PROXY_SERVER] ]]')

deleteCluster

Le travail administratif deleteCluster supprime un cluster. Pour supprimer un cluster dans une cellule, vous devez enregistrer le gestionnaire de déploiement de la cellule avec un gestionnaire de travaux.

Paramètres de travail

Tableau 17. Description des paramètres de deleteCluster. Exécutez une commande submitJob deleteCluster avec au moins un paramètre clusterName.
Paramètre Description Type
clusterName Indique le nom du cluster de serveurs à supprimer. String (chaîne)
replicationDomain.deleteRepDomain Facultatif. Indique que le domaine de réplication du cluster doit être supprimé en même temps que le cluster. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('[-jobType deleteCluster -targetList [DmgrManagedNodeName] 
 -jobParams [ [clusterName newCluster1] [replicationDomain.deleteRepDomain true] ]]')

createClusterMember

Le travail administratif createClusterMember crée un membre de cluster dans un cluster faisant partie d'une cellule. Vous devez enregistrer le gestionnaire de déploiement de la cellule avec un gestionnaire de travaux.

Paramètres de travail

Tableau 18. Description des paramètres de createClusterMember. Exécutez une commande submitJob createClusterMember avec au moins les paramètres clusterName, memberConfig.memberNode et memberConfig.memberName.
Paramètre Description Type
clusterName Spécifie le nom du cluster de serveurs auquel appartient le nouveau membre. String (chaîne)
memberConfig.memberNode Indique le nom du noeud où doit résider le nouveau membre de cluster. String (chaîne)
memberConfig.memberName Indique le nom du nouveau membre du cluster. String (chaîne)
memberConfig.memberWeight Facultativement, indique le poids du nouveau membre de cluster. String (chaîne)
memberConfig.memberUUID Facultativement, indique l'identificateur unique universel (UUID) du nouveau membre de cluster. String (chaîne)
memberConfig.genUniquePorts Facultativement, indique la génération de numéros de port uniques pour les transports HTTP définis dans le serveur. String (chaîne)
memberConfig.replicatorEntry Facultativement, indique qu'une entrée de réplicateur est créée pour ce membre, dans le domaine de réplication du cluster. L'entrée de réplicateur est utilisée pour la réplication des données de session HTTP. String (chaîne)
[z/OS]memberConfig.specificShortName [z/OS]Facultativement, indique le nom abrégé du membre de cluster. [z/OS]String (chaîne)
firstMember.templateName Facultativement, indique le nom du modèle de serveur d'applications à utiliser pour les nouveaux membres du cluster. String (chaîne)
firstMember.templateServerNode Facultativement, indique le nom de noeud associé à un serveur existant qui sera utilisé comme modèle pour les nouveaux membres du cluster. String (chaîne)
firstMember.templateServerName Facultativement, indique le nom du serveur à utiliser comme modèle pour les nouveaux membres du cluster. String (chaîne)
firstMember.nodeGroup Facultativement, indique le nom du groupe de noeuds auquel doivent appartenir tous les noeuds associés aux membres du cluster. String (chaîne)
firstMember.coreGroup Facultativement, indique le nom du groupe central auquel doivent appartenir tous les membres du cluster. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('[-jobType createClusterMember
 -targetList [DmgrManagedNodeName]
 -jobParams [ [memberConfig.memberName newCluster1mem1]
   [memberConfig.memberNode FederatedNode] [clusterName newCluster1] ]]')

deleteClusterMember

Le travail administratif deleteClusterMember supprime un membre de cluster d'un cluster faisant partie d'une cellule. Vous devez enregistrer le gestionnaire de déploiement de la cellule avec un gestionnaire de travaux. Le cluster doit comporter au moins un membre sur un noeud fédéré.

Paramètres de travail

Tableau 19. Description des paramètres de deleteClusterMember. Exécutez une commande submitJob deleteClusterMember avec au moins les paramètres clusterName, memberNode et memberName.
Paramètre Description Type
clusterName Spécifie le nom d'un cluster de serveurs auquel appartient le membre de cluster à supprimer. String (chaîne)
memberNode Indique le nom du noeud où se trouve le membre de cluster. String (chaîne)
memberName Indique le nom de serveur du membre de cluster à supprimer. String (chaîne)
replicatorEntry.deleteEntry Facultativement, indique la suppression de l'entrée de réplicateur ayant le nom de serveur de ce membre de cluster, du domaine de réplication du cluster. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('[-jobType deleteClusterMember -targetList 
 [DmgrManagedNodeName] -jobParams [ [memberName newCluster1mem1]
 [memberNode FederatedNode] [clusterName newCluster1] ]]')

configureProperties

Le travail administratif configureProperties applique un fichier de propriétés à la configuration du serveur d'applications. Ce travail utilise la commande applyConfigProperties fournie par le groupe de commandes PropertiesBasedConfiguration pour l'objet AdminTask, afin de configurer les propriétés de la cible.

Paramètres de travail

Tableau 20. Description des paramètres de configureProperties. Exécutez une commande submitJob configureProperties avec au moins le paramètre propertiesFileLocation.
Paramètre Description Type
propertiesFileLocation Indique l'emplacement du fichier de propriétés à appliquer au serveur d'applications cible.

Le chemin indiqué pour ce paramètre est le chemin relatif du répertoire profile_root/downloadedContent pour le gestionnaire de déploiement. S'il n'existe pas, vous devez créer ce répertoire avant de démarrer le travail d'administration configureProperties.

String (chaîne)
variableMapLocation Facultatif. Indique l'emplacement d'un fichier de mappe de variables à inclure avec le fichier de propriétés. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType configureProperties -targetList 
 [Target1 Target2 Target3] -jobParams [propertiesFileLocation myProperties.props]')

Soumission de travaux de gestion du contexte d'exécution du serveur

L'administrateur système peut utiliser les travaux de contrôle d'exécution de serveur d'applications pour démarrer et arrêter des serveurs d'applications.

startServer

Le travail administratif startServer lance et initialise le serveur d'applications qui vous intéresse.

Paramètres de travail

Tableau 21. Description des paramètres de startServer. Exécutez une commande submitJob startServer avec au moins le paramètre serverName.
Paramètre Description Type
nomServeur Indique le nom du serveur d'applications à démarrer. String (chaîne)
nomNoeud Si la cible du travail est un noeud de gestionnaire de déploiement, indiquez le nom du noeud fédéré qui héberge le serveur. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType startServer -targetList [Target1 Target2 Target3] 
 -jobParams [serverName AppServer01]')

stopServer

Le travail administratif stopServer arrête le serveur d'applications qui vous intéresse. Utilisez le travail startServer pour redémarrer le serveur d'applications.

Paramètres de travail

Tableau 22. Description des paramètres de stopServer. Exécutez une commande submitJob stopServer avec au moins le paramètre serverName.
Paramètre Description Type
nomServeur Indique le serveur d'applications à arrêter. String (chaîne)
nomNoeud Si la cible du travail est un noeud de gestionnaire de déploiement, indiquez le nom du noeud fédéré qui héberge le serveur. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType stopServer -targetList [Target1 Target2 Target3] 
 -jobParams [serverName AppServer01]')

startCluster

Le travail administratif startCluster démarre un cluster. Pour démarrer un cluster dans une cellule, vous devez enregistrer le gestionnaire de déploiement de la cellule avec un gestionnaire de travaux.

Paramètres de travail

Tableau 23. Description des paramètres de startCluster. Exécutez une commande submitJob startCluster avec au moins le paramètre clusterName.
Paramètre Description Type
clusterName Indique le nom du cluster à démarrer. String (chaîne)
rippleStart Facultativement, indique si le cluster est démarré dans le cadre d'une procédure Arrêt/Redémarrage. La valeur par défaut est false. String (chaîne)

Cas d'utilisation

L'exemple suivant démarre un cluster :

AdminTask.submitJob('[-jobType startCluster -targetList [DmgrManagedNodeName] 
 -jobParams [clusterName newCluster1]]')

L'exemple suivant arrête et redémarre un cluster.

AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName] 
 -jobParams [ [clusterName newCluster1] [rippleStart true] ]]')

stopCluster

Le travail administratif stopCluster arrête un cluster. Pour arrêter un cluster dans une cellule, vous devez enregistrer le gestionnaire de déploiement de la cellule avec un gestionnaire de travaux.

Paramètres de travail

Tableau 24. Description des paramètres de stopCluster. Exécutez une commande submitJob stopCluster avec le paramètre clusterName.
Paramètre Description Type
clusterName Indique le nom du cluster à arrêter. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('[-jobType stopCluster -targetList [DmgrManagedNodeName] 
 -jobParams [clusterName newCluster1]]')

Soumission d'un travail d'exécution de commandes

L'administrateur système peut utiliser le travail runCommand du gestionnaire de travaux pour exécuter une commande sur un hôte distant. La commande peut être un utilitaire de ligne de commande, tel que startServer, d'un répertoire racine_serveur_app/bin, une commande wsadmin ou une commande du système d'exploitation.

Paramètres de travail

Tableau 25. Description des paramètres de runCommand. Exécutez une commande submitJob runCommand avec au moins le paramètre command.
Paramètre Description Type
command Indique le nom de la commande à exécuter. String (chaîne)
workingDir Spécifie l'emplacement du fichier de commandes sur l'hôte distant. La valeur par défaut est le répertoire racine_serveur_app de l'hôte distant. String (chaîne)

Cas d'utilisation

[Linux]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password ******* -jobParams [[command ./versionInfo.sh]]')
[Windows]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password ******* -jobParams [[command versionInfo.bat]]')
[Linux]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password *******
 -jobParams [[command "./java -version"][workingDir /opt/IBM/WebSphere/AppServer/java/bin]]')
[Windows]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password *******
 -jobParams [[command "java -version"][workingDir C:/WAS_v800/IBM/WebSphere/AppServer/java/bin]]')

Soumission d'un travail de gestion des profils

L'administrateur système peut utiliser le travail manageprofiles du gestionnaire de travaux pour créer, étendre ou supprimer un profil WebSphere Application Server. Ce travail exécute la commande d'administration manageprofiles.

Paramètres de travail

Tableau 26. Description des paramètres de manageprofiles. Exécutez une commande submitJob manageprofiles avec au moins les paramètres wasHome et responseFile.
Paramètre Description Type
wasHome Indique l'emplacement de l'installation de WebSphere Application Server. Il s'agit du chemin racine_serveur_app sur l'hôte distant. String (chaîne)
responseFile Indique l'emplacement du fichier de réponses manageprofiles qui réside dans le gestionnaire de travaux. String (chaîne)
nom_utilisateur Indique le nom d'utilisateur à employer sur les cibles au moment de l'exécution du travail. Si vous n'indiquez ni nom d'utilisateur ni mot de passe et que la sécurité est activée, l'ID utilisateur est utilisé dans le gestionnaire de travaux. String (chaîne)
mot_de_passe Indique le mot de passe pour le nom d'utilisateur à employer sur les cibles au moment de l'exécution du travail. Si vous n'indiquez ni nom d'utilisateur ni mot de passe et que la sécurité est activée, l'ID utilisateur est utilisé dans le gestionnaire de travaux. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType manageprofiles -targetList Target1 -username user1 -password *******
 -jobParams [[wasHome /WAS80GA][responseFile /temp/mp1.txt]]')

Soumission de travaux Installation Manager

L'administrateur système peut utiliser des travaux Installation Manager pour installer des instances Installation Manager, mettre à jour Installation Manager avec un référentiel, gérer des offres Installation Manager et installer des produits WebSphere Application Server.

Configurations prises en charge Configurations prises en charge: IBM Installation Manager version 1.4.3 ou ultérieure est nécessaire.sptcfg

installIM

Le travail administratif installIM installe une nouvelle instance d'Installation Manager en envoyant un kit d'installation du gestionnaire de travaux vers les hôtes.

Paramètres de travail

Tableau 27. Description des paramètres de installIM. Exécutez une commande submitJob installIM avec au moins le paramètre kitPath.
Paramètre Description Type
kitPath Indique l'emplacement du kit Installation Manager. Si vous n'indiquez pas ce paramètre, le travail trouve le kit d'installation IM le plus récent dans l'emplacement par défaut. String (chaîne)
dataPath Indique l'emplacement des données Installation Manager. String (chaîne)
installPath Spécifie l'emplacement pour installer Installation Manager sur l'hôte cible. Indiquez ce paramètre uniquement si plusieurs emplacements d'installation existent dans la cellule active sur le même hôte. String (chaîne)
skipPrereqCheck Facultatif. Lorsque la valeur est true, indique qu'aucune vérification des éléments prérequis n'est exécutée lors de l'installation d'Installation Manager et que la vérification de l'espace disque d'Installation Manager est désactivée.

La valeur par défaut est false. La vérification des éléments prérequis et de l'espace disque est effectuée sauf si la valeur true est spécifiée.

Booléenne
acceptLicense Doit avoir la valeur true. Si vous n'indiquez pas ce paramètre, le travail échoue. Booléenne

Cas d'utilisation

AdminTask.submitJob('-jobType installIM -targetList [Host1 Host2 Host3] 
 -jobParams [acceptLicense TRUE] [kitPath /IM/agent.installer.zip] -username user1 -password pw')

Si vous ne spécifiez pas le chemin d'accès du kit d'installation d'IBM Installation Manager, le travail installIM recherche ce kit le plus récent approprié pour la plateforme cible dans le référentiel des kits d'installation sur le gestionnaire de travaux. Par défaut, le référentiel des kits d'installation est racine_serveur_app/IMKits. Vous pouvez changer l'emplacement depuis le gestionnaire de travaux. Cliquez sur Travaux > Kits d'installation d'Installation Manager, puis spécifiez un autre emplacement pour Emplacement des kits d'installation Installation Manager.

updateIM

Le travail administratif updateIM met à jour une installation Installation Manager existante avec un référentiel au lieu d'envoyer un kit d'installation depuis le gestionnaire de travaux. Cette commande updateIM nécessite Installation Manager version 1.4 ou ultérieure.

Paramètres de travail

Tableau 28. Description des paramètres de updateIM. Exécutez une commande submitJob updateIM avec au moins les paramètres repository et installPath.
Paramètre Description Type
repository Indique l'emplacement du référentiel pour la mise à jour d'Installation Manager. Le chemin peut correspondre à un fichier local de l'ordinateur du gestionnaire de travaux ou à une URL pointant vers un fichier distant. String (chaîne)
installPath Indique l'emplacement de l'installation Installation Manager. String (chaîne)
keyringFile Si le référentiel de l'offre indiqué dans le fichier de réponses nécessite une connexion, indiquez l'emplacement du fichier de clés à utiliser. Dans le cas contraire, n'indiquez pas ce paramètre. String (chaîne)
keyringPassword Facultatif. Indique le mot de passe pour le fichier de clés. Si le fichier de clés n'a pas besoin de mot de passe, n'indiquez pas ce paramètre. String (chaîne)
acceptLicense Doit avoir la valeur true. Si vous n'indiquez pas ce paramètre, le travail échoue. Booléenne

Cas d'utilisation

AdminTask.submitJob('-jobType updateIM -targetList [Host1] 
 -jobParams [acceptLicense TRUE][ [repository /IM/repository] [installPath /IM] ]')

manageOfferings

Le travail administratif manageOfferings peut installer, mettre à jour, modifier, annuler ou désinstaller des offres dans Installation Manager. Soumettez un travail qui utilise un fichier de réponses Installation Manager et un fichier de clés (facultatif) pour gérer une offre à l'aide d'un référentiel distant.

Eviter les incidents Eviter les incidents: Par défaut, le travail applique l'emplacement de données spécifié comme chemin absolu.
  • [Windows]Le chemin d'accès doit commencer par une lettre d'unité.
  • [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]Le chemin d'accès doit commencer par /.
Pour supprimer cette restriction, affectez la valeur true à la propriété Java suivante : com.ibm.ws.admin.cimjm.disableDataLocationAbsolutePathCheck=true.gotcha

Paramètres de travail

Tableau 29. Description des paramètres de manageOfferings. Exécutez une commande submitJob manageOfferings avec au moins le paramètre responseFile.
Paramètre Description Type
responseFile Indique l'emplacement du fichier de réponses pour mettre à jour, modifier, annuler ou désinstaller des offres d'Installation Manager. Le chemin peut correspondre à un fichier local de l'ordinateur du gestionnaire de travaux ou à une URL pointant vers un fichier distant. String (chaîne)
IMPath Indique l'emplacement de l'installation Installation Manager. Si ce paramètre n'est pas spécifié, le travail tente d'effectuer une reconnaissance et d'utiliser le chemin de l'installation Installation Manager par défaut sur l'hôte cible. Si aucune ou plusieurs installations Installation Manager sont trouvées, le travail échoue. Dans ce cas, la commande submitJob manageOfferings doit spécifier le chemin d'Installation Manager. String (chaîne)
keyringFile Indique l'emplacement du fichier de clés à utiliser si le référentiel de l'offre indiqué dans le fichier de réponses nécessite une connexion. Dans le cas contraire, n'indiquez pas ce paramètre. String (chaîne)
keyringPassword Facultatif. Indique le mot de passe pour le fichier de clés. Si le fichier de clés n'a pas besoin de mot de passe, n'indiquez pas ce paramètre. String (chaîne)

Cas d'utilisation

AdminTask.submitJob('-jobType manageOfferings -targetList [Host1 Host2 Host3] 
 -jobParams [responseFile /IM/agent.installer.zip] -username user1 -password pw')

findIMDataLocation

Le travail administratif findIMDataLocation peut ajouter ou rechercher des emplacements de données Installation Manager.

Si un chemin d'accès contient un point-virgule (;), mettez le chemin entre guillemets ("). Par exemple : "/opt/my,path";/opt/data1. Le travail peut détecter des emplacements de données enregistrés dans le registre Installation Manager. Sous Unix, le registre par défaut pour une installation non administrative se trouve dans userhome/etc/.ibm/registry. Le registre par défaut pour une installation administrative se trouve dans /etc/.ibm/registry. Vous n'avez pas besoin d'ajouter des emplacements de données qui sont enregistrés dans le registre par défaut. Le travail exécute les étapes suivantes :
  • Il valide les emplacements de données spécifiés dans la zone Emplacements de données IM supplémentaires, ainsi que les emplacements de données détectés par le travail lors de la recherche (si la valeur true) est affectée à la recherche dans le système.
  • Il ajoute les emplacements de données valides à la liste d'emplacements de données existante en vue d'une utilisation ultérieure.
  • Il supprime les emplacements de données en double.
  • Il exécute le travail d'inventaire.
Lorsque le travail est terminé, l'inventaire de la cible est en cours.

Paramètres de travail

Tableau 30. Description des paramètres de findIMDataLocation. Exécutez une commande submitJob findIMDataLocation avec au moins le paramètre responseFile. Vous pouvez spécifier les paramètres searchSystem et dataLocations simultanément.
Paramètre Description Type
targetList Indique l'emplacement des systèmes cible du travail. String (chaîne)
searchSystem Indique à CIM de rechercher les emplacements de données Installation Manager dans la totalité du système cible. String (chaîne)
dataLocations Indique l'emplacement des données Installation Manager utilisables. Le travail répertorie uniquement les emplacements de données Installation Manager qui sont utilisables par l'utilisateur cible en cours qui est enregistré sur la console d'administration. String (chaîne)

Cas d'utilisation

AdminTask.submitJob ('[-jobType findDataLocation -targetList targetList -jobParams [[searchSystem true] 
[datalocations path_to_data_locations_separated_by_semicolon]  ]]')

Soumission des travaux Liberty

Vous pouvez soumettre des travaux pour installer et désinstaller des ressources Liberty, et pour démarrer et arrêter les serveurs Liberty. Un serveur Liberty est un serveur d'applications dynamique à démarrage rapide que vous pouvez facilement compléter par de nouvelles fonctions et administrer en éditant les fichiers de configuration XML.

Une installation Liberty nécessite un kit JDK (Java Development Kit) ou un environnement JRE (Java Runtime Environment) pour pouvoir exécuter les travaux de démarrage ou d'arrêt du serveur. Définissez l'emplacement de JDK ou JRE en procédant comme suit :
  • Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE dans le fichier server.env. Le travail lit la propriété JAVA_HOME et la définit sur l'environnement cible avant d'exécuter la commande permettant de démarrer ou d'arrêter le serveur. Cependant, cette propriété n'est pas utilisée par la commande du serveur Liberty si vous démarrez ou arrêtez le serveur manuellement.

    [z/OS]Le fichier server.env doit être au format EBCDIC.

  • [AIX][HP-UX][Linux][Solaris][z/OS]Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE dans le fichier .bashrc de l'utilisateur.
  • [AIX][HP-UX][Linux][Solaris][z/OS]Ajoutez le chemin JDK ou JRE à la variable d'environnement PATH.
  • [Windows]Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE en tant que variable d'environnement système.
  • [Windows]Ajoutez le chemin JDK ou JRE à la variable système PATH.

Si JAVA_HOME n'est pas spécifiée dans server.env ou dans l'environnement utilisateur, le gestionnaire de travaux recherche JDK ou JRE dans le chemin de recherche de l'utilisateur.

installLibertyProfileResources

Le travail installLibertyProfileResources extrait les ressources d'une image Liberty vers les répertoires de destination dont le chemin relatif se trouve dans le répertoire racine. Les conditions suivantes doivent être remplies pour l'exécution de ce travail :

  • Un ordinateur hôte doit être enregistré auprès du gestionnaire de travaux.
  • L'image (fichier zip compressé) doit contenir les ressources Liberty dans une structure de répertoires conforme aux règles du gestionnaire de travaux. Voir Conditionnement des ressources Liberty.
  • Le répertoire racine pour l'installation des ressources sur l'hôte cible doit être défini. Au minimum, affectez à la variable WLP_WORKING_DIR un répertoire valide figurant sur un hôte cible. Pour installer les ressources dans un répertoire partagé sur l'hôte cible, affectez à la variable WLP_SHARED_DIR un répertoire valide. Voir Définition des variables des serveurs Liberty.

Au cours du déploiement des ressources, le produit applique une substitution de variable au fichier bootstrap.properties sur chaque serveur Liberty.

[z/OS]Le fichier server.env doit être au format EBCDIC.

Le travail extrait l'image sur l'hôte cible en essayant les méthodes suivantes dans cet ordre :
  • Utilisez l'utilitaire unzip sur l'hôte.
  • Utilisez l'utilitaire jar sur l'hôte, parmi lesquels l'utilitaire jar d'un kit de développement de logiciels (SDK) trouvé par un travail d'inventaire.
  • [Windows]Utilisez l'utilitaire unzip qui est copié sur l'hôte distant pendant la durée du travail, s'il n'est pas spécifiquement désactivé par l'administrateur. L'utilitaire unzip est supprimé une fois le travail terminé.
  • Décompressez le fichier zip sur le gestionnaire de travaux et copiez les fichiers les uns après les autres sur l'hôte de destination. Cette méthode s'applique uniquement si l'image du serveur Liberty se trouve sur le gestionnaire de travaux.

Le travail échoue sans installer une ressource si l'instance de ressource existe déjà dans un répertoire de destination.

Paramètres de travail

Tableau 31. Descriptions des paramètres installLibertyProfileResources. Exécutez une commande submitJob installLibertyProfileResources avec au moins le paramètre image ou url.
Paramètre Description Type
image Si le fichier compressé qui fournit l'image Liberty se trouve sur un hôte du gestionnaire de travaux, ce paramètre indique le chemin d'accès complet du fichier compressé ; par exemple :
[AIX][HP-UX][Linux][Solaris]
/resources/my_liberty_server.zip
[Windows]
c:/resources/my_liberty_server.zip
String (chaîne)
url Si le fichier compressé qui fournit les ressources Liberty ne se trouve pas sur un hôte du gestionnaire de travaux, ce paramètre indique le chemin d'URL du fichier compressé. Les noms de schéma pris en charge pour l'URL (universal resource locator) incluent http, https, ftp et file.
Restriction : Pour spécifier un protocole d'URL autre que file, l'hôte cible doit avoir un utilitaire wget. Sélectionnez un protocole de téléchargement distant http, https ou ftp pris en charge par l'utilitaire wget situé sur l'hôte cible. Si l'utilitaire wget ne prend pas en charge le protocole sélectionné, le travail ne peut pas installer les ressources.

Par exemple, spécifiez l'une des adresses URL suivantes pour le fichier de ressources, my_liberty_server.zip.

Si les ressources du serveur Liberty se trouvent sur un serveur HTTP ou HTTPS :

http://www.mycompany.com/resources/my_liberty_server.zip

https://www.mycompany.com/resources/my_liberty_server.zip

Si les ressources se trouvent sur un serveur FTP :

ftp://www.mycompany.com/resources/my_liberty_server.zip

Si les ressources se trouvent sur l'ordinateur de l'hôte cible, l'adresse URL peut utiliser le schéma de fichier pour décrire le chemin et le nom du fichier compressé :

[AIX][HP-UX][Linux][Solaris]
file:///resources/my_liberty_server.zip
[Windows]
file://c:/resources/my_liberty_server.zip

Si l'adresse URL est protégée par mot de passe, vous devez également spécifier des valeurs pour urluser et urlpassword.

String (chaîne)
share Indique si des ressources Liberty doivent être installées dans un répertoire partagé. Lorsque ce paramètre est défini sur true, les ressources sont installées à l'emplacement défini par la variable WLP_SHARED_DIR. Si cette dernière n'est pas définie ou n'indique pas un répertoire valide, le produit renvoie une erreur et n'extrait pas les ressources de l'image.

Lorsqu'il est défini sur false, ce qui est la valeur par défaut, le travail installe les ressources à l'emplacement défini par la variable WLP_WORKING_DIR.

Booléenne
urluser Indique un nom d'utilisateur pour l'adresse URL. Si vous avez indiqué une adresse URL et que cette dernière est protégée par mot de passe, vous devez spécifier un nom d'utilisateur. Sinon, n'affectez pas de valeur au paramètre urluser. String (chaîne)
urlpassword Indique un mot de passe qui permet à urluser d'accéder à l'adresse URL. Si vous avez indiqué une adresse URL et que cette dernière est protégée par mot de passe, vous devez spécifier un mot de passe. Sinon, n'affectez pas de valeur au paramètre urlpassword. String (chaîne)

Cas d'utilisation

Dans l'exemple suivant, l'image se trouve sur le même hôte que le gestionnaire de travaux et elle est installée dans WLP_WORKING_DIR :
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
 -description installLibertyProfileResources
 -jobParams [ [image /tmp/liberty/wlpwithjava.zip] [share FALSE] ]]')
Dans l'exemple suivant, l'image est sur un hôte cible, l'adresse URL du fichier de l'image est indiquée et l'image est installée dans WLP_WORKING_DIR :
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
 -description installLibertyProfileResources
 -jobParams [ [url file://c:/LibertyWorking/LibertyWorkingwjava.zip] [share FALSE] ]]')
Dans l'exemple suivant, l'image se trouve sur un serveur ftp distant protégé par mot de passe et elle est installée dans WLP_WORKING_DIR :
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
 -description installLibertyProfileResources
 -jobParams [ [urlpassword ftp_pwd] [url ftp://www.mycompany.com/projects/liberty/image-0111003.zip]
     [share FALSE] [urluser ftp_user] ]]')
Dans l'exemple suivant, l'image se trouve sur un serveur http distant protégé par mot de passe et elle est installée dans WLP_WORKING_DIR :
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
 -description installLibertyProfileResources
 -jobParams [ [urlpassword http_pwd] [url http://www.mycompany.com/projects/liberty/image-0111003.zip]
    [share FALSE] [urluser http_user] ]]')
Dans l'exemple suivant, l'image se trouve sur un serveur https distant protégé par mot de passe et elle est installée dans WLP_SHARED_DIR :
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
 -description installLibertyProfileResources
 -jobParams [ [urlpassword http_pwd] [url https://www.mycompany.com/projects/liberty/image-0111003.zip]
    [share TRUE] [urluser http_user] ]]')

uninstallLibertyProfileResources

Le travail uninstallLibertyProfileResources soustrait une ressource de l'administration effectuée par le gestionnaire de travaux. La ressource a précédemment été installée dans un répertoire de destination sur l'hôte par le travail installLibertyProfileResources ou, après une installation manuelle en décompressant une image Liberty, a été trouvée par le travail d'inventaire.

Le produit renvoie une erreur et ne supprime pas la ressource si l'une des conditions suivantes est remplie :
  • La commande indique plusieurs types de ressources à supprimer.
  • Le nom de la ressource est résolu en plusieurs ressources du même nom.
  • La ressource n'existe pas dans un répertoire auquel le gestionnaire de travaux peut accéder et dans lequel ce dernier peut effectuer des recherches.
Eviter les incidents Eviter les incidents: Si le travail échoue, des fichiers risquent d'être supprimés. L'état de la ressource peut être altéré. Si vous modifiez manuellement les fichiers de ressources pour résoudre le problème, exécutez un travail d'inventaire pour mettre à jour l'inventaire après avoir modifié les fichiers.gotcha

Paramètres de travail

Tableau 32. Description des paramètres de uninstallLibertyProfileResources. Exécutez une commande submitJob uninstallLibertyProfileResources avec un seul paramètre qui identifie la ressource à supprimer.
Paramètre Description Type
projectName Indique le nom ou l'ID de ressource du projet à supprimer. Le produit recherche tous les serveurs du projet. Pour chaque serveur identifié qui s'exécute, le produit arrête le serveur avant de tenter de supprimer la ressource. String (chaîne)
runtimeName Indique le nom ou l'ID de ressource du module d'exécution (runtime) Liberty à retirer. Le produit recherche tous les serveurs pour l'exécution. Pour chaque serveur identifié qui s'exécute, le produit arrête le serveur avant de tenter de supprimer la ressource. String (chaîne)
sdkName Indique le nom ou l'ID de ressource du kit de développement de logiciels (SDK) à supprimer. String (chaîne)
nomServeur Indique le nom ou l'ID de ressource du serveur à supprimer. Si le serveur est en cours d'exécution, le produit arrête le serveur avant de supprimer la ressource. String (chaîne)
applicationBinaryName Indique le nom ou l'ID de ressource du fichier binaire d'application à supprimer. String (chaîne)
forceDelete Indique éventuellement si les ressources doivent être supprimées même si leur statut ne peut pas être détecté. La valeur par défaut est false, ce qui signifie que les ressources ne doivent pas être supprimées. Lorsque la valeur est true, les ressources de serveur sont supprimées même si le statut des ressources de serveur ne peut pas être détecté ou si les serveurs ne peuvent pas être arrêtés. Si le statut d'un serveur ne peut pas être détecté, le travail uninstallLibertyProfileResources échoue à moins que l'option forceDelete ne soit spécifiée. Booléenne

Cas d'utilisation

L'exemple suivant soustrait le fichier binaire d'application DefaultWebApplication.war de l'administration du gestionnaire de travaux :

AdminTask.submitJob('[-jobType uninstallLibertyProfileResources -targetList [host_name]
 -description uninstallLibertyProfileResources
 -jobParams [ [applicationBinaryName DefaultWebApplication.war] ]]')

startLibertyProfileServer

Le travail startLibertyProfileServer démarre une ou plusieurs ressources de serveur Liberty. L'état des ressources du serveur passe de Arrêté à Démarré.

Un serveur Liberty nécessite un kit JDK (Java Development Kit) ou un environnement JRE (Java Runtime Environment) pour pouvoir exécuter ce travail. Définissez l'emplacement de JDK ou JRE en procédant comme suit :
  • Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE dans le fichier server.env. Le travail lit la propriété JAVA_HOME et la définit sur l'environnement cible avant d'exécuter la commande permettant de démarrer le serveur. Toutefois, cette propriété n'est pas utilisée par la commande serveur Liberty si vous démarrez le serveur manuellement.

    [z/OS]Le fichier server.env doit être au format EBCDIC.

  • [AIX][HP-UX][Linux][Solaris][z/OS]Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE dans le fichier .bashrc de l'utilisateur.
  • [AIX][HP-UX][Linux][Solaris][z/OS]Ajoutez le chemin JDK ou JRE à la variable d'environnement PATH.
  • [Windows]Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE en tant que variable d'environnement système.
  • [Windows]Ajoutez le chemin JDK ou JRE à la variable système PATH.

Paramètres de travail

Tableau 33. Description des paramètres de startLibertyProfileServer. Exécutez une commande submitJob startLibertyProfileServer avec le paramètre startResource.
Paramètre Description Type
startResource Indique le nom de chemin d'accès de la ressource de serveur Liberty à démarrer. String (chaîne)

Cas d'utilisation

L'exemple suivant démarre la ressource de serveur Liberty server1 :

AdminTask.submitJob('-jobType startLibertyProfileServer -targetList host_name
 -description startLibertyProfileServer
 -jobParams [[startResource runtime/wlp/liberty_server/server1 ]]')

stopLibertyProfileServer

Le travail stopLibertyProfileServer arrête une ou plusieurs ressources de serveur Liberty en cours d'exécution. L'état des ressources du serveur passe de Démarré à Arrêté.

Un serveur Liberty nécessite un kit JDK (Java Development Kit) ou un environnement JRE (Java Runtime Environment) pour pouvoir exécuter ce travail. Assurez-vous que l'emplacement JDK ou JRE est défini sur la cible. Pour plus d'informations sur la définition d'un emplacement JDK ou JRE, voir startLibertyProfileServer.

Paramètres de travail

Tableau 34. Description des paramètres de stopLibertyProfileServer. Exécutez une commande submitJob stopLibertyProfileServer avec le paramètre stopResource.
Paramètre Description Type
stopResource Indique le nom de chemin d'accès de la ressource de serveur Liberty à arrêter. String (chaîne)

Cas d'utilisation

L'exemple suivant arrête la ressource de serveur Liberty :

AdminTask.submitJob('-jobType stopLibertyProfileServer -targetList host_name
 -description stopLibertyProfileServer
 -jobParams [[stopResource project/proj1/runtime/wlp/liberty_server/defaultServer]]')

generateMergedPluginConfigForLibertyProfileServers

Le travail generateMergedPluginConfigForLibertyProfileServers crée un fichier plugin-cfg.xml unique en fusionnant tous les fichiers plugin-cfg.xml générés pour le serveur Liberty sur les hôtes ciblés.

Pour ce travail, vous pouvez spécifier un serveur Liberty sur plusieurs hôtes cible. Une fois que le serveur Liberty est détecté, un fichier plugin-cfg.xml est généré sur ce serveur, puis recopié sur le gestionnaire de travaux. Lorsque tous les fichiers plugin-cfg.xml ont été générés pour tous les serveurs Liberty ciblés, ils sont fusionnés dans un seul fichier plugin-cfg.xml. Ce fichier fusionné est placé dans le répertoire du gestionnaire de travaux app_server_root/profiles/job_manager_profile/config/temp/JobManager/job_ID/_mergedPluginDir/.

Ce travail nécessite une connexion JMX (Java Management Extensions) aux serveurs Liberty sur les hôtes cible. Vous pouvez configurer la connexion JMX à l'aide de l'un du connecteurs local ou du connecteur HTTP/REST. Indiquez le nom de fonction du connecteur dans le fichier server.xml des serveurs Liberty. L'exemple suivant utilise des noms de fonction dans un fichier server.xml pour le connecteur local et pour les connecteurs HTTP/REST :
<featureManager>
  <feature>localConnector-1.0</feature>
  <feature>restConnector-1.0</feature>
  ...
</featureManager>
Si vous utilisez le connecteur HTTP/REST, vous devez indiquer un nom et un mot de passe utilisateur pour la connexion JMX lors de la soumission du travail.
Le travail s'arrête et le produit renvoie une erreur si l'une des conditions suivantes est vérifiée :
  • Un serveur Liberty ciblé n'est pas en cours d'exécution.
  • Aucun connecteur JMX n'est configuré pour un serveur Liberty ciblé.
  • La commande n'indique pas des données d'identification valides pour une connexion JMX.

Paramètres de travail

Tableau 35. generateMergedPluginConfigForLibertyProfileServers parameter descriptions. Exécutez une commande submitJob generateMergedPluginConfigForLibertyProfileServers avec les paramètres serverName et connection.
Paramètre Description Type
nomServeur Indique le nom ou l'ID de ressource du serveur pour lequel générer des fichiers plugin-cfg.xml sur les hôtes ciblés. Le serveur Liberty doit s'exécuter sur les hôtes ciblés. String (chaîne)
jmxuser Indique le nom d'utilisateur pour une connexion JMX. Indiquez ce paramètre si vous utilisez le connecteur HTTP/REST pour une connexion JMX. String (chaîne)
jmxpassword Indique le mot de passe pour une connexion JMX. Indiquez ce paramètre si vous utilisez le connecteur HTTP/REST pour une connexion JMX. String (chaîne)

Cas d'utilisation

L'exemple suivant génère un fichier plugin-cfg.xml fusionné pour le serveur Liberty defaultServer sur les hôtes cibles, host1 et host2 :

AdminTask.submitJob('[-jobType generateMergedPluginConfigForLibertyProfileServers
 -targetList [host1 host2] -description generateMergedPluginConfigForLibertyProfileServers
 -jobParams [[jmxpassword ********][serverName runtime/wlp/liberty_server/defaultServer][jmxuser c]]]') 

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_7jobtypes
Nom du fichier : rxml_7jobtypes.html