Migration de Custom Edition vers l' Standard Edition

Vous pouvez migrer Custom Edition vers Standard Edition. Les données que vous pouvez migrer comprennent les données de configuration des unités locatives. Les données de configuration de l'unité locataire comprennent les paramètres utilisateur, les tableaux de bord, les événements, les alertes, les perspectives d'application, les sites Web EUM et les applications mobiles, ainsi que d'autres sentinelles d' data.Focus

Les éléments suivants ont été transférés :

  • Email et les paramètres SMTP :
    • Serveur SMTP (hôte, port)
    • Adresse électronique de l'expéditeur
    • SSL / Paramètres d' TLS
    • Identifiants SMTP (si des données sensibles sont incluses)
  • Paramètres du proxy;
    • Serveur proxy (hôte, port)
    • Liste des serveurs sans proxy
    • Identifiants de proxy (si des données sensibles sont incluses)
  • Configurations des récepteurs :
    • Agent récepteur (hôte, port)
    • Accepteur EUM (hôte, port)
    • Accepteur de matériaux synthétiques (hôte, port)
    • Acceptor sans serveur (hôte, port)
    • OpAmp destinataire (hôte, port)
    • OTLP HTTP destinataire (hôte, port)
    • OTLP Récepteur GRPC (hôte, port)
  • Indicateurs de fonctionnalités : indicateurs correspondant aux fonctionnalités activées ou désactivées, avec leurs valeurs
  • Configuration du domaine : paramétrage du chemin d'accès au domaine de base et à l' URL e du locataire ou de l'unité
Remarque : les données analytiques et métriques provenant de vos agents d' Instana s ne peuvent pas être migrées.
Remarque : Important Vous pouvez utiliser la même licence que celle de votre édition personnalisée pour migrer vers le format Standard Edition.

Prérequis

Vérifiez que les conditions pré-requises suivantes sont remplies:

  • Configurez votre nouvel hôte comme indiqué dans les sections « Préparation de votre environnement à nœud unique », « Préparation d'un déploiement à trois nœuds » ou « Configuration système requise pour un déploiement à cinq nœuds ».
    • Pour les paramètres d' DNS, utilisez les noms de locataire et d'unité de votre ancien environnement. Étant donné que les noms des locataires et des unités font partie du nom de domaine de l'unité, ces noms doivent être présents dans l'enregistrement DNS de Standard Edition l'environnement. Cela est également nécessaire pour se connecter à Standard Edition à l'aide de l'authentification LDAP, car les configurations LDAP sont également migrées.
  • Installez le stanctl binaire. Pour plus d'informations, consultez la section Installation de l'outil de ligne de commande stanctl.
  • Assurez-vous que la version backend d' Instana de votre ancien hébergeur et de votre nouvel hébergeur est la même.

Procédure

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

  1. Sur votre hôte Custom Edition, extrayez les données de configuration des unités locatives du magasin de données d' Postgres.

    kubectl-instana dump config-data --unit <unitname> --unit-namespace <namespace>
     

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

    Tableau 1. Paramètres d'extraction
    Paramètre Description
    --unit-namespace Espace de noms de l'unité (par défaut : instana-units)
    --postgres-namespace Espace de noms (par défaut : instana-postgres)
    --unit Nom de l'unité (par défaut : unit0-tenant0 )
    --include-sensitive Activez cette option pour inclure le mot de passe SMTP, le mot de passe du proxy et les clés de téléchargement dans la configuration de la sauvegarde
    --help Voir les options disponibles
  2. Sur votre nouvel hôte Standard Edition, effectuez l'une des opérations suivantes :

    • Migration en ligne : transférez le package dump.tar.gz de l'ancien hébergeur vers votre nouvel hébergeur pour effectuer la migration.
    • Migration avec isolation physique : transférez le dump.tar.gz paquet de l'ancien hôte vers votre nouvel hôte isolé physiquement à l'aide de l'hôte bastion.
  3. Effectuez l'une des étapes suivantes :

    Tableau 2. 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 à nœud unique, exécutez les commandes suivantes :
      • Migration en ligne
        stanctl migrate -f </path/to/tar.gz>
         
      • Migration avec isolation physique
        stanctl migrate --air-gapped -f </path/to/tar.gz>
         
    • Pour un déploiement multi-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 avec isolation physique
        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. Entrez « Non ». La configuration du domaine est conservée.

    Une fois la commande exécutée, la boîte de dialogue suivante s'affiche :

    ? Choose installation type:
    demo <
    production
     
  5. Choisissez votre type d'installation préféré. Pour les clusters multi-nœuds, seul le type production d'installation est pris en charge.

  6. Installez Standard Edition avec les données de configuration de l'unité locataire que vous avez migrées depuis votre ancien hôte. Pour plus d'informations, consultez la section « Installation d' Standard Edition » dans un environnement en ligne ou « Installation d' Standard Edition » dans un environnement isolé.

Configurations post-migration

Si nécessaire, vous devrez peut-être refaire certaines configurations qui se trouvaient sur l'ancien hôte. Vous pouvez reconfigurer comme suggéré dans la liste suivante :

  • Par défaut, la nouvelle Standard Edition instance n'est connectée à aucun agent. Effectuez l'une des étapes suivantes :
    • Connectez vos agents aux anciens et nouveaux backends, voir Configuration de plusieurs backends.
    • Connectez vos agents au nouveau backend, mettez à jour les enregistrements existants DNS pour qu'ils pointent vers la nouvelle instance Standard Edition. Les agents commencent automatiquement à envoyer leurs rapports au nouveau backend.
  • Après la migration, lorsque les anciens et nouveaux environnements sont connectés à vos agents, les deux environnements d' Instana s génèrent des alertes. Pour éviter les alertes en double, vous pouvez définir une fenêtre de maintenance sur l'une de vos instances d' Instana. Pour plus d'informations, consultez la section « Planification des fenêtres de maintenance ». /events_alerts/maintenance-window.dita