MARSインストールガイド

Size: px

Start display at page:

Download "MARSインストールガイド"

そよこうじょう
6 years ago
Views:

1 MARS インストールガイド Pactera Technology International Ltd. 1

2 目次 1. ようこそドキュメントのご利用更新履歴動作環境 Workstation Agent ハードウェア Controller ハードウェアソフトウェア MARS の全体構成 MySQL のインストール MARS Controller のインストール MARS Workstation のインストール MARS Agent for Windows のインストール MARS Mobile のインストール MARS プラグインの設定 FAQ( よくある質問 ) MARS においてスクリプトのデバッグは必要ですかテストシナリオとは何ですかデータベースを新規作成する時 SQL エラーが発生する原因は何ですか管理者 ID で MARS をログインしテストプロジェクトが作成出来ないのはなぜですかライセンスファイルを MARS Controller へ導入しましたが Controller が起動後ライセンス認証エラーが発生しました MARS Controller を起動後アクセス拒否エラーが発生しましたホットキー競合についてどのように回避しますか IE エンジンで対象画面項目が識別できなかったためテストケース実行中に異常終了が発生してしまいましたがどう解決しますか MARS のインストールディレクトリ権限はどう設定しますか MARS は IE11 ブラウザでテストの実行はできますか MARS で全画面キャプチャを取得する際カーソルがブリンクすることによりコンペア結果の不一致問題が発生しました解決方法はありますか MARS 実行中原因不明の異常終了が発生しましたどう解決しますか

3 9.13. IE ブラウザのイントラネットメッセージを表示させない方法はありますか IE ブラウザのメッセージバーに表示されるスクリプトや Active X コントロール実行に関する警告メッセージを表示させない方法はありますか MARS 実行中に証明書エラーが表示させない方法はありますか MARS Workstation のウィンドウを常に最大化で開きたい場合はどう設定しますか

4 1. ようこそようこそ Pactera テスト自動化ソフトウエア MARS のご利用へ本書は MARS に関連する環境を構築するためのインストールガイドとなります 1.1. ドキュメントのご利用本ガイドは MARS 製品のインストールを行う方々にスムーズに進めていただくために作成したドキュメントとなります 1.2. 更新履歴バージョン内容ドキュメントの新規作成 MARS Agent for Windows のインストールに関する説明の追加 MARS Controller のインストールに関する説明の追加一括更新新アイコンの更新 Ver バージョンにアップデート MARS Workstation と MARS Agent for Windows のインストールに関する説明の更新 FAQ の追加 MARS Mobile のインストールに関する説明の追加 FAQ の 9.13 と 9.14 の追加 FAQ の 9.15 の追加 MARS Mobile のインストールに関する説明の更新 FAQ の 9.16 の追加サポート対象となるブラウザリストの追加 2.4 MARS 部品の構成イメージ図の更新 MARS mobile のインストールに関する説明の更新 4

5 2. 動作環境 2.1. Workstation Agent ハードウェアハードディスク : 80G 以上 CPU: Intel i 以上メモリー : 4G 以上 2.2. Controller ハードウェアハードディスク : 80G 以上 CPU: Intel i 以上メモリー : 8G 以上 2.3. ソフトウェア OS:XP Windows 7 Windows 8 Windows 8.1 Windows 10 MARS がサポート対象となるブラウザをインストールすることを前提とします Fixfox: Sarfari: MACOS Chrome: 33~ ~62 Edge: 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:9007 5

2.4. MARS の全体構成 MARS を動かすには MySQL Controller Workstation Agent Mobile の五つのプログラムをインストールする必要があります通常 Controller がインストールされているコンピュータに MySQL をインストールします基本的には Workstation Controller Agent

