Installation manuelle sur un serveur Tomcat

Cette section décrit comment installer manuellement l'agent glass box sur un serveur Tomcat.

Pourquoi et quand exécuter cette tâche

Lorsque AppScan est installé, les fichiers nécessaires à l'installation de l'agent du serveur sont sauvegardés dans un dossier dédié sur votre machine. Pour effectuer cette tâche, vous devez accéder à ce dossier et à votre serveur d'applications.

Procédure

  1. Ouvrez ...\Program Files\IBM\AppScan Standard\Glass box

    Le chemin absolu dépend de l'emplacement dans lequel vous avez installé AppScan.

  2. Localisez le fichier GB_Java_Manual_Setup.zip et copiez-le sur votre serveur Web.
  3. Extrayez le contenu de ce dossier dans votre emplacement préféré sur le serveur.
  4. Définissez un nom d'utilisateur et un mot de passe pour l'agent (seuls des caractères anglais ASCII peuvent être utilisés) :
    • Serveur Linux : Exécutez AgentCredentials.sh <username> <password>
      Remarque : AgentCredentials.sh doit avoir des permissions d'exécution.
    • Serveur Windows : Exécutez AgentCredentials.bat <username> <password>
  5. Déployez l'application Web GBootStrap.
    • Méthode préférée :
      1. Connectez-vous à Tomcat Manager. L'emplacement par défaut est http://<server_name>:<port_number>/manager/html
      2. Dans Deploy table > War file to deploy, cliquez sur Choose file
      3. Recherchez GBootStrap.war (qui se situe dans le dossier glass box que vous avez extrait) puis cliquez sur Open
      4. Cliquez sur Deploy et vérifiez que GBootStrap a été ajouté à la liste des applications.
    • Autre méthode :
      1. Copiez le fichier GBootStrap.war à partir du dossier glass box que vous avez extrait
      2. Collez-le dans le dossier \webapps, à l'emplacement par défaut :
        C:\apache-tomcat-[version]\webapps
  6. Fermez Tomcat.
  7. Configurez l'utilisation permanente de l'agent glass box par Tomcat de l'une des manières suivantes :
    • Via la variable d'environnement : Configurez la machine virtuelle Java de JBoss à l'aide de la variable d'environnement JAVA_OPTS (si celle-ci n'existe pas, créez-la) avec la valeur -javaagent:<path_to_gbAgent.jar>/gbAgent.jar.
    • Via des scripts batch/sh : Transmettez les arguments à la machine JVM exécutant Tomcat en éditant les scripts de configuration fournis :

      Serveur Linux :

      1. Dans le dossier Tomcat (qui se trouve généralement dans <path_to_Tomcat_folder>/bin), ouvrez startup.sh
      2. Recherchez la ligne commençant par CATALINA_OPTS et ajoutez-lui la ligne suivante :
        export CATALINA_OPTS = $CATALINA_OPTS -javaagent:<path_to_gbAgent.jar>/gbAgent.jar
      3. Enregistrez et fermez le fichier.

      Serveur Windows :

      1. Dans le dossier Tomcat (qui se trouve généralement dans <path_to_Tomcat_folder>\bin), ouvrez startup.bat
      2. Recherchez la ligne commençant par set CATALINA_OPTS= et ajoutez la ligne suivante en dessous :
        set CATALINA_OPTS = %CATALINA_OPTS% -javaagent:<path_to_gbAgent.jar>/gbAgent.jar
      3. Enregistrez et fermez le fichier.
    Important : Vérifiez que CATALINA_OPTS est initialisé une seule fois, et avant les lignes ci-dessus, afin que les autres attributions CATALINA_OPTS n'écrasent pas -javaagent.
    Remarque : Pour ajouter des arguments à CATALINA_OPTS, utilisez la convention %CATALINA_OPTS% / $ CATALINA_OPTS.
  8. Redémarrez Tomcat.