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 : Lorsque un serveur Liberty est joint à un collectif, l'hôte
associé est automatiquement enregistré avec le contrôleur collectif
si besoin est.
Un hôte peut être enregistré auprès de la collectivité sous des noms différents. Il est essentiel que les noms d'hôte spécifiés pour registerHost, updateHost et unregisterHost soient 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=hôteContrôleur --port=portHTTPSContrôleur
--user=adminContrôleur --password=motDePasseAdminContrôleur
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 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=hôteContrôleur
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--sshPrivateKey=/home/user1/.ssh/id_rsa
Si l'hôte distant ne prend pas en charge SSH ou si l'utilisation de clés SSH n'est pas souhaitée,
vous pouvez spécifier un ID utilisateur de connexion au système d'exploitation pour
rpcUser et
un 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=hôteContrôleur
--port=portHTTPSContrôleur --user=adminContrôleur --password=motDePasseAdminContrôleur
--rpcUser=osUserForRemoteHost --rpcUserPassword=osUserPasswordForRemoteHost
![[8.5.5.2 ou ultérieure]](../ng_v8552.gif)
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. 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 monHôte.ibm.com --host=hôteContrôleur
--port=portHTTPSContrôleur --user=adminContrôleur --password=motDePasseAdminContrôleur
--rpcUser=utilisateurSe --rpcUserPassword=motDePasseUtilisateurSe
--hostReadPath=/opt --hostWritePath=/rép1 --hostWritePath=/rép2
Pour utiliser l'outil de déploiement du centre d'administration de WebSphere
Liberty, vous devez associer
hostWritePath au chemin dans lequel vous voulez 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 monHôte.ibm.com --host=hôteContrôleur
--port=portHTTPSContrôleur --user=adminContrôleur
--password=motDePasseAdminContrôleur --rpcUser=utilisateurSE --rpcUserPassword=motDePasseUtilisateurSE
--hostWritePath=c:\was\liberty\brokerageAppTest --hostWritePath=c:\wlp_backup
- 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 monHôte.ibm.com --host=hôteContrôleur
--port=portHTTPSContrôleur --user=adminContrôleur --password=motDePasseAdminContrôleur
--rpcUser=utilisateurSE --rpcUserPassword=nouveauMotDePasseUtilisateurSe
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 monHôte.ibm.com --host=hôteContrôleur
--port=portHTTPSContrôleur --user=adminContrôleur --password=motDePasseAdminContrôleur
--rpcUser=utilisateurSe --rpcUserPassword=motDePasseUtilisateurSe
--hostReadPath=/optNew --hostWritePath=/opt --hostWritePath=/home/utilisateurSe
- 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 monHôte.ibm.com --host=hôteContrôleur
--port=portHTTPSContrôleur --user=adminContrôleur --password=motDePasseAdminContrôleur
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.