6 2.4. MARS の全体構成 MARS を動かすには MySQL Controller Workstation Agent Mobile の五つのプログラムをインストールする必要があります通常 Controller がインストールされているコンピュータに MySQL をインストールします基本的には Workstation Controller Agent は別々のコンピュータにインストールを行います MARS で作成したテストケーステストシナリオを疎通するには Workstation をインストールしたコンピュータに同時に Agent のインストールをします疎通が通ったシナリオは Agent のみインストールされたコンピュータにて一括実行が実現可能となりますモバイルデバイステストを実施する必要な場合は Agent がインストールされたコンピュータに Mobile 部品をインストールします MARS の五つのプログラムは同一のコンピュータにインストールすることも可能です MARS 関連部品構成のイメージは下記の図の通りとなります 6

7 3. MySQL のインストール MySQL のインストールパッケージは MARS の公式サイトよりダウンロードしていただけます MARS を正しくご利用いただくため MARS の公式サイトより指定バージョンの MySQL をダウンロードしていただきます MySQL をインストールする前にインストール先のフォルダ配下には MySQL フォルダが存在しないことをあらかじめご確認をお願いします MySQL のインストール MySQLSetup.exe をダブルクリックするとインストールが始まります 7

8 Setup Type を Custom に選択した上 Next ボタンをクリックすると次の設定画面に遷移します Developer Components をクリックし This feature, and all subfeatures, will be installed on local hard drive. を選択するとローカルディスクに配置されます 8

9 Change... ボタンをクリックすると MySQL のデフォルトインストールパスが変更できますインストール先を変更後 Next ボタンをクリックし確認画面へ移ります 9

10 Install ボタンをクリックし設定した通りにインストールが始まりますインストールが完了するまでにお待ちください 10

11 インストール完了後 Skip Sign-Up を選択し Next ボタンをクリックします Configure the MySQL Server now にチェックを入れ Finish ボタンをクリックします 11

12 MySQL のセットアップを開始するため Next ボタンをクリックします Detailed Configuration を選択した上 Next ボタンをクリックします 12

13 Developer Machine を選択した上 Next ボタンをクリックします Multifunctional Database を選択した上 Next ボタンをクリックします 13

14 Next ボタンをクリックします Manual Setting を選択した上最大接続人数 ( 同時接続時通常ライセンス数より多く指定 ) を指定し Next ボタンをクリックします 14

15 Enable TCP/IP Networking をチェックしポート番号 (Port Number) を 3306 に設定します Enable Strict Mode をチェックし Next ボタンをクリックします Manual Selected Default Character Set/Collation を選択した上 Character Set を utf8 に設定し Next ボタンをクリックします 15

Settings をチェックした上新しいパスワードと確認パスワードにすべて root を入力します Enable root access

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 ボタンをクリックします 16

17 Execute ボタンをクリックし MySQL の設定を有効にするように設定します Finish ボタンをクリックし MySQL のデータベースの設定を完了とします 17

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 のようにファイル定義を変更した上編集内容を保存します 18

19 MySQL がインストールされたフォルダ配下にある my.ini と my-small.ini 設定ファイルをそれぞれ編集する必要があります my.ini ファイルの [mysqld] の後に thread_stack=500k の定義を追加します my-small.ini ファイルの thread_stack=64k を thread_stack=500k( か 500K 以上の数値 ) に変更する必要があります編集内容を保存します 19

4. MARS Controller のインストール *MARS Controller( 以下は Controller と略称 ) は MARS Workstation 及び MARS Agent をコントロールする部品であり基本的には MySQL と同じコンピュータにインストールするようお勧めしますがもちろん MySQL

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 ボタンをクリックします 20

21 Browse... ボタンをクリックするとインストール先が変更できます MARS Controller のインストール先 ( デフォルトは MARS フォルダ配下 ) を選択し Next ボタンをクリックしますインストール先に指定したフォルダが既存した (MARS のバージョンアップやすでにライセンスが取得した ) 場合メッセージ表示ウィンドウの Yes ボタンをクリックします 21

22 フォルダ名をデフォルト (Controller) のまま Next ボタンをクリックします Create a desktop icon にチェックを入れた上 Next ボタンをクリックします 22

