UFT Mobileサーバー(オンプレミス)の移行

このトピックでは、UFT Mobileサーバーを別のマシンに移行する方法について説明します。同じオペレーティングシステム(LinuxからLinuxなど)のマシンまたは別のオペレーティングシステム(LinuxからWindowsなど)に移行できます。このセクションは、UFT Mobileのオンプレミスデプロイメントにのみ関連します。

概要

UFT Mobileはデータベースとファイルシステムにデータを保存します。

ファイルシステム

UFT Mobileサーバーサービスがアクセスおよびアクセス許可を持っている場所ならどこでも使用できます。

データベース

UFT Mobile組み込みPostgreSQLデータベースまたは外部PostgreSQLデータベースをご利用いただけます。

UFT Mobileサーバーを移行する場合、データベースは次のように移行できます。

移行フロー ステップ
あるUFT Mobileデータベースが組み込まれたサーバーから別のUFT Mobileサーバーにデータベースが組み込まれたサーバーへ。
  1. 組み込みデータベースをエクスポートします。
  2. 新しいサーバーをインストールします。
  3. データベースを新しいサーバーマシンにインポートします。
あるUFT Mobileサーバーにデータベースが組み込まれているサーバーから別のUFT Mobileサーバーに外部データベースが組み込まれているサーバーへ。
  1. 組み込みデータベースをエクスポートします。
  2. エクスポートされたデータベースを外部データベースに移行します。
  3. 外部PostgreSQLデータベースを使用オプションを使用して新しいサーバーをインストールします。
UFT Mobileサーバーはすでに外部データベースを使用しています。 新しいサーバーをインストールするにスキップ。

重要：UFTM 3.5以降から、コネクターを内蔵したUFTMサーバーを設置するかどうかを選択できます。サーバーを移行するときは、ソースとターゲットが組み込みコネクターに関して整列していることを確認してください。組み込みコネクターなしでインストールされたインスタンスから組み込みコネクター付きでインストールされたインスタンスへの移行、およびその逆の移行はサポートされていません。

トップに戻る

組み込みデータベースをエクスポートする

組み込みデータベースを移行するには、最初に次のように元のサーバーマシンからデータベースをエクスポートします。

  1. PostgreSQL binフォルダーに移動します。
    デフォルトC:\Program Files\PostgreSQL\<postgresバージョン>\bin

  2. コマンドラインプロンプトから次のコマンドを発行します(DBパスワードの入力を求められます)。

    pg_dump -Fc -b -U <uftmデータベース管理者 > hp4m > <ダンプファイルへのパス >

    たとえば、デフォルトの管理者を使用すると、pg_dump -Fc -b -U UFTMadmin hp4m > C:\Temp\hp4m.dump

  1. PostgreSQL binフォルダーに移動します。デフォルトでは/user/pgsql-11/binです。

  2. 次のコマンドを発行します(DBパスワードの入力を求められます)。

    ./pg_dump -Fc -b -U <uftm admin user> hp4m> <ダンプファイルのパス>

    たとえば、デフォルトの管理者を使用すると、./pg_dump -Fc -b -UUFTMadminhp4m > /tmp/hp4m.dump

トップに戻る

エクスポートしたデータを外部データベースに移行する

このセクションでは、元のUFT Mobileサーバーの組み込みデータベースからエクスポートしたデータを外部データベースに移行する方法について説明します。新しいUFT Mobileサーバーが組み込みデータベースを使用する場合、または既存の外部データベースがある場合は、新しいサーバーをインストールするにスキップします。

