IRemoteHostConnectManagerクラス

newInstanceメソッド

IRemoteHostConnectorインタフェースの実装クラスのインスタンスを取得します。複数のリモートホストに対して通信を行う場合は,リモートホストごとにこのメソッドを実行してインスタンスを取得してください。

形式

public IRemoteHostConnector execCommand(Properties prop, String ipAddress,
           String userId, String password, CommunicationProtocol protocol)

入力

表3-31 入力項目一覧

項番引数名:型引数の意味制限
1prop :Properties (java.util.Properties)「表3-32プロパティキー」で示すプロパティキーと対応する値をセットしたプロパティクラスのオブジェクトを指定します。nullを指定した場合,デフォルト値を適用します。
2ipAddress :StringリモートホストのIPアドレスを指定します。IPv4だけです。
null指定はできません。
3userId : StringリモートホストのユーザIDを指定します。Windowsの場合はAdministrator権限を持つユーザだけです。
null指定はできません。
4password :Stringリモートホストのパスワードを指定します。null指定はできません。
5protocol :CommunicationProtocol接続方式を指定します。Linuxの場合:「SSH」
Windowsの場合:「DCOM」
注 enum型定数クラスでどちらかを選択します。
null指定はできません。

表3-32 プロパティキー

項番キー説明必須/任意指定範囲・条件デフォルト値
1RemoteHost.Portリモートホストの接続ポート番号任意半角数字(1~65535)
・Linuxだけ
・Windowsの場合は変更できません。
キーと値ともにnull指定はできません。
22(Linuxの場合)
139(Windowsの場合)
2RemoteHost.Connect.RetryNumリモートホストへのセッション再確立回数(単位:回)任意半角数字(0~600)
0を指定した場合,再確立をしません。
キーと値ともにnull指定はできません。
10
3RemoteHost.Connect.RetryWaitTimeセッション再確立間隔(単位:ms)任意半角数字(0,1,1000~600000)
再確立回数に0を指定した場合,この指定は無効になります。
キーと値ともにnull指定はできません。
5000
4RemoteHost.Connect.SSH.execWaitTimeSSH方式で,リモートホスト上で実行したコマンドの終了を待つ時間(単位:分)任意半角数字(1~60)
キーと値にはnull指定はできません。
定義
deploy.sshexcutetimerで指定された値を採用します。
注※ 設定値の見積もりについては,「2.2.2(6)タイマ,リトライ定義の説明」を参照してください。

出力

なし

例外

表3-33 エラーケース一覧

項番Exception発生理由
(原因コード)
発生後の動作対象リモートホスト
(Linux /Windows)
1CsdUocRemoteExcecuteAssertionFailedExceptionP_RemoCon.001処理を中断し,リターンします。共通
P_RemoCon.002

注 対処方法については,マニュアル「uCosminexus Service Director メッセージ」の「ファイル転送とコマンドのリモート実行時に出力するメッセージの原因コード」を参照してください。


注意事項

この機能を利用するために必ず実行する必要があります。