21.1.3 FTPインバウンドアダプタをセットアップする

FTPインバウンドアダプタをセットアップするには,HCSCサーバが起動している必要があります。

HCSCサーバの状態の確認方法については,マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「5.2.15 HCSCサーバの情報を確認する」を参照してください。

FTPインバウンドアダプタのセットアップの流れを次に示します。

図21-2 FTPインバウンドアダプタのセットアップの流れ

[図データ]

<この項の構成>
(1) FTPインバウンドアダプタのインポート
(2) FTPインバウンドアダプタのデプロイ
(3) FTPインバウンドアダプタの設定
(4) ユーザ情報の設定

(1) FTPインバウンドアダプタのインポート

FTPインバウンドアダプタをインポートする場合の実行形式を次に示します。

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportres <J2EEサーバ名> -type rar -f "<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥rar¥ftp_inbound_adapter.rar"

cjimportresコマンドの詳細は,マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。

(2) FTPインバウンドアダプタのデプロイ

FTPインバウンドアダプタをデプロイする場合の実行形式を次に示します。

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar <J2EEサーバ名> -resname FTP_Inbound_Resource_Adapter

cjdeployrarコマンドの詳細は,マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。

(3) FTPインバウンドアダプタの設定

FTPインバウンドアダプタを設定する手順,およびプロパティファイルの内容を次に示します。

参考
初期状態の設定のままでFTP連携システムを運用する場合,ここでの設定は省略できます。
(a) 設定手順
  1. FTPインバウンドアダプタのRARファイルから属性を取得して,属性ファイルを作成します。
    FTPインバウンドアダプタのRARファイルから属性ファイルを作成する場合の実行形式を次に示します。

    <Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjgetrarprop <J2EEサーバ名> -resname FTP_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>

    cjgetrarpropコマンドの詳細は,マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。
  2. 属性ファイルを編集します。
    属性ファイルの詳細は,「(b) プロパティの内容」を参照してください。
  3. 定義項目を編集した属性ファイルに指定された値を,FTPインバウンドアダプタのRARファイルへ反映します。
    属性ファイルをFTPインバウンドアダプタへ反映する場合の実行形式を次に示します。

    <Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop <J2EEサーバ名> -resname FTP_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>

cjsetrarpropコマンドの詳細は,マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。

(b) プロパティの内容
属性ファイルの定義
属性ファイルにある定義のタグを次に示します。

<hitachi-connector-property>
   <resourceadapter>
       <config-property>
           <config-property-name>   :定義の名称
           <config-property-type>   :定義の型
           <config-property-value>  :定義の値
       </config-property>
       <config-property>
           <config-property-name>   :定義の名称
           <config-property-type>   :定義の型
           <config-property-value>  :定義の値
       </config-property>
                   :
     (以降,定義の数分,繰り返される)
                   :

定義を編集する場合は,編集する「定義の名称」を検索して,対応する「定義の値」を書き替えます。編集できる項目については,「属性ファイルの定義項目」を参照してください。
属性ファイルを編集する際の注意事項を次に示します。
  • 「定義項目」に示している定義項目の値だけを書き替えてください。ほかの項目や値を変更しないでください。
  • 属性ファイルの内容を,Cosminexusアプリケーション属性ファイル(cosminexus.xml)には記載しないでください。
  • 属性ファイル内にある<display-name>タグのリソースアダプタの名称を変更しないでください。
  • ログ出力に関する設定で,各ログのログファイル1面あたりのファイルサイズ,およびログファイルのバックアップファイルの面数を変更した場合は,FTPインバウンドアダプタを起動する前に,ログファイルをバックアップしておいてください。
属性ファイルの定義個所
次に,属性ファイルの定義個所を示します。

図21-3 属性ファイルの内容および定義の設定個所

[図データ]
属性ファイルの定義項目
属性ファイルの定義項目を次の表に示します。

表21-1 属性ファイルの定義項目一覧(転送制御に関する設定)

定義項目定義名値の範囲デフォルト値補足
最大同時接続数server_maxLogins1~102410
文字セットUTF-8の使用server_charset_UTF8ONまたはOFFONONを指定した場合は,文字コードにUTF-8を使用します。
OFFを指定した場合は,文字コードにMS932を使用します。
なお,FTPコマンドで文字セットを指定した場合は,その設定が有効になります。
ローカルIPアドレスnioListener_localAddress0.0.0.0~255.255.255.255All available
(すべてのIPアドレスで要求を受け付けます。)
IPv4のIPアドレスだけ指定できます。
IPv6はサポート対象外です。
ポート番号nioListener_port1~6553521
データコネクション確立時のローカルIPアドレスnioListener_dataConnection_active_localAddress0.0.0.0~255.255.255.255Any available
(どれかのIPアドレスが設定されます。)
IPv4のIPアドレスだけ指定できます。
IPv6はサポート対象外です。
データコネクション確立時のポート番号nioListener_dataConnection_active_localPort1~65535Any available
(空いているポート番号が割り当てられます。)
すでに使用されているポート番号は指定しないでください。指定した場合はデータコネクションの確立に失敗します。
Listenバックログ数nioListener_listenBacklog1~214748364750
データコネクションのバッファサイズnioListener_dataConnection_socketBufferSize1~6553616384(単位:バイト)
(凡例)-:特にありません。

表21-2 属性ファイルの定義項目一覧(タイムアウトに関する設定)

定義項目定義名値の範囲デフォルト値補足
アイドルタイムアウトnioListener_idleTimeout0~72003000を指定した場合はタイムアウト監視をしません。
(単位:秒)
データコネクション接続のリトライ回数nioListener_dataConnection_active_connectRetryCount0~5050を指定した場合はリトライしません。
データコネクション接続のリトライ間隔nioListener_dataConnection_active_connectRetryInterval0~1800100を指定した場合はタイムアウト監視をしません。
(単位:秒)
データ送信およびデータ受信のタイムアウトnioListener_dataConnection_idleTimeout0~1800100を指定した場合はタイムアウト監視をしません。
(単位:秒)

