IBM z/OS へのホストエージェントのインストール

インストールする前に

オンラインで編集する

z/OS -USSレイヤーに Instana エージェントをインストールする前に、サポートされているセンサーを確認し、前提条件の手順を完了してください：

対応センサー

オンラインで編集する

z/OS で自動的に検出される、サポートされているセンサーのリストを以下に示す：

注：z/OS のホストメトリクスの監視は、 Instana -agent ではサポートされていません。詳細については、「 z/OS のホストメトリクスの監視」を参照してください。

前提条件

オンラインで編集する

Instana エージェントをインストールする前に、以下の手順を完了する必要があります：

`zOS-Agent-Prereq.sh` スクリプトをダウンロードして実行する

オンラインで編集する

この zOS-Agent-Prereq.sh スクリプトは、 z/OS 上の Instana エージェントの前提条件を確認し、不足している前提条件をインストールします。スクリプトを実行するには次の手順を行います:

以下のファイルをダウンロードし、SCP、SFTP、またはコピー＆ペーストで z/OS -USS レイヤーに移動する。
- zOS-Agent-Prereq.sh Instana の GitHub リポジトリにあるスクリプトファイル。
- meta-main.XXX.zos.pax.Z ファイルを metaport リポジトリから GitHub ダウンロードします。
bash シェルに切り替え、以下のコマンドを使用して、root権限を持つユーザーとして zOS-Agent-Prereq.sh スクリプトを実行してください：
```
bash
```
- スクリプトファイルをSCPまたはSFTPを使用して z/OS -USSレイヤーに移動した場合は、次のコマンドを実行します：
```
chmod +x ./zOS-Agent-Prereq.sh && chtag -R -tc 819 ./zOS-Agent-Prereq.sh && ./zOS-Agent-Prereq.sh
```
- SCPやSFTPを使わず、スクリプトファイルを z/OS -USSレイヤーにコピー＆ペーストした場合は、以下のコマンドを実行する：
```
chmod +x ./zOS-Agent-Prereq.sh && ./zOS-Agent-Prereq.sh
```
スクリプトのプロンプトが表示されたら、ダウンロードした meta-main.XXX.zos.pax.Z ファイルへのパスを入力します。

このスクリプトは、 z/OS 環境に Instana エージェントをインストールするための前提条件を確認します。もし前提条件が欠けていれば、スクリプトはそれらをダウンロードする。

セキュリティプロファイルの設定（ WebSphere Application Server および WebSphere Liberty 監視用）

オンラインで編集する

IBM WebSphere Application Server と WebSphere Liberty を z/OS でトレースするには、 Resource Access Control Facility ( RACF ) またはその他のメインフレームセキュリティ製品を使用してセキュリティプロファイルを設定する必要があります。

セキュリティ・プロファイルは、以下の方法で設定できる：

汎用プロファイルの作成

SURROGAT クラスに UACC(READ) の読み取りパーミッションを持つ BPX.SRV.** という名前のジェネリック・プロファイルを作成します。
特定のユーザーIDのプロファイルを作成する

特定のユーザーID（例えば、 USERA ）については、 UACC(NONE) でプロファイル BPX.SRV.USERA を作成し、個々のサロゲート・ユーザーまたはグループに読み取りアクセス権を与える。

WebSphere Application Server の監視を有効にする

オンラインで編集する

WebSphere Application Server を監視するには、以下のアタッチフラグを有効にして WebSphere サーバーをセットアップする必要がある：

  - Djdk.attach.allowAttachSelf=true
  - Dcom.ibm.tools.attach.enable=yes

WebSphere Liberty サーバーの監視を有効にする

オンラインで編集する

WebSphere Liberty サーバーを監視するには、 WebSphere Liberty サーバーを設定し（ファイル server_name.jvmprofile の更新により）、以下のアタッチフラグを有効にする必要があります：

  - Djdk.attach.allowAttachSelf=true
  - Dcom.ibm.tools.attach.enable=yes

注：z/OS - CICS リージョン内で実行される WebSphere Liberty も、 z/OS 上で実行される WebSphere Liberty と同様にサポートされています。

