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

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

始める前に

UFT Mobileをインストールする前に、以下を確認してください。

  • サーバーマシンは、サポートマトリックスで指定された要件を満たしています。
  • 管理者権限があります。
  • サーバーマシンのホスト名にアクセスできます。Windowsコマンドラインから以下を実行してこれを確認します。
    ping -n 1 "hostname"
  • Androidデバイス用のUSBドライバー、またはiOSデバイス用のiTunesをインストールしました。

注: USBスティックまたはフラッシュドライブへのサーバーのインストールはサポートされていません。

トップに戻る

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

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

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

  1. 元のデータベースのバックアップをhp4m.binファイルの形式で作成します。詳細については、組み込みデータベースをエクスポートするを参照してください。
  2. PostgreSQLデータベースをアンインストールせずにUFTMサーバーをアンインストールし、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アドレスに置き換えます。
  1. データベースを復元します。詳しくは、エクスポートしたデータを外部データベースに移行するをご覧ください。
  2. 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. postgresql13サービスを再起動します。
  4. postgresql 13ユーザーパスワードをリセットして、再起動します。

トップに戻る

フルインストール

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

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

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

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

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

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

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

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

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

    マシンのファイアウォールに含まれないデフォルトの内部ポート8081を受け入れるか編集します。このポートが使用可能であり、外部からアクセスできないことを確認してください。
  1. 外部PostgreSQLデータベースを構成します。
    外部PostgreSQLデータベースを使用するチェックボックスを選択すると、UFT Mobileを既存の外部PostgreSQLデータベースに接続することを選択できます。このオプションを使用すると、組織は既存のデータベースリソースを管理および利用できます。UFT Mobileを外部データベースとともにインストールする前に、外部データベースの使用で説明されている手順に従っていることを確認してください。

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

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

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

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

    スキーマ 

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

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

    ユーザーの資格情報PostgreSQLデータベースのユーザー名とパスワード。
  2. UFT Mobileにアップロードしたアプリケーションを保存するフォルダーを選択してください。UFT Mobileバージョン3.2以降、アプリケーションはデータベースに保存されなくなり、ファイルシステムに保存されます。

    このインストールを実行するユーザーとローカルシステムアカウントの両方に、フォルダーへの読み取りおよび書き込み権限が必要です。共有フォルダーを使用する場合、UFT Mobileマシンのローカルシステムアカウントには、フォルダーへの読み取りおよび書き込み権限が必要です。ドメインにないマシンには、個別のユーザー管理があります。各マシンは、独自のユーザーアカウントを追跡します。別のマシンのフォルダーを使用するには、同じ名前とパスワードのWindowsアカウントが両方のマシンで定義されていることを確認してください。インストール後、このWindowsアカウントで実行するようにUFT Mobileサーバーを変更します。詳しくは、別のユーザーとしてサービスを実行するをご覧ください。
  3. 共有スペースの構成 (オプション):
    必要に応じて、共有スペース (マルチテナンシー) 機能を有効にします。
    重要：この機能には、EnterpriseまたはUltimateライセンスが必要です。共有スペースの無効化はサポートされておらず、クリーンインストールが必要です。詳しくは共有スペース (オンプレミス)をご覧ください。
  4. 次の資格情報を指定します。
    UFT Mobileデフォルトの管理者

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

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

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

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

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

  5. インストールが完了すると、ウィザードはサーバーが正常にインストールされたことを示すメッセージを表示し、次のオプションを提供します。
    • 次へを押すと自動的にサービスを開始します。
    • 製品の改善のためのデータ収集を許可します。このオプションの選択は、管理設定で変更できます。

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

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

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

    • アクセス監視

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

    • 定期的なバックアップ

    • 暗号化

    • ストレージ消費の監視

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

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

トップに戻る

アップグレード

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

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

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

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

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

  1. インストールzipファイルを入手します。抽出ツールを使用して、アーカイブファイルinstall-server-windows-x64-x.xx-x.zipの内容をコンピューターに抽出します。
  2. セットアップファイルを実行します。インストールを開始すると、ウィザードはアップグレードを実行していることを検出し、既存のアプリが失われることを警告します。また、データベースのパスワードの入力を求められます。アップグレードすると、既存のすべてのアプリは対応するワークスペースに関連付けられたままになります。詳しくはラボとワークスペースの管理をご覧ください。
  3. アップグレード中にデータベースの自動バックアップを実行するかどうかを指定して、障害が発生した場合にインストールがロールバックを実行できるようにします。この手順により、アップグレードの期間が長くなる場合があります。
  4. 次の画面で、インストール後にアプリパッケージャーアップグレーダーを自動的に実行するかどうかを指定します。UFT Mobileサーバーのアップグレード後、アプリは非同期的にアップグレードされ、サーバーのダウンタイムが短縮されます。ユーザーは、アップグレードされたサーバーにアクセスして、アプリのアップグレード中もUFT Mobileを引き続き使用できます。

    自動アップグレーダーを実行しないことを選択した場合は、後でアップグレーダーを手動で実行できます。詳細については、パッケージアプリのアップグレード (オンプレミス)を参照してください。
  5. アプリケーションの古いアップロードを削除することもできます。はいを選択した場合は、保持するアップロード数を指定します(デフォルト: 30)。古いアップロードを削除し、保持するアップロードの数を指定すると、これらの設定は管理 > 設定の一般セクションにコピーされます。詳細については、管理設定のファイルストレージ設定を参照してください。
  6. UFT Mobileにアップロードしたアプリケーションを保存するフォルダーを選択します。このインストールを実行するユーザーとローカルシステムアカウントの両方に、フォルダーへの読み取りおよび書き込み権限が必要です。

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

    ファイルストレージとUFT Mobileサーバーマシンが同じドメインになく、同じWindowsワークグループの一部である場合、両方のマシンで同じWindows管理者のユーザー名とパスワードが必要です。インストール後、Windows管理者ユーザーでUFT Mobileサーバーを実行します。詳しくは、別のユーザーとしてサービスを実行するをご覧ください。

  7. アプリのアップグレードを選択した場合、次の画面で、アップグレードするアプリのオペレーティングシステムを選択するように求められます。
  8. インストール設定の概要を確認し、[次へ]をクリックしてインストールを続行します。

  9. サーバーのアップグレードを完了するには、[次へ]をクリックします。サーバーのアップグレード後も、アプリケーションは引き続きアップグレードされます。

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

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

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

  11. ［Done］をクリックします。

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

    • アクセス監視

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

    • 定期的なバックアップ

    • 暗号化

    • ストレージ消費の監視

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

    • デフォルトのLocalServiceアカウントではなく、UFT Mobileサービスを実行しているアカウントを変更します。このアカウントがUFT Mobileインストールフォルダーへのフルアクセス権を持っていることを確認してください。詳細については、Windowsのドキュメントを参照してください。
    • UFT Mobileインストールおよび一時フォルダーにファイルシステム監視を組み込みます。
    • UFT Mobileサーバーインストールフォルダーにある暗号化.propertiesファイルをバックアップします。