表21-3 属性ファイルの定義項目一覧(FTPSに関する設定)

定義項目定義名値の範囲デフォルト値補足
FTPS有効化server_ftps_enabletrueまたはfalsefalsetrueを指定した場合は,FTPSに関する設定が有効になります。
falseを指定した場合は,FTPSに関する設定がすべて無視されます。
制御コネクションのImplicitモードnioListener_ftps_implicitModetrueまたはfalsefalsetrueを指定した場合は,Implicitモードで動作します。
falseを指定した場合は,Explicitモードで動作します。
キーストアのファイルパスnioListener_ftps_keystore_file任意の文字列空文字列絶対パスで記述してください。
キーストアのパスワードnioListener_ftps_keystore_password6文字以上の任意の文字列空文字列
キーのパスワードnioListener_ftps_keystore_keyPassword6文字以上の任意の文字列空文字列この項目を指定しなかった場合は,キーストアのパスワードをキーのパスワードと見なします。
キーのエイリアスnioListener_ftps_keystore_keyAlias任意の文字列空文字列この項目を指定しなかった場合は,キーストアに含まれる最初のキー(キー証明書のフィンガープリントのバイト列を昇順にしたときの最初のキー)を利用します。
データコネクションの暗号化nioListener_ftps_dataConnection_securetrueまたはfalsetruePROTコマンドを指定していない場合,この項目の指定が有効になります。PROTコマンドが成功した場合は,その指定が有効になります。
 
trueを指定した場合は,データコネクションを暗号化します。
falseを指定した場合は,暗号化しません。

(凡例)-:特にありません。

注※
指定したパスに,「//」,「/./」,「/../」が含まれる場合は,エラーになります。なお,Windowsの場合は,大文字と小文字は区別されません。

表21-4 属性ファイルの定義項目一覧(ログ出力に関する設定)

分類定義項目定義名値の範囲デフォルト値補足
メッセージログ出力レベルserver_message_logLeveldebug,またはinfoinfoinfo:
通常の運用時に使用し,運用時に必要な情報を出力します。
debug:
テストや障害が発生した場合の調査時に使用し,infoの情報に加えて,デバッグ用の情報を出力します。
ログファイル1面当たりのファイルサイズserver_message_maxFileSize1MB~2048MB10MB単位の文字列も指定してください。
(単位:MB)
ログファイルのバックアップファイルの面数server_message_maxBackupIndex1~164
保守ログログ出力レベルserver_maintenance_logLeveldebug,またはinfoinfo「info」および「debug」の意味は,メッセージログの「ログ出力レベル」と同じです。
ログファイル1面当たりのファイルサイズserver_maintenance_maxFileSize1MB~2048MB5MB単位の文字列も指定してください。
(単位:MB)
ログファイルのバックアップファイルの面数server_maintenance_maxBackupIndex1~164
プロトコルトレースログログ出力レベルserver_protocol_logLeveldebug,またはinfoinfo「info」および「debug」の意味は,メッセージログの「ログ出力レベル」と同じです。
ログファイル1面当たりのファイルサイズserver_protocol_maxFileSize1MB~2048MB20MB単位の文字列も指定してください。
(単位:MB)
ログファイルのバックアップファイルの面数server_protocol_maxBackupIndex1~164
転送履歴ログログ出力レベルserver_history_logLeveldebug,またはinfoinfo「info」および「debug」の意味は,メッセージログの「ログ出力レベル」と同じです。
ログファイル1面当たりのファイルサイズserver_history_maxFileSize1MB~2048MB12MB単位の文字列も指定してください。
(単位:MB)
ログファイルのバックアップファイルの面数server_history_maxBackupIndex11
リソースアダプタ間共通ログログ出力レベルserver_common_logLeveldebug,またはinfoinfo「info」および「debug」の意味は,メッセージログの「ログ出力レベル」と同じです。
ログファイル1面当たりのファイルサイズserver_common_maxFileSize1MB~2048MB5MB単位の文字列も指定してください。
(単位:MB)
ログファイルのバックアップファイルの面数server_common_maxBackupIndex1~164
(凡例)-:特にありません。

(4) ユーザ情報の設定

ユーザ情報は,FTPインバウンドアダプタによって,ファイルとして管理されます。認証情報のファイルは,管理者権限を持っている管理者が運用コマンドを実行することによって,登録,更新,削除,および表示できます。

(a) 認証情報の運用コマンド

認証情報の運用コマンドを次の表に示します。

表21-5 認証情報の運用コマンド

運用コマンド内容
csmftpaddusr(FTPインバウンドアダプタのユーザの登録・更新コマンド)ユーザを新規に登録します。また,すでに登録されているユーザのパスワードを更新します。
csmftpdelusr(FTPインバウンドアダプタのユーザの削除コマンド)登録されているユーザの認証情報を削除します。
csmftplsusr(FTPインバウンドアダプタのユーザの表示コマンド)登録されているユーザの認証情報を表示します。

運用コマンドの詳細は,マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「4. コマンド(運用環境・実行環境)」の説明を参照してください。

運用コマンドを実行するときの注意事項を次に示します。

運用コマンドの実行形式を次に示します。

(b) 認証情報へのアクセス制限

認証情報にアクセス制限をするには,運用者が運用開始前に,認証情報のファイルに対して,運用コマンドを実行する管理者だけに更新・参照のアクセス権を設定する必要があります。

なお,管理者にアクセス権を設定すると,認証情報のファイルの所有者は管理者となります。