Migration de l'édition Classic vers l' Standard Edition

Vous ne pouvez pas migrer vos données de l'édition Classic vers un serveur sur lequel l' Standard Edition est déjà installé. Vous devez utiliser un nouvel hébergeur.

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 Classic Edition, doit être de la version 271 ou ultérieure.
  • Pour mettre à niveau le backend d' Instana sur Standard Edition, consultez la page « Mise à niveau » à l'adresse Standard Edition.
• Pour une migration en mode air-gapped, créez un paquet air-gapped sur l'hôte bastion, transférez le paquet vers l'hôte air-gapped, installez stanctl sur l'hôte air-gapped, puis importez le paquet sur l'hôte air-gapped.

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'hôte Classic Edition :

     instana 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. 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.

3. 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>
        

   La boîte de dialogue suivante s'affiche.

   Are you migrating from the Classic offering?

4. Tapez « Oui ». Le domaine unique est conservé pour tous les services.
   Une fois la commande exécutée, l'invite suivante s'affiche :

   ? Choose installation type:
   demo <
   production
    

5. 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.│ 
      │                                              │ 
      ╰──────────────────────────────────────────────╯ 
      

6. 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, les 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 utilisé dans votre ancien environnement Classic 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 de maintenance sur l'une de vos instances d' Instana. Pour plus d'informations, consultez la section « Planification des fenêtres de maintenance ».

• Les indicateurs de fonctionnalité qui étaient activés dans votre ancien environnement ne sont pas transférés. Vous devez réactiver manuellement les indicateurs de fonctionnalité dans votre nouvel environnement. Pour plus d'informations, consultez la section « Fonctionnalités optionnelles ».

• Lorsque vous effectuez la migration de Classic Edition vers Standard Edition, tout le trafic Ingress, y compris celui lié à l'agent, à l'interface utilisateur et à API, sera acheminé via un seul domaine (à savoir le domaine de base). Cette fonctionnalité est activée par défaut. Pour annuler ce comportement, exécutez la commande suivante une fois la migration terminée :

  stanctl backend apply \
  --core-use-tu-url-path=false \
  --core-acceptors-agent-host=<desired-agent-acceptor-domain> \
  --core-acceptors-agent-port=<desired-agent-acceptor-port>
   

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.