Installation d' Standard Edition en auto-hébergement pour la plateforme IBM Concert

Installez et configurez « Standard Edition » en tant que fonctionnalité sur la plateforme Concert.

Important : l'installation dans des environnements isolés physiquement n'est pas prise en charge.

Commencez par acheter la plateforme Concert et la fonctionnalité Concert Observe. Pour plus d'informations, consultez la plateforme IBM Concert.

Ensuite, installez « Instana » en suivant les étapes décrites dans les sections suivantes. La procédure d'installation comprend des instructions pour installer Standard Edition et l'intégrer au hub de la plateforme.

Le processus d'installation utilise l'outil stanctl pour déployer Instana.

Prérequis

Avant de commencer, assurez-vous de remplir les conditions préalables suivantes :

Équipez les nœuds (trois ou cinq nœuds recommandés) de disques externes. Pour connaître la configuration système requise, consultez les rubriques suivantes :
- Pour un cluster à nœud unique, consultez la section « Configuration système requise pour un déploiement à nœud unique ».
- Pour un cluster à trois nœuds, consultez la section « Configuration système requise pour un déploiement à trois nœuds ».
- Pour un cluster à cinq nœuds, consultez la section « Configuration système requise pour un déploiement à cinq nœuds ».
Vous devez ajouter 2 cœurs de processeur supplémentaires et 10 Go de mémoire pour les indicateurs de fonctionnalité que vous devez activer afin de pouvoir utiliser « Instana » comme fonctionnalité de la plateforme Concert. Dans les clusters à plusieurs nœuds, ajoutez ces ressources supplémentaires sur les nœuds qui ne sont pas utilisés pour le stockage des données. Vous pouvez les ajouter soit sur un seul nœud, soit sur plusieurs nœuds.
Préparez les paramètres d'installation d' Instana. Pour plus d'informations, consultez les tableaux 1 et 2 dans la section « Avant de commencer ».
Créez une adresse e-mail valide pour le premier utilisateur administrateur d' Instana.
Installez et configurez le hub de la plateforme Concert.
Remarque : le hub de la plateforme et Instana doivent être installés sur des clusters distincts.
Vérifiez que vous avez bien effectué les tâches suivantes :
- J'ai installé le hub de la plateforme et je peux y accéder à l'adresse URL.
- Ajout d'utilisateurs dans le hub.
- L'instance « Instana » a été enregistrée au format <UNIT_NAME>_<TENANT_NAME>.<BASE_DOMAIN_FOR_ENVIRONMENT>
Si vous avez installé IBM Concert, notez bien le nom d'hôte IBM Concert.
Si vous avez installé IBM Turbonomic, notez bien le nom d'hôte IBM Turbonomic.

Installation

Pour installer Standard Edition sur la plateforme IBM Concert, procédez comme suit :

Installez la version 1.14.1 ou une version ultérieure de l'outil stanctl .

Créez les répertoires et les fichiers destinés aux valeurs personnalisées du noyau et des unités.

mkdir -p $HOME/.stanctl/values/instana-core $HOME/.stanctl/values/instana-unit

touch $HOME/.stanctl/values/instana-core/custom-values.yaml $HOME/.stanctl/values/instana-unit/custom-values.yaml

Configurez le fichier core $HOME/.stanctl/values/instana-core/custom-values.yaml en utilisant un contenu similaire à l'exemple suivant :

Remplacez <HUB_URL> et <HUB_PORT> par l'adresse URL et le port accessibles au public de votre environnement Concert Hub. Instana utilise cette adresse URL pour se connecter au concentrateur.
Vérifiez que la concert/imageConfig/tag valeur correspond bien à la version de build du hub que vous utilisez.
Remplacez <CONCERT_access_hostname> et <TURBO_access_hostname> par les noms d'hôte réels de vos services Concert et Turbonomic dans la config.saas.platform.all.origins propriété. Si vous ne disposez pas de ces informations pour le moment, vous pourrez les ajouter à tout moment une fois l'installation terminée. Veillez à exécuter la stanctl backend apply commande après avoir saisi les informations.
Les valeurs par défaut de unit0-tenant0 sont utilisées dans la config.solis.hub.environments propriété. Si vous prévoyez de spécifier d'autres noms d'unité et de locataire au moment du déploiement, remplacez les valeurs par défaut par vos propres noms d'unité et de locataire.