23 Install ボタンをクリックし設定した通りにインストールが始まりますインストール完了をお待ちください 23

24 Finish ボタンをクリックし Controller のインストールを完了します 24

25 5. MARS Workstation のインストール *MARS Workstation( 以下は Workstaion と略称 ) はシナリオやテストケースなどの編集を実施する作業プラットフォームですテストケース編集を操作する各ユーザのコンピュータにそれぞれインストールする必要があります MARS Workstation_x.x.x_xxx.exe をダブルクリックすると Workstation のインストールが始まります Next ボタンをクリックします 25

26 Browse... ボタンをクリックするとインストール先が変更できます MARS Workstation のインストール先 ( デフォルトは MARS フォルダ配下 ) を選択し Next ボタンをクリックしますインストール先に指定したフォルダが既存した (MARS のバージョンアップやすでにライセンスが取得した ) 場合メッセージ表示ウィンドウの Yes ボタンをクリックします 26

27 フォルダ名をデフォルト (Workstation) のまま Next ボタンをクリックします Create a desktop icon をチェックした上 Next ボタンをクリックします 27

28 Install ボタンをクリックし設定した通りにインストールが始まりますインストール完了をお待ちください 28

29 Finish ボタンをクリックし Workstation のインストールを完了します 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 のインストールが始まります Next ボタンをクリックします 30

31 Browse... ボタンをクリックするとインストール先が変更できます MARS Agent のインストール先 ( デフォルトは MARS フォルダ配下 ) を選択し Next ボタンをクリックしますインストール先に指定したフォルダが既存した (MARS のバージョンアップやすでにライセンスが取得した ) 場合メッセージ表示ウィンドウの Yes ボタンをクリックします 31

32 フォルダ名をデフォルト (Agent) のまま Next ボタンをクリックします Create a desktop icon をチェックした上 Next ボタンをクリックします 32

33 Install ボタンをクリックし設定した通りにインストールが始まりますインストール完了をお待ちください 33

34 Finish ボタンをクリックし Agent のインストールを完了します 34

35 7. MARS Mobile のインストール *MARS Mobile( 以下は Mobile と略称 ) は Android デバイス上で自動化テストを行うモジュールとして MARS Agent For Windows がインストールされたコンピュータにインストールする必要があります Workstation で編集されたモバイル用のテストケースは USB で接続された Android モバイルデバイス上で実行を行います ( ただ Chorme ブラウザのみサポートしております ) MARS Mobile _x.x.x_xxx.exe をダブルクリックすると Mobile のインストールが始まります 35

36 Browse... ボタンをクリックするとインストール先が変更できます MARS Mobile のインストール先 ( デフォルトは MARS\Agent\bin フォルダ配下 ) を選択し Next ボタンをクリックします 36

37 インストール先に指定したフォルダが既存した (MARS のバージョンアップやすでにライセンスが取得した ) 場合メッセージ表示ウィンドウの Yes ボタンをクリックします Install ボタンをクリックし設定した通りにインストールが始まります 37

38 インストール完了をお待ちください Finish ボタンをクリックし Mobile のインストールを完了します 38

39 MARS Mobile がインストール完了後システム環境変数の Path を編集します Path 設定値 :C:\Program Files (x86)\mars\agent\bin\appium 39

