Windowsインストール

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

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

始める前に

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

前提条件 詳細
サーバーの要件 サーバーマシンが、サポートマトリックスで指定された要件を満たしていることを確認してください。
権限 管理者権限が必要です。
サーバーのアクセシビリティ サーバーマシンのホスト名にアクセスできる必要があります。Windowsコマンドラインから以下を実行してこれを確認します。
ping -n 1 "hostname"
ドライバー

Androidデバイス用のUSBドライバー、またはiOSデバイス用のiTunesがインストールされていることを確認してください。

Windows 11ビルド22572以降のみ

WMIコマンドライン (WMIC) ユーティリティをインストールします。

  1. Windows + Iキーを同時に押して、[設定] を開きます。

  2. [アプリ] をクリックします。

  3. [オプション機能] をクリックします。

  4. [機能を表示] ボタンをクリックします。

  5. Wmicを検索します。横にあるチェックボックスをオンにして、[次へ] を押します。

  6. インストール]をクリックします。

トップに戻る

iOS 17以降の考慮事項

iOS 17以降で実行されているデバイスを接続するには、Appleから署名キーを定期的に取得するためにインターネットアクセスが必要です。サーバーマシンは以下にアクセスできる必要があります。

  • http://gs.apple.com
    OpenTextは、すべての*.appleドメインへのアクセスを許可することを推奨しています。

サーバーマシンがプロキシサーバー経由でインターネットにアクセスする場合は、管理設定でプロキシサーバーの詳細を構成します。詳細については、管理設定プロキシ設定を参照してください。

サーバーマシンでインターネットへのアクセスが許可されていない場合は、コネクターがAppleサーバーにアクセスできることを確認してください。コネクターがプロキシサーバーを使用する場合は、<installation_dir>/connector or server/conf/にあるconnector.propertiesファイルで次のプロキシサーバーの詳細を構成します。

  • APPLE_HTTP_PROXY_HOST=<プロキシホスト名>

  • APPLE_HTTP_PROXY_PORT=<プロキシポート番号>

  • APPLE_HTTP_PROXY_USERNAME= <プロキシサーバーに接続するためのユーザー名>

  • APPLE_HTTP_PROXY_PASSWORD= <プロキシサーバーに接続するためのパスワード>

サポートされているオペレーティングシステムと、考慮すべき追加の考慮事項については、サポートマトリックスを参照してください。

トップに戻る

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

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

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

  1. 元のデータベースのバックアップをhp4m.binファイルの形式で作成します。詳細については、組み込みデータベースをエクスポートするを参照してください。
  2. PostgreSQLデータベースをアンインストールせずにサーバーをアンインストールし、OpenText Functional Testing Labの新規インストールでデータベースを外部的に使用している場合は、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アドレスに置き換えます。
  1. データベースを復元します。詳しくは、エクスポートしたデータを外部データベースに移行するを参照してください。
  2. PostgreSQLデータベースが4GBを超える場合は、VACUUM FULLコマンドを実行して、削除されたコンテンツからデータベースをクリーンアップし、そのサイズを縮小することをお勧めします。詳細については、PostgreSQLのドキュメントを参照してください。
  3. オプション: 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>

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

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

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

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

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

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

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

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

トップに戻る

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

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