外部データベースに移行するには:

  1. エクスポートしたデータベースファイルhp4m.dumpを、既存のUFT Mobileサーバーから外部PostgreSQLサーバーにコピーします。

  2. コマンドラインで、ディレクトリをPostgreSQLのbinフォルダーに変更します。

  3. UFT Mobileのデータベースをhp4mという名前で作成します。
    Windows

    createdb.exe -U <データベース管理者> hp4m

    Linux:

    ./createdb -U <データベース管理者> hp4m

  1. データベースをインポートします。

    Windows:

    pg_restore -U <uftmデータベース管理者> -c -d hp4m <hp4m.dumpへのパス>

    Linux:

    ./pg_restore -U <uftmデータベース管理者> -c -d hp4m <hp4m.dumpへのパス>

    復元中に発行された警告は無視してください。

  2. UFT Mobileデータベースユーザーのデータベースへのリモートアクセスを有効にします。

    1. PostgreSQL pg_hba.confファイルを開いて編集します。
    2. ホストコマンドでアクセスを有効にします。
      たとえば、UFTMデータベースユーザーがuftm_adminで、UFT Mobileサーバーの静的IPが172.30.10.2の場合、次の行を追加します。
      host postgres,hp4m uftm_admin 127.0.0.1/32,172.30.10.2/32 md5

  3. UFT Mobileサーバーからデータベースへの接続を有効にします。

    1. postgresql.confファイルを開いて編集します。
    2. listen_addressesコマンドでアクセスを有効にします。たとえば、データベースがIP 172.30.10.10でUFT Mobileから接続を受信する場合、次の行を追加できます。
      listen_addresses = '127.0.0.1,172.30.10.10'

トップに戻る

新しいサーバーをインストールする

