Exportation de données

Après avoir configuré l'utilitaire de migration, exportez les données depuis AppScan® Source.

L'exportation des données se produit en deux parties :
  • Filtres, données utilisateur, règles personnalisées, configurations d'examen.
    Remarque : Les données utilisateur sont exportées pour référence uniquement.
  • Evaluations
  1. Si vous souhaitez exporter des données de AppScan® Source vers un emplacement autre que celui par défaut (c'est-à-dire, pas C:\temp\Ounce ou /tmp/ounce), créez cet emplacement, puis définissez la variable d'environnement transfer_staging_dir de façon à pointer vers l'emplacement qui n'est pas celui par défaut.
    • Windows :
      set transfer_staging_dir="<export data location>"
    • Linux :
      export transfer_staging_dir="<export data location>"
      Remarque : Pour plus d'informations, voir "Exporter les emplacements de données" ci-dessous.
  2. Depuis la ligne de commande, accédez à l'emplacement de l'utilitaire de migration.
  3. Exécutez l'utilitaire avec les paramètres appropriés pour exporter des filtres, des données utilisateur, des règles personnalisées et des configurations d'examen :
    • 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. Exécutez l'utilitaire avec le paramètre d'évaluations pour exporter des évaluations uniquement :
    • 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>
    ]
    Remarque : Lorsque l'option --asmt est utilisée, l'utilitaire de migration n'exporte pas de filtres, de données utilisateur, de règles personnalisées ou de configuration des examens. Il s'agit uniquement d'exporter des évaluations.
    Remarque : Pour obtenir de l'aide sur l'utilisation des commandes d'exportation, exécutez :
    • Windows :
      DBManager.exe --export --help
    • Linux :
      ./dbmanager --export --help

Paramètres d'exportation de l'utilitaire de migration

Paramètre Valeur Par défaut Requis ?
-Dsource-db-user Compte utilisateur à partir duquel les données sont exportées. ounce Non
-Dsource-db-pass Mot de passe associé à l'utilisateur spécifié. ounce Non
-Dsource-db-host Emplacement hôte de la base de données à partir de laquelle les données sont exportées. localhost Non
-Dsource-db-connection-info La manière dont l'hôte est connecté à la base de données. tcp localhost 2315 Non
-Dsource-db-connection-string Nom du service réseau local Pas de valeur par défaut Requis lors de l'exportation à partir d'Oracle uniquement.1
-Dsource-db-client Type de base de données à partir de laquelle les données sont exportées :
  • 1=solidDB
  • 2=oracle
 1 Non. Le client est supposé être SolidDB s'il n'est pas spécifié.
-Dsource-tns-admin-path Chemin du fichier de tnsnames.ora Pas de valeur par défaut Requis lors de l'exportation à partir d'Oracle uniquement.1
--asmt [--start-date <dd-MMM-yyyy> [--end-date <dd-MMM-yyyy>]] Exporter des évaluations uniquement, avec une plage de dates spécifiée au format dans le paramètre Si aucune plage de dates n'est spécifiée, toutes les évaluations sont exportées. Requis lors de l'exportation d'évaluations uniquement.2
  1. Par exemple, l'exportation à partir d'Oracle peut ressembler à ceci :
    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
  2. Par exemple, l'exportation à partir de SolidDB peut ressembler à ceci, car SolidDB est le -Dsource-db-client par défaut :
    C:\Program Files\HCL\AppScanSource\migration_util_win>DbManager.exe --export --asmt
    ou spécification des dates :
    C:\Program Files\HCL\AppScanSource\migration_util_win>DbManager.exe --export -–asmt -–start-date 01-Jan-2020 -–End-date 01-Jan-2021

Exporter les emplacements de données

Les données exportées sont placées dans le répertoire C:\temp\Ounce (/tmp/ounce sous Linux), sauf si vous avez créé un répertoire différent et défini son emplacement à l'étape 1 ci-dessus :

  • Les filtres exportés, les données utilisateur, les règles personnalisées et les données de configuration d'examen sont placés aux emplacements suivants :
    • Filtres : C:\temp\Ounce\Filters
    • Configuration des examens : C:\temp\Ounce\ScanConfig
    • Règles personnalisées : C:\temp\Ounce\vdb
    • Données utilisateur: C:\temp\Ounce\Users
      Remarque : Les données utilisateur sont exportées pour référence uniquement. Elles ne sont pas importées dans AppScan® Enterprise avec d'autres données lors de l'utilisation de cet utilitaire de migration.

  • Le contenu de l'évaluation exportée est placé dans C:\temp\Ounce\Assessments.

Identification et traitement des problèmes d'exportation

Si vous avez des problèmes lors de l'exportation des données, reportez-vous au fichier dbmanager_exceptions.log dans le répertoire de travail AppScan® Source :
  • Windows :
    C:\ProgramData\HCL\AppScanSource\logs\dbmanager_exceptions.log
  • Linux :
    var/opt/hcl/appscansource/logs/dbmanager_exceptions.log