Generating a merged plug-in configuration for Liberty servers using the job manager

Vous pouvez soumettre le travail Générer la configuration de plug-ins fusionnés pour les serveurs à profil Liberty qui permet de créer un fichier plugin-cfg.xml unique et fusionné demandant à un plug-in de serveur Web de réacheminer les requêtes vers plusieurs serveurs d'applications résidant sur plusieurs hôtes. Le travail génère d'abord des fichiers plugin-cfg.xml propres au serveur sur chaque hôte cible. Il fusionne ensuite les fichiers plugin-cfg.xml en un seul fichier plugin-cfg.xml sur l'hôte du gestionnaire de travaux.

Avant de commencer

Démarrez le gestionnaire de travaux et les serveurs du Liberty sur les hôtes cible.

If you need to generate a web server plug-in configuration for a single instance of a Liberty server, see Liberty documentation about configuring Liberty with a web server plug-in.

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.

Ce travail nécessite une connexion JMX (Java™ Management Extensions) aux serveurs Liberty sur les hôtes cible. Pour configurer un serveur Liberty afin qu'il prenne en charge des connexions JMX, ajoutez la fonction de connecteur local ou la fonction de connecteur HTTP/REST à son fichier server.xml. L'exemple suivant montre la fonction de connecteur local et la fonction de connecteur HTTP/REST avec l'élément de gestionnaire de fonctions dans un fichier server.xml :
<featureManager>
  <feature>localConnector-1.0</feature>
  <feature>restConnector-1.0</feature>
  ...
</featureManager>
Lors de la soumission d'un travail, si un ou plusieurs serveurs à Liberty incluent uniquement la fonction de connecteur HTTP/REST, vous devez indiquer le nom d'utilisateur et le mot de passe d'un administrateur de serveur à Liberty. Le gestionnaire de travaux utilise ces données d'identification lors de l'établissement d'une connexion JMX aux serveurs. Si tous les serveurs incluent la fonction de connecteur local, il n'est pas nécessaire d'indiquer un nom d'utilisateur et un mot de passe.

For more information about defining server administrators, see "Mapping the administrator role for Liberty."

Un serveur Liberty nécessite un kit JDK (Java Development Kit) ou un environnement JRE (Java Runtime Environment) pour pouvoir exécuter ce travail. Définissez l'emplacement de JDK ou JRE en procédant comme suit :
  • Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE dans le fichier server.env. The job reads the JAVA_HOME property and sets it on the target environment before running the command to generate a plugin-cfg.xml file for the Liberty server.
  • [AIX][HP-UX][Linux][Solaris][z/OS]Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE dans le fichier .bashrc de l'utilisateur.
  • [AIX][HP-UX][Linux][Solaris][z/OS]Ajoutez le chemin JDK ou JRE à la variable d'environnement PATH.
  • [Windows]Définissez la propriété JAVA_HOME sur l'emplacement JDK ou JRE en tant que variable d'environnement système.
  • [Windows]Ajoutez le chemin JDK ou JRE à la variable système PATH.

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 générer un fichier plugin-cfg.xml unique fusionné qui demande à un plug-in de serveur Web de réacheminer les requêtes vers plusieurs serveurs à Liberty résidant sur plusieurs hôtes. From the console, choose the Generate merged plugin configuration for Liberty servers job, specify the servers and job options, review the summary, and submit the job.

Les étapes expliquent comment exécuter le travail Générer la configuration de plug-ins fusionnés pour les serveurs à profil Liberty à l'aide de la console du gestionnaire de travaux ou du gestionnaire de déploiement. Au lieu d'utiliser une console, vous pouvez exécuter le script du travail generateMergedPluginConfigForLibertyProfileServers dans le groupe de commandes AdministrativeJobs. Pour plus d'informations, voir la rubrique relative aux différents types de travaux d'administration.

