Installation de l'agent hôte sur IBM z/OS - Services système UNIX (USS)

Modifier en ligne

Pour surveiller localement sur z/OS les applications basées sur IBM, WebSphere,, IBM, WebSphere Liberty et JVM, installez l'agent hôte Instana sur la couche z/OS -UNIX System Services (USS).

Pour installer et gérer l'agent d' Instana ation au niveau de l'interface utilisateur d' z/OS, consultez les sections suivantes :

Prérequis

Modifier en ligne

Vous devez suivre les étapes suivantes avant d'installer l'agent « Instana » :

Téléchargez et exécutez le script zOS-Agent-Prereq.sh

Modifier en ligne

Le zOS-Agent-Prereq.sh script vérifie les prérequis de l'agent « Instana » sur z/OS et installe les prérequis manquants. Pour exécuter le script, suivre les étapes suivantes :

  1. Téléchargez les fichiers suivants et déplacez-les sur la couche z/OS -USS en utilisant SCP, SFTP, ou en faisant un copier-coller.

  2. Passez dans le shell d' bash et exécutez le zOS-Agent-Prereq.sh script en tant qu'utilisateur disposant des privilèges root à l'aide des commandes suivantes :

    bash

    • si vous avez déplacé le fichier script vers la couche z/OS -USS en utilisant SCP ou SFTP, exécutez la commande suivante :

      chmod +x ./zOS-Agent-Prereq.sh && chtag -R -tc 819 ./zOS-Agent-Prereq.sh && ./zOS-Agent-Prereq.sh

    • Si vous avez copié et collé le fichier script sur la couche z/OS -USS au lieu d'utiliser SCP ou SFTP, exécutez la commande suivante :

      chmod +x ./zOS-Agent-Prereq.sh && ./zOS-Agent-Prereq.sh

  3. Saisissez le chemin d'accès au fichier meta-main.XXX.zos.pax.Z que vous avez téléchargé lorsque le script vous y invite.

Le script vérifie les conditions préalables à l'installation de l'agent « Instana » dans un environnement « z/OS ». Si des conditions préalables sont manquantes, le script les télécharge.

Configurer un profil de sécurité (pour WebSphere Application Server et WebSphere Liberty monitoring)

Modifier en ligne

Pour tracer IBM WebSphere Application Server et WebSphere Liberty sur z/OS, vous devez configurer un profil de sécurité en utilisant Resource Access Control Facility ( RACF ) ou d'autres produits de sécurité mainframe.

Vous pouvez configurer un profil de sécurité en utilisant les approches suivantes :

  • Créer un profil générique

    Créez un profil générique nommé BPX.SRV.** dans la classe SURROGAT avec le droit de lecture UACC(READ).

  • Créer des profils pour des identifiants d'utilisateurs spécifiques

    Pour des ID d'utilisateurs spécifiques (par exemple, USERA), créez le profil BPX.SRV.USERA avec UACC(NONE) , puis accordez un accès en lecture aux utilisateurs de substitution individuels ou aux groupes.

Activer la surveillance d' WebSphere Application Server

Modifier en ligne

Pour surveiller WebSphere Application Server, vous devez configurer le serveur WebSphere en activant les drapeaux d'attachement suivants :

  - Djdk.attach.allowAttachSelf=true
  - Dcom.ibm.tools.attach.enable=yes

Activer la surveillance du serveur d' WebSphere Liberty

Modifier en ligne

Pour surveiller le serveur d' WebSphere Liberty, vous devez configurer le serveur d' WebSphere Liberty (en mettant à jour le server_name.jvmprofile fichier) en activant les indicateurs de connexion suivants :

  - Djdk.attach.allowAttachSelf=true
  - Dcom.ibm.tools.attach.enable=yes
Remarque : WebSphere Liberty, hébergé dans la région z/OS - CICS, est également pris en charge, tout comme WebSphere Liberty, hébergé sur z/OS.

Activer l' JMX e pour les métriques d' WebSphere Liberty

Modifier en ligne

Pour collecter les métriques pour WebSphere Liberty, vous devez activer la fonctionnalité monitor-1.0 . Pour activer cette fonctionnalité, ouvrez le fichier server.xml , qui se trouve dans le répertoire <websphere-liberty_install_dir>/usr/servers/<specific_server>/ , puis ajoutez les lignes suivantes au fichier :

<featureManager ...>
    ...
    <feature>monitor-1.0</feature>
    ...
</featureManager>

Avant d'installer l'agent, assurez-vous que le kit de développement Java (JDK) 11 est installé sur votre système.

Choix du mode d'installation de l'agent

Modifier en ligne

Choisissez l'une des options d'installation suivantes et cliquez sur le lien correspondant pour continuer :

  • Dans un environnement en ligne (où l'hôte peut communiquer avec les référentiels d'agents hébergés sur Instana ), vous pouvez installer automatiquement l'agent hôte à l'aide de la technique d'installation en une seule ligne. Pour plus d'informations, voir Installation de l'agent par le script automatisé (one-liner).

  • Dans un environnement à air comprimé, vous pouvez installer et exécuter l'agent à partir d'un fichier .tar.gz .

    Pour installer et exécuter l'agent à partir du fichier .tar.gz , téléchargez et extrayez le fichier, puis démarrez l'agent. Pour plus d'informations, voir Installation et exécution de l'agent à partir d'un fichier .tar.gz .

Installation de l'agent par le script automatisé (one-liner)

Modifier en ligne

Vous pouvez utiliser le script one-liner de l'agent pour installer automatiquement l'agent hôte sur la couche z/OS -USS. Pour installer l'agent hôte à l'aide de la fonction "one-liner", procédez comme suit :

  1. Sur la page d'accueil de l'interface utilisateur d' Instana, cliquez sur « Agents et collecteurs ». Dans l'onglet « Agents » de l' Instana, sélectionnez « Installer les agents ».

  2. Sur la page du catalogue de déploiement de l'agent, cliquez sur la tuile z/OS - Installation automatique (One-liner ).

  3. Sélectionnez le mode de conditionnement de l'agent (dynamique ou statique ) que vous souhaitez déployer. Pour comprendre la différence entre les agents statiques et les agents dynamiques, voir Types d'agents d'accueil.

  4. Copiez le script dans la couche z/OS -USS où vous souhaitez installer l'agent hôte, puis exécutez le script pour installer l'agent hôte.

    Le script est prérempli avec votre clé d'agent et le point de terminaison de l'agent hôte.

    Si vous modifiez une option, les paramètres du script sont automatiquement mis à jour.

    Voir l'exemple de script suivant pour installer l'agent avec l'option de conditionnement dynamique :

    curl -o setup_agent.sh https://setup.instana.io/agent && chmod 700 ./setup_agent.sh && chtag -R -tc 819 ./setup_agent.sh -a <your_agent_key> -d <your_agent_key> -t dynamic -e <host-agent-endpoint>

    Vous devez disposer des droits d'administrateur pour installer l'agent hôte d' Instana.

    Vous devez d'abord passer au shell bash à l'aide de la bash commande avant d'exécuter le script.

L'agent hôte est maintenant installé. Affichez l'agent sur la carte de l'infrastructure en cliquant sur View Deployed Agents (Afficher les agents déployés).

Remarque : le référentiel public de paquets Instana est ajouté à votre système via la création d'un fichier de référentiel. Ce fichier ajoute les dépôts authentifiés d' Instana aux sources d'installation de la machine.

Paramètres du script One-liner

Modifier en ligne

Le script one-liner accepte les paramètres suivants :

