Application de fichiers de propriétés pour configurer des serveurs à l'aide du gestionnaire de travaux

Dans un environnement de gestion flexible, vous pouvez soumettre le travail Configurer des propriétés pour appliquer des fichiers de propriétés à des serveurs d'applications gérés par le gestionnaire de travaux. Quand vous avez modifié un fichier de propriétés destiné à une cible d'un serveur d'applications géré, utilisez le gestionnaire de travaux pour distribuer ce fichier de propriétés à la cible gérée et appliquer le fichier modifié afin de mettre à jour la configuration du serveur d'applications.

Avant de commencer

Les fichiers de propriétés permettent d'interroger et de modifier la configuration de produit. Les fichiers répertorient les propriétés les plus utilisées sous la forme de paires nom/valeur.

Avant de soumettre un travail afin d'appliquer un fichier de propriétés, exécutez les actions suivantes :

  1. Démarrer le gestionnaire de travaux. Si vous appliquez le fichier de propriétés à une cible du gestionnaire de déploiement, démarrez le gestionnaire de déploiement et le noeud fédéré du gestionnaire de déploiement. Si vous appliquez le fichier de propriétés à une cible de serveur d'applications autonome, démarrez l'agent d'administration. Les cibles doivent être gérées par le gestionnaire de travaux.
  2. Utilisez la commande extractConfigProperties du groupe de commandes PropertiesBasedConfiguration de l'objet AdminTask pour extraire un fichier de propriétés d'un serveur d'applications géré par le gestionnaire de travaux. Vous devez exécuter la commande extractConfigProperties localement ou lancer un script wsadmin qui extrait le fichier de propriétés dans un travail Exécuter un script wsadmin. Le gestionnaire de travaux n'a pas de travail qui extrait spécifiquement un fichier de propriétés.

    Par exemple, supposons que vous souhaitiez extraire la configuration de serveur d'une cible de serveur d'applications dont le nom de serveur est server1 et le profil est AppSrv02. Exécutez les commandes wsadmin suivantes à partir du répertoire bin du profil AppSrv02 :

    wsadmin -lang jython
    
    AdminTask.extractConfigProperties('[-propertiesFileName server.props -configData Server=server1 ]')

    Le produit extrait la configuration de serveur dans un fichier nommé server.props dans le répertoire bin du profil AppSrv02.

  3. Ouvrez le fichier de propriétés avec un éditeur, changez la valeur d'une ou plusieurs propriétés puis sauvegardez le fichier.
    Important : Le fichier de propriétés doit être sauvegardé au format UTF-8. Le fichier généré est automatiquement au format UTF-8. Assurez-vous que le fichier reste au format UTF-8 après les éditions. Utilisez un éditeur qui gère le format UTF-8 ou US-ASCII si le fichier ne contient pas de caractère externe au jeu de caractères US-ASCII à 7 bits.
  4. Copiez le fichier de propriétés dans le répertoire /config/temp/JobManager du profil du gestionnaire de travaux.

    Si le répertoire JobManager n'existe pas, créez le répertoire JobManager dans le répertoire /config/temp du profil du gestionnaire de travaux. Pour créer ce répertoire et y accéder, vous devez disposer des droits appropriés.

    Si le fichier de propriétés existe sur une cible gérée, vous pouvez exécuter le travail Collecter un fichier pour copier le fichier de propriétés de la cible gérée vers le répertoire profil_gestionnaire_travaux/config/temp/JobManager/jeton_travail/nom_cible. Voir la rubrique sur le travail de collecte de fichier.

  5. Exécutez le travail Distribuer un fichier pour distribuer le fichier de propriétés du gestionnaire de travaux vers une ou plusieurs cibles de serveur d'applications. N'oubliez pas les valeurs que vous indiquerez pour le paramètre Destination car vous utiliserez cet emplacement pour le travail qui applique le fichier de propriétés.
    Eviter les incidents Eviter les incidents: Vous devez distribuer le fichier de propriétés aux cibles pour pouvoir exécuter le travail Configurer des propriétés. Le travail de distribution de fichier copie le fichier de propriétés dans le répertoire /config/temp/JobManager du profil du gestionnaire de travaux vers les cibles. Le nom du fichier de propriétés sur les cibles prend la valeur spécifiée pour la destination lors de la distribution du fichier. Voir la rubrique sur le travail de distribution de fichier.gotcha
  6. Si le fichier de propriétés utilise un fichier de mappe de variables, exécutez le travail Distribuer un fichier pour distribuer ce fichier de mappe. N'oubliez pas la valeur indiquée pour le paramètre Destination.

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 soumettez un travail, vous pouvez indiquer un nom d'utilisateur et un mot de passe pour l'authentification et l'autorisation au niveau de la ou des cibles. Lorsque vous soumettez un travail à plusieurs cibles, le nom d'utilisateur et le mot de passe ou les données d'identification de l'émetteur du travail doivent être applicables à toutes les cibles du travail.

Pourquoi et quand exécuter cette tâche