Android SDK 圧縮パッケージを MARS 公式サイト (http://mars.pactera.

40 Android SDK 圧縮パッケージを MARS 公式サイト ( SDK.zip) よりダウンロードしていただけますローカルの任意場所に解凍しシステム変数を新規作成した上環境変数 Path の編集を行います変数名 :ANDROID_HOME 変数値 : 解凍したファイルの保存パス Path 設定値 :%ANDROID_HOME%\tools %ANDROID_HOME%\platform-tools 40

41 8. MARS プラグインの設定 * 本章はお客様の特別なニーズに応えるため現行の MARS 標準版以外の機能に関するカスタマイズしたプラグインの設定方法についてご説明しますカスタマイズが必要のないユーザはこの節を飛ばしてくださいまず MARS チームより提供したカスタマイズのプラグインパッケージ xxx.msext を MARS Workstation がインストールされた plugin フォルダにコピーしてください 41

42 MARS Workstation を起動し任意のテストケース編集ウィンドウを開くとメニューバーにカスタマイズプラグインのアイコンが表示されますプラグインアイコンをクリックし当該プルダウンメニューからカスタマイズした機能項目が確認できますそれを選択することによりカスタマイズアクションが編集できるようになります 42

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. ホットキー競合についてどのように回避しますか自動化テストを実行する前に入力パネルのデフォルト言語を英語に設定してください 43

44 9.8. IE エンジンで対象画面項目が識別できなかったためテストケース実行中に異常終了が発生してしまいましたがどう解決しますか IE ブラウザのセキュリティレベルが高い場合は IE エンジンにて画面項目の認識ができなくなりテストケース実行中に異常終了が発生してしまう恐れがありますそのため IE ブラウザの設定を見直す必要があります管理者権限で IE ブラウザを開き IE の設定アイコンでマウスを右クリックしインターネットオプションを選択します 44

45 インターネットオプションウィンドウをセキュリティタグに切り替え下記のハードコピーのようにセキュリティ配下の四つのアイコンをそれぞれクリックし設定を行います各アイコンの保護モードを有効にするというチェックボックスのチェックを外した上 OK ボタンで設定内容を保存します 45

46 46

47 47

48 48

49 IE の拡大率 (Zoom) を 100% に設定します 49

50 9.9. MARS のインストールディレクトリ権限はどう設定しますか MARS フォルダを右クリックしメニューからプロパティを選択します 50

51 セキュリティタブをクリックしアクセス権限付与の対象ユーザを選択した上編集ボタンを押下します 51

52 アクセス権限付与の対象ユーザを選択した上すべてのアクセス権限にそれぞれチェックを入れ OK ボタンをクリックし変更内容を保存します 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 を設定してください 53

54 54

55 9.11. MARS で全画面キャプチャを取得する際カーソルがブリンクすることによりコンペア結果の不一致問題が発生しました解決方法はありますか MARS で全画面キャプチャを取得する時入力エリア内でカーソルの点滅により同じ画面表示でも取得したスクリーンショットのコンペア不一致が発生しましたこの問題を解消するためには下記の通り設定を行いますコントロールパネルをクリックします 55

56 コンピュータの簡単操作をクリックしますキーボードの動作の変更をクリックします 56

57 キーボード設定 (B) をクリックします 57

58 カーソルの点滅速度 (B) をなしと設定します 58

59 9.12. MARS 実行中原因不明の異常終了が発生しましたどう解決しますか MARS 実行中原因不明の異常終了が発生したら下記の設定を行ってみてください管理者権限で MARS 部品を起動します例えば MARS Controller MARS Workstation 及び MARS Agent のアイコンを右クリックし管理者として実行をクリックし起動してくださいセキュリティソフトウェア ( 例えば 360 Safety Guard などのアンチウイルスソフトウェア ) は MARS の実行をブロックする恐れがありますのでこのようなソフトウェアをアンロードするよう設定をお願いします Windows ファイアウォールの設定をしますコントロールパネルをクリックし Windows ファイアウォールをクリックします 59

60 Windows ファイアウォールの有効化または無効化を選択しますすべての設定項目の Windows ファイアウォールを無効にするを選択し OK ボタンで変更内容を保存します 60

61 電源オプションの設定コントロールパネルをクリックし電源オプションをクリックしますプラン設定の変更をクリックします 61

62 お使いのコンピュータで使用するスリープ状態とディスプレイの設定をすべてなしと変更した上変更の保存を押下します個人設定コントロールパネル個人設定の順にをクリックします 62

63 個人設定画面のスクリーンセーバーをクリックします 63

64 スクリーンセーバーをなしに設定した上 OK ボタンで変更を保存します 64

65 9.13. IE ブラウザのイントラネットメッセージを表示させない方法はありますか IE ブラウザでシナリオ実行中にイントラネット設定は規定でオフになりましたというメッセージが表示されています 65

66 このメッセージが表示されたことによりシナリオの正常実行に影響を及ぼした場合は下記のように設定を変更します IE ブラウザのツールアイコンをクリックしインターネットオプションを選択します 66

67 セキュリティタブローカルイントラネットサイトの順にをクリックしますローカルイントラネットウィンドウにてイントラネットのネットワークを自動的に検出するのチェックを外した上 OK ボタンで変更内容を保存します 67

68 9.14. IE ブラウザのメッセージバーに表示されるスクリプトや Active X コントロール実行に関する警告メッセージを表示させない方法はありますか IE ブラウザのメッセージバーにはシナリオ実行中にこの Web ページはスクリプトや ActiveX コントロールを実行しないように制限されていますのようなセキュリティ警告が表示されていますこのようなメッセージが表示されたことによりシナリオの正常実行に影響を及ぼした場合は下記のように設定を変更します IE ブラウザのツールアイコンをクリックしインターネットオプションを選択します 68

69 詳細設定タブに切り替えます ( 設定 ) セキュリティカテゴリー配下にあるマイコンピュータのファイルでアクティブコンテンツの実行を許可するにチェックを入れ OK ボタンで変更内容を保存します 69

70 70

71 9.15. MARS 実行中に証明書エラーが表示させない方法はありますか IE ブラウザでシナリオ実行中にこの Web サイトのセキュリティ証明書は問題がありますという警告が表示されていますこのサイトの閲覧を続行する ( 推奨されません ) というリンクをクリックしますアドレスバーに証明書エラーとなるをクリックし証明書は信頼できませんというダイアログを表示させ証明書を表示リンクをクリックします 71

72 証明書ダイアログの証明書のインストールボタンをクリックします 72

73 証明書のインポートウィザード画面にて次へボタンをクリックします 73

74 証明書のインポートウィザード画面にて証明書をすべて次のストアに配置する (P) を選択します参照ボタンをクリックし証明書のストア選択画面が開きます信頼されたルート証明機関を選択し前画面へ戻り次へボタンをクリックします 74

75 証明書のインポートウィザード画面にて完了ボタンを押下し変更内容を保存します 75

76 はいボタンをクリックします正しくインポートされたことが確認した上 OK ボタンをクリックします 76

77 インターネットオプション > 詳細設定 >( 設定 ) セキュリティ配下のサーバの証明書失効を確認する * のチェックを外し OK ボタンで編集内容を保存しますコンピュータを再起動した後に変更内容が有効となります 77

78 9.16. MARS Workstation のウィンドウを常に最大化で開きたい場合はどう設定しますか MARS プログラムを常に最大化した状態で起動したい場合はコンピュータディスプレイのカスタマイズを設定し MARS プログラムが最大化表示するようになります下記の通りにディスプレイ設定をしますデスクトップでマウスを右クリック画面の解像度解像度解像度を 100%( 推奨設定 ) に設定します 78

ご利用の前に目次推奨環境とソフトウェアのバージョン推奨環境について Windows8 Windows8.1 について Internet Explorer のバージョン確認 SAMWEB の初期設定セ

ご利用の前に目次推奨環境とソフトウェアのバージョン推奨環境について Windows8 Windows8.1 について Internet Explorer のバージョン確認 SAMWEB の初期設定セ操作マニュアル ( ご利用の前に ) 2016.10.14 v1.6 ご利用の前に目次 - 01. 推奨環境とソフトウェアのバージョン... 3 1. 推奨環境について... 3 2. Windows8 Windows8.1 について... 4 3. Internet Explorer のバージョン確認... 5 02. SAMWEB の初期設定... 7 1. セキュリティ設定... 7 2.