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

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

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

すべてのコネクターを表示する方法の詳細については、コネクターの表示と管理を参照してください。

始める前に

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

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

注: iOS 17は現在、Macコネクターでのみサポートされています。iOS 17デバイスの接続の詳細については、Macマシンにコネクターをインストールするの前提条件を参照してください。

前提条件と考慮事項

コネクターをインストールする前に、次の前提条件が満たされていることを確認してください。

新規インストールのみ

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

iOS 17のインストール

iOS 17用のMacコネクターをインストールする前に:

注: Macマシンはインターネットにアクセスできる必要があります。これは、Appleから署名キーを時々取得するために必要です。

  1. MacOSが13.4以降にアップグレードされていること、およびXcode 15.0以降がインストールされていることを確認してください。

  2. Xcodeを使用してiOS 17ランタイムをインストールします。
    Xcodeメニューで、[Settings] > [Platforms] > [iOS 17] > [GET] を選択します。

  3. XcodeでApple Developerアカウントにサインインします。このアカウントは、WedDriverAgent-Runnerアプリの署名に使用したアカウントと同じである必要があります。

  4. Xcodeの [Settings] > [Accounts] でAppleアカウントを選択し、[Download Manual Profiles] をクリックします。

  5. Macに複数のXcodeバージョンがある場合は、Xcode15がデフォルトであることを確認してください。

    Xcodeの [Settings] > [Locations] > [Command Line tools] で、Xcode 15を選択します。

  6. Xcodeを少なくとも1回起動して、関連するすべてのデータを初期化します。必要に応じて、使用許諾契約に同意します。

  7. Macマシンをセットアップし、Digital Labをインストールするには、以下の手順に従ってください。コネクターは、現在のXcodeユーザーでインストールする必要があります。このユーザーには管理者権限が必要です。

注: KillアプリケーションはiOS 17ではサポートされていません。

トップに戻る

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

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

  3. 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

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

      2. sudo chmod -R 777 /Applications/<target folder>

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

      2. sudo chmod -R 777 /private/tmp

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

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