トップに戻る

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

Windows スタートメニューから、UFT Mobileサーバーに移動し、必要なアクションを選択します。必要なコマンドを検索することもできます。「UFT Mobileサーバーサービスを開始する」、「UFT Mobileサーバーサービスを停止する」、「UFT Mobileサーバーサービスを再開する」。

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

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

  1. Win + Rをクリックして[ファイル名を指定して実行]ダイアログボックスを開き、services.mscと入力します。
  2. UFT Mobile ServerおよびUFT Mobile Nginxサービスを見つけます。
  3. UFT Mobileサーバーサービスを右クリックし、プロパティを選択します。

  4. ログオンタブで、このアカウントを選択し、認証情報を入力し、適用をクリックします。

  5. UFT Mobile Ngnixサービスについて、上記の手順を繰り返します。

トップに戻る

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

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

アップグレードの準備

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

  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. アップグレードの説明に従って、テストマシンでセットアップファイルを実行します。アップグレード中に問題が発生した場合は、サポートに連絡してください。
  6. テストマシンでUFT Mobileにログインし、以下のアップグレードチェックリストに示されているように、アプリ、デバイス、設定などを確認して、インポートが成功したことを確認します。
  7. 任意：統合テストツールの1つを使用してテストを実行してみてください。

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

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

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

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

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

トップに戻る

トラブルシューティング

インストールの問題は、多くの要因によって引き起こされる可能性があります。次の情報は、インストールの問題を解決するのに役立つ場合があります。

  • インストールのトラブルシューティングについては、UFT Mobileインストールの下のinstallation/Logsフォルダーにあるインストールログファイルを参照してください。インストールがハングした場合でも、中間ログInstallation/UFT_Mobile_Server_install.logを表示できます。

  • 503エラー-アプリケーションストレージ用の共有フォルダーを使用してインストールした後、サーバーを起動できません。ファイルストレージとUFT Mobileサーバーマシンが同じドメインになく、同じWindowsワークグループの一部である場合、両方のマシンで同じWindows管理者のユーザー名とパスワードが必要です。インストール後、Windows管理者ユーザーでUFT Mobileサーバーを実行する必要があります。詳しくは、別のユーザーとしてサービスを実行するをご覧ください。

  • UFT Mobileサーバーの情報を変更する必要がある場合は、UFT Mobileサーバーの再構成 (オンプレミス)をご覧ください。
  • コネクターに関するトラブルシューティングのヒントについては、Windowsコネクターのトラブルシューティングを参照してください。
  • 製品をアンインストールするには、UFT Mobileのアンインストール (オンプレミス)をご覧ください。

  • Windowsサーバーをインストールする前に、Windowsコネクターがマシンにインストールされていないことを確認してください(C:\Program Files\UFT Mobile Connector)。コネクターがある場合は、スタートメニューからアンインストールコマンドを使用します。

  • セットアップで問題が発生した場合:

    • C:\Program Filesに移動し、UFT Mobile Connectorフォルダーが存在する場合は削除します(アンインストールを実行しようとした後)。
    • (非表示)ゼロGレジストリフォルダーを削除します。表示されていない場合は、Windowsエクスプローラーで整理 > フォルダーと検索オプション > 表示タブを選択し、隠しファイル、フォルダー、ドライブを表示を選択します。
    • サーバーのインストールを開始して失敗した場合は、WindowsサーバーのインストールフォルダーC:\Program Files\UFT Mobile Serverを削除し、セットアップを再開してください。
    • インストールは成功したが、UFT Mobileサーバーにアクセスできない場合は、ポートがファイアウォールまたはウイルス対策プログラムによってブロックされていないことを確認してください。
    • インストール > ログフォルダー内のインストールログファイルを参照し、エラーメッセージを探してください。

トップに戻る

その他の参照項目：