サーバーをインストールするには、次の手順を実行します。

  1. マシンにコネクターがインストールされていないことを確認してください。含まれている場合は、Windowsサーバーをインストールする前に削除する必要があります。詳細については、トラブルシューティングを参照してください。
  2. インストールzipファイルを入手します。抽出ツールを使用して、アーカイブファイルinstall-server-windows-x64-x.xx-x.zipの内容をマシンに抽出します。
  3. 管理者としてマシンにログインします。
  4. 解凍した.exeファイルを探します。ネットワーク共有ドライブではなく、ローカルドライブ上にあることを確認してください。
  5. セットアップファイルをクリックし、右クリックメニューから管理者として実行を選択します。インストールウィザードが開き、はじめにページが表示されます。
  6. インストール用のフォルダーと一時ファイル用のローカルフォルダーを選択します。
  7. デバイスをOpenText Functional Testing Labマシンに直接接続せずに、スタンドアロンコネクターのみを使用する予定の場合は、組み込みコネクターチェックボックスをオフにします。
  8. 次のガイドラインに従って、サーバーを構成します。

    サーバー構成 詳細
    FQDNまたはIPアドレス 自動的に検出された値を使用するか、必要に応じて変更します。完全修飾ドメイン名 (FQDN) を使用する場合、FQDNは英語のアルファベット文字で始まる必要があります。数字で始まるFQDNはサポートされていません。
    SSL接続

    非セキュアHTTP接続 (非SSL) で機能するには、SSLのみチェックボックスをオフにします。デフォルトは、ポート8443を使用したセキュアSSL接続です。

    次のガイドラインを考慮してください。

    • SSL設定は、サーバーと統合するすべてのコネクターとテストツールに影響します。コネクターやツールでOpenText Functional Testing Labの設定を行う場合は、サーバーの選択と一致していることを確認してください。

    • SAML 2.0を使用してシングルサインオンを使用する場合は、チェックボックスをオフにしないでください。

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


    空きポート

    マシンのファイアウォールに含まれない内部ポートを受け入れるか編集します。このポートが使用可能であり、外部からアクセスできないことを確認してください。デフォルトの空きポートは8081です。

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

    サーバーのインストールの一部としてインストールされる組み込みPostgreSQLデータベース。ただし、外部PostgreSQLデータベースを使用チェックボックスをオンにすると、既存の外部PostgreSQLデータベースに接続できます。このオプションを使用すると、組織は既存のデータベースリソースを管理および利用できます。OpenText Functional Testing Labを外部データベースとともにインストールする前に、外部データベースを使用するで説明されている手順に従っていることを確認してください。

    このオプションを選択すると、次へボタンで外部PostgreSQLデータベース設定画面が開きます。データベースマシンにアクセスできることを確認し、接続に次を指定します。

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

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

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

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

    スキーマ 

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

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

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

    ラボサーバーがSSLを使用して外部データベースサーバーに接続できるようにするには、チェックボックスをオンにします。

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

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

  2. OpenText Functional Testing Labにアップロードしたアプリケーションを保存するフォルダーを選択してください。
    このインストールを実行するユーザーとローカルシステムアカウントの両方に、フォルダーへの読み取りおよび書き込み権限が必要です。共有フォルダーを使用する場合、OpenText Functional Testing Labマシンのローカルシステムアカウントには、フォルダーへの読み取りおよび書き込み権限が必要です。ドメインにないマシンには、個別のユーザー管理があります。各マシンは、独自のユーザーアカウントを追跡します。別のマシンのフォルダーを使用するには、同じ名前とパスワードのWindowsアカウントが両方のマシンで定義されていることを確認してください。インストール後、このWindowsアカウントで実行するようにOpenText Functional Testing Labサーバーを変更します。詳しくは、別のユーザーとしてサービスを実行するを参照してください。
  3. オプション: 共有スペースの構成。

    必要に応じて、共有スペース (マルチテナンシー) 機能を有効にします。
    重要: この機能には、EnterpriseまたはUltimateライセンスが必要です。共有スペースの無効化はサポートされておらず、クリーンインストールが必要です。詳しくは、共有スペースを参照してください。
  4. 次のユーザーの資格情報を指定します。

    ユーザー詳細
    OpenText Functional Testing Labデフォルト管理者

    インストールにより、ラボコンソールにアクセスするためのデフォルトの管理者ユーザーadmin@default.comが作成されます。このユーザーのパスワードを指定します。

    Postgresユーザー- 組み込みデータベースのみ

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

    データベース管理者ユーザー

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

    画面に表示されるパスワード規則に従います。小文字と大文字の両方で6文字以上の英語の文字、1文字以上の数字、スペースまたは「@」記号を除く文字または数字のみを使用します。

  5. インストールが完了すると、ウィザードはサーバーが正常にインストールされたことを示すメッセージを表示し、次のオプションを提供します。
    • 次へを押すと自動的にサービスを開始します。

    • 製品の改善のためのデータ収集を許可します。このオプションの選択は、管理設定で変更できます。

  6. サービスが開始すると、デフォルトのブラウザーウィンドウでOpenText Functional Testing Labコンソールが開きます。以前に提供した資格情報を使用してログインします。画面の指示に従ってデバイスを接続し、作業を開始します。

    インストールにより、デスクトップ上にサーバーのインストールフォルダーへの新しいショートカットOpenText Functional Testing Labサーバーが作成されます。

  7. OpenText Functional Testing Labをインストールした後、アプリケーションファイルストレージフォルダーと外部データベース (該当する場合) に以下を組み込んで、ファイルとデータを安全に保つことを強くお勧めします。
    • アクセス監視

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

    • 定期的なバックアップ

    • 暗号化

    • ストレージ消費の監視

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

    • デフォルトのLocalServiceアカウントではなく、OpenText Functional Testing Labサービスを実行しているアカウントを変更する。このアカウントがOpenText Functional Testing Labインストールフォルダーへのフルアクセス権を持っていることを確認してください。詳細については、Windowsのドキュメントを参照してください。
    • インストールフォルダーと一時フォルダーにファイルシステム監視を組み込む。
    • encrypted.propertiesファイルをバックアップする。ファイルは<OpenText Functional Testing Labサーバーインストールへのパス> server >confにあります。

