Start des Rational Build Agent unter z/OS über InetD konfigurieren

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

  1. 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
  2. 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.
  3. 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:
    1. <Benutzer> ist die RACF-Benutzer-ID, unter der der Service ausgeführt werden soll.
    2. <Agentenpfad> ist der vollständige Pfad zur ausführbaren Datei von bfagent.
    3. <Konfigurationspfad> ist der vollständige Pfad zur Konfigurationsdatei bfagent.conf.
  4. 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

  1. 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.
  2. Definieren Sie diese Variablen als Eigenschaften einer Build-Steuerkomponenten in Ihrem Projektbereich. Gehen Sie dazu wie folgt vor:
    1. 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.
    2. Geben Sie im Editor für Build-Definitionen den Port an, den Sie in der Datei /etc/services festgelegt haben.
    3. Definieren Sie auf der Registerseite Übersicht des Editors für Build-Steuerkomponenten im Abschnitt Eigenschaften die oben aufgelisteten Variablen.

Feedback