このセクションでは、新しいサーバーをセットアップする方法について説明します。

  1. 新しいUFT Mobileサーバーを元のUFT Mobileサーバーと同じ外部データベースに接続する場合は、既存のUFT Mobileサーバーのサービスを停止して無効にします。
  2. 新しいマシンに、同じバージョンのUFT Mobileサーバーをインストールします。
  3. 外部データベースを使用している場合は、インストール時に外部PostgreSQLデータベースを使用を選択し、必要な詳細を入力してください。
  4. インストールの最後に起動するように求められた場合は、サーバーを起動しないでください。(サービスが開始された場合は、手動で停止します。
    Windows[スタート]メニューからUFT Mobileサーバーサービスの停止を選択します。
    Linux次のコマンドを実行します。
    サービスUFTM停止

  5. 次のファイルを元のサーバーのconfフォルダーから新しいサーバーのconfフォルダーにコピーします。

    デフォルトのconfフォルダーはC:\Program Files\UFT Mobile Server\server\conf

    • …/encrypted.properties
    • …/hp4mExt-audit.properties
    • …/hp4mExt-console.properties
    • …/hp4mExt.properties
    • …/hp4mExt-security.properties
    • …/osp-config/admin_users.csv
    • …/osp-config/osp-configuration.properties

    デフォルトのconfフォルダーは/opt/UFTMobile/server/conf

    • …\encrypted.properties
    • …\hp4mExt-audit.properties
    • …\hp4mExt-console.properties
    • …\hp4mExt.properties
    • …\hp4mExt-security.properties
    • …\osp-config\admin_users.csv
    • …\osp-config\osp-configuration.properties

    次のコマンドを実行して、コピーしたファイルに権限を追加します。
    sudo chmod 664 <confフォルダーへのパス>/<ファイル名>

トップに戻る

データベースを組み込みデータベースにインポートする

このセクションでは、元のUFT Mobileサーバーの組み込みデータベースからエクスポートされたデータを、新しいUFT Mobileサーバーの組み込みデータベースにインポートする方法について説明します。

  1. エクスポートしたデータベースファイルhp4m.dumpを、既存のサーバーから新規サーバーにコピーします。
  2. コマンドラインで、PostgreSQL binフォルダーに移動します。デフォルトではC:\Program Files\PostgreSQL\<postgresversion>\binです。
  3. 現在のデータベースを削除します。dropdb.exe -U <UFTM DB admin> hp4mを実行します(デフォルトのDB管理者はUFTMadmin)
  4. データベースを再作成します。createdb.exe -U <UFTM DB admin> hp4mを実行します(デフォルトのDBadminはUFTMadmin)
  5. インポート中に発行された警告を無視して、データベースをインポートします。pg_restore -U <UFTM DB admin> -c -d hp4m <path to the hp4m.dump>(デフォルトのDBadminはUFTMadmin)

  6. データベースsaユーザーのパスワードを更新します。

    サーバーインストールのserver\binフォルダー (デフォルトではC:\Program Files\UFT Mobile Server\server\bin) に移動し、UFT Mobile adminDBユーザーのパスワードでrenew_uftm_dbuser_password.batを実行します。例えば:

      renew_uftm_dbuser_password.bat <UFTM管理者DBユーザーパスワード>

  7. 必要なデータベース権限を追加します。

    1. PostgreSQLコマンドラインを開きます。psql.exe -U <UFTM DB admin> hp4mを実行します。

    2. 次のコマンドを実行します。

      GRANT USAGE ON SCHEMA public TO mc_sa;

      GRANT SELECT, INSERT, UPDATE, DELETE, TRUNCATE, REFERENCES, TRIGGER ON ALL TABLES IN SCHEMA public TO mc_sa;

      GRANT USAGE, SELECT, UPDATE ON ALL SEQUENCES IN SCHEMA public TO mc_sa;

      GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA public TO mc_sa;

      GRANT USAGE ON SCHEMA public TO mc_security_sa;

      GRANT SELECT, INSERT, UPDATE, DELETE, TRUNCATE, REFERENCES, TRIGGER ON ALL TABLES IN SCHEMA public TO mc_security_sa;

      GRANT USAGE, SELECT, UPDATE ON ALL SEQUENCES IN SCHEMA public TO mc_security_sa;

      GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA public TO mc_security_sa;

      GRANT USAGE ON SCHEMA public TO mc_audit_sa;

      GRANT SELECT, INSERT, UPDATE, DELETE, TRUNCATE, REFERENCES, TRIGGER ON ALL TABLES IN SCHEMA public TO mc_audit_sa;

      GRANT USAGE, SELECT, UPDATE ON ALL SEQUENCES IN SCHEMA public TO mc_audit_sa;

      GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA public TO mc_audit_sa;

  1. エクスポートしたデータベースファイルhp4m.dumpを、既存のサーバーから新規サーバーにコピーします。
  2. コマンドラインで、PostgreSQL binフォルダーに移動します。デフォルトでは/usr/pgsql-11/binです。
  3. 現在のデータベースを削除します。./dropdb -U <UFTM DB admin> hp4mを実行します(デフォルトのDBadminはUFTMadmin)
  4. データベースを再作成します。./createdb -U <UFTM DB admin> hp4mを実行します (デフォルトのDBadminはUFTMadmin)。
  5. インポート中に発行された警告を無視して、データベースをインポートします。./pg_restore -U <UFTM DB admin> -c -d hp4m <path to the hp4m.dump>を実行します (デフォルトのDBadminはUFTMadmin)

  6. データベースsaユーザーのパスワードを更新します

    コマンドラインで、ディレクトリをサーバーインストールのserver/binフォルダーに変更します。デフォルトでは/opt/UFTMobile/server/binで、UFT Mobile adminDBユーザーのパスワードでrenew_uftm_dbuser_password.shを実行します。例えば:

    ./Renew_uftm_dbuser_password.sh <UFTM管理者DBユーザーパスワード>

  7. 必要なデータベース権限を追加します。

    1. PostgreSQLコマンドラインを開きます。以下を実行します。
      ./psql -U <UFTM DB admin> hp4m

    2. 次のコマンドを実行します。

      GRANT USAGE ON SCHEMA public TO mc_sa;

      GRANT SELECT, INSERT, UPDATE, DELETE, TRUNCATE, REFERENCES, TRIGGER ON ALL TABLES IN SCHEMA public TO mc_sa;

      GRANT USAGE, SELECT, UPDATE ON ALL SEQUENCES IN SCHEMA public TO mc_sa;

      GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA public TO mc_sa;

      GRANT USAGE ON SCHEMA public TO mc_security_sa;

      GRANT SELECT, INSERT, UPDATE, DELETE, TRUNCATE, REFERENCES, TRIGGER ON ALL TABLES IN SCHEMA public TO mc_security_sa;

      GRANT USAGE, SELECT, UPDATE ON ALL SEQUENCES IN SCHEMA public TO mc_security_sa;

      GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA public TO mc_security_sa;

      GRANT USAGE ON SCHEMA public TO mc_audit_sa;

      GRANT SELECT, INSERT, UPDATE, DELETE, TRUNCATE, REFERENCES, TRIGGER ON ALL TABLES IN SCHEMA public TO mc_audit_sa;

      GRANT USAGE, SELECT, UPDATE ON ALL SEQUENCES IN SCHEMA public TO mc_audit_sa;

      GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA public TO mc_audit_sa;

トップに戻る

ファイルストレージシステムを移行する

このセクションでは、ファイルシステムに保存されているデータを移行する方法について説明します。

デフォルトのストレージフォルダーは次のとおりです。

Windows C:\Program Files\UFT Mobile Server\mcStorage
Linux /opt/UFTMobile/mcStorage/
  1. ファイルの保存場所を変更するには、ファイルの保存フォルダーを既存の場所から新しい場所にコピーします。場所は、新しいUFT Mobileサーバー上、またはネットワーク上の別のサーバー上でローカルにすることができます。
  2. Linuxでは、次のコマンドを実行して、フォルダーにアクセス許可を追加します。
    sudo chmod -R 774 <ストレージフォルダーへのパス>

  3. ユーザー/アカウントに、その場所へのアクセスと読み取りおよび書き込みのアクセス許可があることを確認してください。

    Windows UFT Mobileサービスが実行されているアカウント、デフォルトではローカルシステムアカウント。必要に応じて、アカウントを変更できます。別のユーザーとしてサービスを実行するを参照してください。
    Linux インストール時に選択されたUFT Mobileユーザー。

UFT Mobileファイルストレージフォルダーへのパスをデータベースに保存します。パスを更新するには:

  1. コマンドラインウィンドウで、PostgreSQL binフォルダーに移動します。

  2. PostgreSQLコマンドラインを開き、次のコマンドを実行します。

    Windows psql.exe -U <UFTM DB admin> hp4m
    Linux ./psql -U <UFTM DB admin> hp4m

    3. ファイルの保存パスを更新します。

    UPDATE public.property SET value = '<ストレージの場所>' WHERE key = 'storage.path';

    例えば:

    Windows:

    UPDATE public.property SET value = 'C:\Program Files\UFT Mobile Server\mcStorage' WHERE key = 'storage.path';

     

    UPDATE public.property SET value = '\\myFilesServer\uftm' WHERE key = 'storage.path';

    Linux:

    UPDATE public.property SET value = '/opt/UFTMobile/mcStorage/' WHERE key = 'storage.path';

トップに戻る

最終的な移行手順

このセクションでは、移行されたデータを使用して新しいサーバーをセットアップおよび検証するための最終手順について説明します。

  1. hp4mExt.propertiesのdb.hibernate.connection.usernameパラメーターが、ターゲットサーバーのUFT Mobileデータベース管理者ユーザーのユーザー名と一致することを確認します。そうでない場合は、hp4mExt.propertiesファイルのパラメーターを更新します。

  2. UFT Mobileに独自のCA証明書を使用している場合は、再インポートしてください。詳しくは、認証局 (CA) 発行のSSL証明書を使用するを参照してください。
  3. 最新のUFT Mobileパッチをサーバーにインストールします。詳しくはUFT Mobileのダウンロードをご覧ください。

  4. インストールを確認します。

    1. サービスを開始します。
      2. Windows [スタート] メニューから [Start UFT Mobile Server service] を選択します
      Linux service UFTM start
    2. UFT Mobileにログインし、データ(アプリとユーザー)が利用可能であることを確認してください。

  5. コネクターを再接続します。

    1. 各コネクターで構成の変更ウィザードを実行します。Windowsの場合は、コネクターを変更するを参照してください。Linuxの場合は、コネクターの構成を変更するを参照してください。

      新しいサーバーに元のサーバーのアドレスとポートがない場合は、UFT Mobileコンソールから新しいコネクターアクセスキーを生成し、構成の変更ウィザードで使用します。詳細については、新しいアクセスキーを生成するを参照してください。

    2. 最新のUFT Mobileパッチをコネクターにインストールします。詳しくはUFT Mobileのダウンロードをご覧ください。

  6. サーバーマシンに直接接続されているデバイスがある場合は、ラボコンソールコネクタータブを開き、エージェントをUFT Mobileサーバーに配布します。詳しくは、デバイスの表示と管理をご覧ください。

  7. Appiumスクリプトとクライアントツール (UFT One、UFT Developer、TruClient、Sprinter) でアドレスとポートを更新します。これは、新しいUFT Mobileサーバーが古いサーバーのアドレスとポートを使用しない場合にのみ必要です。

    8. トップに戻る