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

Nouvelle fonction Nouvelle fonction:
Utilisez la commande renameCell pour modifier le nom de cellule du serveur d'applications autonome, du gestionnaire de déploiement, de l'agent d'administration, du gestionnaire de travaux et des profils de noeud fédéré. Cette commande peut uniquement être exécutée en mode local wsadmin, i.e. wsadmin -conntype none.newfeat
Eviter les incidents Eviter les incidents: N'utilisez pas la commande renameCell dans un environnement de cellule mixte où une cellule comporte des noeuds installés avec différentes versions de WebSphere Application Server.gotcha

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

Eviter les incidents Eviter les incidents: La sauvegarde de votre configuration de noeud avec l'outil backupConfig depuis le répertoire profile_root/bin est recommandée avant le changement du nom de cellule de ce noeud via la commande renameCell. Si vous n'êtes pas satisfait des résultats de la commande renameCell et si l'exécution de la commande renameCell a échoué de manière inattendue, utilisez l'outil restoreConfig pour restaurer votre configuration de sauvegarde.gotcha
Eviter les incidents Eviter les incidents: Sauvegardez le fichier script profile_root/bin/setupCmdLine avant d'exécuter la commande renameCell. La commande met à jour le nom de cellule dans ce fichier avec le nouveau nom mais ne peut pas annuler l'opération si un utilisateur décide de supprimer le changement de configuration résultat de l'exécution de cette commande. Si vous décidez de procéder ainsi, vous devrez restaurer le fichier après avoir supprimé le changement de configuration. Sinon, vous ne pourrez pas démarrer un serveur avec ce profil.gotcha
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 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 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.


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_atutility
Nom du fichier : rxml_atutility.html