Exécution AppDynamics

De EjnTricks

Lors de la décompression du viewer AppDynamics, le fichier readme.txt indique les différents mode de démarrage.

Arguments

Démarrage par défaut

Le mode de démarrage le plus simple consiste à exécuter l'archive adlite-viewer.jar à l'aide de la commande suivante:

java -jar adlite-viewer.jar

Starting ... AppDynamics Lite Viewer 0.91 Beta Build Date 2011-02-01 12:11:15
Lite Viewer Home Directory[/var/opt/AppDynamics/viewer]
Using Java Version [1.6] for Lite Viewer
Starting adlite-viewer on port 8990.
2011-06-24 23:02:29.688::INFO:  Logging to STDERR via org.mortbay.log.StdErrLog
2011-06-24 23:02:29.730::INFO:  jetty-
2011-06-24 23:02:29.781::INFO:  Extract jar:file:/var/opt/AppDynamics/viewer/adlite-viewer.jar!/ to /tmp/Jetty_0_0_0_0_8990_adlite-viewer.jar____-x5l502/webapp
2011-06-24 23:02:30.471::INFO:  NO JSP Support for /, did not find org.apache.jasper.servlet.JspServlet
Logging Configuration File[/var/opt/AppDynamics/viewer/log4j.xml]
23:02:30,905  INFO [main] AgentHandlerServlet - *****************************************************************
23:02:30,906  INFO [main] AgentHandlerServlet - Starting  ....AppDynamics Lite Viewer 0.91 Beta Build Date 2011-02-01 12:11:15
23:02:30,998  INFO [main] FileStore - Configuration File [/var/opt/AppDynamics/viewer/configuration.xml]
23:02:31,316  INFO [main] DirectoryResolver - Deleting directory [/var/opt/AppDynamics/viewer/data]
23:02:31,319  INFO [main] FileStoreManager - Initialized Data Directory [/var/opt/AppDynamics/viewer/data]
23:02:31,326  INFO [main] FileStoreManager - Data File /var/opt/AppDynamics/viewer/data/data.ser_1308949351319 created at Fri Jun 24 23:02:31 CEST 2011
ON ROATE FILESTORE: com.appdynamics.lite.viewer.nb@8691dee
ON ROATE FILESTORE: com.appdynamics.lite.viewer.v@6cb32ed4
ON ROATE FILESTORE: com.appdynamics.lite.viewer.ab@67c7980c
2011-06-24 23:02:31.815::INFO:  Started SocketConnector @ 0.0.0.0:8990
Type 'shutdown' to shutdown the viewer process




 Viewer Lite Shell:>

Cette ligne de commande permet de lancer le serveur avec tous les paramètres par défaut.


Démarrage avec modification du port

Le port d'écoute peut être paramétré avec l'argument -Dadlite.port et une valeur de port à utilisé. La ligne de commande suivante permet d'exécuter le viewer sur le port 8991, au lieu du 8990 standard.

java -Dadlite.port=8991 -jar adlite-viewer.jar

Starting ... AppDynamics Lite Viewer 0.91 Beta Build Date 2011-02-01 12:11:15
Lite Viewer Home Directory[/var/opt/AppDynamics/viewer]
Using Java Version [1.6] for Lite Viewer
Starting adlite-viewer on port 8991.
2011-06-24 23:22:59.440::INFO:  Logging to STDERR via org.mortbay.log.StdErrLog
2011-06-24 23:22:59.481::INFO:  jetty-
2011-06-24 23:22:59.532::INFO:  Extract jar:file:/var/opt/AppDynamics/viewer/adlite-viewer.jar!/ to /tmp/Jetty_0_0_0_0_8991_adlite-viewer.jar____464aod/webapp
2011-06-24 23:23:00.217::INFO:  NO JSP Support for /, did not find org.apache.jasper.servlet.JspServlet
Logging Configuration File[/var/opt/AppDynamics/viewer/log4j.xml]
23:24:31,779  INFO [main] AgentHandlerServlet - *****************************************************************
23:24:31,779  INFO [main] AgentHandlerServlet - Starting  ....AppDynamics Lite Viewer 0.91 Beta Build Date 2011-02-01 12:11:15
23:24:31,873  INFO [main] FileStore - Configuration File [/var/opt/AppDynamics/viewer/configuration.xml]
23:24:32,232  INFO [main] DirectoryResolver - Deleting directory [/var/opt/AppDynamics/viewer/data]
23:24:32,235  INFO [main] FileStoreManager - Initialized Data Directory [/var/opt/AppDynamics/viewer/data]
23:24:32,241  INFO [main] FileStoreManager - Data File /var/opt/AppDynamics/viewer/data/data.ser_1308950672235 created at Fri Jun 24 23:24:32 CEST 2011
ON ROATE FILESTORE: com.appdynamics.lite.viewer.nb@26a3960
ON ROATE FILESTORE: com.appdynamics.lite.viewer.v@700a4488
ON ROATE FILESTORE: com.appdynamics.lite.viewer.ab@3219762f
2011-06-24 23:24:32.674::INFO:  Started SocketConnector @ 0.0.0.0:8991
Type 'shutdown' to shutdown the viewer process



 Viewer Lite Shell:>

