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