Paramètre Description
-a = (obligatoire) La clé de l'agent.
-d = (facultatif) La clé de téléchargement d' Instana. Si vous utilisez un déploiement Instana autohébergé (sur site), la clé vous est fournie par Instana.
-e = (obligatoire) Le point de terminaison de l'agent hôte.
-m = (facultatif) Définit le mode de l'agent « Instana » apm (par défaut). infra
-t = (facultatif) Le type d'agent, dynamic (par défaut) ou static.

Installation et exécution de l'agent à partir d'un fichier .tar.gz

Modifier en ligne

Si vous souhaitez installer et exécuter l'agent à partir d'un fichier .tar.gz , téléchargez et extrayez le fichier, puis démarrez l'agent.

Le .tar.gz fichier est prérempli avec votre clé d'agent et le point de terminaison de l'agent hôte.

Suivez les étapes pour installer l'agent à partir d'un fichier .tar.gz :

Téléchargement de l'agent

Modifier en ligne

Téléchargez le package de l'agent depuis l'interface utilisateur d' Instana. Pour ce faire, procédez comme suit :

  1. Sur la page d'accueil de l'interface utilisateur d' Instana, cliquez sur « Agents et collecteurs ». Dans l'onglet « Agents » de l' Instana, sélectionnez « Installer les agents ».

  2. Sur la page du catalogue de déploiement des agents, cliquez sur la tuile Linux - Archive ( tar.gz ).

  3. Dans la section Emballage, sélectionnez le type d'agent (Dynamic ou Static) que vous souhaitez déployer. Pour comprendre les différences entre les agents statiques et les agents dynamiques, voir Types d'agents d'accueil.

    Pour les environnements à air comprimé, utiliser un emballage statique.

  4. Dans la liste déroulante, sélectionnez l'architecture de la plate-forme (système d'exploitation - s390x ).

    Le fichier d'archivage est automatiquement préconfiguré avec les paramètres de votre compte Instana; il vous suffit donc de l'extraire et de lancer l'agent.

  5. Cliquez sur l'icône de téléchargement pour télécharger le fichier package de l'agent hôte ( tar.gz ) à partir de votre navigateur web.

L'agent hôte est maintenant téléchargé.

Déplacement de l'agent vers z/OS - coucheUSS

Modifier en ligne

Déplacez le paquet d'agents téléchargé de votre système vers la couche z/OS -USS en utilisant SCP ou SFTP. Voir l'exemple suivant :

scp <path-to-file-instana-agent-linux-s390x.tar.gz> <Username>@<zOS-IP>:/<PATH-TO-COPY-FILE-ON-zOS-USS>

Ensuite, téléchargez le fichier setup_agent_airgapped.sh de script depuis le référentiel InstanaGitHub et déplacez-le vers le dossier z/OS -USS.

Démarrage de l'agent

Modifier en ligne

Après avoir déplacé le paquet de l'agent vers la couche z/OS -USS, vous pouvez démarrer l'agent soit manuellement, soit à l'aide du script setup_agent_airgapped.sh .

Démarrage de l'agent à l'aide d'un script

Modifier en ligne

Passez dans le shell d' bash et exécutez le setup_agent_airgapped.sh script en tant qu'utilisateur disposant des privilèges root à l'aide des commandes suivantes :

bash

  • si vous avez déplacé le fichier script vers la couche z/OS -USS en utilisant SCP ou SFTP, exécutez la commande suivante :

    chmod +x ./setup_agent_airgapped.sh && chtag -R -tc 819 ./setup_agent_airgapped.sh && ./setup_agent_airgapped.sh

  • Si vous avez copié et collé le fichier script sur la couche z/OS -USS au lieu d'utiliser SCP ou SFTP, exécutez la commande suivante :

    chmod +x ./setup_agent_airgapped.sh && ./setup_agent_airgapped.sh

Démarrage manuel de l'agent

Modifier en ligne