トップに戻る

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

OpenText Functional Testing Labは、バージョン3.2以降からのアップグレードとしてインストールできます。

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

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

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

アップグレードするには、次の手順を実行します。

  1. インストールzipファイルを入手します。抽出ツールを使用して、アーカイブファイルinstall-server-windows-x64-x.xx-x.zipの内容をコンピューターに抽出します。
  2. セットアップファイルを実行します。インストールを開始すると、ウィザードはアップグレードを実行していることを検出し、既存のアプリが失われることを警告します。また、データベースのパスワードの入力を求められます。アップグレードすると、既存のすべてのアプリは対応するワークスペースに関連付けられたままになります。詳細については、ラボとワークスペースの管理を参照してください。
  3. アップグレード中にデータベースの自動バックアップを実行するかどうかを指定して、障害が発生した場合にインストールがロールバックを実行できるようにします。この手順により、アップグレードの期間が長くなる場合があります。
  4. 次の画面で、インストール後にアプリパッケージャーアップグレーダーを自動的に実行するかどうかを指定します。OpenText Functional Testing Labサーバーのアップグレード後、アプリは非同期的にアップグレードされ、サーバーのダウンタイムが短縮されます。ユーザーは、アップグレードされたサーバーにアクセスして、アプリのアップグレード中もOpenText Functional Testing Labを引き続き使用できます。
    自動アップグレーダーを実行しないことを選択した場合は、後でアップグレーダーを手動で実行できます。詳細については、パッケージアプリのアップグレードを参照してください。
  5. アプリケーションの古いアップロードを削除することもできます。はいを選択した場合は、保持するアップロード数を指定します (デフォルト: 30)。古いアップロードを削除するオプションを選択し、保持するアップロードの数を指定すると、これらの設定は[管理] > [設定] の [一般] セクションにコピーされます。詳細については、管理設定のファイルストレージ設定を参照してください。
  6. OpenText Functional Testing Labにアップロードしたアプリケーションを保存するフォルダーを選択します。このインストールを実行するユーザーとローカルシステムアカウントの両方に、フォルダーへの読み取りおよび書き込み権限が必要です。
  7. ファイルストレージとOpenText Functional Testing Labサーバーマシンが同じドメインになく、同じWindowsワークグループの一部である場合、両方のマシンで同じWindows管理者のユーザー名とパスワードが必要です。インストール後、Windows管理者ユーザーでOpenText Functional Testing Labサーバーを実行します。詳しくは、別のユーザーとしてサービスを実行するを参照してください。
  8. アプリのアップグレードを選択した場合、次の画面で、アップグレードするアプリのオペレーティングシステムを選択するように求められます。
  9. インストール設定の概要を確認し、[次へ]をクリックしてインストールを続行します。
  10. サーバーのアップグレードを完了するには、[次へ]をクリックします。サーバーのアップグレード後も、アプリケーションは引き続きアップグレードされます。

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

    App in the proces of being upgraded

  11. インストールが完了すると、ウィザードはサーバーが正常にインストールされたことを示すメッセージを表示し、次のオプションを提供します。

    • 完了を押すと自動的にサービスを開始します。
    • 製品の改善のためのデータ収集を許可します。このオプションの選択は、管理設定で変更できます。
  12. 完了]をクリックします。

  13. サーバーをアップグレードした後、アプリケーションファイルストレージフォルダーと外部データベース (該当する場合) に以下を組み込んで、ファイルとデータを安全に保つことを強くお勧めします。

    • アクセス監視

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

    • 定期的なバックアップ

    • 暗号化

    • ストレージ消費の監視

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

    • デフォルトのLocalServiceアカウントではなく、OpenText Functional Testing Labサービスを実行しているアカウントを変更する。このアカウントがOpenText Functional Testing Labインストールフォルダーへのフルアクセス権を持っていることを確認してください。詳細については、Microsoft Windowsドキュメントの「サービスの開始方法を構成する」を参照してください。
    • インストールフォルダーと一時フォルダーにファイルシステム監視を組み込む。
    • OpenText Functional Testing Labサーバーインストールフォルダーにあるencrypted.propertiesファイルをバックアップする。