gatewayConfig:
  concert:
    imageConfig:
      registry: artifact-public.instana.io
      repository: self-hosted-images/k8s/ibm-solis-gw
      tag: v3.0.0
    properties:
      - name: solis.hub.external.url
        value: "https://<HUB_URL>:<HUB_PORT>"
featureFlags:
  - name: feature.beeinstana.infra.metrics.enabled
    enabled: true
  - name: feature.solis.enabled
    enabled: true
  - name: feature.vulnerabilityCenter.enabled
    enabled: true
  - name: feature.resource.optimization.actions.enabled
    enabled: true
  - name: feature.ibm.common.enabled
    enabled: true
  - name: feature.solis.test.catalog.enabled
    enabled: true
  - name: feature.tealium.privacy.enabled
    enabled: true
  - name: feature.walkme.tool.enabled
    enabled: true
  - name: feature.segment.analytics.enabled
    enabled: true
  - name: feature.solis.jwt.enabled
    enabled: true
  - name: feature.remote.integrations.enabled
    enabled: true
  - name: feature.instana.prefix.enabled
    enabled: true
  - name: feature.coordinator.ai.agent.enabled
    enabled: true
  - name: feature.coordinator.ai.agent.component.enabled
    enabled: true
  - name: feature.automated.investigation.ai.agent.enabled
    enabled: true
  - name: feature.automated.investigation.ai.agent.component.enabled
    enabled: true
  - name: feature.kubernetes.ai.agent.enabled
    enabled: true
  - name: feature.kubernetes.ai.agent.component.enabled
    enabled: true
  - name: feature.slo.ai.agent.enabled
    enabled: true
  - name: feature.slo.ai.agent.component.enabled
    enabled: true
  - name: feature.mcp.instana.component.enabled
    enabled: true
  - name: feature.incident.ai.summarization.enabled
    enabled: true
  - name: feature.instana.chat.enabled
    enabled: true
  - name: feature.ai.gateway.enabled
    enabled: true
  - name: feature.ai.rca.agentic.workflow.enabled
    enabled: true
  - name: feature.mcp.instana.enabled
    enabled: true
  - name: feature.action.ai.generation.enabled
    enabled: true
  - name: feature.graphql.endpoint.enabled
    enabled: true
  - name: feature.ai.automated.investigation.enabled
    enabled: true
  - name: feature.rca.agentic.enabled
    enabled: true
  - name: feature.rca.ai.automated.investigation.enabled
    enabled: true
properties:
  - name: config.tag.processor.readiness.min.storage.hit.rate
    value: "0.5"
  - name: config.saas.platform.iam.enabled
    value: "true"
  - name: config.saas.platform.all.origins
    value: "<CONCERT_access_hostname>,<TURBO_access_hostname>"
  - name: config.platform.hub.path
    value: "platform_hub"
  - name: config.solis.jwt.audience
    value: "PLATFORMAUD"
  - name: config.solis.jwt.issuer
    value: "IBMPLATFORM"
  - name: config.solis.hub.url
    value: "https://concert-gateway.instana-core.svc.cluster.local:20443"
  - name: config.solisUiHost
    value: "/solis_hub/ui"
  - name: config.solis.jwt.verifyInstanceUrl
    value: "false"
  - name: config.solis.hub.environments
    value: "unit0-tenant0"
  - name: config.solis.jwt.verifySubject
    value: "false"

Configurez le fichier d'unité $HOME/.stanctl/values/instana-unit/custom-values.yaml en utilisant un contenu similaire à celui de l'exemple suivant.