トップに戻る

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

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

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

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

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

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

    Authentication
    資格情報を入力します。Digital Labには、管理者から提供されたアクセスキーを入力してください。

    Digital Lab SaaS: SSL有効オプションを選択する必要があります。

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

  5. コネクターをインストールした後、次のコマンドを実行してファイルアクセスを変更します。

    コードをコピーする
    sudo chmod 644 /usr/local/lib/*
  6. Digital Labバージョン23.4 GAのみ - Intelチップを搭載したMacコンピューター:
    次の追加コマンドを実行します。
    コードをコピーする
    mkdir -p /usr/local/opt/pcre2/lib/
    cp /usr/local/lib/libpcre2-8.0.dylib /usr/local/opt/pcre2/lib/
    mkdir -p /usr/local/opt/openssl@3/lib/
    cp /usr/local/lib/libssl.3.dylib /usr/local/opt/openssl@3/lib/
    cp /usr/local/lib/libcrypto.3.dylib /usr/local/opt/openssl@3/lib/
  7. Appleシリコンチップを搭載したMacコンピューターのみ:
    次の追加コマンドを実行します。
    コードをコピーする
    sudo chmod 644 /usr/local/opt/openssl@3/lib/*
    sudo chmod 644 /usr/local/opt/pcre2/lib/*

    Appleチップセットの詳細については、Appleドキュメントの「Appleシリコン搭載のMacコンピュータ」を参照してください。

  8. Digital Labサービスを再起動します。

    コードをコピーする
    sudo /Users/DL/DL_service restart

トップに戻る

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

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

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

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

    Authentication
    資格情報を入力します。Digital Labには、管理者から提供されたアクセスキーを入力してください。

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

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

  5. コネクターをインストールした後、次のコマンドを実行してファイルアクセスを変更します。

    コードをコピーする
    sudo chmod 644 /usr/local/lib/*
  6. Digital Labバージョン23.4 GAのみ - Intelチップを搭載したMacコンピューター:
    次の追加コマンドを実行します。
    コードをコピーする
    mkdir -p /usr/local/opt/pcre2/lib/
    cp /usr/local/lib/libpcre2-8.0.dylib /usr/local/opt/pcre2/lib/
    mkdir -p /usr/local/opt/openssl@3/lib/
    cp /usr/local/lib/libssl.3.dylib /usr/local/opt/openssl@3/lib/
    cp /usr/local/lib/libcrypto.3.dylib /usr/local/opt/openssl@3/lib/
  7. Appleシリコンチップを搭載したMacコンピューターのみ:
    次の追加コマンドを実行します。
    コードをコピーする
    sudo chmod 644 /usr/local/opt/openssl@3/lib/*
    sudo chmod 644 /usr/local/opt/pcre2/lib/*

    Appleチップセットの詳細については、Appleドキュメントの「Appleシリコン搭載のMacコンピュータ」を参照してください。

  8. Digital Labサービスを再起動します。

    コードをコピーする
    sudo /Users/DL/DL_service restart

トップに戻る

デバイスの接続

  1. エージェントアプリを共同設計し、コネクターマシンに配布します。詳しくは、エージェントアプリに再署名するを参照してください。Macコネクターが実行されている場合は、再起動します。
  2. 次の手順を実行して、Digital Labに接続するデバイスを検出するようにMacマシンをセットアップします。
    iOSデバイス

    1. macOS El Capitan (10.11.6) - macOS Mojave (10.14.6): Macマシンと同期するには、iTunes 12.8以降が必要です。MacにiTunesのアップデートバージョンがあることを確認してください。
      macOS Catalina (10.15) 以降の場合、同期に必要なのはFinderのみです。

    2. iOSデバイスがサポートされていることを確認してください。詳細については、サポートマトリックスを参照してください。
    3. デバイスの初期設定の手順に従ってください。
    Androidデバイス
    1. デバイスのUSBドライバーをインストールします。各デバイスメーカーには、Mac用の独自のUSBドライバーがあります。デバイスの製造元の指示に従ってください。OEM (Original Equipment Manufacturer) USBドライバーへのリンクのリストについては、Android開発者向けドキュメントを参照してください。
    2. まだ行っていない場合は、Androidデバイスの初期設定の手順に従ってください。

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

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

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

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

  4. エージェントがデバイスで実行されるまで待ちます。

注意: Digital Labで保存された情報の整合性と機密性を保証するために、インストールフォルダーと一時フォルダーにファイルシステム監視を組み込むことを強くお勧めします。

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

    instruments -s devices

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

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

トップに戻る

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

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

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

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

アクション

コマンド
コネクターを開始する

方法1

 sudo launchctl load /Library/LaunchDaemons/DL.plist
コネクターを開始する

方法2

 sudo /Users/<user name used when installing the connector>/DL_service start
コネクターを再起動する sudo /Users/<user name used when installing the connector>/DL_service restart
コネクターを停止する sudo /Users/<user name used when installing the connector>/DL_service stop

注: これらのコマンドにはルートアクセスが必要です。

トップに戻る

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

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

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

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

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

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

トップに戻る

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

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

Digital Labサービスが適切に実行されず、大量のjava_errorxxxx.logファイルが生成され続けます。これは、Apple M1またはM2チップモデルを使用している場合に発生する傾向があります。

回避策: macOSコネクターを再起動します。

これは、レジストリファイルが破損しているために発生する可能性があります。

この問題を解決するには:

  1. 既存のインストールをアンインストールします。

  2. レジストリファイル/Library/Preferences/.com.zerog.registry.xmlが削除されていることを確認してください。そうでない場合は、ファイルを手動で削除してください。

  3. Macコネクターを再度インストールします。

トップに戻る

パッチのインストール

最新の機能強化と修正を活用するには、現在のバージョンのDigital Labの最新パッチをインストールしてください。サーバーとコネクターのパッチは、ソフトウェアのライセンスとダウンロードからダウンロードできます。最新のパッチには、以前のパッチの内容が含まれています。以前のパッチをインストールする必要はありません。

重要: リモートiOS署名サービスを使用している場合は、サーバーをアップグレードする前にこれをアップグレードする必要があります。

サーバーを最新のパッチにアップグレードする場合は、以下もアップグレードする必要があります。

  • すべてのコネクター

  • 手動署名ツール (該当する場合)

    • iOSアプリに手動で署名するためのiOS Enabler。サーバーパッチをインストールすると、iOS EnablerがAgentフォルダーで利用できるようになります。パッチは、ADM Marketplaceで入手できます。

    • Androidアプリに手動で署名するためのAndroid Enabler。サーバーパッチをインストールすると、更新されたAndroid Enablerがサーバーフォルダーで利用可能になります。

パッチリリースに含まれているパッチのインストール手順に従ってください。

トップに戻る

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

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

注: ターミナル (PuTTY) を介してコネクターをインストールした場合は、ターミナルからのみアンインストールできます。

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

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

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

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

その他の参照項目: