Préparation d'un déploiement à nœud unique

Préparez votre environnement avant d'installer Standard Edition dans votre cluster à nœud unique.

Remarque : les commandes de préparation décrites dans les sections suivantes s'adressent à l'utilisateur root. Si vous n'êtes pas l'utilisateur root, vous pouvez exécuter ces commandes en utilisant sudo.

Préparez les disques supplémentaires

Vous devez préparer les disques que vous avez ajoutés pour chaque répertoire de données dans le exigences de stockage section.

Les commandes permettant d'effectuer ces tâches dépendent de votre environnement, du système de fichiers que vous choisissez et du type de disque que vous ajoutez.

Les commandes des sections suivantes ne sont que des exemples et sont destinées à montrer les exigences de préparation des disques à l'utilisation. Vous devez utiliser les commandes qui fonctionnent pour votre environnement.

Identifiez les disques de votre hôte

Pour voir les appareils disponibles sur votre système, utilisez la commande suivante :

lsblk
 

Voici un exemple de sortie.

root@vm-node1:~# lsblk
NAME                      MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
loop0                       7:0    0  63.5M  1 loop /snap/core20/2015
loop1                       7:1    0    87M  1 loop /snap/lxd/27037
loop3                       7:3    0 111.9M  1 loop /snap/lxd/24322
loop4                       7:4    0  63.9M  1 loop /snap/core20/2182
loop5                       7:5    0  40.9M  1 loop /snap/snapd/20290
loop6                       7:6    0  40.4M  1 loop /snap/snapd/20671
vda                       252:0    0   250G  0 disk
├─vda1                    252:1    0     1M  0 part
└─vda2                    252:2    0   248G  0 part
└─ubuntu--vg-ubuntu--lv   253:0    0   248G  0 lvm  /
vdb                       252:16   0  1000G  0 disk
vdc                       252:32   0   500G  0 disk
vdd                       252:48   0   500G  0 disk
vde                       252:64   0   200G  0 disk
 

Créer un système de fichiers

Pour chaque disque supplémentaire que vous avez ajouté, vous devez créer un système de fichiers.

Vous pouvez utiliser n'importe quel système de fichiers approprié pour vos disques. Ext4 et XFS sont deux populairesLinux systèmes de fichiers. Le choix entreExt4 et XFS dépend de vos préférences et des besoins spécifiques de votre système. Ext4 est un bon choix pour la plupart des systèmes, mais si vous avez besoin d'un système de fichiers plus fiable, XFS pourrait être une meilleure option.

  • Voici un exemple de commande d'utilisation deext4 système de fichiers.

    for disk in vdb vdc vdd vde; do
       echo "make filesystem for $disk"
       mkfs.ext4 -m 0 -E lazy_itable_init=0,lazy_journal_init=0,discard /dev/$disk
    done
     
  • Voici un exemple d'utilisationxfs système de fichiers.

for disk in vdb vdc vdd vde; do
   echo "make filesystem for $disk"
   mkfs.xfs -f -i size=1024 -L $disk /dev/$disk
done
 

Créer les répertoires

Sur votre hébergeur, assurez-vous de créer les quatre répertoires. Voir Exigences matérielles .

Les exemples de commandes suivants utilisent les chemins de répertoire par défaut. Vous pouvez créer les répertoires à n'importe quel endroit de votre choix. Cependant, assurez-vous d'utiliser le chemin correct lorsque vous montez les répertoires.

mkdir -p /mnt/instana/stanctl/data
mkdir -p /mnt/instana/stanctl/metrics
mkdir -p /mnt/instana/stanctl/analytics
mkdir -p /mnt/instana/stanctl/objects
 

Ajouter des chemins de montage

Vous devez ajouter des chemins de montage aux répertoires que vous avez créés. Vous pouvez consulter la liste des périphériques dans la section « Identifier les disques sur votre hôte ».

Il arrive parfois que les noms des périphériques changent après un redémarrage, notamment lorsque vous connectez plusieurs disques. Dans de telles situations, une inadéquation entre les disques et les chemins de montage d'origine peut se produire. Pour éviter ces problèmes, remplacez les noms des appareils par leurs UUID (Universally Unique Identifiers) dans lefstab déposer.

Mettre à jour le fichier fstab avec les UUID

Pour mettre à jour le fichier fstab, procédez comme suit :

  1. En fonction de la capacité de stockage, identifiez les appareils que vous souhaitez utiliser pour chaque répertoire. Notez les noms des appareils.
  2. Obtenez les UUID de tous les appareils.
    blkid
     
    Consultez l’exemple de commande et de sortie suivant :
    $ blkid /dev/sdb
    /dev/sdb: UUID="86ceb289-ba28-448d-b41f-71e647fc4536" BLOCK_SIZE="4096" TYPE="ext4"
     
  3. Mettez à jour le fichier de table du système de fichiers (fstab) avec l'UUID du périphérique.
    1. Ouvrez le/etc/fstab fichier dans votre éditeur de texte préféré.
    2. Ajoutez l'UUID à/etc/fstab . Pour chaque appareil, ajoutez l'UUID comme indiqué dans l'exemple suivant :
      UUID=<device_uuid>    /mnt/instana/stanctl/data       ext4    discard,defaults,nofail        0 0
      UUID=<device_uuid>    /mnt/instana/stanctl/metrics    ext4    discard,defaults,nofail        0 0
      UUID=<device_uuid>    /mnt/instana/stanctl/analytics  ext4    discard,defaults,nofail        0 0
      UUID=<device_uuid>    /mnt/instana/stanctl/objects    ext4    discard,defaults,nofail        0 0
       
    3. Sauvegardez le fichier.

Créer des chemins de montage

Par mesure de précaution, effectuez une sauvegarde de votrefstab fichier avant de créer les chemins de montage.

cp /etc/fstab /etc/fstab.backup
 

Les exemples de commandes suivants utilisent les chemins de montage par défaut et les disques que nous avons utilisés comme exemples dans les sections précédentes. Les commandes peuvent varier en fonction de votre environnement. Aussi, si vous créé les répertoires dans les chemins personnalisés, assurez-vous d’utiliser ces chemins.

Remarque : si vous avez défini des chemins de montage personnalisés, veillez à ajouter --volume-<directory-name> l'option à la stanctl up commande lors de l'installation de votre Standard Edition auto-hébergé. Par exemple, si vous avez ajouté /data/analytics comme chemin de montage, utilisez alors stanctl up --volume-analytics /data/analytics.
  • Ext4 exemples de commandes

    echo "UUID=<device_vdb_uuid>  /mnt/instana/stanctl/analytics  ext4    discard,defaults,nofail        0 0" >> /etc/fstab
    echo "UUID=<device_vdc_uuid>  /mnt/instana/stanctl/metrics    ext4    discard,defaults,nofail        0 0" >> /etc/fstab
    echo "UUID=<device_vdd_uuid>  /mnt/instana/stanctl/objects    ext4    discard,defaults,nofail        0 0" >> /etc/fstab
    echo "UUID=<device_vde_uuid>  /mnt/instana/stanctl/data       ext4    discard,defaults,nofail        0 0" >> /etc/fstab
     
  • Exemples de commandes XFS

echo "UUID=<device_vdb_uuid>  /mnt/instana/stanctl/analytics  xfs   discard,defaults,nofail    0 0" >> /etc/fstab
echo "UUID=<device_vdc_uuid>  /mnt/instana/stanctl/metrics    xfs   discard,defaults,nofail    0 0" >> /etc/fstab
echo "UUID=<device_vdd_uuid>  /mnt/instana/stanctl/objects    xfs   discard,defaults,nofail    0 0" >> /etc/fstab
echo "UUID=<device_vde_uuid>  /mnt/instana/stanctl/data       xfs   discard,defaults,nofail    0 0" >> /etc/fstab
 

Vérifiez les chemins d'accès aux montages

Vérifiez que le répertoire est monté sur le bon disque. Par exemple, le répertoire « analytics » nécessite un disque de plus grande capacité que le répertoire « objects ». Voir Préparez les disques supplémentaires pour obtenir le nom de l'appareil.

lsblk <device name>
 

Monter les systèmes de fichiers

Montez tous les systèmes de fichiers.

mount -a
 

paramètres de noyau

Pour réussir l'installation du backend d' Instana, vous devez configurer correctement les paramètres du noyau suivants sur tous les nœuds.

vm.swappiness

Ensemblevm.swappiness à0 pour vous assurer que les pages de l'application ne sont pas déplacées vers l'espace d'échange.

sh -c 'echo vm.swappiness=0 >> /etc/sysctl.d/99-stanctl.conf' && sysctl -p /etc/sysctl.d/99-stanctl.conf
 

fs.inotify.max_user_instances

Ensemblefs.inotify.max_user_instances à8192 pour vous assurer que le système autorise un maximum de 8 192 instances inotify.

sh -c 'echo fs.inotify.max_user_instances=8192 >> /etc/sysctl.d/99-stanctl.conf' && sysctl -p /etc/sysctl.d/99-stanctl.conf
 

Pages géantes transparentes

Désactivez définitivement Transparent Huge Pages (THP) pour la gestion de la mémoire.

  • Si vous avez unUbuntu ouDebian hôte, exécutez ces commandes :
    sed -i "s/\(GRUB_CMDLINE_LINUX=\".*\)\"/\1 transparent_hugepage=never\"/" "/etc/default/grub"
    update-grub
     
  • Si vous disposez d'un hébergement Red Hat® Enterprise Linux®, CentOS Stream, Amazon Linux ou Oracle Linux, exécutez cette commande :
    grubby --args="transparent_hugepage=never" --update-kernel ALL
     
  • Si vous disposez d'un hôte SLES ( SUSE Linux Enterprise Server ), exécutez les commandes suivantes :
    sed -i "s/\(GRUB_CMDLINE_LINUX=\".*\)\"/\1 transparent_hugepage=never\"/" "/etc/default/grub"
    grub2-mkconfig -o /boot/grub2/grub.cfg
     

Un redémarrage du système est requis pour que ces modifications prennent effet.

Après le redémarrage, vérifiez que le THP est désactivé.

cat /sys/kernel/mm/transparent_hugepage/enabled
 

La sortie suivante indique que THP est désactivé.

always madvise [never]
 

Paquets et variables d'environnement

Amazon Linux Hôtes 2023

Dans la version 2023 d' Amazon Linux, les paquets container-selinuxk3s-selinux et manquent. Ces configurations sont nécessaires pour que le programme d'installation d' Standard Edition puisse installer Instana sans interruption.

  • Installez lecontainer-selinux emballer.

    dnf install -y container-selinux
     
  • Installez lek3s-selinux emballer.

    dnf install -y https://rpm.rancher.io/k3s/stable/common/centos/8/noarch/k3s-selinux-1.6-1.el8.noarch.rpm
     

Red Hat Enterprise Linux et les animateurs d' CentOS Stream

Sur les serveurs Red Hat Enterprise Linux et CentOS Stream, le /usr/local/bin répertoire n'est pas inclus par défaut dans la variable PATH d'environnement. Le programme d'installation d' Standard Edition a besoin de ce répertoire PATH pour exécuter certaines commandes pendant l'installation.

Ajouter/usr/local/bin répertoire vers lePATH variable d'environnement, procédez comme suit :

  1. Ajouter leexport PATH commande de.bashrc ou.bash_profile déposer.

    echo 'export PATH=$PATH:/usr/local/bin' >> ~/.bashrc
     

    OU

    echo 'export PATH=$PATH:/usr/local/bin' >> ~/.bash_profile
     
  2. Appliquez la modification. Utilisez le nom du fichier que vous avez mis à jour dans la commande précédente.

    source ~/.bashrc
     

    OU

    source ~/.bash_profile
     
  3. Vérifiez que le/usr/local/bin le répertoire est inclus dans lePATH variable d'environnement.

    echo $PATH
     

Si la mise à jour du chemin réussit, vous voyez/usr/local/bin dans la sortie.

Noms des locataires et des logements

Lors de l'installation d' Instana, vous devez indiquer les noms du locataire et de l'unité.

Une fois l' Instana installé, vous ne pouvez plus modifier le nom du tenant ou de l'unité.

