Vous pouvez enregistrer un ordinateur hôte auprès d'un contrôleur de collectivité Liberty, mettre à jour les informations sur l'hôte, ou annuler l'enregistrement d'un hôte. L'enregistrement permet au contrôleur de collectivité d'accéder à des applications, des fichiers de commandes et d'autres ressources sur l'hôte. Les hôtes enregistrés sont des membres de la collectivité.
Pourquoi et quand exécuter cette tâche
Aucun ordinateur hôte n'est requis pour installer des produits de serveur
WebSphere Application Server.
Aucune configuration logicielle n'est requise pour un hôte à part son système d'exploitation. L'hôte peut être l'ordinateur sur lequel le produit est installé
ou un autre ordinateur.
Pour enregistrer un hôte auprès d'un contrôleur de collectivité, mettre à jour les informations sur l'hôte et annuler l'enregistrement d'un hôte, utilisez les commandes
registerHost,
updateHost et
unregisterHost. Indiquez le nom de l'ordinateur hôte dans l'un des formats suivants :
- Chaîne de nom d'hôte DNS complète, par exemple xmachine.ibm.com
- Nom d'hôte DNS abrégé par défaut, tel que xmachine
- Adresse IP numérique, telle que 127.1.255.3
Remarque : Lorsqu'un serveur Liberty rejoint une collectivité, l'hôte associé est automatiquement enregistré avec le contrôleur de collectivité s'il n'est pas déjà enregistré.
Un hôte peut être enregistré auprès de la collectivité sous des noms différents. Vérifiez que le nom d'hôte spécifié pour registerHost,
updateHost et unregisterHost sont cohérents avec le nom d'hôte spécifié pour les membres de la collectivité enregistrés. La variable defaultHostName dans le fichier server.xml du membre de serveur enregistré
détermine le nom d'hôte auquel le serveur appartient.
- Enregistrez un hôte auprès d'un contrôleur de collectivité.
Pour enregistrer l'hôte courant, lorsque l'hôte contrôleur de
collectivité et l'hôte cible distant sont le même ordinateur,
exécutez la commande
registerHost dans le script
d'utilitaire de la collectivité sans indiquer de cible d'hôte
explicite. Spécifiez le nom d'hôte, le port ainsi que le nom et le mot de passe de l'administrateur du contrôleur de collectivité. Exemple :
wlp/bin/collective registerHost --host=controllerHost --port=controllerHTTPSPort
--user=controllerAdmin --password=controllerAdminPassword
Cet exemple de commande génère une paire de clés SSL unique pour l'authentification auprès du serveur SSH
d'un ordinateur hôte spécifique. Si vous enregistrez un hôte distant pour lequel une paire de clés SSH est déjà générée,
vous devez spécifier le chemin du fichier de clé privée SSH. La commande
registerHost ci-après suppose que la clé privée SSH est stockée sur l'ordinateur du contrôleur local à
l'emplacement
/home/user1/.ssh/id_rsa. L'autre fichier
de la paire de clés SSH est le fichier de clé publique
/home/user1/.ssh/authorized_keys
sur l'hôte cible distant.
wlp/bin/collective registerHost remotehost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--sshPrivateKey=/home/user1/.ssh/id_rsa
Si l'hôte distant ne prend pas en charge SSH ou vous ne souhaitez pas utiliser les clés SSH, vous pouvez spécifier un ID utilisateur de connexion au système d'exploitation pour
rpcUser et un mot de passe pour
rpcUserPassword. Si vous incluez
rpcUser avec
rpcUserPassword,
n'incluez pas
sshPrivateKey. La commande permettant d'indiquer
l'utilisateur et le mot de passe de connexion au système d'exploitation
ressemble à ceci :
wlp/bin/collective registerHost remotehost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--rpcUser=osUserForRemoteHost --rpcUserPassword=osUserPasswordForRemoteHost
Pour transférer des fichiers vers et depuis un hôte, vous devez spécifier les chemins de lecture et d'écriture de l'hôte. A moins
que la commande
registerHost ne spécifie les chemins, vous ne pourrez pas déployer d'archive
Liberty sur l'hôte.
hostReadPath spécifie les répertoires que le contrôleur de collectivité peut lire.
hostWritePath spécifie les répertoires
dans lesquels le contrôleur de collectivité peut écrire des données. Les chemins spécifiés par
hostWritePath sont également lisibles. Par exemple, pour télécharger une archive dans
/opt/wlp, vous
devez spécifier
--hostWritePath=/opt. Spécifiez un paramètre plusieurs fois pour plusieurs chemins.
wlp/bin/collective registerHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--rpcUser=osUser --rpcUserPassword=osUserPassword
--hostReadPath=/opt --hostWritePath=/dir1 --hostWritePath=/dir2
Pour utiliser l'outil de déploiement du
Centre d'administration pour déployer un
package serveur
Liberty, vous devez définir
hostWritePath sur le chemin dans lequel vous souhaitez déployer un package serveur. Pour transférer des fichiers dans plusieurs répertoires, incluez plusieurs instances du paramètre
hostWritePath dans la commande. Exemple :
wlp/bin/collective registerHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin
--password=controllerAdminPassword --rpcUser=osUser --rpcUserPassword=osUserPassword
--hostWritePath=c:\was\liberty\brokerageAppTest --hostWritePath=c:\wlp_backup
Vous pouvez éventuellement spécifier le chemin d'accès au répertoire de base Java de l'hôte à l'aide du paramètre -hostJavaHome. Par exemple :
-hostJavaHome=c:\java\jre
- Mettez à jour les informations d'authentification de l'hôte enregistré.
Exécutez la commande updateHost avec le script d'utilitaire de la collectivité afin de changer les informations d'authentification d'un hôte enregistré. Par exemple, si le mot de passe de l'utilisateur change, la commande suivante met à jour le mot de passe de l'hôte utilisé par la collectivité :
wlp/bin/collective updateHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--rpcUser=osUser --rpcUserPassword=newOsUserPassword
- Mettez à jour les chemins d'écriture ou de lecture de l'hôte enregistrés.
Exécutez la commande updateHost dans le script d'utilitaire de collectivité pour changer les chemins de lecture et d'écriture de
l'hôte. Les chemins spécifiés dans cette commande remplacent les chemins définis précédemment pour hostReadPath et
hostWritePath ; ils ne sont pas ajoutés aux chemins existants.
wlp/bin/collective updateHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--rpcUser=osUser --rpcUserPassword=osUserPassword
--hostReadPath=/optNew --hostWritePath=/opt --hostWritePath=/home/osUser
- Annulez l'enregistrement d'un hôte auprès d'un contrôleur de collectivité.
Exécutez la commande unregisterHost avec le script d'utilitaire de la collectivité, par exemple :
wlp/bin/collective unregisterHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
L'annulation d'un hôte supprime tous les serveurs enregistrés sur cet hôte et tout autre information relative à l'hôte depuis le contrôleur de collectivité.
Que faire ensuite
Pour des informations sur tous les paramètres des commandes registerHost, updateHost et unregisterHost, voir la documentation de l'API concernant le bean géré CollectiveRegistration.