Remplacez <VALID_EMAIL_ADDRESS> par l'adresse e-mail valide de l'utilisateur administrateur initial.

initialAdminUser: <VALID_EMAIL_ADDRESS>
properties:
  - name: config.ui.backend.server.max.request.header.size
    value: "32KiB"
  - name: config.ui.backend.server.max.response.header.size
    value: "32KiB"
  - name: config.ui.backend.websocket.max.header.size
    value: "32768"

Déployez « Instana » et intégrez-le à la plateforme Concert en exécutant la commande suivante stanctl up . Cette commande déploie votre cluster Kubernetes et le connecte à la plateforme Concert.
- Remplacez <INSTANA_SALES_KEY> par votre clé de vente Instana.
- Remplacez <BASE_DOMAIN_FOR_ENVIRONMENT> par le nom d'hôte de votre VM, ou par l'entrée DNS correspondant au CNAME ou à l'adresse IP de l'équilibreur de charge de la plateforme Concert.
- Remplacez <INSTANA_PASSWORD> par le mot de passe de l'utilisateur administrateur « Instana » que vous avez défini dans le fichier de valeurs personnalisées de l'unité.
- Pour les clusters à plusieurs nœuds, ajoutez les adresses IP des nœuds à l'aide du --multi-node-ips paramètre. Dans la commande suivante, le paramètre prend trois adresses IP. Si vous disposez d'un cluster à cinq nœuds, ajoutez deux adresses IP supplémentaires.
- Pour les clusters à nœud unique, les --multi-node-enable paramètres et --multi-node-ips ne sont pas nécessaires.
- Tous les services d'acceptation (agent, OTLP, EUM, sans serveur et synthétiques) utilisent le port 8443. Vous pouvez configurer des sous-domaines selon vos besoins, mais le port ne peut pas être le 443.
```
stanctl up --concert-platform-enabled \
  --instana-version=3.319.465-0 \
  --download-key=<INSTANA_DOWNLOAD_KEY> \          
  --sales-key=<INSTANA_SALES_KEY> \
  --multi-node-enable \
  --multi-node-ips <node0 IP>,<node1 IP>,<node2 IP> \ 
  --install-type production \          
  --core-base-domain=<BASE_DOMAIN_FOR_ENVIRONMENT> \
  --core-acceptors-agent-host=agent-acceptor.<BASE_DOMAIN_FOR_ENVIRONMENT> \
  --core-acceptors-agent-port=8443 \
  --core-acceptors-opamp-host=opamp-acceptor.<BASE_DOMAIN_FOR_ENVIRONMENT> \
  --core-acceptors-opamp-port=8443 \
  --core-acceptors-otlp-grpc-host=otlp-grpc.<BASE_DOMAIN_FOR_ENVIRONMENT> \
  --core-acceptors-otlp-grpc-port=8443 \
  --core-acceptors-otlp-http-host=otlp-http.<BASE_DOMAIN_FOR_ENVIRONMENT> \
  --core-acceptors-otlp-http-port=8443 \
  --core-acceptors-eum-port=8443 \
  --core-acceptors-serverless-port=8443 \
  --core-acceptors-synthetics-port=8443 \
  --unit-initial-admin-password=<INSTANA_PASSWORD>
```
Le déploiement comprend les éléments suivants :
- Instana Core avec intégration de la plateforme Concert
- Instana Appareil avec authentification par plateforme
- Services d'acceptation pour les agents, l' OTLP, l'EUM, les solutions sans serveur et les tests synthétiques sur le port 8443

Vérification

Pour vérifier l'installation, accédez à l'interface utilisateur d' Instana à l'adresse https://<UNIT>-<TENANT>.<BASE_DOMAIN_FOR_ENVIRONMENT>.

Saisissez les identifiants de l' Instana que vous avez indiqués dans le fichier de valeurs personnalisées de l'unité. Vous êtes redirigé vers la page de connexion de la plateforme, où vous devez saisir les identifiants de l'utilisateur que vous avez configuré dans le hub.