Procédure

  1. Cliquez sur Travaux > Soumettre dans l'arborescence de navigation de la console d'administration.
  2. Sélectionnez un travail permettant de générer une configuration de plug-in de serveur Web fusionnés pour plusieurs serveurs à Liberty.
    1. Sélectionnez le travail de type Générer la configuration de plug-ins fusionnés pour les serveurs à profil Liberty dans la liste.
    2. Vous pouvez indiquer une description pour le travail.
    3. Cliquez sur Suivant.
  3. Choisissez les cibles du travail.
    1. 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.

    2. 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.
    3. 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.
    4. Cliquez sur Suivant.
  4. Indiquez les paramètres du travail Générer la configuration de plug-ins fusionnés pour les serveurs à profil Liberty.
    1. Pour Serveur(s), indiquez le nom de la ressource ou l'ID ressource qualifié d'un serveur ou encore un masque permettant d'identifier un ou plusieurs serveurs.

      Si un nom de serveur correspond à plusieurs serveurs de même nom, le produit renvoie une erreur et ne génère pas le fichier plugin-cfg.xml.

      Par exemple, supposons que vous souhaitiez spécifier defaultServer pour le serveur. Vous pouvez indiquer l'une des valeurs suivantes pour identifier la ressource du serveur :

      Nom de la ressource
      defaultServer
      ID ressource qualifié
      runtime/wlp/liberty_server/defaultServer
      Masque du nom de ressource
      *Serveur
      Masque de l'ID ressource qualifié
      runtime/wlp/liberty_server/*

      Pour afficher les noms des serveurs à Liberty existants sur les cibles, cliquez sur Rechercher dans la pagede Spécification des paramètres du travail. Dans la page Rechercher les ressources cible, cliquez sur Rechercher pour trouver un identificateur de serveur à Liberty existant sur tous les hôtes cible. Sélectionnez l'ID ressource du serveur pour lequel générer une configuration de plug-in de serveur Web fusionnés.

    2. Si un ou plusieurs serveurs incluent uniquement la fonction de connecteur HTTP/REST (restConnector), pour Nom d'utilisateur, indiquez le nom d'utilisateur d'un administrateur de serveur à Liberty. Le gestionnaire de travaux utilise cette valeur lors de l'établissement d'une connexion JMX aux serveurs.
    3. Si un ou plusieurs serveurs incluent uniquement la fonction de connecteur HTTP/REST (restConnector), pour Mot de passe, indiquez le mot de passe d'un administrateur de serveur à Liberty. Le gestionnaire de travaux utilise cette valeur lors de l'établissement d'une connexion JMX aux serveurs.
    4. Cliquez sur Suivant.
  5. Planifiez le travail.

    Les heures et dates que vous indiquez sont relatives au gestionnaire de travaux.

    1. 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.

    2. Sélectionnez le moment où le travail est disponible pour la soumission.
    3. Sélectionnez l'expiration du travail.
    4. 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.
    5. Cliquez sur Suivant.
  6. Vérifiez le récapitulatif et cliquez sur Terminer pour soumettre le travail.

Résultats

Des fichiers plugin-cfg.xml propres au serveur sont générés sur chaque hôte cible. Le gestionnaire de travaux les fusionne ensuite en un fichier plugin-cfg.xml unique et fusionné sur l'hôte du gestionnaire de travaux.

Que faire ensuite

Dans la page Etat du travail, cliquez sur l'ID du travail Générer la configuration de plug-ins fusionnés pour les serveurs à profil Liberty et examinez son état. Cliquez sur l'icône de régénération d'état Spécifie l'icône de la vue de régénération de l'état d'un travail pour régénérer l'état affiché.

Si le travail a abouti, le produit écrit le fichier plugin-cfg.xml fusionné dans le répertoire racine_serveur_app/profiles/profil_gestionnaire_travaux/config/temp/JobManager/ID_travail/_mergedPluginDir/.

Si le travail échoue, il s'arrête et le produit retourne une erreur chaque fois que l'une des conditions suivantes est vérifiée :
  • Un serveur Liberty ciblé n'est pas en cours d'exécution.
  • Aucun connecteur JMX n'est configuré pour un serveur à Liberty ciblé.
  • Les propriétés du travail n'indiquent pas de données d'identification d'administrateur de serveur valides permettant l'établissement d'une connexion JMX avec un serveur à Liberty qui inclut uniquement la fonction HTTP/REST (restConnector).
Consultez les messages d'erreur issus de l'exécution du travail, corrigez les erreurs indiquées puis soumettez à nouveau le travail.

Icône indiquant le type de rubrique Rubrique de tâche



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=tagt_jobmgr_liberty_plugin_merge
Nom du fichier : tagt_jobmgr_liberty_plugin_merge.html