Déplacez le fichier de l'agent téléchargé dans un emplacement accessible à l'ensemble du système et exécutez l'agent avec un utilisateur disposant des privilèges de l'administrateur (root).

  1. Extraire le paquet en exécutant la commande suivante :

    gzip -d filename.tar.gz && pax -r -f filename.tar

    Si gzip n'est pas disponible sur votre système z/OS, vous pouvez décompresser le tar.gz fichier sur votre système local à l'aide de la gunzip commande (gunzip file_name.tar.gz). Cette commande convertit instana-agent-linux-s390x.tar.gz en instana-agent-linux-s390x.tar. Ensuite, transférez le .tar fichier vers le répertoire « z/OS UNIX System Services » et exécutez la tar commande (-xvf instana-agent-linux-s390x.tar) pour en extraire le contenu. {: note} Si vous utilisez Windows pour télécharger le fichier tar.gz, transférez le fichier téléchargé vers un système Linux. Utilisez gunzip pour convertir .tar.gz en .tar, puis transférez le .tar fichier vers le calque « z/OS UNIX System Services ».

  2. Activez le réglage de la page de code en exécutant la commande suivante :

    chtag -R -tc 819 instana-agent/bin && chtag -R -tc 819 instana-agent/etc
chtag -t -c UTF-8 instana-agent/etc/instana/configuration.yaml

  3. Confirmez que la balise est activée en exécutant la commande suivante :

    ls -lTr instana-agent/bin && ls -lTr instana-agent/etc

    Voir l'exemple de réponse suivant :

    NGHON:/u/nghon/ts/instana-agent #>ls -lTr bin/
total 7360
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS        2659 Mar 18 09:53 stop
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS        2656 Mar 18 09:53 status
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS        2808 Mar 18 09:53 start
t ISO8859-1   T=on  -rw-r--r--   1 ROOT     OMVS       14526 Mar 24 10:56 setenv
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS     2293912 Mar 18 09:53 memory_calculator
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS       16767 Mar 18 09:53 karaf
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS       13806 Mar 18 09:53 inc
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS        4098 Feb 27 04:52 agent-java-check
t ISO8859-1   T=on  -rwxr-xr-x   1 ROOT     OMVS     1357420 Feb 27 04:52 agent-diagnostic.jar
NGHON:/u/nghon/ts/instana-agent #>

  4. Activez la conversion automatique des caractères en exécutant la commande suivante :

    export _BPXK_AUTOCVT=ON

    Nous vous conseillons d'activer la conversion des caractères dans votre profil d'utilisateur pour éviter de l'exporter à chaque fois que vous vous connectez.

  5. Définissez la variable JAVA_HOME d'environnement pour l'agent Instana, puis définissez PATH:

    Voir les exemples de commandes suivants :

    export JAVA_HOME=/usr/lpp/zWebSphere/Liberty/V9R0/java/8.0
export PATH=$JAVA_HOME/bin:$PATH

    Nous vous conseillons de définir la variable d'environnement soit dans votre profil d'utilisateur, soit dans le fichier instana-agent/bin/setenv , afin d'éviter de l'exporter à chaque fois que vous vous connectez.

  6. Démarrez l'agent en exécutant la commande suivante :

    INSTANA_AGENT_FOLDER/bin/start

Pour arrêter l'agent, exécutez la commande suivante :

INSTANA_AGENT_FOLDER/bin/stop

Pour vérifier l'état de l'agent, exécutez la commande suivante :

INSTANA_AGENT_FOLDER/bin/status

L'agent hôte est maintenant installé et démarré. Pour savoir ce que vous pouvez faire après l'installation, voir Que faire ensuite?

Traitement des incidents

Modifier en ligne

Si vous constatez des erreurs lors de l'installation ou de l'exécution de l'agent, vérifiez les messages du journal et consultez les conseils de dépannage. Pour des informations de dépannage générales à tous les agents hôte, voir Dépannage.

Échec du démarrage de l'agent

Modifier en ligne

Lorsque vous lancez l'agent « Instana » à partir de cd instana-agent/bin/ && ./start, il se peut que celui-ci ne parvienne pas à démarrer et affiche l'erreur suivante :