トップに戻る

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

Windowsスタートメニューから、Functional Testing Lab for Mobile and Web Serverに移動し、必要なアクションを選択します。

トップに戻る

別のユーザーとしてサービスを実行する

特定の統合では、Functional Testing Lab for Mobile and Webサービスを別のユーザーとして実行する必要がある場合があります。これは、サービスマネージャーを介して実行できます。

  1. Win + Rをクリックして [ファイル名を指定して実行] ダイアログボックスを開き、services.mscと入力します。
  2. Functional Testing Lab for Mobile and Web ServerおよびFunctional Testing Lab for Mobile and Web Nginxサービスを見つけます。
  3. Functional Testing Lab for Mobile and Web Serverサービスを右クリックし、プロパティを選択します。
  4. ログオンタブで、このアカウントを選択し、認証情報を入力し、適用をクリックします。

  5. Functional Testing Lab for Mobile and Web Ngnixサービスについて、上記の手順を繰り返します。

トップに戻る

サーバーを変更する

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

トップに戻る

更新

機能強化や修正を含むアップデートが随時リリースされます。

製品 詳細
OpenText Functional Testing Lab

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

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

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

  • すべてのコネクター: OpenTextでは、コネクターの自動更新設定を有効にすることを推奨しています。これにより、サーバーに更新プログラムをインストールするときに、コネクターを手動で更新する必要がなくなります。詳細については、管理設定の一般を参照してください。

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

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

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

OpenText Core SDP

OpenTextがサーバーに更新をデプロイする場合は、コネクターもアップグレードする必要があります。OpenTextでは、コネクターの自動更新設定を有効にすることを推奨しています。詳細については、管理設定を参照してください。

注: アプリの手動署名にiOSまたはAndroid Enablerを使用する場合は、サーバーが更新されたときにこれらもアップグレードする必要があります。最新バージョンは、ADM Marketplaceからダウンロードできます。

トップに戻る

トラブルシューティング

Windowsサーバーのトラブルシューティングについては、Windowsサーバーを参照してください。

トップに戻る

その他の参照項目: