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

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

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

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

始める前に

スタンドアロンコネクターは、フルインストールとして、またはコネクターの既存のインストールへのアップグレードとしてインストールできます。

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

トップに戻る

iOS 17以降の考慮事項

iOS 17以降を実行しているデバイスをコネクターマシンに直接接続する場合は、次の点に注意してください。

考慮事項 詳細
サポートされるOS

LinuxおよびmacOS: iOS 17以降は以下でサポートされています。

  • Macコネクター。iOS 18の場合は、macOS 14 (Sonoma) 以降が必要です。

  • Linux Ubuntuスタンドアロンまたは組み込みコネクター。

  • RedHat Enterprise Linuxスタンドアロンまたは組み込みコネクター。

Windows: Windowsコネクターでは、iOSバージョン17.4以降のみがサポートされます。

インターネット接続

Appleから定期的に署名キーを取得するには、コネクターマシンが以下にアクセスできる必要があります。

  • http://gs.apple.com

OpenTextは、すべての*.appleドメインへのアクセスを許可することを推奨しています。
iOS 17以降のその他の考慮事項

  • Dev Accessはサポートされていません。

  • AWS Device FarmとWeTestデバイスの接続はサポートされていません。

  • アプリケーションの強制終了はサポートされていません。

トップに戻る

前提条件

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

新規インストールのみ

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

トップに戻る

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

  1. コネクターのインストールに既存のユーザーを使用するには、ユーザーはプライマリグループ1に属している必要があります。既存のユーザーをプライマリグループ1に追加するには、次のコマンドを実行します。
    sudo dscl .-create /Users/<userName> PrimaryGroupID 1
  2. コネクターをインストールするための前提条件は次のとおりです。OpenSSL-1.1.0hまたはLibreSSL-2.2.7。
  3. Apple Siliconプロセッサーを搭載したMacマシンにコネクターをインストールする場合は、マシンにApple Rosettaをインストールする必要があります。このプログラムをインストールするには、MacマシンがAppleアップデートサービスにアクセスする必要があります。

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

    • 管理者ユーザー: コネクターページのコネクターのダウンロードをクリックします。
    • 管理者以外のユーザー: ラボコンソールの右上隅にある [ヘルプ] メニューから [コネクターのダウンロード] を選択します。

      MacOS Catalina以降: コネクターがOpenTextの公式WebサイトからMacに直接ダウンロードされている場合は、次のコマンドを実行して、ダウンロードしたファイルのメタデータを削除します。

      • ターミナル: xattr -c fileName.zip

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

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

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

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

      2. sudo chmod -R 777 /private/tmp

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

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

トップに戻る

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

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

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

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

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

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

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

    OpenText Core Functional Testing Lab: SSL有効オプションを選択する必要があります。

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

トップに戻る

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

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

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

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

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

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

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

トップに戻る

デバイスの接続

  1. エージェントアプリを共同設計し、コネクターマシンに配布します。詳しくは、エージェントアプリに再署名するを参照してください。Macコネクターが実行されている場合は、再起動します。
  2. 次の手順を実行して、OpenText Functional Testing Labに接続するデバイスを検出するようにMacマシンをセットアップします。
    デバイスOS詳細
    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. エージェントがデバイスで実行されるまで待ちます。

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

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

    instruments -s devices

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

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

トップに戻る

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

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

iOS 17デバイスを接続する場合、インストーラーUIのスタートオプションでは、関連するすべてのプロセスが完全に開始されないことに注意してください。iOS 17デバイスをサポートするためのすべてのプロセスが開始されていることを確認するには、次のコマンドを実行してサービスを開始します。

コードのコピー
sudo /Users/<user name used when installing the connector>/DL_service restart

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

コネクターを起動、再起動、または停止するには、次の手順を実行します。

ターミナルで、ディレクトリを/opt/FunctionalTestingLabForMobileAndWeb/scriptsに変更し、次のコマンドを実行します。これらのコマンドにはルートアクセスが必要です。

アクション

コマンド
コネクターを開始する 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コネクターを再構成する

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

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

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

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

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

トップに戻る

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

Macコネクターが機能するためのトラブルシューティングに関するヒントとガイドラインについては、Macコネクターを参照してください。

トップに戻る

パッチのインストール

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

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

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

  • すべてのコネクター:

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

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

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

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

トップに戻る

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

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

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

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

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

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

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

その他の参照項目: