Préparation d'un déploiement à nœud unique
Préparez votre environnement avant d'installer Standard Edition dans votre cluster à nœud unique.
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 de
ext4systè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 doneVoici un exemple d'utilisation
xfssystè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 :
- En fonction de la capacité de stockage, identifiez les appareils que vous souhaitez utiliser pour chaque répertoire. Notez les noms des appareils.
- Obtenez les UUID de tous les appareils.
Consultez l’exemple de commande et de sortie suivant :blkid$ blkid /dev/sdb /dev/sdb: UUID="86ceb289-ba28-448d-b41f-71e647fc4536" BLOCK_SIZE="4096" TYPE="ext4" - Mettez à jour le fichier de table du système de fichiers (fstab) avec l'UUID du périphérique.
- Ouvrez le
/etc/fstabfichier dans votre éditeur de texte préféré. - 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 - Sauvegardez le fichier.
- Ouvrez le
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.
--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/fstabExemples 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 le
container-selinuxemballer.dnf install -y container-selinuxInstallez le
k3s-selinuxemballer.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 :
Ajouter le
export PATHcommande de.bashrcou.bash_profiledéposer.echo 'export PATH=$PATH:/usr/local/bin' >> ~/.bashrcOU
echo 'export PATH=$PATH:/usr/local/bin' >> ~/.bash_profileAppliquez la modification. Utilisez le nom du fichier que vous avez mis à jour dans la commande précédente.
source ~/.bashrcOU
source ~/.bash_profileVérifiez que le
/usr/local/binle répertoire est inclus dans lePATHvariable 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 :
| 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.
<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.
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 un
Command not foundMessage d'erreur.
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).
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 indiquant
No such file or directory.
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 :
Vérifier si
nm-cloud-setupest autorisé.systemctl is-enabled nm-cloud-setup.serviceSi le service est désactivé, la commande renvoie
disabled, sinon ça revientenabled.Si
nm-cloud-setupest désactivé, passez à la section suivante. Sinm-cloud-setupest activé, désactivez-le.systemctl disable nm-cloud-setup.service nm-cloud-setup.timerRé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.
Etapes suivantes
Poursuivez l'installation d' Instana. Pour plus d'informations, consultez la section « Installation du backend et des bases de données d' Instana ».