z/OS 上で Instana エージェントを起動済みタスクとして開始する

この手順に従って、 z/OS 上で Instana エージェントを起動タスクとして設定および起動することができます。

  1. instana-agent/bin ディレクトリーに移動します。
  2. 「start」および「karaf」スクリプトのバックアップを作成します:
    cp start startb
    cp karaf karafb
  3. 以下の例に示すように、「karafb」スクリプトの realpath() 関数の前に次の set -x コードを追加してください:
    図1. 変更を加えたkarafb
    変更を加えたkarafb
  4. 以下の例に示すように、「startb」ファイルに「karafb」のファイルパスを更新してください:
    図2. 変更を加えたstartb
    変更を加えて開始
    たとえば、次のコードを次のように置き換えてください:
    exec "${KARAF_HOME}/bin/karaf" server "$@" >> "${KARAF_REDIRECT}" 2>&1 &
    上記の行を、次の行に置き換えます。
    exec "${KARAF_HOME}/bin/karafb" server "$@" &

    この変更により、システムが修正されたkarafbスクリプトを使用するようになります。

  5. InstanaBPXINST.jclGitHub リポジトリからスクリプトファイルをダウンロードしてください。
  6. そのファイルを MVS のデータセットにコピーします。
  7. ファイル jcl 内の6行目を、startb PARM='SH /u/neha/c/localbuild/instana-agent/bin/startb' スクリプトのフルパスに更新してください。
  8. 次の例に示すように、データセット PROCLIB にメンバーを追加します:
    USER.PROCLIB(INSTANA)
    連結 PROCLIB を行うには、次のコマンドを実行してください:
    /$d proc
  9. 新しく開始されたタスクのメンバーについて、 RACF プロファイルを更新します。 INSTANA例えば、
    以下の条件が満たされていることを確認します。
    • 開始されたタスクのユーザーIDには十分な権限があります。
    • 所有者IDのUIDは です 0
    図 3. zOS の BPXINST.jcl ファイルの確認
    zOS の BPXINST.jcl ファイルの確認
  10. 開始したタスクをparmlib内の COMMNDxx に追加します。例えば、 USER.PARMLIB(COMMND01)などです。 この設定により、IPL後にエージェントが自動的に起動するようになります。

    以下の例を参照してください。

    前:
    図4. 変更前の zOS のcommndxxコンテンツ
    zOS 変更前のcommndxxの内容
    指定の時間が経過後:
    図5. 変更後の zOS のcommndxxコンテンツ
    zOS 変更後のcommndxxの内容
  11. オペレーターコンソールまたは SDSF を使用して、エージェントを初めて起動します:
    S INSTANA