Importer des données RVTools

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

Tout d'abord, utilisez RVTools pour collecter des données système et des données de performances à partir de vos instances de machine virtuelle (VM) exécutées sur vCenter. Importez ensuite la table générée par RVTools directement dans Migration Center pour ajouter vos composants.

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 acceptées.
  • Lorsque vous importez un tableau généré avec RVTools, le centre de migration n'utilise que les données des onglets suivants :
    • tabvInfo (obligatoire)
    • tabvCPU (facultatif)
    • tabvDisk (facultatif)
    • tabvPartition (facultatif)
    • tabvNetwork (facultatif)
    • tabvHost (facultatif)

Importer des données depuis 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 validés correctement, cliquez sur Importer des données, puis sur Confirmer pour créer les composants à partir des fichiers.

API

  1. Créez une tâche 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 la tâche d'importation.
    • REGION: région dans laquelle créer la tâche d'importation.
    • IMPORT_JOB_ID: ID de la nouvelle tâche d'importation.
    • SOURCE_ID: ID d'une source existante à associer à la tâche d'importation.
  2. Facultatif: Pour vérifier que la tâche d'importation a été créée correctement, récupérez-la.

    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 joint à la tâche 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 : IMPORT_JOB_FORMAT_RVTOOLS_CSV ou IMPORT_JOB_FORMAT_RVTOOLS_EXCEL
  4. Obtenez 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 du fichier importé.
    • COPIED_URL: URL signée copiée à partir des étapes de prévisualisation.
  7. Facultatif: Répétez les étapes 3 à 6 pour créer d'autres fichiers de données dans la même tâche d'importation.

  8. Facultatif: Obtenez tous les fichiers de données d'une tâche d'importation.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
    
  9. Validez la tâche d'importation.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
    
  10. Obtenez la tâche d'importation et affichez le rapport de validation. Si l'état est READY, vous pouvez passer aux étapes suivantes. Dans le cas contraire, vous devez corriger la tâche ou des fichiers spécifiques. Pour ce faire, 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 la tâche d'importation.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
    
  12. Obtenez la tâche d'importation et affichez le rapport d'exécution. Si l'état est COMPLETED, la tâche a bien été exécutée. Sinon, si la tâche a échoué et qu'elle est dans un état terminal, le rapport d'exécution inclut les erreurs. Créez une tâche 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 problèmes courants liés aux messages d'erreur.

Examiner l'importation

Une fois vos fichiers importés, le centre de migration les valide pour vérifier qu'ils sont formellement corrects. Si la validation réussit, Migration Center traite les données pour créer des éléments ou en mettre à jour des existants. Vous pouvez vérifier l'état de vos tâches d'importation depuis la console Google Cloud.

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

  1. Accédez à la page Importation de données, puis cliquez sur Importations de fichiers.
  2. Dans la liste des importations de fichiers, sélectionnez l'importation que vous souhaitez examiner.
  3. Sur la page d'importation de fichiers, sous Progression de l'importation des données, vérifiez l'état de vos fichiers importés.

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

Liste des états

  • Terminé : L'importation de votre fichier a bien été effectuée.
  • Prêt. Votre fichier a été validé et est prêt à être importé.
  • En attente : Votre fichier attend la fin du traitement d'un autre fichier.
  • En cours : Votre fichier est en cours de traitement.
  • Validation Votre fichier est en cours de validation.
  • Échec de la validation Votre fichier contient des erreurs. Corrigez les erreurs, puis réessayez d'importer votre fichier.
  • Échec. Impossible d'importer votre fichier.

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 console Google Cloud.

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

  1. Accédez à la page Importation de données, puis cliquez sur Importations de fichiers.
  2. Cliquez sur le fichier d'importation qui affiche un avertissement ou une erreur. La page des détails du fichier d'importation affiche la liste complète des erreurs.

Sur la page d'informations du fichier d'importation, vous pouvez consulter les éléments et les champs de données à l'origine des erreurs, ainsi qu'une description de l'erreur. Des erreurs dans la tâche d'importation de fichiers peuvent empêcher Migration Center de créer des composants ou de mettre à jour les composants existants avec les nouvelles modifications. Pour corriger l'erreur, modifiez vos fichiers et créez une nouvelle tâche d'importation de fichiers pour les importer à nouveau.

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

Étape suivante