NuGenesis SDMS 用の EmpScan.exe ユーティリティをインストールして実行する方法 - WKB97938

目的または目標

NuGenesis SDMS 用の EmpScan.exe ユーティリティをインストールして実行する。

このツール/ユーティリティは、CRI-1719 への対応として Waters によって作成されており、NuGenesis SDMS データベースでツール/ユーティリティをインストールして実行する機能を提供した。ツール/ユーティリティは、NuGenesis SDMS データベースをスキャンして、不完全なアーカイブされた Empower プロジェクトを見つけ、正常にアーカイブされなかったプロジェクトを特定する。

環境

• NuGenesis 9 SDMS
• NuGenesis 8 SDMS

手順

前提条件

• SDMS .NET SDK：SDK ランタイムがマシンにインストールされている必要があります。
• Oracle クライアント：SDMS Administrator がインストールされているマシンにユーティリティをインストールすることを推奨します。理想的には、ユーティリティは PM フォルダーに配置する必要があります。

1. EmpScan.exe ファイルを SDMS Administrator プログラムと同じフォルダーにコピーします。
   • NuGenesis 9 の場合：ドライブ:\Program Files (x86)\Waters\NGSDMS\PM
   • NuGenesis 8 の場合：ドライブ:\Program Files (x86)\NuGenesis 8.0\PM

2. （NuGenesis 8 の場合）EmpScan.exe を実行する前に NG80tkfu.exe を実行します。コマンドプロンプトを管理者として実行し、コマンドプロンプトで NG80tkfu.exe の場所に移動し、次のステートメントを実行します：NG80tkfu.exe on misctk <Return>
   
   （NuGenesis 9 の場合）EmpScan.exe を実行する前に NGtkfu.exe を実行します。コマンドプロンプトを管理者として実行し、コマンドプロンプトで NGtkfu.exe の場所に移動し、次のステートメントを実行します：NGtkfu.exe on misctk <Return>

3. EmpScan.exe を管理者として実行します。
4. ツールで、リストからサーバー名を選択し、ngprojmgr のユーザー名とパスワードを入力します。
5. すべての SDMS プロジェクトをスキャンするには、［Project］（プロジェクト）リストで［ALL SDMS Projects］（すべての SDMS プロジェクト）を選択します。そうでない場合は、プロジェクトとビューを選択します。
   • 注：選択したビューには、少なくとも使用可能な ID 列が必要です。そうでないと、ツールはビューを使用できません。［Data Name］（データ名）および［Archive (VPR) Product］（プロダクトのアーカイブ (VPR)）列が使用可能な場合、ツールはこれらの列を使用しますが、必須ではありません。
6. ［Begin］（開始）ボタンをクリックしてスキャンを開始します。［ALL SDMS Projects］（すべての SDMS プロジェクト）が選択されている場合、ツールは、ユーザーアカウントが使用できる選択したサーバーで、（各プロジェクトで DefaultView を使用して）すべてのプロジェクトを検索します。そうしないと、ツールはプロジェクトおよびビューへのアクセス権、およびビューがツールでの使用に適しているかどうかを確認します。ID 列が使用できない場合、EmpScan はエラーメッセージを表示し、プロジェクトをスキャンしません。［Data Name］（データ名）および/または［Archive (VPR) Product］（プロダクトのアーカイブ (VPR)）列が使用できない場合、EmpScan は列が欠落しているユーザーに対して警告し、スキャンを続行するかを尋ねます。
   • ngprojmgr が使用されていない場合に必要な SDMS 権限：
     • 各ファイルデータプロジェクトを開く権限
     • 各プロジェクトの DefaultView へのアクセス権
     • 各プロジェクトの「Any Location」（任意の場所）復元場所へのアクセス権
7. EmpScan.exe は、画面上のウィンドウと\PM フォルダーのログファイル status.txt にその操作を記録します。NuGenesis エラーコード (NGxxxxx) が発生するエラーは、ユーティリティを一時停止します。そのため、プログラムを観察し、これらのメッセージが表示されたら［OK］をクリックして、DB 記録の確認を続行できるようにします。

8. ユーティリティは、3 つのログ（Process.log、Status.txt、および Bad.log）を生成できます。これらのログは最初存在せず、ユーティリティが必要に応じて作成します。Process.log および Status.txt は EmpScan.exe と同じフォルダーにあります。ユーティリティは、必要に応じて「Bad」サブフォルダーを作成します。「bad」（不良）基準を満たす（以下を参照）SDMS の Empower プロジェクトのバックアップは、\Bad サブフォルダーの bad.log に含まれます。

追加情報

EmpScan.exe は標準の NuGenesis 製品インストールの一部ではありません。Empower からの不完全なプロジェクトエクスポートを、SDMS でアーカイブする場合をチェックするために開発されたサポートツールです。このユーティリティのコピーが必要な場合は、Waters テクニカルサポートにお問い合わせください。

このツールは、ベンダー/製品が「Waters Corp.」および「Empower-2 Projects」または「Empower-3 Projects」であるファイル記録を探します。記録で以下のチェックが実行されます。

1. アーカイブグループに backup.log という名前のファイルを確認し、見つからない場合はエラーを記録します。
2. backup.log ファイルをディスク上の一時フォルダーにダウンロードし、ファイル内で「Export completed successfully without warnings」（エクスポートが警告なしに正常に完了しました）というテキストがないかを確認します。そのテキストが見つかった場合、ツールは「backup.log shows completed export」（backup.log は完了したエクスポートを表示します）を報告します。そのテキストが見つからない場合、SDMS 記録の NGID が不完全なエクスポートを実行していることが記録され、backup.log が \Bad サブフォルダーにダウンロードされます。backup.log ファイルの名前は、関連する SDMS 記録のタイムスタンプ、プロジェクト名、NGID で変更されます。
   
   トラブルシューティング
   1. Empower プロジェクトバックアップログの完全性チェックユーティリティ画面のログエリアに以下のメッセージが表示された場合：
      「This method is reserved for future use」（このメソッドは将来の使用のために予約されています）：
      これは、適切な NG80tkfu/NGtkfu.exe ファイルが実行されなかったことを示します。
      スキャンを停止し、作成されたログファイルを削除し、ステップ 2 からの手順を繰り返します。
      ［Abort］（中断）をクリックすると、プロセスはすぐに停止します。復元作業が進行中の場合は、その後に発生します。
   2. Empower プロジェクトが処理される順序は必ずしも連続しているとは限りません。ステータス画面に表示される NGID が 0001 に向かってカウントダウンしているように見えることがありますが、これに到達すると、プロセスは他の記録の処理を続行することがあります。