En général, nous laisserons le port par défaut mais en le spécifiant dans la ligne de commande, afin de facilement le changer.


Modification de l'authentification

Le compte par défaut est admin/admin. Les paramètres -Dadlite.user et -Dadlite.password permettent de modifier ces comptes d'accès. La ligne de commande suivante spécifie l'utilisateur AppDynamicsAdmin avec le mot de passe AdminPassword:

java -Dadlite.port=8990 -Dadlite.user=AppDynamicsAdmin -Dadlite.password=AdminPassword -jar adlite-viewer.jar

Starting ... AppDynamics Lite Viewer 0.91 Beta Build Date 2011-02-01 12:11:15
Lite Viewer Home Directory[/var/opt/AppDynamics/viewer]
Using Java Version [1.6] for Lite Viewer
Starting adlite-viewer on port 8990.
2011-06-24 23:33:28.858::INFO:  Logging to STDERR via org.mortbay.log.StdErrLog
2011-06-24 23:33:28.894::INFO:  jetty-
2011-06-24 23:33:29.037::INFO:  Extract jar:file:/var/opt/AppDynamics/viewer/adlite-viewer.jar!/ to /tmp/Jetty_0_0_0_0_8990_adlite-viewer.jar____-x5l502/webapp
2011-06-24 23:33:29.679::INFO:  NO JSP Support for /, did not find org.apache.jasper.servlet.JspServlet
Logging Configuration File[/var/opt/AppDynamics/viewer/log4j.xml]
23:33:30,150  INFO [main] AgentHandlerServlet - *****************************************************************
23:33:30,151  INFO [main] AgentHandlerServlet - Starting  ....AppDynamics Lite Viewer 0.91 Beta Build Date 2011-02-01 12:11:15
23:33:30,241  INFO [main] FileStore - Configuration File [/var/opt/AppDynamics/viewer/configuration.xml]
23:33:30,536  INFO [main] DirectoryResolver - Deleting directory [/var/opt/AppDynamics/viewer/data]
23:33:30,539  INFO [main] FileStoreManager - Initialized Data Directory [/var/opt/AppDynamics/viewer/data]
23:33:30,545  INFO [main] FileStoreManager - Data File /var/opt/AppDynamics/viewer/data/data.ser_1308951210539 created at Fri Jun 24  23:33:30 CEST 2011
ON ROATE FILESTORE: com.appdynamics.lite.viewer.nb@67c7980c
ON ROATE FILESTORE: com.appdynamics.lite.viewer.v@11568fb5
ON ROATE FILESTORE: com.appdynamics.lite.viewer.ab@49f4bcf7
2011-06-24 23:33:30.974::INFO:  Started SocketConnector @ 0.0.0.0:8990
Type 'shutdown' to shutdown the viewer process



 Viewer Lite Shell:>

Ceci permet d'ajouter un minimum de sécurité, même si les informations de connexion sont disponibles au niveau des process en cours:

ps a | grep --color=auto Admin | grep -v grep
 3626 pts/1    S+     0:00 java -Dadlite.port=8990 -jar -Dadlite.user=AppDynamicsAdmin -Dadlite.password=AdminPassword adlite-viewer.jar


Modification avec spécification de l'emplacement

Les deux derniers paramètres permettent de spécifier l'emplacement de décompression, -Ddata.dir de l'application ainsi que le lieu de stockage des données, -Dadlite.directory. Pour cette installation, les données seront stockées dans /src/AppDynamics/viewer/datas et la décompression s'effectuera dans /var/opt/AppDynamics/viewer/webapp. Il est donc nécessaire de créer ces répertoires:

sudo mkdir /srv/AppDynamics
sudo mkdir /srv/AppDynamics/viewer
sudo mkdir /srv/AppDynamics/viewer/datas
sudo mkdir /var/opt/AppDynamics/viewer/webapp

La commande d'exécution devient:

java -Dadlite.port=8990 -Ddata.dir=/srv/AppDynamics/viewer/datas 
-Dadlite.directory=/var/opt/AppDynamics/viewer/webapp -Dadlite.user=AppDynamicsAdmin 
-Dadlite.password=AdminPassword -jar adlite-viewer.jar

Cependant, sur la version testée, ce paramètre n'est pas pris en compte. Une demande a été formulée au niveau du support: http://liteforums.appdynamics.com/discussion/208/viewer-startup-data.dir-is-ignore


Exécution

Il est préférable que le serveur soit démarré avant l'agent. Cependant, si ce n'est pas le cas, l'agent se référencera plus tard. Lorsque l'agent contacte le viewer, un message dans la console de ce dernier est affiché: