Vous pouvez utiliser l'outil Déployer pour installer des fichiers (archive) de package serveur de profil Liberty sur des hôtes d'une collectivité. Utilisez ensuite l'outil Explorer pour gérer les serveurs.
Avant de commencer
- La fonction
du Centre d'administration doit être
installée et configurée sur un serveur de profil Liberty qui inclut
également la fonction de contrôleur de collectivité et toute la
configuration de sécurité requise.
Pour créer une collectivité de profil Liberty incluant les hôtes sur lesquels vous comptez déployer l'installation du profil Liberty, consultez les rubriques suivantes :
- Configuration
d'une collectivité Liberty -- Pour activer la fonction
du Centre d'administration sur le
contrôleur de collectivité, le fichier
server.xml du contrôleur de collectivité doit
inclure
<feature>adminCenter-1.0</feature> dans
la configuration du gestionnaire de fonctions. Par ailleurs, le fichier server.xml doit définir une valeur host dans l'élément httpEndpoint ;
par exemple, ajoutez host="*" afin que tous les hôtes puissent accéder au contrôleur de collectivité.
- Enregistrement des ordinateurs hôte auprès d'une collectivité Liberty -- La commande registerHost doit inclure un paramètre hostWritePath définissant le chemin sur lequel vous désirez déployer un package serveur. Vous spécifiez ce même chemin pour Répertoire cible lorsque vous utilisez l'outil Déployer. Si un hôte est déjà enregistré, vous pouvez utiliser la commande updateHost afin de réinitialiser les informations hostWritePath.
Chaque hôte doit inclure une prise en charge Java pour l'utilitaire jar et, éventuellement, un utilitaire unzip, dans l'environnement
(chemin) de l'utilisateur RPC (Remote Procedure Call) spécifié lors de l'enregistrement de l'hôte.
- L'environnement de profil Liberty que vous comptez déployer doit être compressé dans un package serveur au format ZIP, JAR ou PAX. Le package serveur doit se conformer aux exigences suivantes :
- Le package serveur inclut, au minimum, un environnement d'exécution de profil Liberty et un serveur. Il peut inclure d'autres ressources, comme une application Web s'exécutant sur le serveur.
- Le répertoire de premier niveau dans le package serveur doit être wlp et contenir les répertoires standard de profil
Liberty (bin, clients, dev, lafiles, lib, templates, usr).
Le répertoire usr doit résider à l'emplacement par défaut et tous les serveurs doivent utiliser le répertoire de sortie par défaut.
- Les serveurs inclus ne doivent pas contenir de paramètres de configuration d'appartenance à la collectivité ou des fichiers de clés.
Les outils disponibles pour la constitution d'archives sont les suivants :
Vous devrez peut-être personnaliser l'installation (par exemple, en modifiant les numéros de port, les connexions de base de données ou les connexions du système de messagerie).
Pourquoi et quand exécuter cette tâche
Après avoir défini la collectivité de profil Liberty et créé le package serveur, utilisez l'outil de déploiement pour installer ce package
sur les hôtes de la collectivité.
Reportez-vous à Exemple : Configuration d'un contrôleur de collectivité, enregistrement d'un hôte, création d'un package serveur et déploiement de ce package pour un exemple de déploiement d'un package serveur sur l'ordinateur d'un hôte local Windows.
Procédure
- Accédez à l'outil Déployer.
- Dans la boîte à outils, sélectionnez
.
- Pour des informations détaillées sur les hôtes dans l'outil Explorer, sélectionnez .
Pour lancer directement l'outil de déploiement à l'avenir, vous
pouvez utiliser l'URL qui est affichée dans le navigateur lors de l'affichage de cet outil.
- Pour Hôtes cible, sélectionnez les ordinateurs hôtes sur lesquels installer le package serveur. Transférez les hôtes cible de la zone Hôtes disponibles vers la zone Hôtes sélectionnés.
Chaque hôte cible doit être enregistré auprès de la collectivité gérée par le Centre d'administration. Voir Enregistrement des ordinateurs hôte auprès d'une collectivité Liberty.
- Pour Package serveur, indiquez si un fichier de package serveur doit être téléchargé ou si un fichier de package serveur sur un contrôleur de collectivité doit être utilisé. Spécifiez alors le chemin du fichier.
- Pour Répertoire cible, spécifiez un répertoire cible pour l'installation du profil Liberty. Si le répertoire existe, il doit être vide. S'il n'existe pas, le produit le crée dans la mesure où les droits d'accès au système de fichiers le permettent.
Pour les formats ZIP ou JAR de package serveur, indiquez le répertoire d'installation. Par
exemple, indiquez /home/user1/liberty pour le produit afin de télécharger
le package serveur dans /home/user1 et
le décompresser dans le répertoire liberty.
Pour les formats PAX de package serveur, indiquez le répertoire d'installation et l nom de fichier PAX. Par exemple, indiquez /home/user1/liberty/nom_package.pax pour
produit afin de développer l'archive dans
le répertoire /home/user1/liberty/package_name.pax.
L'utilisateur RPC de chaque hôte cible doit disposer de droits d'accès en lecture et écriture sur le parent du répertoire d'installation.
- Pour Mot de passe du magasin de clés, spécifiez un mot de passe pour protéger les nouveaux fichiers de magasin de clés générés contenant des données d'authentification au serveur. Le même mot de passe est utilisé pour tous les serveurs déployés.
Le produit génère des fichiers de clés dans le répertoire resources de chaque serveur déployé.
- Pour Données d'identification pour la gestion à distance,
indiquez comment le contrôleur de collectivité va se connecter à chaque hôte cible
afin de gérer à distance les serveurs déployés.
- Pour Mot de passe, spécifiez le mot de
passe que vous avez utilisé pour vous connecter au Centre d'administration. L'opération d'ajout des serveurs déployés à la collectivité est effectuée avec votre nom d'administrateur et votre mot de passe Liberty.
- Sélectionnez Déployer.
Résultats
L'action Déployer s'exécute. Sélectionnez
sur un ordinateur ou une tablette, ou
sur un smartphone, pour déterminer le statut du déploiement.
Exemple : Configuration d'un contrôleur de collectivité, enregistrement d'un hôte, création d'un
package serveur et déploiement de ce package
Cet exemple décrit comment installer un package serveur de profil
Liberty sur un hôte Windows d'une collectivité à l'aide de l'outil Déployer.
Configurez un contrôleur de collectivité, enregistrez un hôte auprès de ce contrôleur et constituez un package du serveur avant d'utiliser l'outil de déploiement.
- Créez un contrôleur de collectivité qui utilise le
Centre d'administration et
démarrez le contrôleur de collectivité.
- Créez un serveur. Cet exemple nomme le serveur myController.
wlp/bin/server create myController
- Créez un contrôleur de collectivité.
wlp/bin/collective create myController --keystorePassword=myControllerPwd
- Ouvrez le fichier server.xml de myController dans un éditeur et apportez-lui les modifications suivantes :
- Ajoutez la configuration de contrôleur de collectivité générée au fichier server.xml de myController.
Par exemple, copiez la sortie de la commande de collectivité et collez-la après l'élément
httpEndpoint et avant </server>, la dernière balise du fichier server.xml.
- Ajoutez la fonction adminCenter-1.0 au gestionnaire de fonctions.
<featureManager>
<feature>jsp-2.2</feature>
<feature>adminCenter-1.0</feature>
</featureManager>
- Ajoutez une valeur host à l'élément httpEndpoint
du fichier myController server.xml. Par exemple, ajoutez host="*" afin que tous les hôtes puissent accéder au contrôleur.
<!-- To access this server from a remote client add a host
attribute to the following element, e.g. host="*" -->
<httpEndpoint id="defaultHttpEndpoint"
host="*"
httpPort="9080"
httpsPort="9443" />
- Spécifiez des valeurs pour userName et userPassword.
<quickStartSecurity userName="admin" userPassword="adminpwd" />
Conseil : Si des noms d'utilisateur ou des mots de passe comportent des caractères non anglais,
créez le fichier
jvm.options pour le serveur et définissez le codage client
par défaut sur UTF-8 :
-Ddefault.client.encoding=UTF-8
Si
le registre d'utilisateurs figure dans les éléments
quickStartSecurity ou
basicRegistry,
qui stockent les noms et les mots de passe dans le fichier
server.xml,
sauvegardez le fichier
server.xml en UTF-8.
Pour plus d'informations
sur le fchier
jvm.options,
voir
Personnalisation de l'environnement du profil Liberty.
- Démarrez le contrôleur.
wlp/bin/server start myController
- Lancez la commande registerHost pour enregistrer un ordinateur hôte auprès du contrôleur de collectivité.
Dans cet exemple, le contrôleur de collectivité opère sur l'ordinateur 'localhost', dont le nom d'hôte est winHost. L'ordinateur opérant sous système d'exploitation Windows, lequel ne prend pas en charge SSH, la commande doit spécifier un utilisateur et un mot de passe RPC.
wlp/bin/collective registerHost winHost --host=localhost --port=9443 --user=admin --password=adminpwd --rpcUser=myWindowsLoginID --rpcUserPassword=myWindowsLoginPwd --hostWritePath=c:\wlp_example
La commande effectue les actions suivantes :
- Elle enregistre l'ordinateur localhost auprès du contrôleur de collectivité.
- Pour user et password, elle spécifie les valeurs
userName et userPassword définies dans le fichier myController server.xml de myController.
- Elle spécifie l'utilisateur se connectant au système d'exploitation à rpcUser et le mot de passe correspondant à rpcUserPassword.
- Elle définit hostWritePath d'après le chemin de répertoire sur lequel l'outil Déployer installe le package serveur.
A l'invite, entrez O pour accepter la chaîne de certificats.
Si vous désirez par la suite modifier ces paramètres, vous pouvez utiliser la commande collective updateHost.
- Créez un package serveur pour son installation à l'ide de l'outil Déployer.
- Si vous ne disposez pas d'un serveur existant pour lequel créer un package, exécutez la commande create pour créer un nouveau serveur.
wlp/bin/server create server1
- Si vous disposez déjà d'un serveur existant pour lequel créer un package, vérifiez que ce serveur est bien arrêté.
- Exécutez la commande package pour créer le package serveur.
wlp/bin/server package server1
La commande crée un
package serveur nommé, par exemple, C:\wlp\usr\servers\server1\server1.zip.
- Installez le package serveur à l'aide de l'outil de déploiement.
- Lancez l'outil Déployer depuis la boîte à outils ou depuis la page d'hôte de l'outil Explorer. Voir Connexion au Centre d'administration
- Pour Hôtes cible, déplacez l'hôte cible winHost depuis la zone Hôtes disponibles vers la zone Hôtes sélectionnés.
- Pour Package serveur, indiquez d'utiliser un fichier de package serveur sur un contrôleur de collectivité. Spécifiez ensuite le chemin du fichier, C:\wlp\usr\servers\server1\server1.zip.
- Pour Répertoire cible, spécifiez le répertoire défini pour hostWritePath dans la commande registerHost, à savoir c:\wlp_example\member.
- Pour Mot de passe du magasin de clés, spécifiez un mot de passe pour protéger les nouveaux fichiers de magasin de clés générés contenant des données d'authentification au serveur. Le même mot de passe est utilisé pour tous les serveurs déployés. Par exemple, spécifiez serverpwd.
- Pour Données d'identification pour la gestion à distance,
indiquez comment le contrôleur de collectivité va obtenir les données d'identification pour
la connexion au système d'exploitation hôte
afin de gérer à distance les serveurs déployés. Pour cet exemple
qui utilise un ordinateur hôte, vous avez deux possibilités. Vous pouvez choisir Utiliser la méthode et les
identifiants de connexion configurés pour chaque hôte cible car
l'hôte cible est enregistré auprès du contrôleur de collectivité. Ou bien, vous ,
pouvez choisir Utiliser le nom d'utilisateur et le mot de passe du système d'exploitation suivant sur chaque hôte cible et
indiquer le nom d'utilisateur et le mot de passe connexion au système d'exploitation.
- Pour Mot de passe, spécifiez le mot de
passe que vous avez utilisé pour vous connecter au Centre d'administration.
- Sélectionnez Déployer.
Que faire ensuite
Pour déterminer le statut du déploiement sur un ordinateur ou une tablette, cliquez sur
sur la barre de titre.
Pour visualiser le statut sur un
smartphone, cliquez sur
.
Sur la page Tâches d'arrière-plan, vous pouvez
consulter un récapitulatif de toutes les tâches d'arrière-plan en cours d'exécution et accéder à un historique détaillé des tâches d'arrière-plan en exécution, arrêtées et terminées. Voir Surveillance des tâches en arrière-plan