Mise à niveau de l'édition Classic auto-hébergée ( Docker )

Pour mettre à niveau l'édition Classic, procédez comme suit :

Remarque : la politique de mise à jour prévoit qu'il est possible de sauter au maximum une version; en d'autres termes, il est possible de passer de la version 245-x à la version 247-x ou à la version 249-x, mais pas au-delà. Si la règle ne vous permet pas d'effectuer la mise à niveau requise en une seule fois, vous devez effectuer plusieurs étapes de mise à niveau.
Remarque : pour les versions antérieures, jusqu'à la version 279 du backend, de stanctl 1.6.0 ou d'Operator 1.0.0, vous devez mettre à niveau le backend par paliers ne dépassant pas deux versions. Par exemple, vous ne pouvez passer à la version 279 qu'à partir de la version 275 ou d'une version ultérieure. Pour plus d'informations, consultez la documentation relative aux anciennes versions d' Instana.
Important : la restauration du backend « Instana » après une mise à niveau n'est pas prise en charge pour l'édition Classic.

Mise à niveau d'une configuration à deux hôtes d' Docker

Pour mettre à niveau une configuration à deux hôtes de l' Docker, procédez comme suit :

  1. Mettez à niveau votre console Instana vers une version cible sur votre hôte ClickHouse. Pour plus d'informations, consultez la section « Mise à niveau de la console d' Instana ».

  2. Sur la machine hôte sur laquelle Instana est déployé, procédez comme suit :

    1. Mettez à niveau votre console Instana vers une version cible sur votre serveur Instana. Pour plus d'informations, consultez la section « Mise à niveau de la console d' Instana ».

    2. Mettez à jour le backend d' Instana sur votre hébergement Instana. Pour plus d'informations, consultez la section « Mise à niveau de votre backend d' Instana ».

Mise à niveau d'une installation d' Docker s en mode air-gapped

Vous pouvez mettre à niveau une installation d' Docker en mode air-gapped soit sur la machine virtuelle externe ( VM ), soit sur l' VM cible.

Sur le site VM (connexion Internet requise)

  1. Téléchargez et installez l'application console « Instana ».

    Cette yum --showduplicates commande affiche la liste des versions disponibles de l'application console Instana.

    yum --showduplicates list instana-console
    (...)
    instana-console.x86_64   259_3-1   instana-product
    instana-console.x86_64   259_4-1   instana-product
    instana-console.x86_64   261_0-1   instana-product
    instana-console.x86_64   261_1-1   instana-product
    instana-console.x86_64   261_2-1   instana-product
    instana-console.x86_64   263_0-1   instana-product
    instana-console.x86_64   263_1-1   instana-product
    instana-console.x86_64   263_2-1   instana-product
    instana-console.x86_64   263_3-1   instana-product
    instana-console.x86_64   265_0-1   instana-product
     
  2. À l'aide de la console Instana, téléchargez toutes les images d' Instana s nécessaires.

  3. Exportez l'application console Instana et les images Instana vers le serveur VM isolé du réseau.

    La commande instana images export -k DOWNLOAD_KEY suivante télécharge les images d' Instana s dans un .tar fichier, qui peut ensuite être exporté vers un serveur VM isolé :

    instana images export -k DOWNLOAD_KEY
    Images export ⣯ pull artifact-public.instana.io/backend/butler:3.265.276-0
    (...)
    -rw------- 1 root    root    8295586304 Feb  8 01:38 export-265-1.tar
     
    Remarque : la taille du fichier « .tar Instana » est d'environ 8 Go.

Sur l' VM cible (aucune connexion Internet requise)

  1. Installez ou mettez à jour le instana-console logiciel vers la version requise; pour plus d'informations, consultez la section « Mise à niveau de la console d' Instana ».

    La commande yum install --downloadonly suivante permet de télécharger le fichier instana-console à un emplacement spécifique; vous pouvez ensuite l'exporter vers l' VM e sans connexion Internet :

    yum install -y --downloadonly --downloaddir=/opt/instana instana-console-265_1-1
    (...)
    -rw-r--r-- 1 root    root      30581559 Feb 12 02:41 instana-console-265_1-1.x86_64.rpm
     

    La commande yum localinstall suivante installe le package à partir du fichier local (par exemple: Red Hat Package Manager (RPM)):

    yum localinstall instana-console-259_2-1.x86_64.rpm
    (...)
    Total size: 29 M
    Is this ok [y/N]: Y
    Downloading Packages:
    Running transaction check
    Transaction check succeeded.
    Running transaction test
    Transaction test succeeded.
    Running transaction
     Preparing        :                                                                                                                                                     1/1
     Upgrading        : instana-console-265_1-1.x86_64                                                                                                                      1/2
     Cleanup          : instana-console-259_2-1.x86_64                                                                                                                      2/2
     Running scriptlet: instana-console-259_2-1.x86_64                                                                                                                      2/2
     Verifying        : instana-console-265_1-1.x86_64                                                                                                                      1/2
     Verifying        : instana-console-259_2-1.x86_64                                                                                                                      2/2
     Installed products updated.
    
     Upgraded:
     instana-console-265_1-1.x86_64
     
  2. Importez les images de l' Instana e à l'aide de la commande suivante :

    instana images import -f /opt/instana/export-265-0.tar
     

    La procédure de mise à jour échoue si la version instana-console n'est pas prise en charge.

  3. Lancez la mise à jour d' Instana s à l'aide de la commande suivante :

    instana update -f settings.hcl