Linuxインストール

このセクションでは、LinuxマシンにOpenText Functional Testing Labサーバーをインストールする方法について説明します。

このセクションは、OpenText Core SDPおよびOpenText Core Functional Testing Labには関連していません。

始める前に

OpenText Functional Testing Labをインストールまたはアップグレードする前に、次の前提条件が満たされていることを確認してください。

前提条件 詳細
サーバーの要件 サーバーマシンが、サポートマトリックスで指定された要件を満たしていることを確認してください。
権限

root権限が必要です。

Ubuntu: インストールにはsudo権限が必要です。

サーバーのアクセシビリティ サーバーマシンのホスト名にアクセスできます。次のコマンドを実行して、これを確認します。
ping -c 1 "hostname"
iOSデバイス USBケーブルを使用してiOSデバイスをサーバーマシンに接続する場合は、IPv6が有効になっていることを確認してください。

新規インストールのみ

  • Nginxがすでにサーバーマシンにインストールされている場合は、OpenText Functional Testing Labをインストールする前に、Nginxを削除してください。
  • CentOS 7.6 -7.9: X11転送が必要です。

トップに戻る

Ubuntuに関する考慮事項

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

考慮事項 詳細
バージョンサポート 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デバイスの接続はサポートされていません。

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

トップに戻る

外部データベースを使用する

サーバーのインストールの一部としてインストールされる組み込みPostgreSQLデータベース。ただし、代わりにOpenText Functional Testing Labを既存の外部PostgreSQLデータベースに接続することもできます。このオプションを使用すると、組織は既存のデータベースリソースを管理および利用できます。

外部データベースを使用してインストールまたはアップグレードする前に:

  1. 元のデータベースのバックアップをhp4m.binファイルの形式で作成します。詳細については、組み込みデータベースをエクスポートするを参照してください。
  2. PostgreSQLデータベースをアンインストールせずにサーバーをアンインストールし、新しいインストールでデータベースを外部的に使用している場合は、postgresユーザーをpg_hba.confファイルに追加します。このファイルは、<Postgres_installdir>/<postgresバージョン>/dataにあります。
  3. postgres user listed in postgres configuration file
    また、元のデータベース暗号化キーも必要です。外部データベースには、OpenText Functional Testing Labによって最初に作成されたデータを復号化するためのキーが必要です。

  1. 外部データベースがOpenText Functional Testing Labマシンとは異なるマシン上にある分散環境では、データベースサーバーがOpenText Functional Testing Labサーバーからの接続を受け入れ、そのOpenText Functional Testing Labは、正しいデータベースサーバーマシンに接続するように構成されていることを確認してください。
    • <Postgres installdir>/<postgresバージョン>/dataの下に保存されているpostgresql.confファイルで、 listen_addresses = を検索します。これは、サーバーが接続をリッスンするアドレスを指定します。値をOpenText Functional Testing LabサーバーのIPまたは完全修飾ドメイン名 (FQDN) で更新します。値をワイルドカード「*」として設定すると、データベースサーバーがすべてのアドレスからの接続を受け入れることを意味します。
    • conf/hp4mExt-****.propertiesファイルを <OpenText Functional Testing Lab_ installdir>/server/confで見つけます。IPアドレス/FQDNがデータベースサーバーの正しいアドレスであることを確認してください。DNSの問題によりOpenText Functional Testing LabサーバーマシンがFQDNにアクセスできない場合は、FQDNをデータベースマシンのIPアドレスに置き換えます。
  2. データベースを復元します。詳しくは、エクスポートしたデータを外部データベースに移行するを参照してください。
  3. PostgreSQLデータベースが4GBを超える場合は、VACUUM FULLコマンドを実行して、削除されたコンテンツからデータベースをクリーンアップし、そのサイズを縮小することをお勧めします。詳細については、PostgreSQLのドキュメントを参照してください。
  4. オプション: SSL接続を有効にするようにPostgreSQLサーバーを構成できます。

    データベースサーバーへの安全な接続を有効にするには、次の手順を実行します。
    1. SSL証明書を生成します。

      サーバープライベートキー、サーバー証明書、および証明機関 (CA) 証明書を作成します。

    2. 証明書とキーを適切なディレクトリ (例: /var/lib/postgresql/data) に移動します。ファイルに適切な権限があることを確認してください。

    3. Postgresql.confファイルを開き、次のパラメーターを設定してPostgreSQL構成を編集します。

      • ssl = on

      • ssl_cert_file = <server.crt>

      • ssl_key_file = <server.key>

        ssl_ca_file = <root.crt>

    4. pg_hba.confファイルを編集します。

      hosthostsslに変更して、SSLを使用するようにクライアント認証を構成します。

    5. PostgreSQLサーバーを再起動します。

