You can use the Install Liberty profile job to remotely install
the resources in multiple-host Liberty server
environments. Les ressources, qui doivent être stockées dans un ou plusieurs fichiers compressés (.zip) avant l'installation, sont extraites par le gestionnaire de travaux en direction des répertoires de destination associés à un répertoire racine spécifié.
Avant de commencer
Avant d'exécuter le travail Installer les ressources de profil Liberty, les conditions suivantes doivent exister :
- Le gestionnaire de travaux doit être en cours d'exécution.
- Au moins un ordinateur hôte cible doit être enregistré auprès du gestionnaire de travaux.
- Le fichier compressé (.zip) doit contenir les ressources du Liberty dans une structure de répertoire conforme aux règles du gestionnaire de travaux. Voir Conditionnement des ressources du Liberty.
- Le répertoire racine pour l'installation des ressources sur les hôtes cible doit être défini. Avant de tenter d'installer les ressources de travail, définissez la variable WebSphere WLP_WORKING_DIR sur un chemin de répertoire valide pour les hôtes cible. De même, avant de tenter d'installer les ressources partagées, définissez la variable WebSphere WLP_SHARED_DIR sur un chemin de répertoire valide. Vous pouvez définir des valeurs par défaut globales pour ces variables et remplacer les valeurs présentes sur des hôtes spécifiques si nécessaire. See "Setting variables
for Liberty servers."
Votre ID au niveau du gestionnaire de travaux doit disposer des droits du rôle administrateur ou du rôle opérateur pour soumettre des travaux.
Lorsque vous enregistrez un hôte cible auprès du gestionnaire de travaux, vous pouvez sauvegarder les informations de sécurité du système d'exploitation. Lorsque vous soumettez un travail à une ou plusieurs cibles pour lesquelles les informations de sécurité n'ont pas été sauvegardées, vous devez spécifier un nom d'utilisateur de système d'exploitation autorisé et un mot de passe ou les informations de clé privée-publique pour ce nom d'utilisateur. Les informations de droits d'accès de sécurité doivent être valides pour toutes les cibles des travaux.
Status from Liberty servers is automatically sent to the STATUS_LISTENER_ADDRESS port. Pour modifier le numéro de port de
STATUS_LISTENER_ADDRESS, utilisez la page Ports d'une console du gestionnaire de déploiement () ou d'une console du gestionnaire de travaux (). If you change the STATUS_LISTENER_ADDRESS port number after installing Liberty
server resources, you will no longer receive automatic status from the previously installed Liberty
resources.
Pourquoi et quand exécuter cette tâche
Vous pouvez utiliser la console d'administration du gestionnaire de travaux ou du gestionnaire de déploiement
pour installer les ressources du Liberty sur une ou plusieurs cibles hôte. Depuis la console, choisissez le travail Installer les ressources de profil Liberty, spécifiez l'emplacement du fichier compressé et d'autres options de travail, vérifiez le récapitulatif et soumettez le travail.
Au lieu d'utiliser une console, vous pouvez exécuter le script du travail installLibertyProfileResources dans le groupe de commandes
AdministrativeJobs. Pour plus d'informations, voir la rubrique relative aux différents types de travaux d'administration.
Procédure
- Cliquez sur dans l'arborescence de navigation de la console
d'administration.
- Choisissez un travail pour installer les ressources du Liberty.
- Sélectionnez le type de travail Installer les ressources de profil Liberty dans la liste.
- Vous pouvez indiquer une description pour le travail.
- Cliquez sur Suivant.
- Choisissez les cibles sur lesquelles vous voulez ajouter les ressources Liberty.
- Sélectionnez un groupe de cibles dans la liste ou sélectionnez Noms cible.
Seuls les groupes de cibles valides pour le type de travail sélectionné sont affichés
dans la liste des groupes de cibles.
- Si vous avez sélectionné Noms cible, entrez un nom de cible et cliquez sur Ajouter, ou cliquez sur Rechercher, puis indiquez les cibles choisies
dans la page Rechercher des cibles.
- Si vous n'avez pas choisi de sauvegarder les informations d'authentification de sécurité lors de l'enregistrement des hôtes cible auprès du gestionnaire de travaux, indiquez un nom d'utilisateur de système d'exploitation et le mot de passe correspondant ou les informations de clé privée-publique pour l'accès aux hôtes cible. Les informations de droits d'accès de sécurité doivent être valides pour toutes les cibles des travaux.
- Cliquez sur Suivant.
- Indiquez les paramètres pour le travail d'installation des ressources du Liberty.
- If the compressed file that contains the Liberty
resources resides on the job manager server, for Path of the Liberty profile resources
compressed file, specify the full path name for the compressed
(.zip) file.
Si le fichier compressé ne se trouve pas sur le serveur de gestionnaire de travaux, ignorez cette étape et spécifiez un chemin d'accès à l'URL du fichier compressé.
Par exemple, supposons que les ressources Liberty existent dans le fichier compressé /resources/my_liberty_server.zip. Spécifiez le nom du chemin d'accès complet au fichier compressé :
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
/resources/my_liberty_server.zip
![[Windows]](../images/windows.gif)
c:/resources/my_liberty_server.zip
- If the compressed file that contains the Liberty
resources does not reside on the job manager server, for URL path of the Liberty profile
resources compressed file, specify the URL path for the compressed file.
Les noms de schéma pris en charge pour l'URL (universal resource locator) incluent http, https, ftp et file.
Restriction : Pour utiliser URL du fichier zip des ressources de profil Liberty avec un protocole autre que fichier, l'hôte cible doit posséder un utilitaire wget. Sélectionnez un protocole de téléchargement distant http, https ou ftp pris en charge par l'utilitaire wget sur l'hôte cible. Si l'utilitaire wget ne prend pas en charge le protocole sélectionné, le travail ne peut pas installer les ressources.
Par exemple, spécifiez l'une des adresses URL suivantes pour le fichier de ressources du Liberty, my_liberty_server.zip.
Si les ressources du Liberty se trouvent sur un serveur HTTP ou HTTPS :
http://www.mycompany.com/resources/my_liberty_server.zip
https://www.mycompany.com/resources/my_liberty_server.zip
Si les ressources du Liberty se trouvent sur un serveur FTP :
ftp://www.mycompany.com/resources/my_liberty_server.zip
Si les ressources du Liberty se trouvent sur l'ordinateur de l'hôte cible, l'URL peut utiliser le schéma de fichier pour décrire le chemin et le nom du fichier compressé :
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
file:///resources/my_liberty_server.zip
![[Windows]](../images/windows.gif)
file://c:/resources/my_liberty_server.zip
- Si le fichier compressé qui contient les ressources du Liberty ne se trouve pas sur le serveur du gestionnaire de travaux et que l'URL est protégée par mot de passe, indiquez un nom d'utilisateur et un mot de passe.
- Pour Nom d'utilisateur requis pour accéder à l'URL, indiquez un nom d'utilisateur pouvant accéder à l'URL indiquée pour l'étape 4(b).
- Pour Mot de passe requis pour accéder à l'URL et Confirmation du mot de passe, indiquez un mot de passe permettant à l'utilisateur d'accéder à l'URL.
- Pour installer les ressources du Liberty pouvant être partagées par les serveurs, sélectionnez Installer dans un emplacement partagé.
Par défaut, cette option n'est pas sélectionnée et le travail installe les ressources dans l'emplacement défini par la variable WebSphere WLP_WORKING_DIR. Lorsque cette option est sélectionnée, le travail installe les ressources dans l'emplacement défini par la variable WebSphere WLP_SHARED_DIR.
- Pour exécuter les scripts iSeries en option qui autorisent l'installation de Liberty et de ses serveurs imbriqués, sélectionnez Exécuter des scripts d'installation facultatifs sur les cibles IBM i.
Une fois la sélection effectuée, la commande suivante est exécutée pour chaque
Liberty que le gestionnaire de travaux installe sur les cibles IBM i :
liberty_home/bin/iAdmin POSTINSTALL
Lors de l'installation d'un ou de plusieurs serveur dans une topologie partagée, la commande suivante est exécutée :
liberty_home_of_server/bin/iAdmin GRANTAUTH --rolename server
--userprofilename QEJBSVR --userdir racine_serveur
racine_serveur est le grand-parent du répertoire de serveur. Par exemple, si le serveur est installé dans le répertoire
/usr/servers/myserver,
racine_serveur est
/usr et la commande est la suivante :
liberty_home_of_server/bin/iAdmin GRANTAUTH --rolename server
--userprofilename QEJBSVR --userdir /usr
Lors de la désinstallation d'une installation
Liberty,
la commande suivante est exécutée sur les cibles IBM i :
liberty_home/bin/iAdmin PREUNINSTALL
- Cliquez sur Suivant.
- Planifiez le travail.
Les heures et dates que vous indiquez
sont relatives au gestionnaire de travaux.
- Vous pouvez éventuellement indiquer une ou plusieurs adresses e-mail à notifier
lorsque le travail est terminé.
Si vous indiquez plusieurs adresses e-mail, séparez-les avec une virgule.
- Sélectionnez le moment où le travail est disponible pour la soumission.
- Sélectionnez l'expiration du travail.
- Vous pouvez également définir un intervalle de récurrence pour le travail ainsi qu'une heure et une date de démarrage et
d'arrêt pour l'intervalle.
- Cliquez sur Suivant.
- Vérifiez le récapitulatif et cliquez sur Terminer pour soumettre le travail.
Résultats
Le serveur de gestionnaire de travaux exécute le travail et tente d'ajouter les ressources du Liberty aux hôtes cible.
Le travail extrait l'image sur un hôte cible en essayant les méthodes suivantes dans cet ordre :
- Utilisez l'utilitaire unzip sur l'hôte.
- Utilisez l'utilitaire jar sur l'hôte, parmi lesquels l'utilitaire jar d'un kit de développement de logiciels (SDK) trouvé par un travail d'inventaire.
Utilisez l'utilitaire unzip qui est copié sur l'hôte distant pendant la durée du travail, s'il n'est pas spécifiquement désactivé par l'administrateur. L'utilitaire unzip est supprimé une fois le travail terminé.
- Décompressez le fichier zip sur le gestionnaire de travaux et copiez les fichiers les uns après les autres sur l'hôte de destination. Cette méthode s'applique uniquement si l'image se trouve sur le gestionnaire de travaux.
Que faire ensuite
Dans la page Etat du travail, cliquez sur l'ID du travail d'installation des ressources du Liberty et examinez son état. Cliquez sur l'icône de régénération d'état
pour régénérer l'état affiché.
Si le travail a échoué, examinez les messages d'erreur issus de l'exécution, corrigez les erreurs indiquées puis soumettez à nouveau le travail.
Eviter les incidents: Si le travail échoue avec le message
Undefined
variable WLP_WORKING_DIR, cliquez sur , sélectionnez la portée et cliquez sur
Nouveau. Créez une variable sous le nom
WLP_WORKING_DIR et une valeur indiquant le chemin de répertoire dans lequel installer les ressources du
Liberty (par exemple,
/liberty/working). Si le travail échoue en affichant le message
Undefined
variable WLP_SHARED_DIR, créez une variable sous le nom
WLP_SHARED_DIR et indiquez un chemin de répertoire dans lequel installer les ressources partagées du
Liberty (par exemple,
/liberty/shared). Soumettez ensuite à nouveau le travail.
gotcha
Si le travail a abouti, cliquez sur pour voir les ressources Liberty dans la liste de ressources.