Macマシンにコネクターをインストールする

デバイスコネクターは、デバイスをDigital Labに接続するためのスタンドアロンコンポーネントです。 コネクターをスタンドアロンコンポーネントとしてMacマシンにインストールし、Digital Labサーバーに接続するように設定できます。分散コネクターマシンに接続されたデバイスは、Digital Labデバイスラボの一部になります。

このセクションでは、iOSまたはAndroidフォンをテストするためにMacマシンにコネクターをインストールする方法について説明します。

このトピックの内容:

始める前に

Digital Labのスタンドアロンコネクターは、フルインストールとして、またはDigital Lab (UFT Mobile) 3.0以降のコネクターの既存のインストールへのアップグレードとしてインストールできます。

コネクターをインストールまたは更新する前に、マシンが推奨システム要件に準拠していること、およびデバイスがサポートされていることを確認してください。詳細については、システム要件およびDigital Labへのデバイスの接続を参照してください。

新規インストールの場合のみ:

1. サーバーはコネクターからアクセス可能である必要があります。http/s://<Digital Lab server IP address>:<server port>に移動し、Digital Labにアクセスできることを確認します。
2. コネクターマシンの時間およびタイムゾーンがDigital Labサーバーの時間およびタイムゾーンと一致していることを確認してください。
3. 管理者からコネクターのアクセスキーを取得します。コネクターのインストール中にキーの入力を求められます。
   • 管理者ユーザー: アクセスキータブを選択します。[新規生成] をクリックし、名前、タイプ (コネクター)、有効期限、説明 (オプション) を入力します。次に、[生成] をクリックします。
   • 管理者以外のユーザー:管理者にリクエストしてください。[ヘルプ] メニュー (右上) から [管理者にお問い合わせください] を選択します。

トップに戻る

Macマシンをセットアップする

1. コネクターのインストールに既存のユーザーを使用するには、ユーザーはプライマリグループ1に属している必要があります。既存のユーザーをプライマリグループ1に追加するには、次のコマンドを実行します。
   sudo dscl .-create /Users/<userName> PrimaryGroupID 1
2. コネクターをインストールするための前提条件は次のとおりです。OpenSSL-1.1.0hまたはLibreSSL-2.2.7。
3. 次の手順を実行して、Digital Labに接続するデバイスを検出するようにMacマシンをセットアップします。
   
   

   iOSデバイス	macOS El Capitan (10.11.6) - macOS Mojave (10.14.6): Macマシンと同期するには、iTunes 12.8以降が必要です。MacにiTunesのアップデートバージョンがあることを確認してください。 macOS Catalina (10.15) 以降の場合、同期に必要なのはFinderのみです。 まだ行っていない場合は、iOSデバイスの設定手順に従ってください。
   Androidデバイス	デバイスのUSBドライバーをインストールします。各デバイスメーカーには、Mac用の独自のUSBドライバーがあります。デバイスの製造元の指示に従ってください。OEM (Original Equipment Manufacturer) USBドライバーへのリンクのリストについては、Android開発者向けドキュメントを参照してください。 まだ行っていない場合は、Androidデバイスの初期設定の手順に従ってください。

4. USBポートを介してデバイスをマシンに接続します。
   

   一部のデバイスでは、USB経由でデバイスを接続すると、デバイスがセキュリティアラートを発行します。警告を受け入れます。

   ヒント: 一部の電話機には、充電接続とは別にデータ接続を有効にできるUSB設定があります。お使いの携帯電話にこのオプションがある場合は、設定をチェックして、USBデータ接続が有効になっていることを確認してください。

   macOS El Capitan (10.11.6) - macOS Mojave (10.14.6): macOS el Capitan - Mojaveを新規インストールする場合は、デバイスを接続する前に必ずiTunesを開いてください。

5. Macコネクターを次のいずれかの方法でダウンロードします:

• 管理者ユーザー: コネクターページのコネクターのダウンロードをクリックします。
• 管理者以外のユーザー: Digital Labコンソールの右上隅にある [ヘルプ] メニューから [コネクターのダウンロード] を選択します。
  
  MacOS Catalina以降: UFT Digital LabコネクターソフトウェアがOpenTextの公式WebサイトからMacに直接ダウンロードされている場合は、次のコマンドを実行して、ダウンロードしたファイルのメタデータを削除します。
  

Terminal: xattr -c fileName.zip

例: xattr -c install-connector-macos-x64-X.XX-XXXXX.zip

6. ファイルを抽出します。
   Terminal: unzip <name of macOS connector installation file>.zip –d <target folder>
   
7. コネクターのインストールフォルダーをアプリケーションフォルダーに移動します。
   Terminal: cp –r desktop/<target folder> /Applications
8. ターミナルを使用してフォルダーのアクセス許可を変更します。
   1. コネクターのインストールフォルダーとサブフォルダーの権限を変更します。
       sudo chmod -R 777 /Applications/<target folder>
      

   2. インストール中に一時ファイルに使用するフォルダーのアクセス許可を変更します (デフォルト: tmp)。
      sudo chmod -R 777 /private/tmp
      

9. MacOS Mojave以降: インストーラーにフルディスクのアクセス許可があることを確認します。

   1. システム環境設定を開きます。
   2. セキュリティとプライバシーで、プライバシータブを選択します。
   3. フルディスクアクセスを選択し、鍵アイコンをクリックします。Touch IDを使用するか、システム管理者の資格情報を入力して、ロック解除をクリックします。
   4. +ボタンをクリックし、UFT Digital Lab install appを追加します。
      
      
      

