1
MARS インストールガイド
2
目次 1. ようこそ ... 4 1.1. ドキュメントのご利用 ... 4 1.2. 更新履歴 ... 4 2. 動作環境 ... 5 2.1. Workstation、Agent ハードウェア ... 5 2.2. Controller ハードウェア ... 5 2.3. ソフトウェア ... 5 2.4. MARS の全体構成 ... 6 3. MySQL のインストール ... 7 4. MARS Controller のインストール ... 20 5. MARS Workstation のインストール ... 256. MARS Agent for Windows のインストール ... 30
7. MARS Mobile のインストール ... 35 8. MARS プラグインの設定 ... 41 9. FAQ（よくある質問） ... 43 9.1. MARS において、スクリプトのデバッグは必要ですか... 43 9.2. テストシナリオとは何ですか ... 43 9.3. データベースを新規作成する時、SQL エラーが発生する原因は何ですか ... 43 9.4. 管理者 ID で MARS をログインし、テストプロジェクトが作成出来ないのはなぜですか... 43
9.5. ライセンスファイルを MARS Controller へ導入しましたが、Controller が起動後、ライセンス認証 エラーが発生しました ... 43 9.6. MARS Controller を起動後、アクセス拒否エラーが発生しました ... 43 9.7. ホットキー競合について、どのように回避しますか ... 43 9.8. IE エンジンで対象画面項目が識別できなかったため、テストケース実行中に異常終了が発生し てしまいましたが、どう解決しますか ... 44 9.9. MARS のインストールディレクトリ権限はどう設定しますか ... 50 9.10. MARS は、IE11 ブラウザでテストの実行はできますか ... 53 9.11. MARS で全画面キャプチャを取得する際、カーソルがブリンクすることにより、コンペア結果の不 一致問題が発生しました。解決方法はありますか ... 55 9.12. MARS 実行中、原因不明の異常終了が発生しました。どう解決しますか ... 59
3
9.13. IE ブラウザのイントラネットメッセージを表示させない方法はありますか ... 65 9.14. IE ブラウザのメッセージバーに表示されるスクリプトや Active X コントロール実行に関する警告 メッセージを表示させない方法はありますか ... 68 9.15. MARS 実行中に、証明書エラーが表示させない方法はありますか ... 71 9.16. MARS Workstation のウィンドウを常に「最大化」で開きたい場合は、どう設定しますか ... 784
1. ようこそ
ようこそ、Pactera テスト自動化ソフトウエア「MARS」のご利用へ。
本書は、MARS に関連する環境を構築するためのインストールガイドとなります。
1.1. ドキュメントのご利用
本ガイドは MARS 製品のインストールを行う方々に、スムーズに進めていただくために作成した ドキュメントとなります。1.2. 更新履歴
バージョン 内容 2014-8-8 ドキュメントの新規作成2015-1-28 MARS Agent for Windows のインストールに関する説明の追加 2015-3-13 MARS Controller のインストールに関する説明の追加
2016-3-7 一括更新
2016-6-17 新アイコンの更新
2016-6-20 Ver 2.7.0 バージョンにアップデート
2017-4-13 MARS Workstation と MARS Agent for Windows のインストー ルに関する説明の更新 2017-4-14 FAQ の追加 2017-4-20 MARS Mobile のインストールに関する説明の追加 2017-5-17 FAQ の 9.13 と 9.14 の追加 2017-6-9 FAQ の 9.15 の追加 2017-6-15 MARS Mobile のインストールに関する説明の更新 2017-6-29 FAQ の 9.16 の追加 2017-12-15 2.3 サポート対象となるブラウザリストの追加、 2.4 MARS 部品 の構成イメージ図の更新、MARS mobile のインストールに関す る説明の更新
5
2. 動作環境
2.1. Workstation、Agent ハードウェア
ハードディスク： 80G 以上
CPU： Intel i3-2120 以上
メモリー： 4G 以上2.2. Controller ハードウェア
ハードディスク： 80G 以上
CPU： Intel i5-3470 以上
メモリー： 8G 以上2.3. ソフトウェア
OS：XP、Windows 7、Windows 8、Windows 8.1、Windows 10
MARS がサポート対象となるブラウザをインストールすることを前提とします。 Fixfox：55、56、57 Sarfari: MACOS 10.12、10.13 Chrome: 33~37、44、48、54~62 Edge: 14393、15063、16299
DB：MySQL 5.0
.Net Framework バージョン：4.0
Microsoft Excle：2007 以上
MARS の関連部品は下記のポート番号を使っておりますが、他のアプリに占用されないように事前 確認をお願いします。 MySQL DB：3306 MARS Controller：9003 MARS Workstation：9006 MARS Agent for Windows：90076
2.4. MARS の全体構成
MARS を動かすには、MySQL、Controller、Workstation、Agent、Mobile の五つのプログラムをイ ンストールする必要があります。
通常、Controller がインストールされているコンピュータに MySQL をインストールします。
基本的には Workstation、Controller、Agent は別々のコンピュータにインストールを行います。
MARS で作成したテストケース、テストシナリオを疎通するには、Workstation をインストールしたコ ンピュータに同時に Agent のインストールをします。疎通が通ったシナリオは Agent のみインストー ルされたコンピュータにて一括実行が実現可能となります。
モバイルデバイステストを実施する必要な場合は、Agent がインストールされたコンピュータに Mobile 部品をインストールします。
MARS の五つのプログラムは同一のコンピュータにインストールすることも可能です。 MARS 関連部品構成のイメージは下記の図の通りとなります。7
3. MySQL のインストール
※MySQL のインストールパッケージは MARS の公式サイトよりダウンロードしていただけます。
http://mars.pactera.com/MySQLSetup.exe。
MARS を正しくご利用いただくため、MARS の公式サイトより指定バージョンの MySQL をダウンロード していただきます。
MySQL をインストールする前に、インストール先のフォルダ配下には MySQL フォルダが存在しない ことをあらかじめご確認をお願いします。
MySQL のインストール8
✓ Setup Type を Custom に選択した上、Next ボタンをクリックすると、次の設定画面に遷移します。✓ Developer Components をクリックし、This feature, and all subfeatures, will be installed on local hard drive.を選択すると、ローカルディスクに配置されます。
9
✓ Change... ボタンをクリックすると、MySQL のデフォルトインストールパスが変更できます。10
✓ Install ボタンをクリックし、設定した通りにインストールが始まります。11
✓ インストール完了後、Skip Sign-Up を選択し、 Next ボタンをクリックします。12
✓ MySQL のセットアップを開始するため、Next ボタンをクリックします。13
✓ Developer Machine を選択した上、Next ボタンをクリックします。14
✓ Next ボタンをクリックします。✓ Manual Setting を選択した上、最大接続人数(同時接続時、通常ライセンス数より多く指定)を指定 し、Next ボタンをクリックします。
15
✓ Enable TCP/IP Networking をチェックし、ポート番号(Port Number)を 3306 に設定します。✓ Enable Strict Mode をチェックし、Next ボタンをクリックします。
✓ Manual Selected Default Character Set/Collation を選択した上、Character Set を utf8 に設定 し、Next ボタンをクリックします。
16
✓ Install As Windows Service をチェックし、ServiceName を MySQL に指定し ます。✓ Include Bin Directory in Windows PATH をチェックし、Next ボタンをクリックします。
✓ Modify Security Settings をチェックした上、新しいパスワードと確認パスワードにすべて root を入 力します。
✓ Enable root access from remote machines にチェックを入れ、Create An Anonymous Account を 選択しない状態で、Next ボタンをクリックします。
17
✓ Execute ボタンをクリックし、MySQL の設定を有効にするように設定します。18
その他のファイル設定 ✓ MySQL がインストールされたフォルダ配下にある、my.ini ファイルを編集する必要があります。 [MySQLd] の後に max_allowed_packet=20M wait_timeout=30 interactive_timeout=30 max_connect_errors=1000 上記の設定を追加した上、ファイルを保存します。 ファイル編集後、MySQL サービスを再起動した後に変更内容が有効となります。 ✓ MySQL がインストールされたフォルダ配下にある、my.ini ファイルを編集する必要があります。 MARS ライセンスファイルで指定した最大アクセスユーザ数と関連するため、my.ini 設定ファイル には、MySQL への最大接続数を定義しています。 max_connections=100 の「100」という数値は、実際の最大接続ユーザ数に合わせて計算した上、その計算結果数値と 置き換える必要があります。 例えば：ライセンス許可ユーザ数が 40 人の場合は、最大接続数を 40 * 20 = 800 のように、設 定ファイルの最大接続数を max_connections=800 のようにファイル定義を変更した上、編集内容を保存します 。19
✓ MySQL がインストールされたフォルダ配下にある、my.ini と my-small.ini 設定ファイルをそれぞれ編集する必要があります。
my.ini ファイルの [mysqld] の後に thread_stack=500K の定義 を追加します。
my-small.ini ファイルの thread_stack=64K を thread_stack=500K（か 500K 以上 の数値）に変更す る必要があります。
20
4. MARS Controller のインストール
*MARS Controller(以下は Controller と略称）は、MARS Workstation 及び MARS Agent をコントロー ルする部品であり、基本的には、MySQL と同じコンピュータにインストールするようお勧めしますが、も ちろん、MySQL と別々のコンピュータにインストールしても問題がありません。
Controller と MySQL の接続は、MySQL がインストールされたマシンの IP アドレスを利用します。
Mars_controller_x.x.x_xxx.exe をダブルクリックすると、Controller のインストールが始まります。 Next ボタンをクリックします。21
Browse... ボタンをクリックすると、インストール先が変更できます。MARS Controller のインストール 先(デフォルトは MARS フォルダ配下)を選択し、Next ボタンをクリックします。
インストール先に指定したフォルダが既存した(MARS のバージョンアップや、すでにライセンスが 取得した)場合、メッセージ表示ウィンドウの Yes ボタンをクリックします。22
フォルダ名をデフォルト（Controller）のまま、Next ボタンをクリックします。
23
Install ボタンをクリックし、設定した通りにインストールが始まります。24
25
5. MARS Workstation のインストール
*MARS Workstation（以下は Workstaion と略称）はシナリオやテストケースなどの編集を実施する作 業プラットフォームです。テストケース編集を操作する各ユーザのコンピュータにそれぞれインストール する必要があります。
MARS Workstation_x.x.x_xxx.exe をダブルクリックすると、Workstation のインストールが始まりま す。26
Browse... ボタンをクリックすると、インストール先が変更できます。MARS Workstation のインストー ル先（デフォルトは MARS フォルダ配下）を選択し、Next ボタンをクリックします。
インストール先に指定したフォルダが既存した（MARS のバージョンアップや、すでにライセンスが 取得した）場合、メッセージ表示ウィンドウの Yes ボタンをクリックします。27
フォルダ名をデフォルト（Workstation)のまま、Next ボタンをクリックします。28
Install ボタンをクリックし、設定した通りにインストールが始まります。29
30
6. MARS Agent for Windows のインストール
*MARS Agent for Windows（以下は Agent for Windows と略称）はテストケースを実行するための部 品です。テスト実行を行う各コンピュータに Agent for Windows をそれぞれインストールする必要があ ります。通常、MARS で作成したテストケースを疎通するために、Agent for Windows は MARS Workstation と同じコンピュータにインストールすることをお勧めします。
MARS Agent_x.x.x_xxx.exe をダブルクリックすると、Agent for Windows のインストールが始まりま す。31
Browse... ボタンをクリックすると、インストール先が変更できます。MARS Agent のインストール先 （デフォルトは MARS フォルダ配下）を選択し、Next ボタンをクリックします。
インストール先に指定したフォルダが既存した（MARS のバージョンアップや、すでにライセンスが 取得した）場合、メッセージ表示ウィンドウの Yes ボタンをクリックします。32
フォルダ名をデフォルト（Agent）のまま、Next ボタンをクリックします。33
Install ボタンをクリックし、設定した通りにインストールが始まります。34
35
7. MARS Mobile のインストール
*MARS Mobile（以下は Mobile と略称）は Android デバイス上で、自動化テストを行うモジュールとし て、MARS Agent For Windows がインストールされたコンピュータにインストールする必要があります。 Workstation で編集されたモバイル用のテストケースは USB で接続された Android モバイルデバイス 上で実行を行います。(ただ Chorme ブラウザのみサポートしております。)
36
Browse... ボタンをクリックすると、インストール先が変更できます。MARS Mobile のインストール先 （デフォルトは MARS\Agent\bin フォルダ配下）を選択し、Next ボタンをクリックします。37
■インストール先に指定したフォルダが既存した（MARS のバージョンアップや、すでにライセンスが取得した）場合、メッセージ表示ウィンドウの Yes ボタンをクリックします。
38
インストール完了をお待ちください。39
MARS Mobile がインストール完了後、システム環境変数の Path を編集します。 Path 設定値：C:\Program Files (x86)\Mars\Agent\bin\appium40
Android SDK 圧縮パッケージを MARS 公式サイト(http://mars.pactera.com/Android SDK.zip)よりダウンロードしていただけます。 ローカルの任意場所に解凍し、システム変数を新規作成した上、環境変数 Path の編集を行いま す。 変数名：ANDROID_HOME 変数値：解凍したファイルの保存パス Path 設定値：%ANDROID_HOME%\tools %ANDROID_HOME%\platform-tools
41
8. MARS プラグインの設定
*本章は、お客様の特別なニーズに応えるため、現行の MARS 標準版以外の機能に関するカスタマ イズしたプラグインの設定方法についてご説明します。
カスタマイズが必要のないユーザはこの節を飛ばしてください。
まず、MARS チームより提供したカスタマイズのプラグインパッケージ xxx.msext を MARS Workstation がインストールされた plugin フォルダにコピーしてください。42
MARS Workstation を起動し、任意のテストケース編集ウィンドウを開くと、メニューバーにカスタマ イズプラグインのアイコンが表示されます。プラグインアイコンをクリックし、当該プルダウンメニューからカスタマイズした機能項目が確認できま す。それを選択することにより、カスタマイズアクションが編集できるようになります。
43
9. FAQ（よくある質問）
9.1. MARS において、スクリプトのデバッグは必要ですか
MARS はまったくスクリプトのないテスト自動化ソフトウエアのため、利用者よりスクリプトの作成をす る必要はまったくありません。9.2. テストシナリオとは何ですか
テストシナリオは MARS 自動化テスト対象システムの業務フローです。 MARS の「シナリオ編集エリア」で、業務フローの開始から終了までの遷移フロー図を作成すること ができます。 「ノード」はそれぞれのテストの対象画面を表し、「コネクタ」は画面の遷移方向及び操作アクション などを表すために設計しております。ノードとノードの間にコネクタで繋げることが必須です。9.3. データベースを新規作成する時、SQL エラーが発生する原因は何ですか
MARS DB ユーザとして、root の権限が必要となります。MySQL の全てのアクセス権限の有無をご確認ください。
権限がない場合は、MySQL で下記の SQL スクリプトを実行してみてください。 grant all on *.* to root@'%' identified by "root" WITH GRANT OPTION;
9.4. 管理者 ID で MARS をログインし、テストプロジェクトが作成出来ないのは
なぜですか
管理者(Adminstrator)権限とは、プロジェクトメンバーのロール管理、及びプロジェクトマネージャー の設定のみとなります。プロジェクトマネージャ権限で、テストプロジェクトを新規することができます。
9.5. ライセンスファイルを MARS Controller へ導入しましたが、Controller が起
動後、ライセンス認証エラーが発生しました
MARS ライセンスの有効期限が切れていないか、ご提供いただいたコントローラ端末の MAC アド レスが間違っていないかをあらかじめご確認ください。それでも解決できない場合は、お手数です が、MARS のテクニックサポートまでご連絡ください。9.6. MARS Controller を起動後、アクセス拒否エラーが発生しました
サービス起動後、アクセス拒否エラーが表示されたら、システムユーザの MARS Controller ルート ディレクトリに対し、すべてのアクセス権限を付与するように設定を変更してください。9.7. ホットキー競合について、どのように回避しますか
自動化テストを実行する前に、入力パネルのデフォルト言語を英語に設定してください。44
9.8. IE エンジンで対象画面項目が識別できなかったため、テストケース実行中
に異常終了が発生してしまいましたが、どう解決しますか
IE ブラウザのセキュリティレベルが高い場合は、IE エンジンにて画面項目の認識ができなくなり、 テストケース実行中に異常終了が発生してしまう恐れがあります。そのため、IE ブラウザの設定を 見直す必要があります。
管理者権限で IE ブラウザを開き、IE の設定アイコンでマウスを右クリックし、インターネットオプショ ンを選択します。45
インターネット オプションウィンドウを セキュリティ タグに切り替え、下記のハードコピーのように、セ キュリティ配下の四つのアイコンをそれぞれクリックし、設定を行います。各アイコンの「保護モード を有効にする」というチェックボックスのチェックを外した上、OK ボタンで設定内容を保存します。49
50
9.9. MARS のインストールディレクトリ権限はどう設定しますか
MARS フォルダを右クリックし、メニューからプロパティ を選択します。51
セキュリティ タブをクリックし、アクセス権限付与の対象ユーザを選択した上、編集ボタンを押下し ます。52
アクセス権限付与の対象ユーザを選択した上、すべてのアクセス権限にそれぞれチェックを入53
9.10. MARS は、IE11 ブラウザでテストの実行はできますか
IE 11 ブラウザにおいて、MARS が正常に実行させるためには、レジストリエディターに情報を追加す る必要があります。
32-bit Windows の場合： HKEY_LOCAL_MACHINE └SOFTWARE └Microsoft └Internet Explorer └Main └FeatureControl └FEATURE_BFCACHE 配下には、種類は DWORD(REG_DWORD)である 「iexplore.exe」というファイルを新規し、データ値に 0 を設定してください。
64-bit Windows の場合：HKEY_LOCAL_MACHINE └SOFTWARE └Wow6432Node └Microsoft └Internet Explorer └Main └FeatureControl └FEATURE_BFCACHE 配下には、種類は DWORD(REG_DWORD)である 「iexplore.exe」というファイルを新規し、データ値に 0 を設定してください。55
9.11. MARS で全画面キャプチャを取得する際、カーソルがブリンクすることによ
り、コンペア結果の不一致問題が発生しました。解決方法はありますか
MARS で全画面キャプチャを取得する時、入力エリア内でカーソルの点滅により、同じ画面表示で も取得したスクリーンショットのコンペア不一致が発生しました。この問題を解消するためには、下 記の通り設定を行います。
コントロールパネル をクリックします。56
コンピュータの簡単操作をクリックします。57
58
59
9.12. MARS 実行中、原因不明の異常終了が発生しました。どう解決しますか
MARS 実行中、原因不明の異常終了が発生したら、下記の設定を行ってみてください。
管理者権限で MARS 部品を起動します。 例えば、MARS Controller、MARS Workstation 及び MARS Agent のアイコンを右クリックし、管理者として実行をクリックし、起動してください。
セキュリティソフトウェア（例えば 360 Safety Guard などのアンチウイルスソフトウェア）は、MARS の 実行をブロックする恐れがありますので、このようなソフトウェアをアンロードするよう設定をお願いし ます。
Windows ファイアウォールの設定をします。60
✓ Ｗindows ファイアウォールの有効化または無効化を選択します。✓ すべての設定項目の「Windows ファイアウォールを無効にする」を選択し、 OK ボタンで変更内 容を保存します。
61
電源オプションの設定✓ 「コントロール パネル」をクリックし、 電源オプション をクリックします。
62
✓ お使いのコンピュータで使用するスリープ状態とディスプレイの設定をすべて「なし」と変更した上、変更の保存を押下します。
個人設定63
✓ 個人設定画面のスクリーンセーバー をクリックします。64
✓ スクリーンセーバーをなしに設定した上、OK ボタンで変更を保存します。65
9.13. IE ブラウザのイントラネットメッセージを表示させない方法はありますか
IE ブラウザでシナリオ実行中に、「イントラネット設定は規定でオフになりました。」というメッセージ が表示されています。
66
このメッセージが表示されたことにより、シナリオの正常実行に影響を及ぼした場合は、下記のように設定を変更します。
67
セキュリティタブ→ローカル イントラネット→サイトの順にをクリックします。
ローカル イントラネットウィンドウにてイントラネットのネットワークを自動的に検出するのチェックを 外した上、OK ボタンで変更内容を保存します。68
9.14. IE ブラウザのメッセージバーに表示されるスクリプトや Active X コントロー
ル実行に関する警告メッセージを表示させない方法はありますか
IE ブラウザのメッセージバーには、シナリオ実行中に、「この Web ページはスクリプトや ActiveX コ ントロールを実行しないように制限されています。」のような、セキュリティ警告が表示されていま す。 このようなメッセージが表示されたことにより、シナリオの正常実行に影響を及ぼした場合は、下記 のように設定を変更します。
IE ブラウザのツールアイコンをクリックし、インターネット オプションを選択します。69
詳細設定タブに切り替えます。（設定）セキュリティカテゴリー配下にあるマイ コンピュータのファイルでアクティブ コンテンツの実 行を許可するにチェックを入れ、OK ボタンで変更内容を保存します。
