# Configuración
**INSTALACIÓN DE JOLOKIA**
Descargue el agente Jolokia de la web oficial: [https://jolokia.org/download.html](https://jolokia.org/download.html)
**Securización del agente Jolokia (WAR)** Puede asignar políticas de seguridad para restringir tanto el acceso como el uso de las opciones disponibles en el agente Jolokia.
Estas restricciones pueden especificarse en un fichero XML de políticas. Este fichero está dividido en secciones con las que podrá controlar varios parámetros:
Restricciones basadas en IP
El acceso general puede ser permitido basándose en la dirección IP de un cliente HTTP. Esta restricción se especifica en la sección<remote> , contendrá elementos <host> . El origen puede ser una dirección IP, un nombre de host, o una red en formato CIDR.
El ejemplo siguiente permite el acceso desde localhost y todos los clientes de la red
10.0.0.0/16:
```
localhost
10.0.0.0/16
```
Restricciones de comandos
Puede restringir los comandos que se permitirán ejecutar de manera general, indicando aquellos que se permitan. Para ello se utilizará la sección <commands> especificando cada comando con un elemento <command> .
El ejemplo siguiente habilita los comandos READ, LIST, SEARCH y VERSION . El resto de comandos ( WRITE, EXEC ) no estarían disponibles:
```
read
list
version
search
```
Existen restricciones de consultas de mbeans y orígenes de peticiones. Puede consultar la ayuda completa en el siguiente enlace: [https://jolokia.org/reference/html/security.html](https://jolokia.org/reference/html/security.html)
**Ejemplo de política de seguridad**
En este ejemplo se permite la conexión desde localhost y la red 10.0.0.0/16. También se limitan los comandos disponibles a READ,LIST,VERSION y SEARCH
```
127.0.0.1
localhost
10.0.0.0/16
read
list
version
search
post
```
**Inclusión de una política de seguridad**
Para reempaquetar una política en el archivo WAR del agente Jolokia deberá seguir los
siguientes pasos:
```
# Descargue el agente WAR
$ jolokia
```
Nota: Puede descargarlo manualmente de: [http://search.maven.org/remotecontent?filepath=org/jolokia/jolokia-war/1.5.0/jolokiawar-1.5.0.war](http://search.maven.org/remotecontent?filepath=org/jolokia/jolokia-war/1.5.0/jolokiawar-1.5.0.war)
```
# Descargue la plantilla de política de ejemplo
# en el directorio local como “jolokia-access.xml”
$ jolokia download --policy
```
Nota : Si ha recibido errores al ejecutar los pasos previos, puede descargar la política de ejemplo desde [http://www.jolokia.org/templates/jolokia-access.xml](http://www.jolokia.org/templates/jolokia-access.xml)
Edite la política y coloque el archivo jolokia-war-VERSION.war y el archivo jolokia-access.xml en el mismo directorio.
```
# Repack the to add the policy file 'jolokia-access.xml' form the cwd
$ jolokia repack --policy jolokia.war
```
Deberá recibir una salida similar a lo siguiente:
```
$ jolokia repack --policy jolokia-war-1.5.0.war
* Adding policy WEB-INF/classes/jolokia-access.xml to
jolokia-war-1.5.0.war
```
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626084627819.png)
Puede realizar una verificación del contenido del fichero WAR con el siguiente comando:
```
# Show current state (policy file include: yes/no)
$ jolokia jolokia.war
```
**Jolokia en WebSphere**
Para instalar el proxy en IBM Websphere. Realizar los siguientes pasos:
Seleccione en el menú lateral:
Aplicaciones > Nueva aplicación
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626084718348.png)
Seleccione el fichero WAR de Jolokia.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626084740556.png)
Pulse siguiente .
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626084759321.png)
Mantenga las opciones por defecto y pulse siguiente.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626084781286.png)
Modifique el nombre de la aplicación por “jolokia”, no es necesario realizar más cambios en esta pantalla. Presione siguiente.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626084805919.png)
Active la casilla de verificación para mapear la nueva aplicación con el servidor deseado. Pulse siguiente.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626084841984.png)
Active la casilla de verificación para mapear el host virtual por defecto. Pulse siguiente.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626084874603.png)
Ajuste el contexto raíz de la aplicación a /jolokia
Pulse siguiente.
Verifique el resumen. Pulse finalizar.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626084906736.png)
Verifique en el log presentado que la aplicación se ha instalado satisfactoriamente. Si es así presione “Guardar directamente a la configuración master”.
La aplicación ya está desplegada. Deberemos iniciarla para poder interactuar con ella desde el plugin de JMX.
Navegue a la lista de aplicaciones y seleccione “Jolokia”.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626084957590.png)
Deberá recibir un mensaje indicando que la aplicación se inició correctamente:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626084988980.png)
Puede validar la instalación de Jolokia en el enlace siguiente:
[https://localhost:9443/jolokia](https://localhost:9443/jolokia)
Debe recibir una salida en formato JSON con información general del agente Jolokia.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085035783.png)
**Jolokia en WebSphere con seguridad habilitada**
Para utilizar el plugin JMX para la extracción de datos de entornos IBM WebSphere con
seguridad habilitada, será necesario realizar modificaciones en la aplicación Jolokia (archivo
WAR).
Habilitar mapeo de seguridad para rol específico
Este paso agrega la información para el mapeo de roles al fichero jolokia.war, que
posteriormente desplegaremos en nuestro servidor de aplicaciones.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085239095.png)
Configuración del servidor de aplicaciones IBM WebSphere
Será necesario crear un usuario con permisos para supervisión (monitor). Usuarios y grupos > Administrar usuarios > Crear usuario
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085281629.png)
Y asignarle el rol específico “Monitor”: Usuarios y grupos > Administrar roles de usuario > Agregar
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085305510.png)
Una vez creado el usuario y asignado el rol correcto, realizamos el mapeo en la configuración de la aplicación Jolokia:
Aplicaciones > Aplicaciones de empresa > Jolokia > Mapeo rol de seguridad a usuario/grupo
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085336431.png)
Una vez realizada la configuración, guarde los cambios y reinicie la aplicación Jolokia.
NOTA : Se ha confirmado que en versiones antiguas de IBM WebSphere, existe la necesidad
de realizar el mapeo de usuarios agregando el grupo TODOS al mapeo con rol supervisor:
Los cambios a realizar son:
Activar “todos” y “todos autenticados” en el mapeo JMX – usuario en la configuración de
Jolokia:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085387520.png)
Enlazar las peticiones del grupo “Todos” en gestión de grupos:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085418644.png)
**Jolokia en Weblogic**
Pasos previos
Para garantizar la funcionalidad completa del plugin JMX en Weblogic, deberá verificar una serie de configuraciones previas. Si decide omitir estos pasos la monitorización podría estar limitada.
Nota : Si sus necesidades de monitorización se limitan al listado de aplicaciones, estado, número de invocaciones, consumo de recursos y estado general del servidor de aplicaciones, puede ignorar esta sección.
Acceda a la pantalla de configuración de servidores en:
Dominio base > Entorno > Servidores
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085520438.png)
Presione Bloquear y editar para habilitar la edición de la configuración:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085563865.png)
Haga clic sobre el servidor donde se desplegará la aplicación Jolokia:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085587237.png)
Habilite IIOP
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085613273.png)
Presione guardar .
Seleccione Dominio base en el menú
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085644466.png)
En la pestaña de Seguridad, habilitar Anonymous Admin Lookup:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085680332.png)
Despliegue de Jolokia
Acceda al apartado del menú
Estructura de dominio > Despliegues
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085731601.png)
En la pantalla que se le presenta, seleccione la opción Instalar
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085769184.png)
Seleccione el enlace upload your file(s) para mostrar el formulario de subida de ficheros:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085796012.png)
Seleccione el archivo WAR de Jolokia de su equipo y pulse siguiente :
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085822702.png)
La ubicación se habrá completado con la ruta de subida del fichero WAR. Presione siguiente
para iniciar el proceso de instalación.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085854145.png)
Seleccione el modelo de seguridad de roles personalizados y pulse siguiente .
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085884993.png)
Actualice el nombre del despliegue y mantenga la configuración propuesta.
Pulse siguiente .
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085909696.png)
Pulse Finalizar .
En este paso, la aplicación se encuentra desplegada en el servidor de aplicaciones JMX. En
la pestaña Configuración , seleccione el punto de entrada desde donde se atenderá el
servicio, configurando el “contexto raíz”:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085938347.png)
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085949006.png)
Pulse guardar para salvar los cambios.
Presione Activar cambios para aplicar los cambios.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626085985386.png)
Una vez aplicados los cambios, se mostrará la aplicación Jolokia preparada para ser
iniciada:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626086010612.png)
Seleccione la casilla de verificación y pulse iniciar > Iniciar todas las peticiones
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626086042869.png)
Tras el proceso de arranque, la aplicación aparecerá como Activa .
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626086069241.png)
Edite el rol de seguridad de la aplicación para agregar las condiciones de acceso que desee (permitir grupos, usuarios, etc.)
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626086096261.png)
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626086107619.png)
Puede validar la instalación de Jolokia en el enlace siguiente:
[https://localhost:7001/jolokia](https://localhost:7001/jolokia)
Debe recibir una salida en formato JSON con información general del agente Jolokia.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626086146811.png)
**Jolokia en Apache Kafka**
Para monitorizar un servidor Apache Kafka se requiere el agente JVM Jolokia en vez del agente WAR. Basta con descargarlo de la página oficial:
[https://jolokia.org/download.html](https://jolokia.org/download.html)
Sacamos el PID del servidor Apache Kafka:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1626086227024.png)
Y relacionamos el agente JVM con el servidor mediante éste con
```
$ java –jar agente.jar start pid
```
Puede validar la instalación de Jolokia en el enlace siguiente:
[http://localhost:8778/jolokia/](http://localhost:8778/jolokia/)
**INSTALACIÓN DE JMX4PERL**
En el equipo donde ejecutará el plugin JMX deberá instalar las librerías Perl necesarias:
```
JMX::Jmx4Perl
JMX::Jmx4Perl::Alias
JMX::Jmx4Perl::Request
```
Para instalar las librerías necesita conexión a internet y CPAN.
```
# cpan install JMX::Jmx4Perl
```
Aunque las aplicaciones siguientes son extremadamente útiles para explorar los mbean de nuestros servidores de aplicaciones, es posible que den conflicto por librerías o paquetes pendientes de instalar.
```
jmx4perl
check_jmx4perl
j4psh
```
En un entorno de producción recomendamos ignorar las sugerencias de aplicaciones adicionales e instalar únicamente la librería JMX::Jmx4Perl.
Responda no a todas las peticiones de instalación de componentes adicionales:
```
Install 'jmx4perl' ? (y/n) [y ]n
Install 'check_jmx4perl' ? (y/n) [y ]n
Install 'cacti_jmx4perl' ? (y/n) [y ]n
Install 'j4psh' ? (y/n) [y ]n
```