Installation et exécution de l'agent sous z/OS

Le fichier exécutable de l'agent de génération a été installé dans votre répertoire préfixeChemin/usr/lpp/jazz/bfagent lors de l'installation de SMP/E.

Effectuez les étapes suivantes pour terminer l'installation et démarrer Rational Build Agent :
  1. Si les générations Antz ne seront pas utilisées, l'agent de génération peut être démarré manuellement ou via INETD. pour démarrer l'agent de génération via INETD, voir "Conseils d'utilisation d'inetd ou de xinetd". Pour démarrer manuellement l'agent de génération, accédez à yourPathPrefix/usr/lpp/jazz/v2.1/bfagent et utilisez l'option -s :
    bfagent -s -f /etc/jazz/bfagent.conf
    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. Voir Référence bfagent. Reportez-vous également aux conseils ci-après sur inetd.
  2. Si vous prévoyez d'utiliser les extensions de génération Antz, Rational Build Agent doit être démarré à partir d'un script de shell pour lequel des variables d'environnement supplémentaires sont définies. Build System Toolkit for System z 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.
  3. 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 à l'aide d'un ID utilisateur autre que root ou admin, 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.

Conseils d'utilisation d'inetd ou de xinetd

Si le démon TCP/IP UNIX® (inetd ou xinetd) est installé et actif sur le système z/OS, vous pouvez configurerRational Build Agent pour qu'il soit exécuté comme service et démarré automatiquement. Pour plus d'informations sur la configuration d'inetd, reportez-vous au centre de documentation de z/OS V1R9 à l'adresse http://publib.boulder.ibm.com/infocenter/zos/v1r9/index.jsp?topic=/com.ibm.zos.r9.cs3/cs3.htm (ou au centre de documentation correspondant à votre version de z/OS). La configuration intégrale d'inetd n'est pas abordée dans le présent document. Dans un même exemple, vous pouvez :
  1. Modifier /etc/inetd.conf en ajoutant la ligne suivante :
    bfagent stream tcp nowait userID /usr/lpp/jazz/v2.0/bfagent/bfagent -f /etc/jazz/bfagent.conf
    bfagent
    Nom de service du démon. La valeur par défaut est bfagent (en minuscules). Ce nom doit correspondre au nom utilisé dans /etc/services.
    stream tcp nowait
    Instructions de configuration spécifiques d'inetd (type de socket, protocole, indicateur d'attente). Ne pas modifier.
    ID utilisateur
    ID utilisateur du processus du démon. La valeur par défaut est "OMVSKERN". Cet ID utilisateur doit être un ID utilisateur avec un segment de sécurité OMVS valide, des droits BPX.DAEMON et des droits READ et EXECUTE pour les répertoires d'installation et de configuration.
    /usr/lpp/jazz/v2.0/bfagent/bfagent
    Programme serveur (emplacement absolu de bfagent). La valeur par défaut est /usr/lpp/jazz/v2.0/bfagent/bfagent. Les arguments après cet argument inetd sont des arguments serveur.
    -f /etc/jazz/bfagent.conf
    Répertoire de travail (emplacement du fichier de configuration du serveurBuild Forge). La valeur par défaut est /etc/jazz/bfagent.conf.
    Important : Copiez les fichiers de configuration personnalisés de Rational Build Agent dans un nouveau répertoire (tel que /etc/jazz/) pour éviter de les remplacer lors de l'application de la maintenance. Le répertoire de travail défini ici doit refléter cette modification.
  2. Ajoutez la chaîne suivante à /etc/services :
    bfagent 5555/tcp #BUILD FORGE AGENT
  3. Mettez à jour le port dans votre fichier bfagent.conf pour le mapper à votre entrée de services :
    port 5555
  4. Redémarrez inetd.

Commentaires

Cela vous a-t-il aidé ? Vous pouvez nous faire part de vos commentaires sur le site Jazz.net (inscription obligatoire) : Comment in the forums ou submit a bug