Les restrictions suivantes s'appliquent aux noms des locataires et des logements :

  • Le nom doit correspondre au modèle d'expression régulière suivant :
    ^[a-z][a-z0-9]*$
     
  • Le nom ne doit pas dépasser 15 caractères.
  • Le nom doit commencer par une lettre de l'alphabet.
  • Le nom ne doit être composé que de caractères alphanumériques.
  • Tous les caractères doivent être en minuscules.

Par exemple,test est un nom d'unité etmarketing est le nom d'un locataire.

Pour plus d'informations sur les locataires et les unités, voirunits.instana.io .

Configuration réseau requise

Votre domaine Instana et votre hébergeur doivent être accessibles depuis l'extérieur de votre environnement sur site. Veillez à mettre à jour les paramètres du système de noms de domaine ( DNS ) et à définir les règles du pare-feu sur votre serveur.

Paramètres DNS

Assurez-vous de disposer d'un nom de domaine et d'une zone DNS pour votre environnement Instana. Ajoutez ensuite des enregistrements A de type « DNS » dans la zone pour les domaines suivants :

Tableau 1. DNS paramètres
Domaine Description Exemple de nom
Domaine de base <base_domain> Le nom de domaine complet (FQDN) que vous pouvez utiliser pour accéder à Instana. Renvoie vers l'adresse IP de votre hébergeur. instana.example.com
sous-domaine accepteur d'agent agent-acceptor.<base_domain> Nom de domaine pour le trafic des agents d' Instana. Renvoie vers l'adresse IP de votre hébergeur. agent-acceptor.instana.example.com
OpAMP sous-domaine d'acceptation opamp-acceptor.<base_domain> Nom de domaine destiné à la gestion du trafic du collecteur d' OpenTelemetry s. Renvoie vers l'adresse IP de votre hébergeur. opamp-acceptor.instana.example.com
OTLP HTTP sous-domaine d'acceptation otlp-http.<base_domain> Nom de domaine pourOpenTelemetry collectionneurOTLP/HTTP trafic. Renvoie vers l'adresse IP de votre hébergeur. otlp-http.instana.example.com
OTLP gRPC sous-domaine d'acceptation otlp-grpc.<base_domain> Nom de domaine pourOpenTelemetry collectionneurOTLP/gRPC trafic. Renvoie vers l'adresse IP de votre hébergeur. otlp-grpc.instana.example.com
Sous-domaine du locataire et du logement <unit-name>-<tenant-name>.<base_domain> Nom de domaine pour une unité et son locataire. Renvoie vers l'adresse IP de votre hébergeur. test-marketing.instana.example.com

Pour connaître la procédure détaillée d'ajout d'enregistrements A pour DNS, consultez la documentation de votre registraire de domaine.

Remarque : si vous souhaitez utiliser uniquement <base_domain> pour tout votre trafic entrant, consultez la section « Configuration avec un seul domaine ».

Règles de pare-feu

CertainLinux Les distributions peuvent avoir des conflits potentiels ou des restrictions imposées par le pare-feu. Ces conflits peuvent avoir un impact sur la communication réseau et la découverte de services nécessaires à l'installation. Par conséquent, si votre pare-feu est ouvert, ajoutez le ports requis et les règles.

Si vous disposez d'un pare-feu externe, consultez la documentation du pare-feu pour savoir comment ouvrir les ports.

Pour le déploiement d' Standard Edition sur Amazon Web Services ( AWS ), vous devez ouvrir les ports 22, 80, 443 et 8443 de TCP dans le groupe de sécurité, même si le pare-feu est désactivé.

Ubuntu hôte

Utilisez ces commandes sur unUbuntu hôte.

  1. Vérifiez si le pare-feu est activé.

    ufw status
     
    • Si le pare-feu est activé, le résultat de la commande répertorie les règles actuellement configurées.
    • Si le pare-feu est désactivé, vous voyez unCommand not found Message d'erreur.
  2. Si le pare-feu est désactivé, aucune action n'est nécessaire.

    Si le pare-feu est activé, les ports ouverts ajoutent des règles à l'aide des commandes suivantes :

    ufw allow 22/tcp
    ufw allow 80/tcp
    ufw allow 443/tcp
    ufw allow 8443/tcp
    ufw allow from 10.42.0.0/16 to any
    ufw allow from 10.43.0.0/16 to any
    ufw allow in on lo
    ufw allow out on lo
    ufw reload
     

