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

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

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

始める前に

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

前提条件 詳細
システム要件

マシンが推奨システム要件に準拠していること、およびデバイスがサポートされていることを確認してください。詳細については、サポートマトリックスのコネクター要件、デバイスの接続、およびインストールと構成のベストプラクティスを参照してください。
iOSデバイス USBケーブルを使用してiOSデバイスをコネクターマシンに接続する場合は、IPV6が有効になっていることを確認してください。

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

  1. OpenText Functional Testing Labサーバーが本機にインストールされていないことを確認してください。

  2. コネクターはサーバーにアクセスできる必要があります。
    接続を確認するには、次のcurlコマンドを実行し、200 OKステータスを取得することを確認します。

    curl -I http/s://<OpenText Functional Testing Lab server IP address>:<port>

  3. Nginxがコネクターマシンにすでにインストールされている場合は、OpenText Functional Testing Labコネクターをインストールする前に、Nginxを取り外してください。

  4. サーバーからコネクターのアクセスキーを取得します。

    • 管理者ユーザー: [コネクター] タブを選択します。[新しいキーの生成] をクリックし、名前、タイプ (コネクター)、有効期限、説明 (オプション) を入力します。
    • 管理者以外のユーザー: 管理者にリクエストしてください。[ヘルプ] メニュー (右上) から [管理者にお問い合わせください] を選択します。

  5. CentOS 7.6 -7.9新規インストール: X11転送が必要です。

    x11転送を有効にするには:

    1. 必要なパッケージをインストールします。

      コードをコピーする
      yum install -y xorg-x11-server-Xorg xorg-x11-xauth xorg-x11-apps
    2. X11転送を有効にします。

      SSH構成ファイルを開きます。

      コードをコピーする
      vi /etc/ssh/sshd_config

      以下の行のコメントを外すか追加します。

      コードをコピーする
      X11Forwarding yes

    3. SSHサービスを再起動します。

      4. コードをコピーする
      systemctl restart sshd

トップに戻る

Ubuntuに関する考慮事項

UbuntuにLinuxコネクターをインストールする際には、考慮すべき点がいくつかあります。

考慮事項 詳細
バージョンサポート Ubuntuバージョン22.04.3 (LTS)、24.04以降。
インストールタイプ

Ubuntuの通常インストールとUbuntuの最小インストールがサポートされています。Ubuntu Proはサポートされていません。
エディション UbuntuデスクトップとUbuntuサーバーがサポートされています。
CPU X86_64アーキテクチャーのみがサポートされます。
権限 インストールにはsudo権限が必要です。

トップに戻る

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デバイスの接続はサポートされていません。

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

トップに戻る

コネクターのダウンロード

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

    • 管理者の場合は、コネクターページでコネクターのダウンロードを選択します。
    • 管理者以外のユーザーの場合は、OpenText Functional Testing Labコンソールの [ヘルプ] メニューHelp menuから [コネクターのダウンロード] を選択します。

トップに戻る

コネクターのインストール

OpenText Functional Testing Labのスタンドアロンコネクターは、フルインストールとして、またはコネクターの既存のインストールへのアップグレードとしてインストールできます。インストーラーは、どのファイルがすでに存在するかを確認し、関連するファイルをインストールまたは更新します。

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

  1. Linuxマシンで、rootとしてログインします。Ubuntu: インストールするにはsudo権限が必要です。
  2. ファイルをLinuxマシンにコピーし、インストールファイルを抽出します。 
    unzip <name of Linux connector installation file>.zip –d <Target directory Name>
  3. ディレクトリをターゲットディレクトリに変更します。
    cd <Target directory name>/
  4. コネクターインストーラーを実行します。
    ./<install_connector-x64 file name>.bin
  5. 使用許諾契約書を読み、Yを選択して条件に同意し、インストールを続行します。インストールフォルダーと一時ファイル用のローカルフォルダーを選択します。次のガイドラインに従って、各インストールセクションに情報を入力するか、質問に回答します。

    セクション詳細
    ユーザー構成既存のLinux OSユーザーを使用するか、nをクリックしてデフォルトユーザーを作成します。
    このユーザーのパスワードを指定します。
    認証資格情報を入力します。管理者から提供されたアクセスキーを入力してください。

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

    プロキシ経由で接続する場合は、プロキシセクションでサーバーアドレスを選択し、必要に応じてサーバー、ポート、資格情報を指定します。

    コネクター構成コネクターに意味のある名前を付けます。これにより、コネクター名に基づいてデバイスを効果的にフィルタリングできます。コネクターのIPアドレス (IPが静的な場合) またはFQDNを入力するか、デフォルトを受け入れます。

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

  6. インストール前の概要を確認し、Enterを押して、コネクターのインストールを続行します。

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

