z/OS 上の Rational Build Agent を InetD を介して開始するように構成

インターネット・デーモン (InetD) を使用してサーバーを再始動したときに Rational® Build Agent を自動的に開始するよう構成することができます。

このタスクについて

Build System Toolkit には、z/OS® 用のシェル・スクリプト (startbfa.sh) が含まれています。このシェル・スクリプトは、z/OS UNIX System Services (USS) の下で Rational Build Agent を開始するようカスタマイズすることができます。このスクリプトは、必要なシステム環境を確立し、スタンドアロン・デーモンとしてエージェントを開始します。このスクリプトを使用する代わりに、サーバーを再始動したときに、必要なシステム環境を使用して自動的に Rational Build Agent を開始するように構成することができます。ビルド・エージェントを InetD 構成に追加するには、以下のステップを実行してください。

手順

InetD 構成ファイルの更新

  1. /etc/services ファイルに以下の行を追加して、Rational Build Agent (bfagent) サービスを USS システムに定義します。
    bfagent       8888/tcp    #Rational Build Agent
  2. 8888 は、bfagent.conf ポート・プロパティーに定義されているポート番号に置換します。この行は、bfagent という名前のサービスを、指定されたポートにマップします。InetD は、指定されたポートでサービス要求を受け取ると、InetD 構成ファイルの定義に従って bfagent サービスを起動します。
  3. 以下の行を /etc/inetd.conf に追加して、InetD のサービスを定義します。
    stream tcp nowait <user>   <agentPath>/bfagent bfagent -f <configPath>/bfagent.conf 
    ここで:
    1. <user> は、サービスを実行するために使用される RACF® ユーザー ID です。
    2. <agentPath> は、bfagent 実行可能ファイルへの絶対パスです。
    3. <configPath> は、bfagent.conf 構成ファイルへの絶対パスです。
  4. サービスが定義された後は、InetD デーモンに構成の再読み取りを強制する必要があります。デーモンに構成の再読み取りを強制するにはいくつかの方法がありますが、最も容易な方法は、以下のコマンドを使用して、デーモンを停止して再始動する方法です。
    kill `cat /etc/inetd.pid`
    /usr/sbin/inetd /etc/inetd.conf

ビルド環境のセットアップ

  1. Ant with Enterprise Extensions ビルドが実行されている場合、bfagent にはいくつかの環境変数の定義が必要になります。これらの変数は、通常、startbfa.sh スクリプトによって定義され、bfagent デーモンを開始する前にエクスポートされます。InetD を介してエージェントを実行しているときにビルドを実行するには、以下の変数を定義する必要があります。
    • HOME
    • ZLANG
    • _TIMEOUT
    • _CMDSRV
    • _BASE_HOME
    • SCM_WORK
    • BLD_TOOLKIT
    • JAVA_HOME
    • JAZZ_USER
    • JAZZ_PASSWORD_FILE
    • STEPLIB
    • ANT_HOME
    これらの変数の予期される値を見つけ、どの変数がご使用環境に必要かを判別するには、@pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa/startbfa.sh ディレクトリーにある、startbfa.sh スクリプトのコメントを参照してください。
    注: これらの変数のいくつかは、ユーザーのセットアップに必要ない可能性があります。
  2. これらの変数を、プロジェクト・エリア内のビルド・エンジンのプロパティーとして定義します。これらの変数を定義するには、以下のようにします。
    1. Rational Build Agent タイプのビルド・エンジンを定義します。詳細については、Ant with Enterprise Extensions ビルド定義エディターの使用法を参照してください。
    2. ビルド定義エディターで、/etc/services ファイルに定義したポートを指定します。
    3. ビルド・エンジン・エディターの「概要」タブの「プロパティー」セクションで、上記の変数を定義します。

フィードバック