Migration de Standard Edition vers Standard Edition

Effectuez les étapes prérequises suivantes :

• Configurez votre nouvel hôte comme indiqué dans les sections « Préparation de votre environnement à nœud unique » ou « Préparation de votre environnement à plusieurs nœuds ».
  • Pour les paramètres d' DNS, utilisez les noms de tenant et d'unité de votre ancien environnement. Étant donné que les noms du locataire et de l'unité font partie du nom de domaine de l'unité, ces noms doivent figurer dans l'enregistrement « DNS » de l'environnement Standard Edition. Cela est également nécessaire pour se connecter à Standard Edition en utilisant l'authentification LDAP, car les configurations de LDAP sont également migrées.
• Installez le fichier stanctl binaire. Pour plus d'informations, consultez la section « Installation de l'outil en ligne de commande stanctl ».
• Assurez-vous que la version du backend d' Instana, tant sur votre ancien hébergeur que sur votre nouvel hébergeur, est identique. Si nécessaire, mettez à jour le backend :
  • Pour mettre à niveau le backend d' Instana. sur Classic Edition, consultez la section Mise à niveau de Classic Edition. Le backend d' Instana, sur l'édition Classic, doit être de la version 271 ou ultérieure.
  • Pour mettre à jour le backend d' Instana sur Standard Edition, consultez la page Mise à jour de Standard Edition.
• Pour une migration en mode air-gapped, créez un paquet air-gapped sur l'hôte bastion, transférez ce paquet vers l'hôte air-gapped, installez stanctl sur l'hôte air-gapped, puis importez le paquet sur cet hôte.

Pour migrer les données, procédez comme suit :

1. Extraire les données de configuration des unités de locataires du magasin de données Postgres. Exécutez la commande suivante sur l'ancien hôte Standard Edition :

   stanctl dump config-data

   Un dump.tar.gz fichier est créé dans le ./dump répertoire. Ce fichier contient les données de configuration des unités de locataires sous forme de requêtes SQL exécutables.

2. Facultatif : activez l'option --include-sensitive pour ignorer la boîte de ....Do you want to include sensitive information?dialogue suivante.

   Les informations sensibles comprennent le mot de passe SMTP, le mot de passe du proxy et les clés de téléchargement.

   Si l'option --include-sensitive n'est pas activée, la boîte de dialogue suivante s'affiche.

   This operation may include sensitive information (for example, SMTP credentials, proxy credentials, and download key).
   Do you want to include sensitive information?
   Note: Excluding it will require you to reconfigure SMTP and proxy settings in the destination environment during installation.

3. Effectuez l'une des étapes suivantes :
   • Pour inclure les informations sensibles dans la sauvegarde, saisissez « Oui ».
   • Pour exclure les informations sensibles de la sauvegarde, saisissez « Non ».

   Un dump-<timestamp>.tar.gz fichier est créé dans le répertoire actuel. Ce fichier contient les données de configuration des unités de locataires sous forme de requêtes SQL exécutables.

4. Effectuez l'une des opérations suivantes :

   • Migration en ligne : transférez le dump.tar.gz pack de l'ancien hébergeur vers votre nouvel hébergeur Standard Edition.
   • Migration en mode « air-gapped » : transférez le dump.tar.gz paquet de l'ancien hôte vers votre nouvel hôte « air-gapped » Standard Edition en passant par l'hôte bastion.

5. Sur votre nouvel hébergeur Standard Edition, transférez les données du dump.tar.gz fichier.

   Paramètres de migration

   Paramètre	Utilisation	Exemple
   --volume-data =<répertoire-personnalisé>	Spécifie le répertoire dans lequel sont stockées les données de configuration et d'exploitation pour les magasins de données Elasticsearch, PostgreSQL, et Kafka Par défaut :/mnt/instana/stanctl/data	--volume-data =/custom/data/path
   --volume-metrics =<répertoire-personnalisé>	Spécifie le répertoire dans lequel stocker les métriques et les données chronologiques pour les magasins de données Cassandra et BeeInstana Par défaut :/mnt/instana/stanctl/metrics	--volume-metrics =/custom/metrics/path
   --volume-analytics =<répertoire-personnalisé>	Spécifie le répertoire dans lequel stocker les données d'analyse pour le magasin de données d' ClickHouse Par défaut :/mnt/instana/stanctl/analytics	--volume-analytics =/custom/analytics/path
   --volume-objects =<répertoire-personnalisé>	Spécifie le répertoire dans lequel stocker les données de stockage d'objets, y compris les traces et les données de surveillance Par défaut :/mnt/instana/stanctl/objects	--volume-objects =/custom/objects/chemin

   • Pour un déploiement sur un seul nœud, exécutez les commandes suivantes :
     • Migration en ligne

       stanctl migrate -f </path/to/tar.gz>
        

     • Migration en environnement isolé

       stanctl migrate --air-gapped -f </path/to/tar.gz>
        

   • Pour un déploiement sur plusieurs nœuds, exécutez les commandes suivantes :
     • Migration en ligne

       stanctl migrate --file=</path/to/tar.gz> --multi-node-enable --multi-node-ips=<node0IPaddress,node1IPaddress,node2IPaddress>
        

     • Migration en environnement isolé

       stanctl migrate --air-gapped --file=</path/to/tar.gz> --multi-node-enable --multi-node-ips=<node0IPaddress,node1IPaddress,node2IPaddress>
        

