z/OS での Rational Build Agent のインストールおよび実行の完了

このセクションでは、z/OS® で Rational® Build Agent の実行を開始する方法について説明します。

エージェントはスタンドアロン・デーモンとして実行され、デフォルトのエージェント・ポートである 5555 を使用します。デフォルトのポートを変更するには bfagent.conf のポート設定を使用します。 bfagent.conf ファイルを見つけてデフォルト・ポートを変更する方法については、 z/OS でのエージェントの構成のセクションを参照してください。

以下の手順を実行してインストールを完了し、Rational Build Agent を始動してください。
  1. 以下のいずれかのオプションで Build Agent を始動します。
    • オプション 1: Ant with Enterprise Extensions ビルドを使用する予定であれば、Rational Build Agent は、 追加の環境変数セットが用意されているシェル・スクリプトから始動する必要があります。z/OS の場合、Build System Toolkit にはサンプル・シェル・スクリプトが含まれており、このスクリプトでそれらの環境変数を構成して、エージェントを始動します。詳しくは、Rational Build Agent シェル・スクリプトの構成を参照してください。

      Rational Build Agent を開始するには、ジョブの指示に従って、hlq.SBLZSAMP ライブラリーに提供されているサンプルの開始済みタスク BLZBFA を構成します。 システムの始動時に Rational Build Agent を開始済みタスクとして実行できます。ジョブをシステムで割り振られた PROCLIB にコピーして、 開始済みタスクとして実行するために必要なセキュリティー設定をセットアップする必要があります。

      あるいは、OMVS から startbfa.sh スクリプトを手動で開始することができます。

      注: startbfa.sh を、Rational Developer for System z® UNIX シェルからシェル・スクリプトとして直接開始すると、 ISPF ゲートウェイが Rational Developer for System z の rsed.envvars から構成ファイルを取得するため、 競合が発生する可能性があります。 競合が発生しないようにするには、インターネット・デーモン (InetD) を通して Rational Build Agent を開始済みタスクとして開始するか、 あるいは、Rational Developer for System z を通さずに z/OS 上の OMVS で直接呼び出されるようにそれを構成します。
    • オプション 2: Build Agent を直接開始します。このメソッドは、Ant with Enterprise Extensions により要求される環境変数は設定しません。@pathPrefix@/usr/lpp/jazz/v4.0/buildagent ディレクトリーに移動し、-s オプションを使用します。
      /usr/lpp/jazz/v4.0/buildagent/bfagent -s -f /etc/jazz40/ccm/bfagent.conf
    • オプション 3: Build Agent を InetD を通して開始します。z/OS 上の Rational Build Agent を InetD を介して開始するように構成を参照してください。
  2. z/OS システムで実行中の Build Agent をテストするには、Telnet コマンドを使用して接続をテストします。接続のテストを参照してください。
注: 通常、Build Agent は root または管理者などの管理特権を使用して、 オペレーティング・システムにログオンします。さらに、Build Agent は、 ログインに使用されたユーザー名ではなく、エージェントを始動したユーザーの権限を使用してすべてのコマンドを実行します。 Build Agent が root または管理者ユーザーとして実行されていないと、 接続のテスト時に認証エラーを受け取る場合があります。エージェントを非 root または非管理者ユーザー ID から実行するには、bfagent.conf に magic_login 設定を構成します。これは、標準的なシステム認証の代わりとなるものです。 この設定を使用すると、システムは単一のユーザー名およびパスワードでログインを認証することができます。magic_login の構成に必要なステップを確認するには、bfagent.conf リファレンスを参照してください。

フィードバック