Digital Labサーバーの移行

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

概要

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

ファイルシステム

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

データベース

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

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

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

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

トップに戻る

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

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

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

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

    pg_dump -Fc -b -U <dl database admin> hp4m > <path to dump file>

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

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

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

    ./pg_dump -Fc -b -U <dl admin user> hp4m> <path for dump file>

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

トップに戻る

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

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

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

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

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

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

    createdb.exe -U <database admin> hp4m

    Linux:

    ./createdb -U <database admin> hp4m

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

    Windows:

    pg_restore -U <dl database admin> -c -d hp4m <path to the hp4m.dump>

    Linux:

    ./pg_restore -U <dl database admin> -c -d hp4m <path to the hp4m.dump>

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

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

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

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

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

トップに戻る

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

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

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

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

    デフォルトのconfフォルダーは、C:\Program Files\UFT Digital Lab 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/UFTDigitalLab/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フォルダーへのパス>/<ファイル名>

トップに戻る

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

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

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

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

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

      renew_dl_dbuser_password.bat <DL管理者DBユーザーパスワード>

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

    1. PostgreSQLコマンドラインを開きます。psql.exe -U <DL 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 <DL DB admin> hp4mを実行します (デフォルトのDBadminはDLadmin)。
  4. データベースを再作成します。./createdb -U <DL DB admin> hp4mを実行します (デフォルトのDBadminはDLadmin)。
  5. インポート中に発行された警告を無視して、データベースをインポートします。./pg_restore -U <DL DB管理者> -c -d hp4m <path to the hp4m.dump>を実行します (デフォルトのDB管理者はDLadmin)。

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

    コマンドラインで、ディレクトリをサーバーインストールのserver/binフォルダーに変更します。デフォルトでは/opt/UFTDigitalLab/server/binで、Digital Lab admin DBユーザーのパスワードでrenew_dl_dbuser_password.shを実行します。例: 

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

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

    1. PostgreSQLコマンドラインを開きます。以下を実行します。
      ./psql -U <DL 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 Digital Lab Server\mcStorage
Linux /opt/UFTDigitalLab/mcStorage/
  1. ファイルの保存場所を変更するには、ファイルの保存フォルダーを既存の場所から新しい場所にコピーします。場所は、新しいDigital Labサーバー上、またはネットワーク上の別のサーバー上でローカルにすることができます。
  2. Linuxでは、次のコマンドを実行して、フォルダーにアクセス許可を追加します。
    sudo chmod -R 774 <ストレージフォルダーへのパス>

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

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

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

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

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

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

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

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

    例:

    Windows:

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

     

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

    Linux:

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

トップに戻る

最終的な移行手順

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

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

  2. Digital Labに独自のCA証明書を使用している場合は、再インポートしてください。詳しくは、認証局発行のSSL証明書を使用するを参照してください。
  3. 最新のDigital Labパッチをサーバーにインストールします。詳細については、ソフトウェアのライセンスとダウンロードを参照してください。

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

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

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

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

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

    2. 最新のDigital Labパッチをコネクターにインストールします。詳細については、ソフトウェアのライセンスとダウンロードを参照してください。

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

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

    8. トップに戻る