Sie können den Rational Build
Agent so konfigurieren, dass er über den Internetdämon
(InetD) automatisch beim Serverstart gestartet wird.
Informationen zu diesem Vorgang
Das Build System Toolkit enthält bei Auslieferung ein Shell-Script (
startbfa.sh)
für z/OS, das für den Start
des Rational Build
Agent unter z/OS UNIX System Services (USS) angepasst werden kann. Das Script erzeugt die erforderliche
Systemumgebung und startet den Agenten dann als einen eigenständigen Dämon. Anstatt das Script zu verwenden, können Sie den Rational Build Agent so konfigurieren,
dass er bei einem Neustart des Servers automatisch mit der erforderlichen Systemumgebung
gestartet wird. Gehen Sie wie folgt vor, um den Build Agent zu Ihrer
InetD-Konfiguration hinzuzufügen.
Vorgehensweise
Aktualisieren Sie die InetD-Konfigurationsdateien
- Definieren Sie den Service des Rational Build
Agent (bfagent) in Ihrem USS-System. Fügen Sie dazu zur Datei
/etc/services die folgende Zeile hinzu:
bfagent 8888/tcp # Rational Build Agent
- Ersetzen Sie 8888 durch die von der Port-Eigenschaft in
bfagent.conf definierte Port-Nummer. Durch diese Zeile wird der Service mit dem Namen
bfagent dem angegebenen Port zugeordnet. Wenn InetD am angegebenen Port eine Serviceanfrage empfängt, startet er den Service
bfagent wie in der InetD-Konfigurationsdatei definiert.
- Fügen Sie zu /etc/inetd.conf die folgende Zeile hinzu, um den
Service für InetD zu definieren:
stream tcp nowait <Benutzer> <Agentenpfad>/bfagent bfagent -f <Konfigurationspfad>/bfagent.conf
Hierbei gilt Folgendes: - <Benutzer> ist die RACF-Benutzer-ID, unter der der Service
ausgeführt werden soll.
- <Agentenpfad> ist der vollständige Pfad zur ausführbaren Datei von bfagent.
- <Konfigurationspfad> ist der vollständige Pfad zur Konfigurationsdatei bfagent.conf.
- Wenn der Service definiert ist, muss durchgesetzt werden, dass der Dämon InetD die Konfiguration erneut liest. Dafür gibt es mehrere Optionen.
Die einfachste Methode besteht darin, den Dämon mit folgendem Befehl zu stoppen und neu zu starten:
kill `cat /etc/inetd.pid`
/usr/sbin/inetd /etc/inetd.conf
Build-Umgebung einrichten
- Wenn Builds unter Verwendung von Ant mit Enterprise Extensions erstellt werden, müssen für den
bfagent mehrere Umgebungsvariablen definiert sein.
Normalerweise werden diese Variablen vom Script startbfa.sh definiert und vor dem Start des
bfagent-Dämons exportiert. Wenn Sie den Agenten über
InetD laufen lassen, müssen Sie für die Build-Erstellung die folgenden Variablen definieren:
- HOME
- ZLANG
- _TIMEOUT
- _CMDSRV
- _BASE_HOME
- SCM_WORK
- BLD_TOOLKIT
- JAVA_HOME
- JAZZ_USER
- JAZZ_PASSWORD_FILE
- STEPLIB
- ANT_HOME
Lesen Sie die Kommentare im Script
startbfa.sh unter
@pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa/startbfa.sh, um festzustellen, welche Variablen erforderlich sind und welche Werte erwartet werden.
Anmerkung: Möglicherweise werden einige Variablen für Ihre Konfiguration nicht benötigt.
- Definieren Sie diese Variablen als Eigenschaften einer Build-Steuerkomponenten in Ihrem Projektbereich. Gehen Sie dazu wie folgt vor:
- Definieren Sie eine Build-Steuerkomponente vom Typ Rational Build
Agent. Einzelheiten hierzu enthält der Artikel
Editor für Ant-mit-Enterprise-Extensions-Build-Definitionen
verwenden.
- Geben Sie im Editor für Build-Definitionen den Port an, den Sie in der Datei
/etc/services festgelegt haben.
- Definieren Sie auf der Registerseite Übersicht des Editors für Build-Steuerkomponenten
im Abschnitt Eigenschaften die oben aufgelisteten Variablen.