Utilisez la console d'administration du gestionnaire de travaux ou du gestionnaire de déploiement pour soumettre un travail qui applique un fichier de propriétés et configure un serveur d'applications. Dans la console, sélectionnez le travail Configurer des propriétés, indiquez le fichier de propriétés à appliquer, indiquez les options du travail, planifiez le travail, vérifiez le récapitulatif, puis soumettez le travail.

Le travail modifie la configuration du serveur d'applications comme suit :
  • Définit avec la nouvelle valeur l'attribut correspondant à chaque propriété spécifiée dans le fichier de propriétés.
  • Si un attribut correspondant à une propriété spécifiée n'existe pas dans la configuration, crée un attribut dans la configuration.
  • Si un objet de configuration spécifié dans le fichier de propriétés n'existe pas dans la configuration, crée un objet de configuration.

Facultativement, vous pouvez indiquer que le gestionnaire de travaux utilisera les variables définies dans un fichier de mappe de variables lors de l'application du fichier de propriétés. Indiquez l'emplacement d'un fichier de mappe de variables à inclure avec le fichier de propriétés.

Les étapes expliquent comment utiliser la console d'administration du gestionnaire de travaux ou du gestionnaire de déploiement pour soumettre le travail. Au lieu d'utiliser une console, vous pouvez exécuter le travail en exécutant la commande configProperties à partir du groupe de commandes AdministrativeJobs afin de configurer les propriétés de la cible de serveur d'applications. Pour plus d'informations, voir la rubrique relative aux différents types de travaux d'administration.

Le travail de configuration des propriétés utilise la commande applyConfigProperties fournie par le groupe de commandes PropertiesBasedConfiguration pour l'objet AdminTask, afin de configurer les propriétés de la cible.

Procédure

  1. Cliquez sur Travaux > Soumettre dans l'arborescence de navigation de la console d'administration.
  2. Sélectionnez un travail pour appliquer un fichier de propriétés à une ou plusieurs cibles de serveurs d'applications.
    1. Sélectionnez le type de travail Configurer les propriétés dans la liste.
    2. Ajoutez une description pour le travail si vous le souhaitez.
    3. Cliquez sur Suivant.
  3. Pour la cible du travail, sélectionnez les cibles des serveurs d'applications que vous voulez configurer en appliquant le fichier de propriétés.
    1. Sélectionnez Noms cible.
    2. Indiquez les noms des cibles vers lesquelles vous avez précédemment distribué le fichier de propriétés, puis cliquez sur Ajouter, ou cliquez sur Rechercher et indiquez les cibles des serveurs d'applications désirés dans la page Rechercher les cibles.
    3. Cliquez sur Suivant.
    4. Si une authentification de l'utilisateur est requise, spécifiez un nom d'utilisateur ou toute autre valeur d'authentification nécessaire.
    5. Cliquez sur Suivant.
  4. Spécifiez les paramètres du travail de configuration des propriétés.
    1. Indiquez l'emplacement du fichier de propriétés à appliquer.

      L'emplacement du fichier de propriétés correspond à la valeur de destination que vous avez indiquée pour le travail Distribuer un fichier.

    2. Si le fichier de propriétés utilise un fichier de mappe de variables, indiquez l'emplacement de ce fichier de mappe.

      Utilisez la valeur de destination que vous avez indiquée pour le travail Distribuer un fichier.

    3. Cliquez sur Suivant.
  5. Planifiez le travail.

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

    1. Vous pouvez indiquer une ou plusieurs adresses e-mail à notifier lorsque le travail est terminé.

      Si vous indiquez plusieurs adresses e-mail, séparez-les par des virgules. Les adresses e-mail sont enregistrées dans vos préférences de console. Chaque adresse e-mail est validée pour vérifier sa syntaxe.

    2. Sélectionnez le moment où le travail est disponible pour la soumission.

      Vous pouvez soumettre le travail afin qu'il soit disponible maintenant ou vous pouvez indiquer une heure et une date à laquelle il est extrait du gestionnaire de travaux.

    3. Sélectionnez l'expiration du travail.

      L'expiration du travail est le moment auquel le travail ne peut plus être exécuté par les cibles. Vous pouvez utiliser l'expiration par défaut, indiquer une heure et une date d'expiration ou indiquer une durée au bout de laquelle le travail expire. L'expiration par défaut est définie dans la page de configuration du gestionnaire de travaux.

    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

Le gestionnaire de travaux exécute les actions suivantes :

  • Il rend le travail Configurer des propriétés disponible pour les cibles.
  • Il indique l'état du travail sur chaque cible.

Que faire ensuite

Dans la page Etat du travail, cliquez sur l'ID du travail et examinez l'état du travail. 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 échoué, examinez les messages d'erreur issus de l'exécution, corrigez les erreurs indiquées puis soumettez à nouveau le travail.

Si l'état de travail est Abouti, contrôlez l'une des cibles pour vérifier que le fichier de propriétés a bien été appliqué.


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_server_propfile
Nom du fichier : tagt_jobmgr_server_propfile.html