6. La boîte de dialogue suivante s'affiche.

   Are you migrating from the Classic offering?

7. Si vous saisissez « Non », la configuration d'origine (multidomaine ou monodomaine) est conservée.
   Une fois la commande exécutée, l'invite suivante s'affiche :

   ? Choose installation type:
   demo <
   production
    

8. Choisissez le type d'installation qui vous convient. Pour les clusters à plusieurs nœuds, seul le type production d'installation est pris en charge.

   Une fois la migration terminée, un message de confirmation s'affiche, similaire à l'exemple suivant :

   
      ╭──────────────────────────────────────────────╮ 
      │                                              │ 
      │ Migration completed successfully!            │ 
      │ You can now install Instana Standard Edition.│ 
      │                                              │ 
      ╰──────────────────────────────────────────────╯ 
      

9. Installez Standard Edition en utilisant les données de configuration de l'unité de locataire que vous avez migrées depuis votre ancien hébergeur. Pour plus d'informations, consultez les sections « Installation d' Standard Edition dans un environnement en ligne » ou « Installation d' Standard Edition dans un environnement isolé ».

   Remarque : si vous souhaitez configurer des paramètres supplémentaires tels que des certificats personnalisés, la configuration SMTP, des proxys et d'autres paramètres, consultez la section « Configurations du backend » sur Instana. Vous pouvez utiliser les options de configuration avec la stanctl up commande.

Une fois l'installation terminée, un message similaire à l'exemple suivant s'affiche :

*****************************************************************
* Successfully installed Instana Self-Hosted Standard Edition! *
*                                                               *
* URL: https://instana.example.com                              *
* Username: admin@instana.local                                 *
*****************************************************************
 

Vous pouvez vous connecter à la nouvelle interface utilisateur d' Standard Edition en utilisant le même mot de passe de tenant que celui que vous utilisiez dans votre ancien environnement Standard Edition.

Si nécessaire, vous devrez peut-être refaire certaines configurations qui étaient en place sur l'ancien serveur. Vous pouvez procéder à la reconfiguration comme indiqué dans la liste suivante :

• Par défaut, une nouvelle instance d' Standard Edition n'est connectée à aucun agent. Pour connecter vos agents aux anciens et aux nouveaux backends, consultez la section « Configuration de plusieurs backends ».

• Après la migration, lorsque l'ancien et le nouvel environnement sont connectés à vos agents, les deux environnements Instana génèrent des alertes. Pour éviter les alertes en double, vous pouvez définir une plage horaire de maintenance sur l'une de vos instances d' Instana. Pour plus d'informations, consultez la section « Planification des fenêtres de maintenance ».

Les restrictions suivantes s'appliquent en cas de transmission simultanée vers deux serveurs de données d' Instana :

• Le capteur « Kubernetes » de l'agent « Instana » ne prend pas en charge les configurations de backend « two Instana ». Voir « Rapport vers plusieurs backends » pour la surveillance d' Kubernetes.
• Les clients EUM (surveillance des utilisateurs finaux) ne prennent pas en charge la génération de rapports vers deux serveurs de gestion de l' Instana.
• Les implémentations client sans serveur ne prennent pas en charge la transmission de rapports vers deux backends Instana.
• Les modifications de configuration effectuées après la migration ne sont pas automatiquement synchronisées entre les deux serveurs Instana.

Vous pourriez rencontrer des problèmes après la migration. Si vous ne parvenez pas à résoudre ces problèmes, contactez le service d'assistance d' IBM.