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
- Soumission d'un travail de collecte d'inventaire
- Soumission d'un travail de collecte de l'état des cibles
- Soumission de travaux de gestion de fichiers
- Soumission d'un travail qui exécute un script wsadmin
- Soumission de travaux de gestion d'applications
- Soumission de travaux de gestion de serveurs
- Soumission de travaux de gestion du contexte d'exécution du serveur
- Soumission d'un travail d'exécution de commandes
- Soumission d'un travail de gestion des profils
- Soumission de travaux Installation Manager
- Soumission des travaux Liberty
Paramètres communs à tous les types de travaux
- 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]')
- 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]](../images/iseries.gif)
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
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
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.

- 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.
- Entrez la commande suivante : mkdir JobManager
- Entrez la commande suivante : chown -R QEJBSVR JobManager
- Copiez le fichier à distribuer dans le répertoire JobManager.
- Dans la console d'administration, soumettez le travail distributeFile.
Paramètres de travail
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
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
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.
Paramètres de travail
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
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.
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.
Paramètres de travail
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
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
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 |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
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
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
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
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
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) |
![]() |
![]() |
![]() |
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
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
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) |
![]() |
![]() |
![]() |
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
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
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
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
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
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
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
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]](../images/linux.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password ******* -jobParams [[command ./versionInfo.sh]]')
![[Windows]](../images/windows.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password ******* -jobParams [[command versionInfo.bat]]')
![[Linux]](../images/linux.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password *******
-jobParams [[command "./java -version"][workingDir /opt/IBM/WebSphere/AppServer/java/bin]]')
![[Windows]](../images/windows.gif)
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
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.

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
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 , 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
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.

Le chemin d'accès doit commencer par une lettre d'unité.
Le chemin d'accès doit commencer par /.
Paramètres de travail
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.
- 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.
Paramètres de travail
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.
- 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.
Le fichier server.env doit être au format EBCDIC.
Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE dans le fichier .bashrc de l'utilisateur.
Ajoutez le chemin JDK ou JRE à la variable d'environnement PATH.
Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE en tant que variable d'environnement système.
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.
Le fichier server.env doit être au format EBCDIC.
- 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.
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
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 :![]() ![]() ![]() ![]()
![]()
|
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 :
Si les ressources se trouvent sur un serveur FTP :
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é : ![]() ![]() ![]() ![]()
![]()
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
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [image /tmp/liberty/wlpwithjava.zip] [share FALSE] ]]')
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [url file://c:/LibertyWorking/LibertyWorkingwjava.zip] [share FALSE] ]]')
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] ]]')
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] ]]')
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.
- 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.

Paramètres de travail
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é.
- 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.
Le fichier server.env doit être au format EBCDIC.
Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE dans le fichier .bashrc de l'utilisateur.
Ajoutez le chemin JDK ou JRE à la variable d'environnement PATH.
Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE en tant que variable d'environnement système.
Ajoutez le chemin JDK ou JRE à la variable système PATH.
Paramètres de travail
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
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/.
<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.- 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
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]]]')