Dans un environnement de gestion flexible, vous pouvez soumettre le travail Distribuer un fichier pour copier des fichiers sur les cibles gérées du gestionnaire de travaux.
Quand vous voulez soumettre des travaux utilisant des fichiers, vous devez préalablement distribuer ces fichiers aux noeuds concernés. Par exemple, vous devez distribuer une application d'entreprise avant d'installer ou de mettre à jour cette application sur les cibles des serveurs d'applications gérés. De même, vous devez distribuer un fichier de propriétés aux cibles des serveurs d'applications gérés avant de pouvoir appliquer ce fichier afin de configurer les serveurs d'applications.
Avant de commencer
Démarrer le gestionnaire de travaux. Vérifiez que les cibles sur lesquelles vous voulez copier un fichier sont enregistrés sur le gestionnaire de travaux.
- Pour enregistrer un serveur d'applications autonome sur le gestionnaire de travaux, utilisez d'abord la commande registerNode d'agent d'administration pour enregistrer le serveur d'applications autonome auprès de l'agent d'administration.
Utilisez ensuite la console de l'agent d'administration ou la commande registerWithJobManager pour enregistrer la cible de serveur d'applications autonome auprès du gestionnaire de travaux.
- Pour enregistrer un gestionnaire de déploiement sur le gestionnaire de travaux, utilisez la console du gestionnaire de déploiement ou la commande registerWithJobManager.
Si vous collectez un fichier sur un hôte, vous devez d'abord enregistrer l'hôte
auprès du gestionnaire de travaux.
Démarrer les cibles. Si une cible est un serveur d'applications autonome, démarrez aussi l'agent d'administration.
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 s'appliquer à toutes les cibles du travail.
Vous pouvez simplifier l'administration d'un grand nombre de cibles en soumettant des travaux à des groupes de cibles. Pour pouvoir soumettre un travail à un groupe de cibles, vous devez
avoir créé ce groupe de cibles.
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 soumettre un travail qui
transfère un fichier vers des cibles.
Dans la console, sélectionnez le travail
Distribuer un fichier, indiquez le fichier à transférer, indiquez les options du travail,
planifiez le travail, vérifiez le récapitulatif, puis soumettez le travail. Quand le travail s'exécute, le gestionnaire
de travaux copie le fichier dans le répertoire downloadedContent du profil de l'agent
d'administration ou du profil du gestionnaire de déploiement.
Vous devez
distribuer un fichier avant d'exécuter les travaux suivants :
- Installation de l'application
- Mise à jour de l'application
- Configuration des propriétés
- Exécution d'un script wsadmin
Ces étapes expliquent comment exécuter le travail Distribuer
un fichier à l'aide de la console du gestionnaire de travaux ou de la console
du gestionnaire de déploiement. Au lieu d'utiliser une console, vous pouvez exécuter le script du travail distributeFile à
partir du groupe de commandes AdministrativeJobs afin de distribuer un fichier à des cibles.
Pour plus d'informations, voir la rubrique relative aux différents types de travaux d'administration.
Eviter les incidents: Le travail de distribution de fichiers ne peut transférer des fichiers qu'à
l'environnement QShell. Les fichiers sont transférés en mode binaire ; par conséquent, il n'y a pas de
conversion des jeux de caractères ou de l'encodage durant le transfert.
gotcha
Eviter les incidents: Le travail de distribution de fichiers ne peut transférer que des fichiers accessibles depuis
le shell z/OS UNIX. Les fichiers sont transférés en mode binaire ; par conséquent, il n'y a pas de
conversion des jeux de caractères ou de l'encodage durant le transfert.
gotcha
Procédure
- Copiez le fichier à distribuer 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.
Par exemple, créez le fichier DynaCacheEsi.ear situé dans le répertoire racine_serveur_app /installableApps vers le répertoire
/config/temp/JobManager du profil du gestionnaire de travaux.
- Cliquez sur dans l'arborescence de navigation de la console
d'administration.
- Choisissez un travail pour distribuer un fichier.
- Sélectionnez le type de travail Distribuer un fichier dans la liste.
- Ajoutez une description pour le travail si vous le souhaitez.
- Cliquez sur Suivant.
- Sélectionnez les cibles auxquelles vous voulez distribuer le fichier.
- 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.
La cible peut être un hôte.
Si
les cibles sont des serveurs d'applications autonomes gérés
par un agent d'administration, vous pouvez sélectionner une seule cible autonome
au lieu de sélectionner toutes les cibles autonomes. Toutes les cibles
peuvent utiliser le fichier distribué dans le répertoire downloadedContent
de l'agent d'administration.
- Si une authentification de l'utilisateur est requise, spécifiez un nom d'utilisateur ou toute autre valeur d'authentification nécessaire.
- Cliquez sur Suivant.
- Spécifiez les paramètres du travail de distribution de fichier.
- Dans la zone Source, indiquez l'adresse URL du fichier que vous voulez distribuer.
L'emplacement du fournisseur de distribution par défaut est une adresse URL de fichier relative au répertoire
config/temp/JobManager du profil du gestionnaire de travaux.
Pour le fichier DynaCacheEsi.ear, indiquez ce qui suit :- Noeud :
file://DynaCacheEsi.ear
- Hôte :
DynaCacheEsi.ear
Vous pouvez spécifier des fichiers sur les hôtes en utilisant des caractères génériques. Les caractères acceptés sont (*) et (?).
- L'astérisque (*)
remplace plusieurs caractères inconnus ou variables dans le terme.
- Le point d'interrogation (?) remplace un caractère unique inconnu ou variable
dans le terme.
- Pour la zone Destination, indiquez l'emplacement de la cible sur laquelle le gestionnaire de travaux stocke le ficher. Le paramètre de destination est
relatif au répertoire downloadedContent du profil du gestionnaire de déploiement ou de l'agent d'administration.
N'oubliez pas la valeur indiquée pour le fichier. Si vous exécutez ultérieurement un travail qui référence ce fichier, indiquez la valeur de destination pour l'identifier.
Pour le fichier DynaCacheEsi.ear, indiquez une valeur qui identifie le fichier. Exemple :dynacache_esi_sample
Pour les hôtes, il n'existe pas de
restriction. Spécifiez un chemin absolu. Le chemin doit être un répertoire.
Par exemple :
/home/userA
- Pour la zone Fournisseur de la distribution, si vous utilisez un fournisseur de distribution différent du fournisseur par défaut, indiquez le nom de ce fournisseur de distribution. Dans l'exemple de DynaCacheEsi.ear, n'indiquez pas de valeur mais utilisez le fournisseur de distribution par défaut.
- 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. 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.
- 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.
- 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 sur le panneau de configuration
du gestionnaire de travaux.
- 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 gestionnaire de travaux copie le fichier dans le répertoire
downloadedContent du profil de l'agent d'administration ou du gestionnaire de déploiement. Le nom du fichier est la
destination.
Dans l'exemple du fichier DynaCacheEsi.ear, un fichier nommé dynacache_esi_sample est copié dans le répertoire downloadedContent.
Que faire ensuite
Dans la page Etat du travail, cliquez sur l'ID du travail de distribution de fichier et examinez l'état du travail. 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.
Si le gestionnaire de travaux parvient à copier le fichier sur les cibles, soumettez les travaux qui utilisent le fichier distribué :
- Installation de l'application
- Mise à jour de l'application
- Configuration des propriétés
- Exécution d'un script wsadmin
- Suppression d'un fichier
Dans l'exemple du fichier DynaCacheEsi.ear, vous pouvez installer l'application.