Groupe de commandes Utility de l'objet AdminTask
Vous pouvez utiliser les langages de script Jython ou Jacl pour gérer les serveurs à l'aide de l'outil wsadmin. Les commandes et paramètres du groupe Utility peuvent être utilisés pour modifier le nom d'hôte d'un noeud, analyser le nom du gestionnaire de déploiement et déterminer si le système est un serveur unique ou un déploiement réseau.
Le groupe de commandes Utility de l'objet AdminTask inclut les commandes suivantes :
changeHostName
Utilisez la commande changeHostName pour modifier le nom d'hôte d'un noeud.
Objet cible
Aucune
Paramètres et valeurs renvoyées
- -hostName
- Le nouveau nom d'hôte. (Chaîne, obligatoire)
- -nodeName
- Nom du noeud dont le nom d'hôte a été changé. (Chaîne, obligatoire)
Paramètres facultatifs :
- -systemName
- Nom du système z/OS sur lequel s'exécute ce noeud. Cette zone est obligatoire uniquement si un noeud doit être déplacé
d'un système vers un autre, par exemple, du système SYSA vers le système SYSB. Si vous n'êtes pas sûr de la valeur à spécifier
pour ce paramètre, exécutez la commande IPLINFO sur votre système z/OS et utilisez le nom affiché
dans la zone Sysname= comme valeur pour ce paramètre. Remarque : Lors de l'exécution de la commande changeHostName en mode interactif, le paramètre systemName apparaît, mais il ne doit être utilisé que pour un système z/OS. Le paramètre systemName représente le nom de système z/OS qui est défini dans le fichier server.xml comme valeur pour la propriété was.ConfiguredSystemName. Lorsque le paramètre systemName est sélectionné, cette propriété est modifiée.
- -regenDefaultCert
- Demande de régénération des certificats par défaut. La valeur admise pour ce paramètre est "true"
si vous souhaitez régénérer les certificats par défaut. Toute autre valeur suppose que vous ne voulez PAS
que les certificats par défaut soit régénérés. L'argument de chaîne est traité au format booléen. La valeur booléenne renvoyée représente la valeur true si l'argument de chaîne n'est pas NULL
et qu'il est égal, sans faire de distinction entre les majuscules et les minuscules, à la chaîne "true". Le paramètre regenDefaultCert fonctionne comme AdminTask.createChainedCertificate
et comporte les valeurs par défaut suivantes :
- -keyStoreName "NodeDefaultKeyStore"
- -keyStoreScope "(node):" + nodeName
- -certificateAlias" "default_" + hostName
- -certificateCommonName" nodeName
- -certificateOrganization" "IBM"
- -certificateOrganizationalUnit" nodeName
- -certificateCountry "US"
Remarque : Pour les paramètres AdminTask.createChainedCertificate et regenDefaultCert, si vous utilisez le noeud de gestionnaire de déploiement, -keyStoreName prend la valeur -keyStoreName "CellDefaultKeyStore" et -keyStoreScope prend la valeur -keyStoreScope "(cell):" + cellname.Le commutateur est un commutateur de commodité qui émet des hypothèses quant aux valeurs par défaut des paramètres de certificat. Si les valeurs par défaut ne sont pas utilisées, alors AdminTask.createChainedCertificate ou regenDefaultCert doit être utilisé.
Prenez connaissance des détails fonctionnels suivants :- keyStoreName et keyStoreScope ne sont pas admis avec le paramètre regenDefaultCert.
- Lorsque vous exécutez la commande changeHostName, vous ne pouvez pas spécifier certificateCommonName (CN de la nouvelle certification). Pour spécifier un nouveau nom d'hôte comme CN, vous devez utiliser AdminTask.createChainedCertificate .
Exemples
Syntaxe d'un exemple de mode différé :
Avec Jacl :
$AdminTask changeHostName {-hostName host_name -nodeName node_name -systemName system_name}
A l'aide de la chaîne Jython :
AdminTask.changeHostName('-hostName host_name -nodeName node_name -systemName system_name')
Avec une liste Jython :
AdminTask.changeHostName(['-hostName', 'host_name', '-nodeName', 'node_name', '-systemName', 'system_name'])
Exemple d'utilisation en mode interactif :
Avec Jacl :
$AdminTask changeHostName {-interactive}
A l'aide de la chaîne Jython :
AdminTask.changeHostName ('[-interactive]')
Avec une liste Jython :
AdminTask.changeHostName (['-interactive'])
getDmgrProperties
La commande getDmgrProperties permet de renvoyer le nom du gestionnaire de déploiement.
Objet cible
Aucun
Paramètres et valeurs renvoyées
- Paramètres : Aucun
- Résultat : le nom du gestionnaire de déploiement dans un système de déploiement réseau. Renvoie une chaîne vide si le système est un serveur unique.
Exemples
Syntaxe d'un exemple de mode différé :
Avec Jacl :
$AdminTask getDmgrProperties {}
Avec Jython :
AdminTask.getDmgrProperties()
isFederated
La commande isFederated permet de savoir si le système est un serveur unique ou un déploiement réseau.
Objet cible
Aucun
Paramètres et valeurs renvoyées
- Paramètres : Aucun
- Résultat : booléen. true si le système est un déploiement réseau. Sinon, renvoie false.
Exemples
Syntaxe d'un exemple de mode différé :
- Avec Jacl :
$AdminTask isFederated {}
- Avec une chaîne Jython :
AdminTask.isFederated ()
renameCell