Debian, Red Hat Enterprise Linux, CentOS Stream, Amazon Linux, Oracle Linux et SLES

Utilisez ces commandes sur les serveurs Debian, Red Hat Enterprise Linux, CentOS Stream, Amazon Linux, Oracle Linux et SUSE Linux Enterprise Server (SLES).

  1. Vérifiez si le pare-feu est activé.

    systemctl status firewalld
     
    • Si le pare-feu est activé, le résultat de la commande fournit l'état du pare-feu, y compris les règles actives.
    • Si le pare-feu est désactivé, vous voyez un message d'erreur indiquantNo such file or directory .
  2. Si le pare-feu est désactivé, passez à la section suivante.

    Si le pare-feu est activé, les ports ouverts ajoutent des règles à l'aide des commandes suivantes :

    firewall-cmd --permanent --add-port=22/tcp
    firewall-cmd --permanent --add-port=80/tcp
    firewall-cmd --permanent --add-port=443/tcp
    firewall-cmd --permanent --add-port=8443/tcp
    firewall-cmd --permanent --zone=trusted --add-source=10.42.0.0/16
    firewall-cmd --permanent --zone=trusted --add-source=10.43.0.0/16
    firewall-cmd --permanent --zone=trusted --add-interface=lo
    firewall-cmd --reload
     

Vérifier les ports

Vérifiez si les ports dans Ports requis sont ouverts.

Ubuntu hôte

Utilisez la commande suivante pour vérifier les ports bloqués par un pare-feu. Si un pare-feu est activé, la commande répertorie les ports bloqués.

 ufw status verbose
 

Pour ouvrir un port, exécutez la commande suivante :

ufw allow <port_number>
 
Debian, Red Hat Enterprise Linux, CentOS Stream, Amazon Linux, Oracle Linux et SLES

Pour vérifier si un port est bloqué par un pare-feu, utilisez la commande suivante :

firewall-cmd --query-port=<port_number>/tcp
 

Si la sortie de la commande est no, le port spécifié est fermé.

Pour ouvrir le port, utilisez les commandes suivantes :

firewall-cmd --zone=public --add-port=<port_number>/tcp --permanent
firewall-cmd --reload
 

Configuration d'un proxy HTTP

Définir laHTTP_PROXY ,HTTPS_PROXY , etNO_PROXY Variables d'environnement.

Lorsque vous exécutez la stanctl up commande d'installation de l' Standard Edition, l'installation utilise automatiquement les valeurs des variables d'environnement du shell actuel.

Dans leNO_PROXY Dans la liste, assurez-vous d'inclure les plages d'adresses IP (adresses IP publiques et privées) que les nœuds utilisent. Ou, si votre proxy peut accéder aux nœuds, vous n'avez pas besoin de définir leNO_PROXY variable d'environnement.

Définissez les variables d'environnement à l'aide des commandes suivantes :

HTTP_PROXY=http://your-proxy.example.com:<port_number>
 
HTTPS_PROXY=http://your-proxy.example.com:<port_number>
 
NO_PROXY=127.0.0.0/8,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16
 

Utilitaire nm-cloud-setup sur les hôtes RHEL et CentOS Stream

Sur les hôtes Red Hat Enterprise Linux et CentOS Stream, si nm-cloud-setup cette option est activée, vous devez la désactiver et redémarrer le nœud.

Exécutez les commandes suivantes :

  1. Vérifier sinm-cloud-setup est autorisé.

    systemctl is-enabled nm-cloud-setup.service
     

    Si le service est désactivé, la commande renvoiedisabled , sinon ça revientenabled .

  2. Sinm-cloud-setup est désactivé, passez à la section suivante. Sinm-cloud-setup est activé, désactivez-le.

    systemctl disable nm-cloud-setup.service nm-cloud-setup.timer
     
  3. Réamorcez le noeud.

    systemctl reboot
     

TLS certificat et clé

Standard Edition, lorsqu'il est hébergé en local, nécessite un certificat et une clé TLS (TLS).

Le certificat doit être émis pour les domaines indiqués dans la section des paramètres d' DNS.

Si vous ne souhaitez spécifier aucun certificat, vous pouvez utiliser un certificat auto-signé généré lors de l'installation.