WebSphere Liberty のメトリクスで JMX を有効にする

オンラインで編集する

WebSphere Liberty のメトリクスを収集するには、 monitor-1.0 機能を有効にする必要があります。この機能を有効にするには、 <websphere-liberty_install_dir>/usr/servers/<specific_server>/ ディレクトリにある server.xml ファイルを開き、次の行をファイルに追加する：

<featureManager ...>
    ...
    <feature>monitor-1.0</feature>
    ...
</featureManager>

エージェントをインストールする前に、お使いのシステムに Java Development Kit (JDK) 11がインストールされていることを確認してください。

エージェントのインストール方法の選択

オンラインで編集する

以下のインストール・オプションのいずれかを選択し、関連するリンクをクリックして続行します：

オンライン環境（ホストが Instana のホスト型エージェントリポジトリと通信できる環境）では、ワンライナーによるインストール手法を使用して、ホストエージェントを自動的にインストールできます。詳細については、自動(ワンライナー)スクリプトによるエージェントのインストールを参照してください。
エアギャップ環境では、 .tar.gz ファイルからエージェントをインストールして実行することができます。

.tar.gz ファイルからエージェントをインストールして実行するには、ファイルをダウンロードして解凍し、エージェントを起動します。詳細については、 .tar.gz ファイルからのエージェントのインストールと実行を参照してください。

自動(ワンライナー)スクリプトによるエージェントのインストール

オンラインで編集する

エージェント・ワンライナー・スクリプトを使用して、 z/OS -USS層にホスト・エージェントを自動的にインストールすることができます。ワンライナーを使用してホストエージェントをインストールするには、以下の手順を実行します：

Instana UIのホームページで、 「エージェントとコレクター」 をクリックします。 [ Instana ] の [エージェント] タブで、 [エージェントのインストール] を選択します。
エージェント展開カタログページで、 z/OS - 自動インストール(ワンライナー) というタイルをクリックします。
展開したいエージェントのパッケージングモード（動的または静的）を選択します。静的エージェントと動的エージェントの違いを理解するには、ホストエージェントのタイプを参照してください。
スクリプトをホストエージェントをインストールする z/OS -USS レイヤにコピーし、スクリプトを実行してホストエージェントをインストールします。

このスクリプトには、エージェントキーとホストエージェントのエンドポイントが事前に入力されています。

オプションを変更すると、スクリプトのパラメータが自動的に更新されます。

ダイナミックパッケージングオプションを使用してエージェントをインストールする以下のサンプルスクリプトを参照してください：
```
curl -o setup_agent.sh https://setup.instana.io/agent && chmod 700 ./setup_agent.sh && chtag -R -tc 819 ./setup_agent.sh -a <your_agent_key> -d <your_agent_key> -t dynamic -e <host-agent-endpoint>
```
Instana のホストエージェントをインストールするには、rootユーザーの権限が必要です。

スクリプトを実行する前に、まず ` bashbash ` コマンドを使用してシェルを切り替える必要があります。

これでホストエージェントがインストールされた。 View Deployed Agents をクリックして、インフラストラクチャマップ上にエージェントを表示します。

注：Instana の公開システムパッケージリポジトリは、リポジトリファイルを作成することでシステムに追加されます。このファイルは、 Instana の認証済みリポジトリをマシンのインストールソースに追加します。

一行スクリプトのパラメータ

オンラインで編集する

ワンライナー・スクリプトは以下のパラメーターを受け付ける：


パラメーター	説明
`-a` = (必須)	エージェント・キー。
`-d` = (オプション)	Instana のダウンロードキー。自社でホストする（オンプレミス） Instana 環境をご利用の場合、キーは Instana から提供されます。
`-e` = (必須)	ホストエージェントのエンドポイント。
`-m` = (オプション)	Instana のエージェントモードを設定します（デフォルト `apm` ）。 `infra`
`-t` = (オプション)	エージェントのタイプ、 `dynamic` （デフォルト）または `static`。

`.tar.gz` ファイルからのエージェントのインストールと実行

