Réalisation de l'installation et exécution de Rational Build Agent sous z/OS

Cette section décrit comment lancer l'exécution de Rational Build Agent sous z/OS.

L'agent est exécuté comme démon autonome et utilise le port d'agent par défaut 5555. Pour modifier le port par défaut, utilisez le paramètre de port du fichier bfagent.conf. Reportez-vous à la section Configuration de l'agent sous z/OS pour plus d'informations sur la localisation du fichier bfagent.conf et la modification du port par défaut.

Effectuez les étapes suivantes pour terminer l'installation et démarrer Rational Build Agent :
  1. Lancez l'agent de génération à l'aide d'une des options suivantes :
    • Option 1 : Si vous comptez utiliser des générations Ant avec extensions Enterprise, Rational Build Agent doit être démarré depuis un script de shell dans lequel sont définies des variables d'environnement supplémentaires. Sous z/OS, Build System Toolkit contient un exemple de script de shell qui configure ces variables d'environnement et démarre l'agent. Pour plus d'informations, voir Configuration du script de shell de Rational Build Agent.

      Pour démarrer Rational Build Agent, configurez l'exemple de tâche démarrée BLZBFA fourni dans la bibliothèque hlq.SBLZSAMP en suivant les instructions affichées par ce travail. Vous pouvez exécuter Rational Build Agent en tant que tâche démarrée au démarrage du système. Vous devez copier ce travail vers une bibliothèque PROCLIB affectée par le système et configurer les paramètres de sécurité requis afin qu'il puisse s'exécuter en tant que tâche démarrée.

      Vous pouvez également démarrer le script startbfa.sh manuellement depuis OMVS.

      Remarque : Le démarrage de startbfa.sh directement depuis un script de shell depuis les shells Rational Developer for System z UNIX peut engendrer des conflits vu que la passerelle ISPF obtiendra les fichiers de configuration depuis l'emplacement Rational Developer for System z rsed.envvars. Pour éviter des conflits potentiels, démarrez Rational Build Agent en tant que tâche démarrée, via "Internet Daemon" (InetD), ou bien configurez-le de sorte qu'il soit appelé directement dans OMVS sous z/OS et non via Rational Developer for System z.
    • Option 2 : démarrer l'agent de génération directement. Cette méthode ne configure pas les variables d'environnement requises par Ant avec Enterprise Extensions. Accédez au répertoire @pathPrefix@/usr/lpp/jazz/v4.0/buildagent et utilisez l'option -s :
      /usr/lpp/jazz/v4.0/buildagent/bfagent -s -f /etc/jazz40/ccm/bfagent.conf
    • Option 3 : démarrer l'agent de génération via InetD. Voir Configuration de Rational Build Agent sous z/OS pour un démarrage via InetD.
  2. Pour tester l'agent de génération qui fonctionne sur le système z/OS, utilisez la commande telnet pour tester la connexion. Voir Test de la connexion.
Remarque : L'agent de génération utilise généralement des droits d'administration tels que root ou admin pour se connecter au système d'exploitation. En outre, l'agent de génération exécute toutes les commandes à l'aide des droits de l'utilisateur qui a démarré l'agent et non du nom d'utilisateur utilisé pour se connecter. Si l'agent de génération n'est pas exécuté en tant qu'utilisateur root ou admin, vous risquez de recevoir des erreurs d'authentification lors du test de la connexion. Pour exécuter l'agent à partir d'un ID utilisateur non superutilisateur ou non administrateur, configurez le paramètre magic_login dans le fichier bfagent.conf. Cette méthode remplace l'authentification système standard. Avec de ce paramètre, le système peut authentifier votre connexion à l'aide des seuls nom d'utilisateur et mot de passe. Pour consulter les étapes requises pour configurer le paramètre magic_login, voir Référence bfagent.conf.

Commentaires