File Manager Service Provider のインストール z/OS®

Service Provider の機能は UNIX システム・サービスに抽出された後、WLP 内の z/OS Connect にインストールされ、ADFzCC server で構成されます。

始める前に

インストール手順は UNIX® システム・サービス環境で実行され、環境の前提条件は次のとおりです。

シェル環境には、PATH 環境変数で使用可能な z/OS® の Java™ Connect EE 互換バージョンが必要です。UNIX® システム・サービスの echo $PATH コマンドを使用して PATH 変数を確認できます。
z/OS® Connect インストール・ディレクトリー <ZCON_INST_DIR>/v3r0/wlp/bin は PATH 環境変数内にある必要があります。

このタスクについて

File Manager Service Provider for z/OS® Connect の機能は、SFMNSAM1 データ・セットの FMNZCEE メンバーのバイナリー・アーカイブとして提供されます。アーカイブには、以下のファイルが含まれます。

com.hcl.zosconnect.fm.provider.feature_n.n.n.n.esa	機能アーカイブ
fmService.sar	File Manager Base サービス・アーカイブ
fmIMSService.sar	IMS™ サービス・アーカイブ
fmDB2Service.sar	Db2® サービス・アーカイブ
filemanager.properties	Properties file
com.hcl.zosconnect.buildtoolkit.filemanager.jar	ビルド・ツールキット・プラグイン

手順

UNIX システム・サービスの pax コマンドを使用して、File Manager Service Provider for z/OS® Connect のアーカイブを SFMNSAM1 データ・セットから抽出します。
```
pax -rf "//'<hlq>.SFMNSAM1(FMNZCEE)'"
```
このコマンドは、FMNZCEE アーカイブを現行作業ディレクトリーに抽出します。
(オプション) インストール・ディレクトリーを変更する場合は、プロパティー・ファイルで productInstall オプションを編集します。
```
com.ibm.websphere.productInstall=</your/preferred/directory>
```
これは、File Manager Service Provider がインストールされる場所です。このディレクトリーは完全修飾されている必要があります。つまり、スラッシュ (/) で始まる必要があります。デフォルトのインストール・ディレクトリーは /var/filemanager です。デフォルトのディレクトリを変更する場合は、既存のファイルやサブディレクトリが存在しないディレクトリを選択することをお勧めします。productInstall ディレクトリーは、存在しない場合には作成されます。
UNIX システム・サービス z/OS® コマンドを使用して、プロパティー・ファイルを <WLP_USER_DIR>/v3r0/extensions Connect cp ディレクトリーにコピーします。
例:
```
cp filemanager.properties /var/zosconnect/v3r0/extensions
```
サービス・アーカイブ・ファイルを z/OS® Connect サービス・ディレクトリーにコピーします。
例:
```
cp fm*.sar 
   /var/zosconnect/servers/<yourWLPServer>/resources/zosconnect/services
```
サービス・アーカイブ・ファイルが、z/OS® Connect WLP 開始タスク・ユーザーから読み取り可能であることを確認します。
installUtility コマンドを使用して、File Manager Service Provider の機能を z/OS® Connect にインストールします。例:
```
installUtility install 
com.hcl.zosconnect.fm.provider.feature_2.0.0.0.esa --to=filemanager
```
ESA ファイルのバージョン番号がアーカイブ内のファイル名と一致することを確認します。
z/OS Connect WLP の server.xml 構成を編集します。

server.xml に次の変更を加える必要があります。
1. File Manager 機能を featureManager スタンザに追加します。
```
<featureManager>
	<feature>filemanager:fmProvider-2.0</feature>
</featureManager>
```
2. 機能の runport およびの最大タイムアウト構成を追加します。
```
<FileManager_Connection id="default" runport="2800" max_timeout="1800" />
```
  runport は File Manager セッションの確立に使用される ADFzCC server ポートを表し、max_timeout はアクティビティーがなくてもクライアントが File Manager セッションを開いたままにしておける最大秒数を表します。
ADFzCC server JCL を、z/OS Connect REST 要求をサポートするように変更します。
IPVSRV CONFIG DD ステートメントで、CONFIG=FM スタンザの後に REST=YES を追加します。例:
```
//CONFIG DD *
	CONFIG=FM
	REST=YES
	…
/*
```
z/OS Connect WLP タスクおよび ADFzCC server タスクを再始動または更新します。

次のタスク

File Manager Service Provider が正常にインストールされたことを確認するには、次の手順を実行します。

z/OS Connect WLP 開始タスクの JOBLOG を調べて、CWWKF0012I メッセージに fmProvider-2.0 がインストール済み機能の 1 つとしてリストされていることを確認します。例:
```
CWWKF0012I: The server installed the following features: ssl-1.0, 
jdbc-4.1, filemanager:fmProvider-2.0, …
```
次のペイロードで https://zceehost:zceeport/zosConnect/services/fmService?action=invoke への HTTP PUT 要求を使用して、File Manager Service Provider を手動で起動します。
```
{
    "action" : "verify"
}
```
この操作は、ブラウザーまたは POSTMAN などの REST API ツールから行うことができます。HTTP 動詞は PUT または POST である必要があり、Content-Type: application/json ヘッダーは必須です。HTTP ステータス・コード 200 は、File Manager Service Provider が正しくインストールされていることを示します。

インストールの確認が失敗した場合、すべてのインストール手順が指定された順序で完了したことを確認します。「File Manager ユーザーズ・ガイドおよびリファレンス」にも、File Manager Service Provider for z/OS Connect のトラブルシューティング・トピックがあります。