Fails with karaf: JAR files could not be found. Please check tar command if you run into path length limitation. We advise the use of GNU tar for uncompressing the host agent tarball. Could not resolve mvn:org.apache.felix/org.apache.felix.framework/5.6.12

  • Cause : Le fichier d'archive de l'agent .tar` est corrompu.

  • Étape de dépannage : Exécutez les commandes suivantes :

    ls instana-agent/system/org/apache/felix/org.apache.felix.framework/5.6.12

  • Résultat attendu : Le fichier org.apache.felix.framework-5.6.12.jar est répertorié.

  • Solution : assurez-vous que le instana-agent-linux-s390x.tar.gz fichier est bien décompressé sur votre environnement local ( MacOS ou Windows ), et que le instana-agent-linux-s390x.tar fichier est bien déplacé vers le répertoire z/OS -USS et décompressé à l'aide des pax -r -f filename.tar commandes tar –xvf filename.tar ou /.

Impossible pour l'agent de se connecter au serveur WebSphere

Modifier en ligne

Si l'agent Instana ne parvient pas à se connecter au serveur WebSphere, utilisez les scripts suivants pour vérifier si les options nécessaires sont activées afin de surveiller WebSphere Application Server.

  • WebSphere-zOS-Prereq.sh scénario

Ce script vérifie les conditions préalables à la surveillance d' WebSphere, notamment si l'indicateur d'attachement WebSphere est activé à l'aide de l'agent Instana, et renvoie tous les PID surveillés.

  1. Téléchargez le fichier WebSphere-zOS-Prereq.sh de script depuis le référentiel InstanaGitHub et déplacez-le vers le répertoire z/OS -USS à l'aide de SCP, SFTP ou par copier-coller.

  2. Passez dans le shell bash et exécutez le script depuis la couche USS de z/OS avec un utilisateur disposant des privilèges root, en exécutant les commandes suivantes :

    bash

    • si vous avez déplacé le fichier script vers la couche z/OS -USS en utilisant SCP ou SFTP, exécutez la commande suivante :

      chmod +x ./WebSphere-zOS-Prereq.sh && chtag -R -tc 819 ./WebSphere-zOS-Prereq.sh && ./WebSphere-zOS-Prereq.sh

    • Si vous avez copié et collé le fichier script sur la couche z/OS -USS au lieu d'utiliser SCP ou SFTP, exécutez la commande suivante :

      chmod +x ./WebSphere-zOS-Prereq.sh && ./WebSphere-zOS-Prereq.sh
  • WebSphere-Pid-Trace-Enable.sh scénario

Ce script vérifie les conditions préalables à la surveillance d' WebSphere, notamment si l'indicateur « Attach » d' WebSphere est activé à l'aide de l'agent Instana. Il vous invite à saisir le PID requis et à vérifier si l'indicateur est activé pour ce PID.

  1. Téléchargez le fichier WebSphere-Pid-Trace-Enable.sh de script depuis le référentiel InstanaGitHub et déplacez-le vers le répertoire z/OS -USS à l'aide de SCP, SFTP ou par copier-coller.

  2. Passez dans le shell bash et exécutez le script depuis la couche USS de z/OS avec un utilisateur disposant des privilèges root, en exécutant les commandes suivantes :

    bash

    • si vous avez déplacé le fichier script vers la couche z/OS -USS en utilisant SCP ou SFTP, exécutez la commande suivante :

      chmod +x ./WebSphere-Pid-Trace-Enable.sh && chtag -R -tc 819 ./WebSphere-Pid-Trace-Enable.sh && ./WebSphere-Pid-Trace-Enable.sh

    • Si vous avez copié et collé le fichier script sur la couche z/OS -USS au lieu d'utiliser SCP ou SFTP, exécutez la commande suivante :

      chmod +x ./WebSphere-Pid-Trace-Enable.sh && ./WebSphere-Pid-Trace-Enable.sh`