トップに戻る

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

  1. まだ行っていない場合は、AndroidおよびiOSデバイスを接続するときに、デバイスの初期設定の手順に従ってください。
  2. USBケーブルを使用してデバイスをコネクターマシンに接続します。一部のデバイスでは、デバイスを接続すると、通知、信頼、または場所のポップアップが表示される場合があります。これらのポップアップを受け入れます。
  3. エージェントがデバイスで実行されるまで待ちます。

  4. エージェントがデバイスで起動しない場合は、デバイスが認識されていることを確認してください。

    Linuxコネクターマシンで次のコマンドを実行します (rootユーザーの場合は、ディレクトリを/opt/FunctionalTestingLabForMobileAndWeb/connector/android-sdk-linux/platform-toolsに変更します)。

    ./adb devices

    接続されているすべてのデバイスが一覧表示されます。デバイスステータスは「デバイス」である必要があり、「未承認」などの他の状態であってはなりません。

    ヒント: One PlusおよびNexus 5のCタイプのUSBデバイスに接続している場合、idVendorの値が認識されていない可能性があります。
    回避策: dmesgを実行して、0xから始まるidVendor値を取得します。インストール時に指定したユーザーとしてログインします。sudo ~/add_android_vendor.sh <idVendor>スクリプトを実行します。

    1. 次の場所に移動します。
      /opt/FunctionalTestingLabForMobileAndWeb/Connector/libimobiledevice/linux/
    2. ./idevice_id –lを実行します。


    このコマンドの結果は、デバイスID (UDID) のリストになります。コマンドが空の結果またはエラーメッセージを返す場合は、次のことを試してください。

    1. サーバーまたはコネクターマシンで、rootとしてログインします。
    2. 「usbmuxd」のプロセスIDを見つけます。
      ps aux | grep '[u] sbmuxd'
    3. プロセスを強制終了します。
      kill –9 <processID>
    4. usbmuxdを再度開始します。
      usbmuxd
    5. idevice_id –lを再度実行して、デバイスが認識されているかどうかを確認します。

    デバイスが正しく接続されている場合は、ランチャーアプリを手動で起動してみてください。信頼できないアプリ開発者の通知が表示された場合:

    • 信頼をクリックします。
    • デバイスを切断します。
    • 5秒間待ってから、デバイスを再接続します。

  5. iOSデバイスのみ:

    まだ行っていない場合は、デバイスの [設定] > [デベロッパ] > [Enable UI Automation] でUIオートメーションを有効にします。デバイスを切断し、5秒間待ってから、再接続します。

    エンタープライズ証明書で署名されているが、モバイルデバイス管理 (MDM) ソリューションを使用しないアプリをインストールすると、アプリの初回インストール時にエンタープライズ開発者を信頼するように求められます。プロファイルを信頼するには、設定 > 一般 > デバイス管理に移動し、エンタープライズ開発者プロファイルを選択して信頼します。これらのアクションは、デバイス上でリモートで実行できます。

    エンタープライズ署名付きアプリを初めてインストールするすべてのユーザーは、インターネット接続も必要になります。エンタープライズ開発者プロファイルがデバイスで信頼されると、それらが開かれているデバイスがインターネットに接続されている場合、同じプロファイルを持つ追加のアプリを再度信頼する必要はありません。テスト対象のアプリケーションのエンタープライズ開発者プロファイルが信頼されていない場合、エージェントはアプリを開くことができず、1009エラー: 「AUTと通信できません」という結果になります。

トップに戻る

コネクターの開始および停止

次のコマンドを使用してコネクターを管理できます。

アクション

コマンド
コネクターを開始する service DL start
コネクターを停止する service DL stop
コネクターを再起動する service DL restart

Ubuntu:

  • コネクターサービスを管理するコマンドはsudoを使用して実行する必要があります。たとえば、sudo service DL startです。

  • ログ情報はコンソール出力ではなく、ログファイル {インストールパス}/log/hpmc_daemon_service.logに出力されます。

トップに戻る

ローカリゼーションの有効化

英語以外のサポートされている言語でシステムアプリ (デバイス自体を実行するために使用されるアプリ) を表示するには、コネクターをインストールした後、/opt/FunctionalTestingLabForMobileAndWeb/connector/conf/connector.propertiesに移動し、ファイル内の次の行のコメントを外します。
ENABLE_LOCALIZATION=true

トップに戻る

コネクターのアンインストール

コネクターは次のようにアンインストールできます。

  1. rootユーザーとしてLinuxコネクターマシンにログインします。

  2. ディレクトリをコネクターインストールディレクトリに変更します。
    cd <path to installation folder> (デフォルト/opt/FunctionalTestingLabForMobileAndWeb/)
  3. 次のコマンドを入力して、アンインストールスクリプトを実行します。
    ./DL_uninstall
  4. Enterキーを押して、コネクターのアンインストールを続行します。

注: 既存のLinuxユーザーを使用してコネクターをインストールまたはアップグレードした場合、アンインストール中にこのユーザーを削除するかどうかを尋ねられます。インストール時にOpenText Functional Testing Labで作成したデフォルトの新規ユーザーを使用した場合、このユーザーは自動的に削除されます。

トップに戻る

コネクターの構成を変更する

サーバーまたはコネクターの詳細を変更するなど、コネクターの詳細を変更する必要がある場合は、更新ツールを使用できます。ツールを実行すると、次の詳細を更新できます。

マシン 変更可能な詳細
サーバー

  • IPアドレスまたはFQDN

  • ポート

  • セキュアまたは非セキュア接続 (SSL)

  • プロキシ情報
コネクター

  • 資格情報

  • コネクター名

  • コネクターのIPアドレス

  • コネクターポート

コネクターの構成を変更するには:

  1. コネクターマシンで、rootまたはLinux sudoersファイルのユーザーとしてログインします。
  2. コネクターのインストールディレクトリに移動します。
    デフォルト opt/FunctionalTestingLabForMobileAndWeb/
  3. 次のコマンドを実行します。
    ./DL_update
  4. プロンプトが表示されたら、新しい詳細を指定します。
  5. プロセスの最後にコネクターを再起動して、変更を有効にします。
  6. SSLアクセスのみ: サーバーの詳細を変更した後でコネクターの詳細を変更すると、コネクターの新しい証明書が生成されます。テストツールのユーザーは、OpenText Functional Testing LabへのSSLアクセスも再構成する必要があります。

トップに戻る

パッチのインストール

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

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

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

  • すべてのコネクター:

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

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

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

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

その他の参照項目: