Importer des données RVTools

Si vous ne souhaitez pas installer et exécuter une collecte automatique des données avec un client de découverte dans votre infrastructure, vous pouvez importer manuellement vos données d'infrastructure dans Migration Center.

Commencez par utiliser RVTools pour collecter des données sur le système et les performances à partir de vos instances de machine virtuelle (VM) exécutées sur vCenter. Ensuite, importez la table générée par RVTools directement dans Migration Center pour ajouter vos éléments.

Limites

  • Pour importer des données, créez une table avec RVTools version 4.3.1 ou ultérieure. Les versions précédentes de RVTools ne sont pas compatibles.
  • Les tables générées avec l'indicateur --DBColumnNames ne sont pas compatibles.
  • Lorsque vous importez une table générée avec RVTools, Migration Center n'utilise que les données des onglets suivants :
    • tabvInfo (obligatoire pour XLSX et CSV)
    • tabvCPU (obligatoire pour XLSX, facultatif pour CSV)
    • tabvDisk (obligatoire pour XLSX, facultatif pour CSV)
    • tabvPartition (obligatoire pour XLSX, facultatif pour CSV)
    • tabvNetwork (obligatoire pour XLSX, facultatif pour CSV)
    • tabvHost (obligatoire pour XLSX, facultatif pour CSV)

Importer des données à partir de RVTools

Pour importer manuellement une table générée avec RVTools, procédez comme suit :

Console

  1. Accédez à la page Importation de données.

    Accéder à l'importation de données

  2. Cliquez sur Ajouter des données > Importer des fichiers.

  3. Dans la section Configurer l'importation de fichiers, saisissez le nom de l'importation de fichiers.

  4. Dans la liste Format de fichier, sélectionnez Excel exporté depuis RVTools ou CSV exporté depuis RVTools.

  5. Cliquez sur Sélectionner les fichiers à importer, puis sélectionnez tous les fichiers que vous souhaitez importer.

  6. Pour confirmer et commencer à importer les fichiers, cliquez sur Importer des fichiers.

  7. Si les fichiers sont correctement validés, cliquez sur Importer des données , puis sur Confirmer pour créer les éléments à partir des fichiers.

API

  1. Créez un job d'importation.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs?importJobId=IMPORT_JOB_ID

{
  "asset_source": "projects/PROJECT_ID/locations/REGION/sources/SOURCE_ID"
}

    Remplacez les éléments suivants :

    • PROJECT_ID: ID du projet dans lequel créer le job d'importation.
    • REGION : région dans laquelle créer le job d'importation.
    • IMPORT_JOB_ID : ID du nouveau job d'importation.
    • SOURCE_ID: ID d'une source existante à associer au job d'importation.

  2. Facultatif : Pour vérifier que le job d'importation a été créé correctement, récupérez-le.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

  3. Créez un fichier de données d'importation associé au job d'importation.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles?import_data_file_id=DATA_FILE_ID

{
  "format": "IMPORT_JOB_FORMAT"
}

    Remplacez les éléments suivants :

    • DATA_FILE_ID : ID du nouveau fichier de données
    • IMPORT_JOB_FORMAT : Soit IMPORT_JOB_FORMAT_RVTOOLS_CSV ou IMPORT_JOB_FORMAT_RVTOOLS_EXCEL

  4. Récupérez le fichier de données.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID

  5. Copiez l'URL du champ signedUrl de la réponse.

  6. Importez un fichier à l'URL copiée.

    PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'

    Remplacez les éléments suivants :

    • UPLOAD_FILE_PATH: chemin d'accès local au fichier importé.
    • COPIED_URL: URL signée copiée à partir des étapes précédentes.

  7. Facultatif : Répétez les étapes 3 à 6 pour créer d'autres fichiers de données dans le même job d'importation.

  8. Facultatif : Récupérez tous les fichiers de données d'un job d'importation.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles

  9. Validez le job d'importation.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate

  10. Récupérez le job d'importation et consultez le rapport de validation. Si l'état est READY, vous pouvez passer aux étapes suivantes. Sinon, vous devez corriger le job ou des fichiers spécifiques. Vous devrez peut-être supprimer des fichiers ou en importer de nouveaux.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

  11. Exécutez le job d'importation.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run

  12. Récupérez le job d'importation et consultez le rapport d'exécution. Si l'état est COMPLETED, le job a été exécuté correctement. Sinon, si le job a échoué et qu'il est dans un état final, le rapport d'exécution inclut les erreurs. Créez un job d'importation et appliquez les modifications requises.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

Si vous rencontrez des problèmes lors de l'importation de votre fichier, découvrez comment résoudre les messages d'erreur courants.

Vérifier l'importation

Une fois vos fichiers importés, Migration Center les valide pour vérifier qu'ils sont formellement corrects. Si la validation réussit, Migration Center traite ensuite les données pour créer des éléments ou mettre à jour ceux qui existent déjà. Vous pouvez vérifier l'état de vos jobs d'importation à partir de la Google Cloud console.

Pour vérifier l'état de votre job d'importation, procédez comme suit :

  1. Dans la Google Cloud console, accédez à la page Importation de données.

    Accéder à l'importation de données

  2. Dans l'onglet Importations de fichiers , cliquez sur le job d'importation que vous souhaitez examiner dans la liste des importations de fichiers.

  3. Vérifiez l'état de vos fichiers importés.

    Vos fichiers peuvent avoir l'un des états suivants :

    • Terminé : l'importation de votre fichier a réussi.
    • Prêt : votre fichier a réussi la validation et est prêt à être importé.
    • En attente : votre fichier attend qu'un autre fichier ait terminé son traitement.
    • En cours : votre fichier est en cours de traitement.
    • Validation en cours : votre fichier est en cours de validation.
    • Échec de la validation : votre fichier contient des erreurs. Corrigez-les, puis réessayez d'importer votre fichier.
    • Échec : votre fichier n'a pas pu être importé.

Consulter les détails des erreurs

Si vous rencontrez des erreurs après avoir importé vos fichiers, vous pouvez consulter le message d'erreur directement dans la Google Cloud console.

Pour examiner les erreurs de votre job d'importation, procédez comme suit :

  1. Dans la Google Cloud console, accédez à la page Importation de données.

    Accéder à l'importation de données

  2. Dans l'onglet Importations de fichiers , cliquez sur le fichier d'importation qui affiche un avertissement ou une erreur dans la liste des importations de fichiers.

    La page d'informations du fichier d'importation affiche la liste complète des erreurs.

Sur la page d'informations du fichier d'importation, vous pouvez examiner les éléments et les champs de données qui sont à l'origine des erreurs, et afficher une description de l'erreur. Les erreurs dans le job d'importation de fichiers peuvent empêcher Migration Center de créer des éléments ou de mettre à jour ceux qui existent déjà avec les nouvelles modifications. Pour corriger l'erreur, modifiez vos fichiers et créez un job d'importation de fichiers pour les importer à nouveau.

Pour en savoir plus sur les messages d'erreur possibles, consultez Résoudre les erreurs d'importation de fichiers.

Étape suivante