Instalación manual en un servidor JBoss o servidor JBoss Service

Esta sección describe cómo instalar manualmente el agente de glass box en un servidor JBoss o servidor JBoss Service.

Acerca de esta tarea

Cuando se instala AppScan, los archivos necesarios para instalar el agente de servidor se guardan en una carpeta dedicada en la máquina. Para llevar a cabo esta tarea deberá acceder a esta carpeta y al servidor de aplicaciones.

Procedimiento

Abra ...\Archivos de programa\IBM\AppScan Standard\Glass box
La vía de acceso absoluta dependerá de donde haya instalado AppScan.
Localice GB_Java_Manual_Setup.zip y cópielo a su servidor web.
Extraiga el contenido de esta carpeta en la ubicación deseada del servidor web.
Defina un nombre de usuario y una contraseña para el agente (utilice únicamente caracteres ASCII ingleses):
- Servidor Linux: Ejecute AgentCredentials.sh <nombre_usuario> <contraseña>
  Nota: AgentCredentials.sh debe tener permisos de ejecución.
- Servidor Windows: Ejecute AgentCredentials.bat <nombre_usuario> <contraseña>
Desplegar la aplicación web GBootStrap:
1. Inicie sesión en la consola de administración de JBoss. La ubicación predeterminada es http://<nombre_servidor>:<número_puerto>/admin-console/
2. Pulse Aplicaciones > WAR de aplicación web y pulse Añadir un recurso nuevo.
3. Escriba la vía de acceso para GBootStrap.war (que se encuentra en la carpeta de glass box que ha extraído) y pulse Continuar.
Un mensaje conforma que el recurso se ha creado correctamente.
Concluya el servicio/servidor JBoss.
Proporcione el agente de Java gbAgent.jar (que se encuentra en la carpeta que ha extraído) como un argumento JVM, realizando una de las acciones siguientes:
- Por medio de la variable de entorno: configure la JVM de JBoss a través de la variable de entorno JAVA_OPTS (si no existe, créela), con el valor:
```
-javaagent:"<vía_a_gbAgent.jar>/gbAgent.jar"
-Djava.net.preferIPv4Stack=true
-Djboss.modules.system.pkgs=com.ibm.glassbox.asm.agent,
		com.ibm.glassbox.agent,com.ibm.glassbox.logger,
		com.ibm.glassbox.jsp,org.jboss.byteman
```
- Por medio de scripts por lotes batch/sh: pase argumentos al JBoss que ejecuta la JVM editando los archivos de configuración que se incluyen con el servidor:
  Servidor Linux:
  1. En la carpeta JBoss busque y abra el archivo adecuado en un editor (que suele estar en /bin):
    - JBoss AS: run.sh
    - JBoss EAP Standalone: standalone.sh
    - JBoss EAP Managed Domain: domain.sh
  2. Localice una línea que empieza por JAVA_OPTS y añada el código siguiente justo debajo:
```
export JAVA_OPTS=$JAVA_OPTS "-javaagent:<vía_a_gbAgent.jar>/gbAgent.jar"
-Djava.net.preferIPv4Stack=true
-Djboss.modules.system.pkgs=com.ibm.glassbox.asm.agent,
		com.ibm.glassbox.agent,
		com.ibm.glassbox.logger,
		com.ibm.glassbox.jsp,org.jboss.byteman
```
  3. Guarde y cierre el archivo.
  Servidor Windows:
  1. En la carpeta JBoss busque y abra el archivo adecuado en un editor (que suele estar en /bin):
    - JBoss AS: run.conf
    - JBoss EAP Standalone: standalone.conf
    - JBoss EAP Managed Domain: domain.conf
  2. Localice una línea que empieza por set JAVA_OPTS= y añada la línea siguiente justo debajo:
```
set JAVA_OPTS=$JAVA_OPTS "-javaagent:<vía_a_gbAgent.jar>\gbAgent.jar"
-Djava.net.preferIPv4Stack=true
-Djboss.modules.system.pkgs=com.ibm.glassbox.asm.agent,
		com.ibm.glassbox.agent,com.ibm.glassbox.logger,
		com.ibm.glassbox.jsp,org.jboss.byteman"
```
  3. Guarde y cierre el archivo.
Importante: Asegúrese de que JAVA_OPTS se inicializa sólo una vez, y antes de las líneas anteriores, para que otras asignaciones de JAVA_OPTS no prevalezcan (cambien) sobre -javaagent.

Nota: Para añadir argumentos a to JAVA_OPTS, use el convenio %JAVA_OPTS% / $ JAVA_OPTS.
Reinicie el servicio/servidor JBoss.