Postgres 13に関する重要な注意事項

パスワード認証では、md5メソッドのみがサポートされています。Postgres 13をインストールした後、以下を実行します。

  1. postgres構成ファイル<postgresql 13パス>/data/postgresql.confで、パスワード暗号化設定をmd5に変更します。
    Password_encryption = md5

  2. pg_hba.confファイル<postgresql 13パス>/data/pg_hba.confで、出現するすべてのscram-sha-256md5に変更します。

  3. postgresql-13サービスを再起動します。
  4. postgresql13ユーザーパスワードをリセットして再起動します。

トップに戻る

新規インストールとしてサーバーをインストールする

OpenText Functional Testing Labは、以前のバージョンがインストールされていない場合にフルインストールとしてインストールできます。

サーバーをインストールするには:

  1. Linuxサーバーのzipファイルをダウンロードします。

  2. Linuxマシンでroot権限でログインします。
  3. zipファイルをLinuxマシンにコピーします。
  4. サーバーインストールファイルを抽出します。
    unzip <Linuxサーバーファイルの名前>.zip –d <ターゲットディレクトリ名>
  5. ディレクトリをターゲットディレクトリに変更します。
    cd <ターゲットディレクトリ名>
  6. インストーラーを実行します。

    root権限を持つユーザー:
    ./<install_server-x64ファイル名>.bin

    インストールウィザードに [Introduction] ページが表示されます。内容を読み、Enterを押します。

  7. インストールウィザードに使用許諾契約が表示されます。Enterを押してページを移動し、Yを押して同意を受け入れます。
  8. インストールフォルダーを選択します。デフォルトは/opt/FunctionalTestingLabForMobileAndWeb/です。
  9. Linux OSユーザーを構成します。
  10. 既存のLinux OSユーザーを使用する場合は、Yを選択し、ユーザー名を入力してください。

    注意: このインストールを実行しているroot権限を持つユーザーと同じ名前を使用しないでください。

    nを選択すると、OpenText Functional Testing LabによってDLという名前のデフォルトのLinux OSユーザーが作成されます。このユーザーに新しいパスワードを入力します。

  11. 次のガイドラインに従って、サーバーを構成します。

    サーバー構成詳細
    FQDNまたはIPアドレス

    完全修飾ドメイン名 (FQDN) は、ホスト名とドメイン名で構成されます。例: myhost.opentext.comFQDNは英語の英字で始まる必要があります。数字で始まるFQDNはサポートされていません。

    SSL接続

    サーバーへの接続をSSLのみで行うかどうかを指定します。

    デフォルトはY (安全な接続のみ) です。

    注: SSLオプションを選択した場合、コネクターおよびテストツールマシンからサーバーへのすべての接続が安全である必要があります。コネクターやツールでOpenText Functional Testing Labの設定を行う場合は、サーバーの選択と一致していることを確認してください。
    SAML 2.0を使用してシングルサインオンを使用する場合は、デフォルトのYを使用します。

    注意: SSL接続を指定すると、セットアップによって自己署名証明書がインストールされます。サーバーのIDを検証する外部の権限がないため、自己署名証明書は最適ではありません。OpenTextでは、サーバーを運用開始した後、組織のCA証明書をインストールすることを強くお勧めします。詳しくは、認証局発行のSSL証明書を使用するを参照してください。

    サーバーポート

    デフォルトでは、インストールはポート8443でSSLに設定されています。デフォルトの非SSLはポート8080を使用します。

    内部で使用する空きポートデフォルト: 8081
    組み込みコネクターこのコンポーネントはオプションです。デバイスをOpenText Functional Testing Labマシンに直接接続する場合は、コネクターをインストールします。
    デフォルトユーザーインストールにより、OpenText Functional Testing Labコンソールにアクセスするためのデフォルトの管理者ユーザーadmin@default.comが作成されます。このユーザーのパスワードを指定します。
    一時ファイルのローカルフォルダー

    一時ファイルに使用するローカルフォルダーを指定するか、デフォルトを受け入れます。

  12. オプション: 外部PostgreSQLデータベースを構成します。

    組み込みPostgreSQLデータベースは、サーバーのインストールの一部としてインストールされます。ただし、外部PostgreSQLデータベースを使用するオプションを選択すると、既存の外部データベースに接続できます。外部データベースを使用すると、組織は既存のデータベースリソースを利用し、他のすべてのシステムでそれらを管理できます。OpenText Functional Testing Labが埋め込まれたPostgreSQL版を利用したい場合は、次のステップに進んでください。

    外部データベースとともにインストールする前に、外部データベースを使用するで説明されている手順に従っていることを確認してください。

    外部PostgreSQLデータベースを使用しますかプロンプトが表示されたら、「y」と入力します。

    データベースマシンにアクセスできることを確認し、接続に次を指定します。

    データベース設定詳細
    外部データベースサーバー

    データベースマシンのIPアドレスまたは完全修飾ドメイン名 (FQDN)。

    データベースポート外部データベースマシンのポート。
    データベース

    外部データベースの名前。hp4mなどのデータベース名を使用できます。ターゲットデータベースサーバーにすでに存在する名前を使用できます。データベースが存在しない場合、ユーザーが十分な権限を持っていれば、OpenText Functional Testing Labサーバーのインストールの一部としてデータベースが作成されます。

    スキーマ 

    publicなどのスキーマ名を使用できます。指定したデータベースにすでに存在する名前を使用できます。スキーマが存在しない場合、ユーザーに十分な権限がある場合、サーバーのインストールの一部としてスキーマが作成されます。

    注: データベース/スキーマが元々OpenText Functional Testing Labによって作成された場合 (たとえば、サーバーをアンインストールしたがPostgreSQLデータベースはアンインストールしなかった場合)、次の画面に進むときに暗号化キーを入力するように求められます。データベース/スキーマがOpenText Functional Testing Labによって作成されていない場合は、暗号化キーを提供する必要はありません。

    ユーザーの資格情報PostgreSQLデータベースのユーザー名とパスワード。
    SSL接続

    ラボサーバーがSSLを使用して外部データベースサーバーに接続できるようにするには、「y」と入力します。

    外部PostgreSQLデータベースへのSSL接続を有効にするには、ルート証明書の場所を指定します。サーバーは証明書にアクセスできる必要があります。.crt拡張子を持つファイルのみがサポートされます。

    このオプションでは、SSL接続用に外部PostgresSQLデータベースを構成する必要があります。SSL接続用にデータベースを構成するには、外部データベースを使用するを参照してください。

  13. 組み込みバージョンのPostgreSQLデータベースを使用する場合は、次のガイドラインに従ってPostgreSQLを構成してください。
  14. データベース設定詳細
    データベースサーバーポートデフォルト: 5432
    PostgreSQLスーパーユーザーパスワード

    PostgreSQLサーバーを最初にインストールすると、スーパーユーザーアカウントpostgresが自動的に作成されます。OpenText Functional Testing Labデータベーススキーマを作成し、データベースを管理するためのユーザーを追加するには、スーパーユーザーが必要です。スーパーユーザーはデータベース内のすべてのアクセス制限をオーバーライドできるため、スーパーユーザー以外のロールを使用してほとんどの操作を実行するのが最善です。

    スーパーユーザーのパスワードを入力する必要があります。

    • パスワードの長さは6~20文字である必要があります (英語のアルファベット、数字、および特殊文字「@」と「_」を使用できます)。
    • 少なくとも1桁、大文字と小文字の英語文字が1つ含まれています。
    PostgreSQLデータベース管理者のユーザー名

    インストールにより、データベースを管理するための追加のユーザーが作成されます。このユーザーはスーパーユーザーではなく、OpenText Functional Testing Labデータベースでのみ操作を実行する権限を持っています。

    データベース管理者のユーザー名を指定する必要があります (デフォルト: DLadmin)。ユーザー名は、英語の小文字のアルファベット、数字、および特殊文字「_」で構成できます。

    このユーザーの名前としてpostgresを使用しないでください。

    PostgreSQLデータベース管理者パスワード

    データベース管理者のパスワードを入力する必要があります。

    パスワードには、少なくとも1桁、大文字と小文字の英字が含まれている必要があり、6~20文字の英字である必要があります。任意の英字、数字、および特殊文字「@」と「_」を使用できます。

  15. OpenText Functional Testing Labにアップロードしたアプリケーションを保存するフォルダーを選択してください。デフォルトはopt/FunctionalTestingLabForMobileAndWeb/storageです。このインストールを実行するユーザーと、インストールの開始時に定義されたLinux OSユーザーの両方に、フォルダーに対する読み取りおよび書き込み権限が必要です。

  16. (オプション) 共有スペース (マルチテナント) 構成。

    必要に応じて、共有スペース機能を有効にします。
    重要: この機能には、EnterpriseまたはUltimateライセンスが必要です。共有スペースの無効化はサポートされておらず、クリーンインストールが必要です。詳しくは、共有スペースを参照してください。
  17. インストール前の概要を確認し、Enterを押して、インストールを続行します。
  18. インストールが完了するまでに数分かかります。インストールが完了すると、サーバーがインストールされたことを示すメッセージが表示され、次のオプションが提供されます。
    • 製品の改善のために匿名データの収集を許可します。このオプションの選択は、インストール後に管理設定で変更できます。
    • サービスを開始します。デフォルトでは、インストールプロセス中に特に指定しない限り、サーバーはポート8443 (HTTPS) または8080 (HTTP) で起動します。
  1. インストール後、アプリケーションファイルストレージフォルダーと外部データベース (該当する場合) に以下を組み込んで、ファイルとデータを安全に保つことを強くお勧めします。

    • アクセス監視

    • 制限付きアクセス権 (OpenText Functional Testing Labユーザーのみ)

    • 定期的なバックアップ

    • 暗号化

    • ストレージ消費の監視。合計ファイルストレージのしきい値を設定し、管理ダッシュボードのファイルストレージウィジェットを使用してこれを監視できます。詳細については、ファイルストレージを参照してください。

    OpenTextでは、次のことも推奨しています。

    • インストールフォルダーと一時フォルダーにファイルシステム監視を組み込む。
    • <OpenText Functional Testing Labサーバーインストールへのパス>/ Server /conf directoryにあるencrypted.propertiesファイルのバックアップ。

トップに戻る

サーバーをアップグレードする

OpenText Functional Testing Labは、既存のインストールのアップグレードとしてインストールできます。

スムーズなアップグレードを確実にするには、アップグレードのベストプラクティスを参照してください。

パッケージアプリ:  
iOSアプリでアプリパッケージャーアップグレーダーを実行するには、自動署名サービスの説明に従ってMacマシンをセットアップしておく必要があります。

OpenText Functional Testing Labにアップロードする前にコマンドラインから手動でアプリをパッケージ化した場合、アップグレーダーはアプリをアップグレードできなくなります。最新バージョンのPackager Service (iOS) またはAndroid Enablerを使用してアプリを再パッケージ化し、OpenText Functional Testing Labにアップロードする必要があります。

サーバーをアップグレードするには:

  1. OpenText Functional Testing Lab Linuxサーバーのzipファイルをダウンロードします。

  2. Linuxマシンでroot権限を持つユーザーとしてログインします。
  3. zipファイルをホームディレクトリの/rootにコピーします。
  4. サーバーインストールファイルを抽出します。
    unzip <Linuxサーバーファイルの名前>.zip –d <ターゲットディレクトリ名>
  5. ディレクトリをターゲットディレクトリに変更します。
    cd <ターゲットディレクトリ名>
  6. インストーラーを実行します。
    root権限を持つユーザーとして:
    ./<install_server-x64ファイル名>.bin

    インストールウィザードに [Introduction] ページが表示されます。内容を読み、Enterを押します。
  7. 使用許諾契約書を読み、yを選択して条件に同意し、インストールを続行します。
  8. インストーラーはこれがアップグレードであることを検出し、それに応じて警告します。アップグレードすると、既存のすべてのアプリは、対応するワークスペースに関連付けられたままになります。
  9. PostgreSQLスーパーユーザーのパスワードを入力します。
  10. アップグレード中にデータベースの自動バックアップを実行するかどうかを指定して、障害が発生した場合にインストールがロールバックを実行できるようにします。この手順により、アップグレードの期間が長くなる場合があります。
  11. インストール後にアプリパッケージャーアップグレーダーを自動的に実行するかどうかを指定します。OpenText Functional Testing Labサーバーのアップグレード後、アプリは非同期的にアップグレードされ、サーバーのダウンタイムが短縮されます。ユーザーは、アップグレードされたサーバーにアクセスして、アプリのアップグレード中もOpenText Functional Testing Labを引き続き使用できます。

    アップグレーダーを自動的に実行しない場合は、アップグレード後に手動で実行できます。詳細については、パッケージアプリのアップグレードを参照してください。

  12. アプリケーションの古いアップロードを削除することもできます。yを選択した場合は、保持するアップロード数を指定します (デフォルト: 30)。古いアップロードを削除するオプションを選択し、保持するアップロードの数を指定すると、これらの設定は[管理] > [設定] の [一般] セクションにコピーされます。詳しくは一般の設定を参照してください。
  13. OpenText Functional Testing Labにアップロードしたアプリケーションを保存するフォルダーを選択します。このアップグレードを実行するユーザーと、初期インストール時に定義されたLinux OSユーザーの両方に、フォルダーに対する読み取りおよび書き込みのアクセス許可が必要です。
  14. アプリをアップグレードすることを選択した場合、アップグレードするアプリのオペレーティングシステムを選択するように求められます。
  15. インストール前の概要を確認し、Enterを押して、インストールを続行します。

  16. パッケージアップグレードの概要セクションで、Enterをクリックして、サーバーのアップグレードを完了します。サーバーのアップグレード後も、アプリケーションは引き続きアップグレードされます。

    インストール後にサーバーが起動すると、ラボコンソールの [アプリ] メニューでアプリのアップグレードステータスを確認できます。アプリのステータスを確認するには、アプリカードの [詳細情報] アイコンをクリックします。以下の例は、まだアップグレード中のアプリを示しています。
  17. App in the proces of being upgraded

  18. インストールが完了すると、サーバーがインストールされたことを示すメッセージが表示され、製品の改善のために匿名データの収集を許可するオプションが提供されます。このオプションの選択は、インストール後に管理設定で変更できます。
  19. インストーラーを終了します。
  20. アップグレード後:
    • ラボ管理コンソールにログインする前に、ブラウザーのキャッシュをクリアしてください。テストエンジニアは、OpenText Functional Testing Labに接続する前に、テストツールマシンのブラウザーキャッシュをクリアする必要があります。
    • iOS: 開発者証明書を使用してエージェントアプリに再署名します。詳しくはiOSモバイルデバイスの接続を参照してください。

    ファイルとデータを安全に保つために、アプリケーションファイルストレージフォルダーと外部データベース (該当する場合) に次のものを組み込むことを強くお勧めします。

    • アクセス監視

    • 制限付きアクセス権 (OpenText Functional Testing Labユーザーのみ)

    • 定期的なバックアップ

    • 暗号化

    • ストレージ消費の監視。合計ファイルストレージのしきい値を設定し、管理ダッシュボードのファイルストレージウィジェットを使用してこれを監視できます。詳細については、ファイルストレージを参照してください。

    OpenTextでは、次のことも推奨しています。

    • インストールフォルダーと一時フォルダーにファイルシステム監視を組み込む。
    • OpenText Functional Testing Lab_ server_installdir/Server/confディレクトリにあるencrypted.propertiesファイルをバックアップする。