インストールウィザードでインストールする

1. アプリケーションフォルダーで、コネクターインストールフォルダーに移動し、インストールファイル (.appファイル) を見つけます。

2. rootまたはadminユーザーとしてファイルを実行します。
   

注: Digital Labが新しいヘルパーツールをインストールしようとしているポップアップをすべて、ユーザーパスワードを入力して受け入れます。

3. インストールウィザードが開きます。内容をお読みになり、次へをクリックしてください。

4. 次のガイドラインに従って、インストールウィザードの各ページで情報を入力するか、質問に答えてください。

   認証
   資格情報を入力します。Digital Labには、管理者から提供されたアクセスキーを入力してください。 Digital Lab SaaS: SSL有効オプションを選択する必要があります。
   プロキシ経由で接続する場合は、プロキシセクションでサーバーアドレスを選択し、必要に応じてサーバー、ポート、資格情報を指定します。
   Connector configuration
   コネクターに意味のある名前を付けます。これにより、コネクター名に基づいてデバイスを効果的にフィルタリングできます。コネクターのIPアドレスまたはFQDNを入力するか、デフォルトを受け入れます。

トップに戻る

ターミナルでインストールする

1. 次のフォルダーに移動します。
   cd /Applications/<Connector installation folder>/install.app/Contents/MacOS

2. ./installを実行します。使用許諾契約書に同意するなどのプロンプトが表示されたら、EnterおよびY/Nを押します。

3. 次のガイドラインに従って、インストールウィザードの各ページで情報を入力するか、質問に答えてください。

   Authentication
   資格情報を入力します。Digital Labには、管理者から提供されたアクセスキーを入力してください。 Digital Lab SaaS: SSL有効オプションを選択する必要があります。
   プロキシ経由で接続する場合は、プロキシセクションでサーバーアドレスを選択し、必要に応じてサーバー、ポート、資格情報を指定します。
   Connector configuration
   コネクターに意味のある名前を付けます。これにより、コネクター名に基づいてデバイスを効果的にフィルタリングできます。コネクターのIPアドレスまたはFQDNを入力するか、デフォルトを受け入れます。

4. インストール後に設定を変更する方法については、Macコネクターを再構成するを参照してください。

デバイスの接続を確認し、デバイスを接続する

インストール後、Xcodeがインストールされている場合は、instrumentsコマンドを使用して、マシンがiOSデバイスを認識するかどうかを確認できます。

このコマンドの結果は、デバイスID (UDID) のリストになります。USBポートに接続したときにデバイスがリストにない場合、これは次のことを意味している可能性があります。

• USBポートが機能しない (ハードウェアの問題)。
• 最新バージョンのiTunesを使用していません。iTunesのバージョンをアップグレードします。

iOSデバイスをMacコネクターを介してDigital Labに接続するには:

1. エージェントアプリを共同設計し、コネクターマシンに配布します。詳しくは、エージェントアプリに再署名するを参照してください。

2. Macコネクターが実行されている場合は、再起動します。

トップに戻る

Macコネクターを起動または停止する

インストールを実行すると、デフォルトでMacコネクターがMacサービスとしてインストールされます。インストールの最後に、このサービスを開始するように求められます。

インストールの終了時にサービスを開始しないことを選択した場合は、次のように後でコネクターを停止して開始できます。

ターミナルウィンドウから、ディレクトリを/opt/UFTDigitalLab/scriptsに変更し、以下を実行します。

アクション
コネクターを開始する 方法1	sudo launchctl load /Library/LaunchDaemons/UFTM.plist
コネクターを開始する 方法2	sudo /Users/<user name used when installing the connector>/UFTM_service start
コネクターを再起動する	sudo /Users/<user name used when installing the connector>/UFTM_service restart
コネクターを停止する	sudo /Users/<user name used when installing the connector>/UFTM_service stop

トップに戻る

Macコネクターを再構成する

サーバーまたはコネクターの詳細を変更するなど、コネクターの詳細を変更する必要がある場合は、再インストールせずにコネクターの設定を再構成できます。

コネクターを再構成するには:

マシンのアプリケーション > UFT Digital Labコネクターフォルダー内のDigital Lab_Updateをダブルクリックします。

ターミナルから再構成するには:

1. ディレクトリをインストールフォルダーに変更します。cd /opt/UFTDigitalLab/installation/
   
2. アップグレードスクリプトを実行します。
   ./UFTM_update.command
   

トップに戻る

Macコネクターのトラブルシューティング

このセクションでは、コネクターを取り付けるためのヒントとガイドラインを示します。

トップに戻る

Macコネクターをアンインストールする

Macのコネクターは、Mac OSマシンでアンインストールプログラムを実行するか、ターミナルから削除できます。アンインストールには、rootまたはadminの権限が必要です。

コネクターをアンインストールするには:

マシンのアプリケーション > UFT Digital Labコネクターフォルダー内のDigital Lab_Uninstallをダブルクリックします。

ターミナルを使用してアンインストールするには:

1. ディレクトリをインストールフォルダーに変更します。cd /opt/UFTDigitalLab/installation/
   
2. アンインストールスクリプトを実行します。
   ./UFTM_uninstall.command
   
   

その他の参照項目:

• デバイスの管理
• Linuxマシンにコネクターをインストールする
• Windowsマシンにコネクターをインストールする >