オンラインで編集する

.tar.gz ファイルからエージェントをインストールして実行する場合は、ファイルをダウンロードして解凍し、エージェントを起動します。

この .tar.gz ファイルには、エージェントキーとホストエージェントのエンドポイントが事前に入力されています。

.tar.gz ファイルからエージェントをインストールする手順に従ってください：

前提条件のチェック
エージェントのダウンロード
エージェントを z/OS に移動 - USSレイヤー
エージェントの開始

エージェントのダウンロード

オンラインで編集する

Instana のUIから、以下の手順に従ってエージェントパッケージをダウンロードしてください：

Instana UIのホームページで、 「エージェントとコレクター」 をクリックします。 [ Instana ] の [エージェント] タブで、 [エージェントのインストール] を選択します。
エージェント配置カタログページで、 Linux - Archive ( tar.gz ) タイルをクリックします。
パッケージング・セクションで、配備するエージェント・タイプ（Dynamic または Static ）を選択します。静的エージェントと動的エージェントの違いについては、ホストエージェントの種類を参照してください。

エアギャップ環境では、静的梱包を使用する。
ドロップダウンリストで、プラットフォームアーキテクチャ（オペレーティングシステム - s390x ）を選択します。

アーカイブファイルには、 Instana のアカウント設定が自動的に事前設定されています。そのため、ファイルを解凍してエージェントを起動するだけで利用を開始できます。
ダウンロードアイコンをクリックして、ウェブブラウザからホストエージェントパッケージファイル( tar.gz )をダウンロードします。

これでホストエージェントがダウンロードされた。

エージェントを z/OS -USS レイヤーに移動する

オンラインで編集する

SCP または SFTP を使用して、ダウンロードしたエージェントパッケージをシステムから z/OS -USS レイヤに移動します。以下の例を参照してください。

scp <path-to-file-instana-agent-linux-s390x.tar.gz> <Username>@<zOS-IP>:/<PATH-TO-COPY-FILE-ON-zOS-USS>

次に、 Instana の GitHubsetup_agent_airgapped.sh リポジトリからスクリプトファイルをダウンロードし、 z/OS -USSレイヤーに移動します。

エージェントの開始

オンラインで編集する

エージェントパッケージを z/OS -USS 層に移動した後、手動または setup_agent_airgapped.sh スクリプトを使用してエージェントを起動できます。

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

オンラインで編集する

z/OS で「 Instana 」エージェントをスケジュールされたタスクとして開始する方法の詳細については、「 z/OS からエージェントを開始する」を参照してください。

スクリプトによるエージェントの起動

オンラインで編集する

bash シェルに切り替え、以下のコマンドを使用して、root権限を持つユーザーとして setup_agent_airgapped.sh スクリプトを実行してください：

bash

スクリプトファイルをSCPまたはSFTPを使用して z/OS -USSレイヤーに移動した場合は、次のコマンドを実行します：
```
chmod +x ./setup_agent_airgapped.sh && chtag -R -tc 819 ./setup_agent_airgapped.sh && ./setup_agent_airgapped.sh
```
SCPやSFTPを使わず、スクリプトファイルを z/OS -USSレイヤーにコピー＆ペーストした場合は、以下のコマンドを実行する：
```
chmod +x ./setup_agent_airgapped.sh && ./setup_agent_airgapped.sh
```

手動でのエージェントの開始

オンラインで編集する

ダウンロードしたエージェント・パッケージ・ファイルをシステム全体でアクセス可能な場所に移動し、root権限を持つユーザーでエージェントを実行する。

以下のコマンドを実行してパッケージを展開する：
```
gzip -d filename.tar.gz && pax -r -f filename.tar
```
z/OS システムでが利用できない gzip 場合は、コマンド gunzip (gunzip file_name.tar.gz) を使用してローカルシステム上でファイルを解凍できます。この tar.gz コマンドはを instana-agent-linux-s390x.tar.gz に変換 instana-agent-linux-s390x.tarします。次に、その .tar ファイルを z/OS UNIX System Services レイヤーに転送し、コマンド tar (-xvf instana-agent-linux-s390x.tar) を実行して内容を抽出します。 {: note}Windows を使用してをダウンロードする場合は、ダウンロードしたファイルを tar.gzLinux システムに転送してください。を使用して gunzip をに変換 .tar.gz し .tar、その後、その .tar ファイルを z/OS UNIX System Services レイヤーに転送します。

