データのエクスポート
移行ユーティリティーをセットアップした後、AppScan® ソース からデータをエクスポートします。
データのエクスポートは、次の 2 つの部分で行います。
- フィルター、ユーザー・データ、カスタム・ルール、スキャン構成。注: ユーザー・データは参照用にのみエクスポートされます。
- 評価
- AppScan® ソース からデフォルト以外の場所 (つまり、C:\temp\Ounce または /tmp/ounce ではない) にデータをエクスポートする場合は、その場所を作成し、デフォルト以外の場所を指す環境変数
transfer_staging_dir
を定義します。- Windows:
set transfer_staging_dir="<export data location>"
- Linux:
export transfer_staging_dir="<export data location>"
注: 詳しくは、以下の「データ・エクスポートの場所」を参照してください。
- Windows:
- コマンド行から、移行ユーティリティーの場所に移動します。
- フィルター、ユーザー・データ、カスタム・ルール、およびスキャン構成をエクスポートするには、適切なパラメーターを指定してユーティリティーを実行します。
- Windows:
DBManager.exe --export [ -Dsource-db-user=<username> -Dsource-db-pass=<password> -Dsource-db-host=<host IP> -Dsource-db-connection-info=<tcp <IP> <PORT>> -Dsource-db-connection-string=<LocalNetServiceName> -Dsource-db-client=<1-solidDB, 2-Oracle> -Dsource-tns-admin-path=<<path>\tnsnames.ora> ]
- Linux:
./dbmanager --export [ -Dsource-db-user <username> -Dsource-db-pass=<password> -Dsource-db-host=<host IP> -Dsource-db-connection-info=<tcp <IP> <PORT>> -Dsource-db-connection-string=<LocalNetServiceName> -Dsource-db-client=<1-solidDB, 2-Oracle> -Dsource-tns-admin-path=<<path>/tnsnames.ora> ]
- Windows:
- 評価パラメーターを指定してユーティリティーを実行して、評価のみをエクスポートします。
- Windows:
DBManager.exe --export --asmt [ --start-date <dd-MMM-yyyy > [--end-date <dd-MMM-yyyy >] ] [ -Dsource-db-user=<username> -Dsource-db-pass=<password> -Dsource-db-host=<host IP> -Dsource-db-connection-info=<tcp <IP> <PORT>> -Dsource-db-connection-string=<LocalNetServiceName> -Dsource-db-client=<1-solidDB, 2-Oracle> -Dsource-tns-admin-path=<<path>\tnsnames.ora> ]
- Linux:
./dbmanager --export --asmt [ --start-date <dd-MMM-yyyy > [--end-date <dd-MMM-yyyy >] ] [ -Dsource-db-user=<username> -Dsource-db-pass=<password> -Dsource-db-host<host IP> -Dsource-db-connection-info=<tcp <IP> <PORT>> -Dsource-db-connection-string=<LocalNetServiceName> -Dsource-db-client=<1-solidDB, 2-Oracle> -Dsource-tns-admin-path=<<path>/tnsnames.ora> ]
注: この--asmt
オプションが使用されている場合、移行ユーティリティーはフィルター、ユーザー・データ、カスタム・ルール、またはスキャン構成をエクスポートしません。これは、評価のみをエクスポートする場合に使用します。注: エクスポート・コマンドの使用に関するヘルプが必要な場合は、以下を実行します。- Windows:
DBManager.exe --export --help
- Linux:
./dbmanager --export --help
- Windows:
移行ユーティリティーのエクスポート・パラメーター
パラメータ | 値 | 「デフォルト」 | 必須 ? |
---|---|---|---|
-Dsource-db-user |
データのエクスポートに使用するユーザー・アカウント。 | ounce | いいえ |
-Dsource-db-pass |
指定されたユーザーに関連付けられたパスワード。 | ounce | いいえ |
-Dsource-db-host |
データのエクスポートに使用するデータベースのホスト・ロケーション。 | localhost | いいえ |
-Dsource-db-connection-info |
ホストがデータベースに接続される方法。 | tcp localhost 2315 | いいえ |
-Dsource-db-connection-string |
ローカル・ネット・サービス名 | デフォルトなし | Oracle からのエクスポートの場合のみ必要です。1 |
-Dsource-db-client |
データのエクスポートを行うデータベースのタイプ。
|
1 | いいえ。クライアントは、指定されていない場合は SolidDB と見なされます。 |
-Dsource-tns-admin-path |
tnsnames.ora のファイル・パス | デフォルトなし | Oracle からのエクスポートの場合のみ必要です。1 |
--asmt [--start-date <dd-MMM-yyyy> [--end-date <dd-MMM-yyyy>]] |
パラメーターの形式で指定された日付範囲で、評価のみをエクスポートします。 | 日付範囲を指定しない場合、すべての評価がエクスポートされます。 | 評価のみをエクスポートする場合は必須です。2 |
- 例えば、Oracle からのエクスポートは次のようになります。
C:\Program Files\HCL\AppScanSource\migration_util_win>DbManager.exe --export --asmt -Dsource-db-client=2 -Dsource-db-connection-string=10.111.11.11:1521/appscan -Dsource-tns-admin-path=C:\app\Oracle\product\19.0.0\client_1\network\admin\tnsnames.ora
- 例えば、SolidDB からのエクスポートは、SolidDB が
-Dsource-db-client
のデフォルトで次のようになります。C:\Program Files\HCL\AppScanSource\migration_util_win>DbManager.exe --export --asmt
または、日付を指定します。C:\Program Files\HCL\AppScanSource\migration_util_win>DbManager.exe --export -–asmt -–start-date 01-Jan-2020 -–End-date 01-Jan-2021
データ・エクスポートの場所
エクスポートされたデータは、上記のステップ 1 で別のディレクトリーを作成し、その場所を定義しない限り、C:\temp\Ounce ディレクトリー (Linux の /tmp/ounce) に配置されます。
- エクスポートされたフィルター、ユーザー・データ、カスタム・ルール、およびスキャン構成データは、以下の場所に配置されます。
- フィルター: C:\temp\Ounce\Filters
- スキャン構成: C:\temp\Ounce\ScanConfig
- カスタム・ルール: C:\temp\Ounce\vdb
- ユーザー・データ: C:\temp\Ounce\Users 注: ユーザー・データは参照用にのみエクスポートされます。この移行ユーティリティーを使用する場合、他のデータとともに AppScan® Enterprise にインポートされません。
-
エクスポートされた評価コンテンツは、C:\temp\Ounce\Assessments に配置されます。
エクスポートのトラブルシューティング
データのエクスポート中に問題が発生した場合は、次の AppScan® ソース データ・ディレクトリーにある dbmanager_exceptions.log ファイルを参照してください。
- Windows:
C:\ProgramData\HCL\AppScanSource\logs\dbmanager_exceptions.log
- Linux:
var/opt/hcl/appscansource/logs/dbmanager_exceptions.log