データのエクスポート

移行ユーティリティーをセットアップした後、AppScan Source からデータをエクスポートします。

データのエクスポートは、次の 2 つの部分で行います。
  • フィルター、ユーザー・データ、カスタム・ルール、スキャン構成。
    注: ユーザー・データは参照用にのみエクスポートされます。
  • 評価
  1. AppScan Source からデフォルト以外の場所 (つまり、C:\temp\Ounceまたは /tmp/ounce ではない) にデータをエクスポートする場合は、その場所を作成し、デフォルト以外の場所を指す環境変数 transfer_staging_dir を定義します。
    • Windows:
      set transfer_staging_dir="<export data location>"
    • Linux:
      export transfer_staging_dir="<export data location>"
      注: 詳しくは、以下の「データ・エクスポートの場所」を参照してください。
  2. コマンド行から、移行ユーティリティーの場所に移動します。
  3. フィルター、ユーザー・データ、カスタム・ルール、およびスキャン構成をエクスポートするには、適切なパラメーターを指定してユーティリティーを実行します。
    • 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>
          ]
  4. 評価パラメーターを指定してユーティリティーを実行して、評価のみをエクスポートします。
    • 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

移行ユーティリティーのエクスポート・パラメーター

パラメータ 「デフォルト」 必須 ?
-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
  • 2=oracle
1 いいえ。クライアントは、指定されていない場合は SolidDB と見なされます。
-Dsource-tns-admin-path tnsnames.ora のファイル・パス デフォルトなし Oracle からのエクスポートの場合のみ必要です。1
--asmt [--start-date <dd-MMM-yyyy> [--end-date <dd-MMM-yyyy>]] パラメーターの形式で指定された日付範囲で、評価のみをエクスポートします。 日付範囲を指定しない場合、すべての評価がエクスポートされます。 評価のみをエクスポートする場合は必須です。2
  1. 例えば、Oracle からのエクスポートは次のようになります。
    C:\Program Files(x86)\IBM\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
  2. 例えば、SolidDB からのエクスポートは、SolidDB が -Dsource-db-client のデフォルトで次のようになります。
    C:\Program Files(x86)\IBM\AppScanSource\migration_util_win>DbManager.exe --export --asmt
    または、日付を指定します。
    C:\Program Files(x86)\IBM\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 Source データ・ディレクトリーにある dbmanager_exceptions.log ファイルを参照してください。
  • Windows:
    C:\ProgramData\IBM\AppScanSource\logs\dbmanager_exceptions.log
  • Linux:
    var/opt/ibm/appscansource/logs/dbmanager_exceptions.log