トップに戻る

サーバーの停止、開始、または再起動

次のコマンドを使用して、サーバーを停止および起動できます。

  • サーバーを起動するには: service DL start
  • サーバーを停止するには: service DL stop
  • サーバーを再起動するには: service DL restart

Ubuntu: ログ情報はコンソールではなく、ログファイル <OpenText Functional Testing Lab_server_installdir>/log/hpmc_daemon_service.logに出力されます。

トップに戻る

サーバーログ

サーバーの実行中にサーバーログを削除することはお勧めしません。ただし、サーバーがLinuxで実行されているときにログファイルをクリアする必要がある場合は、次のコマンドを実行できます。

cat /dev/null > <logFileName>

空きディスク容量を増やすためにログファイルを削除する場合、OpenTextでは、番号付きサフィックスを持つログファイルのみを削除することを推奨しています。例: connectorKeepAlive-1.log、connectorKeepAlive-2.log

トップに戻る

サーバーを変更する

必要に応じて、更新ツールを実行してサーバー構成を変更できます。詳細については、サーバーの再構成を参照してください。

トップに戻る

パッチのインストール

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

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

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

  • すべてのコネクター。

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

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

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

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

トップに戻る

トラブルシューティング

createrepoパッケージが見つからないために発生したサーバーインストールエラーを解決するには、以下の手順に従います。

トップに戻る

その他の参照項目: