リモートコントロール (JA)-工事中
T-Planロボット・エンタープライズ・リモコン
内容
1.概要
についてリモコン(RC)はT-Plan Robot Enterprise v3.5からサポートされたスタンドアロンツールです。ローカルまたはリモートのRobotインスタンスで実行されるテストスクリプトを制御することができます。サポートされている操作
リストテストスクリプトとワークアイテム(が実行されている、
スタートテストスクリプトまたはワークアイテム (RC v2 および Robot 4.0.1 以降)
一時停止テストスクリプトまたはワークアイテム、
履歴書テストスクリプトまたはワークアイテム、
ストップテストスクリプトまたはワークアイテム、
キルサーバー (RC v2 および Robot 4.0.1 以降)
通信はTCP/IP接続で行われ、ロボットがサーバー、ツールがクライアントとして動作します。プロトコルはテキストベースなので、例えばtelnetでサーバーに接続することもできます。
2.セットアップ
T-Planロボットエンタープライズ
T-Plan Robot Enterpriseインスタンスは、バージョン3.5以上(RC v1.0)または4.0.1以上(RC v2.0)である必要があります。インスタンスを起動するにはリモート・コントロール・サーバーを指定してロボットを起動する。オプションを指定する。オプションの後に、--remotecontrol 5556 のようにポート番号を指定することもできる。ポートを省略すると、サーバーはデフォルトの5899番ポートで起動する。ターゲット・ポートがファイアウォールによって占有またはブロックされていないことを確認してください。
Robot4.0.1以降では、--remotecontrolと-n/-nodisplayを組み合わせてCLIモードで起動することができます。このモードではGUIを起動する必要がないため、必要なリソースを最小限に抑え、最高のパフォーマンスを得ることができます。このモードは配備シナリオに推奨される。
遠隔操作ツール
ツールのダウンロードはこちらから:
https://downloads.t-plan.com/releases/robot/plugins/remotecontrol_v2.zip
このツールにはJava SE 1.6(JREまたはJDK)が必要である。以下の手順は、Java実行ファイルがシステム・パスにあることを前提としている。これはJavaの要件の章を参照してください。Javaがシステムパスにない場合は、javaコールをjava.exe(Windows)またはjava(Unix/Linux)バイナリのフルパスに置き換えてください。例えば、"C:˶Program FilesJavajdk1.6.0_<version>˶java.exe "のようになります。ツールをインストールするには、ダウンロードしたZIPアーカイブをハードドライブに解凍するだけです。
3.使用方法
ツールを起動するには、ツール・ディレクトリに移動して実行する:
java -jar remotecontrol.jar [OPTIONS] [COMMAND]
または、提供されているスクリプトのいずれかを起動する(システム・パスにJavaが必要):
MS Windows: |
|
Unix/Linux: |
|
オプション:
-h, --host [ホスト名] | 接続先のホスト名 (オプション。デフォルトは localhost) |
-p, --port [port] | 接続するポート番号 (オプション。デフォルトは 5899) |
--ヘルプ | 使い方やオプションに関するヘルプを表示 |
COMMANDは任意である。例えば "pause "のように、実行するコマンドを1つだけ指定することもできる。コマンドが指定されない場合、ツールはtelnetに似た対話型プロンプトを開始する。サポートされているコマンド
バイバイ | 接続を閉じてセッションを終了する |
スタート [FILE] [OPTIONS] | 指定されたテストスクリプトを開始するかワークアイテムを実行し、終了を待たないでください。RC v2およびロボット4.0.1以降に対応 |
FILE] [OPTIONS] を実行する。 | startと同じですが、スクリプト/ワークアイテムの終了を待ちます。RC v2およびRobot 4.0.1からサポートされています。セッションが外部から強制終了された場合、リモートスクリプト/ワークアイテムの実行は停止しません。停止させるには、新しいセッションを開いて stop コマンドを実行してください。 |
ポーズ [NAME] | 指定された、または現在実行中のスクリプトやワークアイテムを一時停止する。 |
レジュメ | 指定された、または現在一時停止しているテストスクリプトまたはワークアイテムを再開します。 |
ストップ【NAME | 指定された、または現在実行中のスクリプトやワークアイテムを停止する |
リスト | 現在実行中のテストスクリプトおよび/またはワークアイテムの一覧を表示します。 |
キルサーバー | サーバをシャットダウンします。RC v2およびRobot 4.0.1からサポートされています。サーバがCLIモードで動作している場合(Robotがn/-nodisplayオプションで起動されている場合)、 このコマンドはRobotの全プロセスを終了させます。 |
ヘルプ | コマンドのヘルプを表示する |
期間「テストスクリプトの実行を通じて開始されたスクリプトを指す。Java APIを経由する。r/-run CLIオプション手動で実行ボタンは、GUI または RC コマンドの start/execute で指定します。Run コマンドを使用して開始されたサブスクリプトは適用されず、それらはリストされず、呼び出しスクリプトとは別に制御することはできません。FILE パラメータには、スクリプトまたはワークアイテムの完全なパスを指定します。パスにスペースが含まれる場合は、二重引用符 (") で囲む必要があります。OPTIONSは省略可能で、スクリプトに関連するものを1つ以上指定できます。CLIオプションv/var、-c/connect、-p/passwordなど。NAMEパラメータはオプションで、以下のいずれかを指定する:
についてスレッドID(名前)が自動テストスレッドに割り当てられている。createAutomatedRunnable()メソッドを使用します。スレッド ID は list コマンドの出力に表示されます。この属性は検索の優先順位が最も高く、同じテスト スクリプトの複数の実行を区別できます。マルチスレッドテストスクリプトの実行(負荷テスト)。
についてスクリプトファイルのフルパス例えば、C:¥MyAutomation¥script1.tpr。
についてスクリプトファイル名同じファイル名で複数のテスト スクリプトが実行されている場合、コマンドは最初に開始されたスクリプトに適用されます。
NAME パラメータが省略され、対象のロボットインスタンスが 1 つのテキストスクリプトを実行 している場合、操作はそのスクリプトに適用されます。実行中のテストスクリプトが 2 つ以上あり、NAME が指定されていない場合は、 サーバはエラーを報告して何も行いません。
例
ローカルで動作している T-Plan Robot Enterprise にデフォルトのポート 5899 で接続します:
java -jar remotecontrol.jar
アドレス上で動作するT-Plan Robot Enterpriseに接続します。red.fox.com:5222実行中のスクリプトを一時停止し、セッションを閉じる:
java -jar remotecontrol.jar -h red.fox.com -p 5222 pause
ローカルで動作している T-Plan Robot Enterprise のデフォルトポート 5899 に telnet で接続します:
telnet localhost 5899
アドレス上で動作しているT-Plan Robot Enterpriseにtelnetを使用して接続します。red.fox.com:5222:
telnet red.fox.com 5222
4.改善点
将来のバージョンでは、以下の改善が提供される可能性があります。優先順位を上げるにはサポートにご連絡ください。
SSLによるTCP/IP接続の保護
IP/ホスト名フィルタリングによる限定的なアクセスを許可する。
テストスクリプトからのサーバー起動