Objet cible
Aucun
Paramètres et valeurs renvoyées
- -newCellName
- Nouveau nom de cellule. (Chaîne, obligatoire)
- -dmgr_host
- Nom d'hôte ou adresse IP de l'ordinateur gestionnaire de déploiement. (Chaîne, obligatoire si la commande s'exécute sur un noeud fédéré)
- -dmgr_port
- Port de connexion JMX (Java Management Extensions). (Chaîne, obligatoire si la commande s'exécute sur un noeud fédéré. La valeur par défaut "8879" est utilisée si aucune valeur n'est spécifiée)
- -connType
- Type de connecteur JMX à utiliser pour la connexion au gestionnaire de déploiement. SOAP est le type de connecteur JMX par défaut pour la commande. Les autres types corrects sont JSR160RMI ou Remote Method Invocation (RMI). (Chaîne, obligatoire si la commande s'exécute sur un noeud fédéré. La valeur par défaut "SOAP" est utilisée si aucune valeur n'est spécifiée)
- -userName
- Nom d'utilisateur pour l'authentification si la sécurité est activée. (Chaîne, obligatoire si la commande s'exécute sur un noeud fédéré et si la sécurité est activée)
- -password
- Mot de passe pour l'authentification si la sécurité est activée. (Chaîne, obligatoire si la commande s'exécute sur un noeud fédéré et si la sécurité est activée)
Paramètres facultatifs :
- -regenCerts
- Détermine s'il convient de régénérer des certificats SSL (Secure Sockets Layer) pour tous les noeuds d'une cellule. Seuls les certificats des magasins de clés par défaut sont régénérés. Ce paramètre ne s'applique pas pour les cellules présentes sur les systèmes d'exploitation z/OS. Gardez à l'esprit que, suite à la régénération de certificats, des clients accédant au serveur peuvent rétablir la confiance avec le serveur en obtenant de nouveaux certificats. La valeur par défaut est false. Définir sur true pour régénérer les certifications SSL pour les noeuds d'une cellule. (Booléen, facultatif)
- -updateJaccContextID
- Détermine s'il convient de mettre à jour cet ID de contexte de sécurité des applications utilisées par un fournisseur JACC (Java Authorization Contract for Containers). La valeur par défaut est false. Affectez la valeur true pour mettre à jour l'ID de contexte de sécurité. (Booléen, facultatif)
Syntaxe d'un exemple de mode différé :
- Avec une chaîne Jython :
AdminTask.renameCell('-newCellName new_cell_name')
- Avec une liste Jython :
AdminTask.renameCell(['-newCellName', 'new_cell_name'])
Exemple d'utilisation en mode interactif :
- Avec une chaîne Jython :
AdminTask.renameCell ('[-interactive]')
- Avec une liste Jython :
AdminTask.renameCell (['-interactive'])
Exemples de scénarios utilisant renameCell


- Renommage d'une cellule pour un serveur d'applications autonome :
- Arrêtez le serveur autonome.
- Renommez la cellule en utilisant wsadmin en mode local :
AdminTask.renameCell('-newCellName new_cell_name')
- Renommage d'une cellule pour un gestionnaire de déploiement et ses noeuds fédérés :
Pour renommer une cellule d'une topologie de déploiement réseau, la commande doit être exécutée sur un noeud/profil de gestionnaire de déploiement ainsi que sur tous les noeuds/profils fédérés.
Eviter les incidents: Si la cellule fait partie d'une topologie multicellule, supprimez les liens de la cellule depuis les autres avant d'exécuter cette procédure et liez à nouveau les cellule à l'issue de l'exécution.gotcha
- Arrêtez tous les serveurs de la cellule, y compris le serveur de gestionnaire de déploiement, les serveurs d'agent de noeud et tous les serveurs d'applications.
- Renommez la cellule d'un noeud/profil de gestionnaire de déploiement : exécutez la commande
ci-après avec wsadmin en mode local, ce qui a pour effet de changer le nom de cellule en même temps
que le certificat SSL dans le référentiel maître dmgr.
AdminTask.renameCell('[-newCellName new_cell_name]')
- Exécutez la commande de renommage de cellule pour tous les noeuds/profils fédérés de la cellule.
- Démarrez le serveur de gestionnaire de déploiement.
- Dans le profil de chaque agent de noeud et pour chaque noeud qui n'est pas le noeud de gestionnaire de déploiement,
démarrez wsadmin en mode local et exécutez la commande ci-après :
AdminTask.renameCell('[-newCellName new_cell_name –dmgr_host dmgr_hostname –dmgrPort dmgr_connector_port –connType SOAP –username my_user –password my_password]')
- Renommage d'une cellule pour un serveur d'agent d'administration :
- Arrêtez le serveur d'agent d'administration.
- Renommez la cellule en utilisant wsadmin en mode local :
AdminTask.renameCell('-newCellName new_cell_name')
Remarque : Si vous souhaitez renommer une cellule pour un serveur d'applications autonome enregistré sur un serveur d'agent d'administration, vous devez commencer par annuler l'enregistrement de ce noeud autonome avec ce serveur d'administration. Vous devrez réenregistrer le noeud auprès du serveur d'administration une fois la commande de renommage de cellule exécutée si vous souhaitez que le serveur d'administration continue à gérer le noeud autonome.
- Renommage d'une cellule pour un serveur de gestionnaire de travaux :
- Arrêtez le serveur de gestionnaire de travaux.
- Renommez la cellule en utilisant wsadmin en mode local :
AdminTask.renameCell('-newCellName new_cell_name')
Eviter les incidents: Cette opération est destinée à des profils de gestionnaire de travaux autonome uniquement. Ne l'utilisez pas pour un gestionnaire de déploiement qui fonctionne en tant que gestionnaire de travaux.gotcha
- Renommage d'une cellule dans la topologie multicellule :
Pour renommer une cellule dans une topologie multicellule telle que la topologie en étoile, la cellule doit être déconnectée des autres cellules avant l'opération de renommage. Une fois la cellule renommée, elle doit être rattachée aux autres cellules.