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

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

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

始める前に

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

Linuxのみ: iOSデバイスをUSB経由でこのマシンに接続する場合は、IPV6が有効になっていることを確認してください。

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

Digital Labサーバーが本機にインストールされていないことを確認してください。
サーバーはコネクターからアクセス可能である必要があります。
接続を確認するには、次のcurlコマンドを実行し、200 OKステータスを取得することを確認します。

curl -I http/s://<Digital Lab server IP address>:<port>
Nginxがコネクターマシンにすでにインストールされている場合は、Digital Labコネクターをインストールする前に、Nginxを取り外してください。
Digital Labサーバーからコネクターのアクセスキーを取得します。
- 管理者ユーザー: [コネクター] タブを選択します。[新しいキーの生成] をクリックし、名前、タイプ (コネクター)、有効期限、説明 (オプション) を入力します。
- 管理者以外のユーザー: 管理者にリクエストしてください。[ヘルプ] メニュー (右上) から [管理者にお問い合わせください] を選択します。
CentOS 7.6 -7.9新規インストール: 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サービスを再起動します。

トップに戻る

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

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

管理者の場合は、コネクターページでコネクターのダウンロードを選択します。
管理者以外のユーザーの場合は、Digital Labコンソールの右上隅にある [ヘルプ] メニューから [コネクターのダウンロード] を選択します。

トップに戻る

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

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

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

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

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

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

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

トップに戻る

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

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

Androidデバイス

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

./adb devices

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

ヒント: One Plus、Nexus 5などのCタイプのUSBデバイスに接続している場合、idVendorの値が認識されていない可能性があります。
回避策: dmesgを実行して、0xから始まるidVendor値を取得します。インストール時に指定したユーザーとしてログインします。sudo ~/add_android_vendor.sh <idVendor>スクリプトを実行します。
iOSデバイス
1. 以下に移動します。
  /opt/UFTDigitalLab/Connector/libimobiledevice/linux/
2. ./idevice_id –lを実行します。
このコマンドの結果は、デバイスID (UDID) のリストになります。コマンドが空の結果またはエラーメッセージを返す場合は、次のことを試してください。
1. Digital Labサーバーまたはコネクターマシンで、rootとしてログインします。
2. 「usbmuxd」のプロセスIDを見つけます。
  ps aux | grep '[u] sbmuxd'
3. プロセスを強制終了します。
  kill –9 <processID>
4. usbmuxdを再度開始します。
  usbmuxd
5. idevice_id –lを再度実行して、デバイスが認識されているかどうかを確認します。
デバイスが正しく接続されている場合は、Digital Labランチャーアプリを手動で起動してみてください。信頼できないアプリ開発者の通知が表示された場合:
- 信頼をクリックします。
- デバイスを切断します。
- 5秒間待ってから、デバイスを再接続します。

iOSデバイスに関する追加の考慮事項:

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

トップに戻る

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

次のコマンドを使用して、コネクターを停止および開始できます。

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

トップに戻る

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

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

トップに戻る

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

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

rootユーザーとしてLinuxコネクターマシンにログインします。
ディレクトリをコネクターインストールディレクトリに変更します。
cd <path to installation folder> (デフォルト/opt/UFTDigitalLab/)
次のコマンドを入力して、アンインストールスクリプトを実行します。
./DL_uninstall
Enterキーを押して、Digital Labコネクターのアンインストールを続行します。

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

トップに戻る

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

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

UFT Digital Labサーバー詳細

IPアドレスまたはFQDN
ポート
セキュアまたは非セキュア接続 (SSL)
プロキシ情報

UFT Digital Labコネクター詳細

資格情報
コネクター名
コネクターのIPアドレス
コネクターポート

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

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

トップに戻る

パッチのインストール

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

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

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

すべてのコネクター

手動署名ツール (該当する場合)
- iOSアプリに手動で署名するためのiOS Enabler。サーバーパッチをインストールすると、iOS EnablerがAgentフォルダーで利用できるようになります。パッチは、ADM Marketplaceで入手できます。
- Androidアプリに手動で署名するためのAndroid Enabler。サーバーパッチをインストールすると、更新されたAndroid Enablerがサーバーフォルダーで利用可能になります。

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

トップに戻る

その他の参照項目:

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

始める前に

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

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

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

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

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

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

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

パッチのインストール

ヘルプセンターに関するフィードバックの送信