以下のコマンドを実行して、コード・ページ設定を有効にする：

chtag -R -tc 819 instana-agent/bin && chtag -R -tc 819 instana-agent/etc
chtag -t -c UTF-8 instana-agent/etc/instana/configuration.yaml

以下のコマンドを実行して、タグが有効になっていることを確認する：

ls -lTr instana-agent/bin && ls -lTr instana-agent/etc

以下の回答例をご覧ください：

NGHON:/u/nghon/ts/instana-agent #>ls -lTr bin/
total 7360
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS        2659 Mar 18 09:53 stop
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS        2656 Mar 18 09:53 status
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS        2808 Mar 18 09:53 start
t ISO8859-1   T=on  -rw-r--r--   1 ROOT     OMVS       14526 Mar 24 10:56 setenv
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS     2293912 Mar 18 09:53 memory_calculator
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS       16767 Mar 18 09:53 karaf
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS       13806 Mar 18 09:53 inc
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS        4098 Feb 27 04:52 agent-java-check
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS     1357420 Feb 27 04:52 agent-diagnostic.jar
NGHON:/u/nghon/ts/instana-agent #>

以下のコマンドを実行して、自動文字変換を有効にする：
```
export _BPXK_AUTOCVT=ON
```
ログインするたびにエクスポートされないように、ユーザープロファイルで文字変換をオンに設定することをお勧めします。
InstanaJAVA_HOME エージェントの環境変数名を設定し、以下を設定します PATH：

以下のコマンド例を参照：
```
export JAVA_HOME=/usr/lpp/zWebSphere/Liberty/V9R0/java/8.0
export PATH=$JAVA_HOME/bin:$PATH
```
ログインするたびに環境変数がエクスポートされるのを避けるため、ユーザープロファイルか instana-agent/bin/setenv ファイルに環境変数を設定することをお勧めします。
以下のコマンドを実行してエージェントを開始します。
```
INSTANA_AGENT_FOLDER/bin/start
```

エージェントを停止するには、以下のコマンドを実行する：

INSTANA_AGENT_FOLDER/bin/stop

エージェントの状態を確認するには、以下のコマンドを実行する：

INSTANA_AGENT_FOLDER/bin/status

これでホスト・エージェントがインストールされ、起動した。インストール後にできることについては、次にすることを参照してください。

トラブルシューティング

オンラインで編集する

エージェントのインストールまたは実行中にエラーが発生した場合は、ログメッセージを確認し、トラブルシューティングのヒントを確認してください。すべてのホスト・エージェントに共通するトラブルシューティング情報については、トラブルシューティングを参照してください。

エージェントの起動失敗

オンラインで編集する

Instana エージェントをから起動すると cd instana-agent/bin/ && ./start、次のエラーが表示され、エージェントの起動に失敗する場合があります：

Fails with karaf: JAR files could not be found. Please check tar command if you run into path length limitation. We advise the use of GNU tar for uncompressing the host agent tarball. Could not resolve mvn:org.apache.felix/org.apache.felix.framework/5.6.12

