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 :
- 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.
- 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.
- 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 :
- 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.
- Ajoutez la chaîne suivante à /etc/services :
bfagent 5555/tcp #BUILD FORGE AGENT
- Mettez à jour le port dans votre fichier bfagent.conf pour le mapper à votre entrée
de services :
port 5555
- Redémarrez inetd.