UFT Mobile - Linuxインストール (オンプレミス)

このセクションでは、Linuxマシンにサーバーをインストールする方法について説明します。このセクションは、UFT Mobileのオンプレミスデプロイメントにのみ関連します。Windowsマシンへのサーバーのインストールについては、UFT Mobile-Windowsインストール (オンプレミス)を参照してください。

始める前に

UFT Mobileをインストールまたはアップグレードする前に:

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

  • root権限がある。
  • サーバーマシンのホスト名にアクセスできる。次のコマンドを実行して、これを確認します。
    ping -c 1 "hostname"
  • 新規インストールのみ: Nginxがすでにサーバーマシンにインストールされている場合は、UFT Mobileをインストールする前に、Nginxを削除してください。

トップに戻る

UFT Mobileで外部データベースを利用する

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

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

  1. 元のデータベースのバックアップをhp4m.binファイルの形式で作成します。詳細については、組み込みデータベースをエクスポートするを参照してください。
  2. サーバーをアンインストールしたがPostgreSQLデータベースをアンインストールせず、データベースを外部データベースとして使用していて、UFT Mobileをクリーンインストールしている場合は、postgresユーザーをpg_hba.confファイルに追加します。このファイルは、<Postgresインストールフォルダー>/<postgresバージョン>/dataにあります。


    3. また、元のUFT Mobileデータベース暗号化キーも必要になります。外部データベースには、UFT Mobileによって最初に作成されたデータを復号化するためのキーが必要です。

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

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

トップに戻る

新規インストールとしてUFT Mobileをインストールする

以前のバージョンがインストールされていないフルインストールとしてUFT Mobileをインストールするには、次の手順に従います。

  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/UFTMobile/です。
  9. Linux OSユーザーを構成します。

    10. 既存のLinux OSユーザーを使用する場合は、Yを選択し、ユーザー名を入力してください。

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

    nを選択すると、UFT MobileがデフォルトのLinux OSユーザーUFTMを作成します。このユーザーに新しいパスワードを入力します。

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

    FQDNまたはIPアドレス

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

    SSL接続

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

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

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

    サーバーポート

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

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

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

  11. PostgreSQLの構成段階で、インストールにより、外部PostgreSQLデータベースを使用するかどうかを指定するように求められます。外部データベースを使用すると、組織は既存のデータベースリソースを利用し、他のすべてのシステムでそれらを管理できます。UFT Mobileが埋め込まれたPostgreSQL版を利用したい場合は、次のステップに進んでください。

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

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

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

    • 外部データベースサーバー: データベースマシンのIPアドレスまたは完全修飾ドメイン名 (FQDN)。
    • データベースポート: 外部データベースマシンのポート。
    • データベース: 外部データベースの名前。「hp4m」などのデータベース名を使用できます。このデータベースは、ターゲットデータベースサーバーにすでに存在している可能性があります。そうでない場合は、ユーザーに十分な権限がある場合、UFT Mobileサーバーのインストールの一部として作成されます。

    • スキーマ: 「public」などのスキーマ名を使用できます。このスキーマは、指定されたデータベースにすでに存在している可能性があります。そうでない場合は、ユーザーに十分な権限がある場合、UFT Mobileサーバーのインストールの一部として作成されます。

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

    • データベースのユーザー名とパスワード。
  12. 埋め込みバージョンのPostgreSQLデータベースを使用する場合は、次のガイドラインに従ってPostgreSQLを構成してください。
    13. データベースサーバーポート標準設定: 5432
    PostgreSQLスーパーユーザーパスワード

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

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

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

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

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

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

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

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

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

    注: Mobile Centerバージョン3.2以降、アプリケーションはデータベースに保存されなくなり、ファイルシステムに保存されます。

  14. オプションで、共有スペース (マルチテナンシー) 構成を設定します。
    必要に応じて、共有スペース機能を有効にします。
    重要: この機能には、EnterpriseまたはUltimateライセンスが必要です。共有スペースの無効化はサポートされておらず、クリーンインストールが必要です。詳しくは共有スペース (オンプレミス)をご覧ください。
  15. インストール前の概要を確認し、Enterを押して、インストールを続行します。
  16. インストールが完了するまでに数分かかります。インストールが完了すると、サーバーがインストールされたことを示すメッセージが表示され、次のオプションが提供されます。
    • 製品の改善のために匿名データの収集を許可します。このオプションの選択は、インストール後に管理設定で変更できます。
    • サービスを開始します。インストールプロセス中に特に指定されていない限り、デフォルトでは、サーバーはポート8443 (HTTPS) または8080 (HTTP) で起動します。
  1. インストール後:

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

    • アクセス監視

    • 制限付きアクセス権 (UFTMユーザーのみ)

    • 定期的なバックアップ

    • 暗号化

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

    また、次のことをお勧めします。

    • UFT Mobileインストールおよび一時フォルダーへのファイルシステム監視の組み込み。
    • <UFT Mobile サーバーのインストール> サーバー >confディレクトリにあるencrypted.propertiesファイルのバックアップ。

トップに戻る

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

UFT Mobileは、UFT Mobile 3.2以降の既存のインストールへのアップグレードとしてインストールできます。

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

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

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

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

  1. UFT Mobile 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. インストール後にアプリパッケージャーアップグレーダーを自動的に実行するかどうかを指定します。UFT Mobileサーバーのアップグレード後、アプリは非同期的にアップグレードされ、サーバーのダウンタイムが短縮されます。ユーザーは、アップグレードされたサーバーにアクセスして、アプリのアップグレード中もUFT Mobileを引き続き使用できます。

    そうしないことを選択した場合は、アップグレード後に手動で実行できます。詳細については、パッケージアプリのアップグレード (オンプレミス)を参照してください。

  12. アプリケーションの古いアップロードを削除することもできます。yを選択した場合は、保持するアップロード数を指定します。(デフォルト: 30)。古いアップロードを削除し、保持するアップロードの数を指定すると、これらの設定は [管理] > [設定] の [一般] セクションにコピーされます。詳しくは一般の設定をご覧ください。
  13. UFT Mobileにアップロードしたアプリケーションを保存するフォルダーを選択します。このアップグレードを実行するユーザーと、初期インストール時に定義されたLinux OSユーザーの両方に、フォルダーに対する読み取りおよび書き込みのアクセス許可が必要です。

    注: UFT Mobileバージョン3.2以降、アプリケーションはデータベースに保存されなくなり、ファイルシステムに保存されます。

  14. アプリをアップグレードすることを選択した場合、アップグレードするアプリのオペレーティングシステムを選択するように求められます。

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

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

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

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

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

    • アクセス監視

    • 制限付きアクセス権 (UFTMユーザーのみ)

    • 定期的なバックアップ

    • 暗号化

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

    また、次のことをお勧めします。

    • UFT Mobileインストールおよび一時フォルダーへのファイルシステム監視の組み込み。
    • <UFT Mobile サーバーのインストール> サーバー >confディレクトリにあるencrypted.propertiesファイルのバックアップ。

トップに戻る

サーバーを停止、開始、または再起動する

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

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

  • サーバーを再起動するには: service UFTM restart

トップに戻る

サーバーログ

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

cat /dev/null > <logFileName>

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

アップグレードのベストプラクティス

スムーズなアップグレードを保証し、データの損失を防ぐために、最初に、実稼働マシンと同じオペレーティングシステムを使用してテストマシンでアップグレードを実行することを強くお勧めします。テストマシンでアップグレードが成功した場合は、本番サーバーのアップグレードに進むことができます。

アップグレードの準備

アップグレードプロセスを開始する前に:

  1. iOSパッケージャサービスを使用している場合は、アップグレードプロセスを実行する前に、新しいバージョンにアップグレードしてください。詳細については、自動パッケージングおよび署名サービスを参照してください。

  2. セットアップ中にプロンプトが表示されるので、アップグレードプロセス中にアプリケーションをアップグレードするかどうかを決定します。

    • UFT Mobile 3.2以降、アプリは非同期でアップグレードされます。ユーザーは、アプリのアップグレード中も、アップグレードされたサーバーにアクセスして引き続き使用できます。アプリのアップグレード状況は、ラボコンソールのアプリメニューで確認できます。
    • アプリを自動的にアップグレードしたくない場合は、後の段階でアプリをアップグレードできます。詳細については、パッケージアプリのアップグレード (オンプレミス)を参照してください。
  3. 既存のUFT Mobileデータベースをバックアップします。詳細については、組み込みデータベースをエクスポートするを参照してください。

  4. 実稼働環境と同じオペレーティングシステムでテストマシンを準備します。CPUやRAMなどの他のハードウェアパラメーターは異なる場合があります。このマシンは、アップグレードのテスト環境として機能します。

アップグレードを実行する

上記で準備したテストマシンでアップグレードを実行することをお勧めします。UFT Mobileを次のようにアップグレードします。

  1. 現在のUFT Mobileサーバーのバージョンを、実稼働環境と同じオペレーティングシステムのテストマシンにインストールします。
  2. 元のデータベースをテストマシンにインポートします。詳しくは、エクスポートしたデータを外部データベースに移行するを参照してください。

  3. テストマシンでUFT Mobileにログインし、アップグレードチェックリストに示されているように、アプリ、デバイス、設定などを確認して、インポートが成功したことを確認します。これらのコネクターは、テストマシンではなく本番マシンで動作するように構成されているため、通信できないことに注意してください。

  4. アップグレードするUFT Mobileバージョンのサーバーインストールファイルを見つけます。
  5. UFT Mobileサーバーのアップグレードの説明に従って、その内容を抽出し、テストマシンでファイルを実行します。アップグレード中に問題が発生した場合は、サポートに連絡してください。
  6. テストマシンでUFT Mobileにログインし、アップグレードチェックリストに示されているように、アプリ、デバイス、設定などを確認して、インポートが成功したことを確認します。
  7. オプション: アップグレードされたテストマシンに新しいコネクターをインストールし、統合されたテストツールの1つを使用してテストを実行してみてください。

  8. 上記のすべての情報がテストマシンで正しい場合は、本番マシンのUFT Mobileサーバーをアップグレードするに進みます。

アップグレードチェックリスト

テストマシンでアップグレードプロセスが完了したら、次の項目をチェックして、アップグレードが成功したことを確認します。

  • ログイン: 管理者ユーザーとしてUFT Mobileにログインします。
  • ユーザー: [管理] > [ユーザー] ページで、すべてのユーザーがUFT Mobileに移行したことを確認してください。
  • 設定: すべての管理設定が実稼働環境から移行されたことを確認してください。
  • アプリ: アップグレードプロセス中にアプリケーションをアップグレードすることを選択した場合は、すべてのアプリがアプリ画面に表示されていることを確認してください。
  • コネクター: [デバイス] > [コネクター] ページにすべてのコネクターが表示されていることを確認してください。これらのコネクターは、テストマシンではなく本番マシンで動作するように構成されているため、通信できないことに注意してください。
  • デバイス: 実稼働環境のすべてのデバイスが表示されていることを確認してください。

欠品やその他の問題が発生した場合は、サポートまでご連絡ください。

トップに戻る