原因エージェントアーカイブ .tar` ファイルが壊れています。
トラブルシューティングステップ ：以下のコマンドを実行する：
```
ls instana-agent/system/org/apache/felix/org.apache.felix.framework/5.6.12
```
期待される結果 org.apache.felix.framework-5.6.12.jar ファイルがリストされる。
解決策 ：ファイル instana-agent-linux-s390x.tar.gz がローカル環境（ MacOS または Windows ）に展開されていることを確認し、ファイルを instana-agent-linux-s390x.tarz/OS -USSレイヤーに移動し、または /pax -r -f filename.tar コマンド tar –xvf filename.tar を使用して展開してください。

エージェントが WebSphere サーバーにアタッチできない

オンラインで編集する

Instana エージェントが WebSphere サーバーに接続できない場合は、以下のスクリプトを使用して、 WebSphere Application Server を監視するために必要なフラグが有効になっているかどうかを確認してください。

WebSphere-zOS-Prereq.sh スクリプト

このスクリプトは、 Instana エージェントを使用して、 WebSphere のアタッチフラグが有効になっているかなど、 WebSphere の監視に必要な前提条件を確認し、監視対象となっているすべてのPIDを返します。

Instana の WebSphere-zOS-Prereq.shGitHub リポジトリからスクリプトファイルをダウンロードし、SCP、SFTP、またはコピー＆ペーストを使用して、 z/OS -USSレイヤーに移動してください。
bash シェルに切り替え、root権限を持つユーザーとして、以下のコマンドを実行し、 z/OS のUSSレイヤーからスクリプトを実行してください：
```
bash
```
- スクリプトファイルをSCPまたはSFTPを使用して z/OS -USSレイヤーに移動した場合は、次のコマンドを実行します：
```
chmod +x ./WebSphere-zOS-Prereq.sh && chtag -R -tc 819 ./WebSphere-zOS-Prereq.sh && ./WebSphere-zOS-Prereq.sh
```
- SCPやSFTPを使わず、スクリプトファイルを z/OS -USSレイヤーにコピー＆ペーストした場合は、以下のコマンドを実行する：
```
chmod +x ./WebSphere-zOS-Prereq.sh && ./WebSphere-zOS-Prereq.sh
```

WebSphere-Pid-Trace-Enable.sh スクリプト

このスクリプトは、 Instana エージェントを使用して、「 WebSphere 」アタッチフラグが有効になっているかなど、 WebSphere の監視に必要な前提条件を確認します。必要なPIDを入力し、そのPIDに対してフラグが有効になっているかを確認するよう促します。

Instana の WebSphere-Pid-Trace-Enable.shGitHub リポジトリからスクリプトファイルをダウンロードし、SCP、SFTP、またはコピー＆ペーストを使用して、 z/OS -USSレイヤーに移動してください。
bash シェルに切り替え、root権限を持つユーザーとして、以下のコマンドを実行し、 z/OS のUSSレイヤーからスクリプトを実行してください：
```
bash
```
- スクリプトファイルをSCPまたはSFTPを使用して z/OS -USSレイヤーに移動した場合は、次のコマンドを実行します：
```
chmod +x ./WebSphere-Pid-Trace-Enable.sh && chtag -R -tc 819 ./WebSphere-Pid-Trace-Enable.sh && ./WebSphere-Pid-Trace-Enable.sh
```
- SCPやSFTPを使わず、スクリプトファイルを z/OS -USSレイヤーにコピー＆ペーストした場合は、以下のコマンドを実行する：
```
chmod +x ./WebSphere-Pid-Trace-Enable.sh && ./WebSphere-Pid-Trace-Enable.sh`
```

IBM z/OS へのホストエージェントのインストール - UNIX System Services (USS)

インストールする前に

対応センサー

前提条件

zOS-Agent-Prereq.sh スクリプトをダウンロードして実行する

セキュリティプロファイルの設定（ WebSphere Application Server および WebSphere Liberty 監視用）

WebSphere Application Server の監視を有効にする

WebSphere Liberty サーバーの監視を有効にする

WebSphere Liberty のメトリクスで JMX を有効にする

エージェントのインストール方法の選択

自動(ワンライナー)スクリプトによるエージェントのインストール

一行スクリプトのパラメータ

.tar.gz ファイルからのエージェントのインストールと実行

エージェントのダウンロード

エージェントを z/OS -USS レイヤーに移動する

エージェントの開始

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

スクリプトによるエージェントの起動

手動でのエージェントの開始

トラブルシューティング

エージェントの起動失敗

エージェントが WebSphere サーバーにアタッチできない

`zOS-Agent-Prereq.sh` スクリプトをダウンロードして実行する

`.tar.gz` ファイルからのエージェントのインストールと実行