jboss Archives - Software Evolutivo

JBoss EAP: Configuración de la memoria

Jorge Aguilar — Thu, 13 Oct 2022 20:41:50 +0000

Una de las tareas de afinamiento más comunes luego de comenzar a operar un servidor de aplicaciones Java suele ser el ajuste de la memoria que utiliza el Java Virtual Machine (JVM). Por defecto, cierta cantidad de memoria es asignada al momento de iniciar el JVM, esta memoria es utilizada para alojar los objetos creados por las aplicaciones y para mantener otra información creada durante la ejecución de las mismas. El valor inicial suele ser suficiente para iniciar a operar pero ciertas aplicaciones necesitarán una mayor cantidad de recursos ya sea de entrada o con el tiempo para cubrir una mayor demanda por parte de los usuarios.

Si la cantidad de memoria asignada es insuficiente para la demanda inicial de las aplicaciones o para soportar la carga que reciban éstas, entonces eventualmente se podría experimentar lentitud o la cancelación de las peticiones, llegando a la temida excepción de Java: java.lang.OutOfMemoryError, que se presenta cuando el JVM es incapaz de crear un objeto en memoria y en este punto será necesario reiniciar el servidor, con la correspondiente afectación a los usuarios conectado o nuevos que estén por llegar.

En esta entrada se va a considerar los pasos a seguir para modificar la cantidad de memoria que es asignada al JVM del servidor de aplicaciones JBoss Enterprise Application Platform (EAP) en su versión 7 en modo Standalone y utilizando Java 11, aunque para Java 8 los pasos son similares.

El punto de partida será que contamos con servidor JBoss EAP instalado y aplicada su configuración básica. Para llegar a este punto se puede tomar como referencia la entrega inicial de esta serie de artículos: JBoss EAP: Instalación y configuración básica

Algunos conceptos básicos

Tipos de memoria

En Java 11 existen dos tipos principales de memoria del JVM:

Heap

Corresponde al espacio donde se alojarán los objetos y arreglos que son utilizados por las aplicaciones. El tamaño del Heap varía mientras se ejecutan las aplicaciones.

Existen dos parámetros que podemos utilizar para modificar el espacio utilizado por el Heap, éstos son:

-Xms: Valor inicial

-Xmx: Valor máximo que podría tomar
Non-heap

El espacio más relevante dentro de lo que no sea Heap se lo conoce como Metaspace y es donde se almacena la metadata, estructura de las clases, constantes, valores de los String, entre otros.

Desde la versión 8 de Java encontramos los siguientes parámetros para lo que se conoce como Metaspace:

-XX:MetaspaceSize: Valor inicial para almacenar los elementos del Non-heap

-XX:MaxMetaspaceSize: Valor máximo que podría tomar el espacio de Non-heap

Nota: Antes de Java 8, se lo conoce como Permanent Gen y los parámetros eran -XX:PermSize y -XX:MaxPermSize, equivalentes a los antes mencionados.

Gestión de la memoria

Es bien conocido que como desarrolladores no tenemos que liberar de manera explícita la memoria que ya no estemos utilizando, a diferencia de otros lenguajes de programación como C++. Y ésto es debido a que Java dispone del Garbage Collector, un componente del JVM que es el encargado de monitorear y liberar el espacio de memoria que ya no está en uso.

Procedimiento de ajuste de la memoria

Heap

Cuando encontremos la excepción java.lang.OutOfMemoryError en el archivo de log ($EAP_HOME/standalone/server.log) de JBoss EAP podremos tener la certeza de que se va a requerir un incremento en la memoria Heap.

Para el modo Standalone de JBoss EAP simplemente se deberá cambiar el archivo standalone.conf, el cuál está ubicado en el directorio $EAP_HOME/bin/

Según el archivo del ejemplo, se puede ver que en línea 53 están los valores correspondientes para -Xms y -Xmx, en este caso ambos establecidos en 1303 MB.

NOTA: Para ambientes productivos se recomienda establecer -Xms y -Xmx con el mismo valor, así no se tiene que gestionar el incremento hasta el valor máximo sino que ya está establecido de antemano.

Metaspace

Usualmente no existe la necesidad de especificar un tamaño máximo para Metaspace a menos que se esté presentando una pérdida de memoria (memory leak), que resulta de la falta de liberación de la misma una vez que ya no se la necesita, afectando al rendimiento del servidor.

Conclusiones

Dentro de los ajustes que podemos hacer a un servidor de aplicaciones, como JBoss EAP, el espacio Heap es el principal ya que es el más dependiente de la dinámica de nuestras aplicaciones y de la exigencia que reciba por parte de sus clientes.

La modificación del tamaño del espacio Heap es una tarea sencilla pero requiere el reinicio del servidor de aplicaciones, y como pudimos evidenciar son instrucciones que recibe el JVM al momento de iniciar el mismo. Estos parámetros son los mismo que aplican para cualquier servidor de aplicaciones que se ejecute sobre la máquina virtual de Java (JVM).

Otras modificaciones, como el cambio del Metaspace no son tan habituales, sin embargo podría ser necesarias cuando las aplicaciones mantienen un número extenso de clases o gestionan muchos valores del tipo String.

Te hacemos una cordial invitación ya que en próximas entradas del blog habrá más contenido sobre esta temática. Hasta pronto.

The post JBoss EAP: Configuración de la memoria appeared first on Software Evolutivo.

JBoss EAP: Instalación y configuración básica

Jorge Aguilar — Thu, 12 May 2022 00:59:03 +0000

En esta primera entrega, de la serie de artículos relacionados a JBoss Enterprise Application Platform (EAP), vamos a considerar la instalación y configuración inicial del producto, de tal manera que podamos contar con los servicios suficientes para un despliegue en un ambiente de pruebas o que sea el primer paso para tener una instancia candidata a producción.

JBoss EAP es una plataforma de código abierto que ofrece seguridad, escalabilidad y rendimiento a nivel empresarial para aplicaciones Java. Incluyen todo lo que se necesita para crear, ejecutar, implementar y administrar aplicaciones Java empresariales en cualquier entorno.

Si bien JBoss EAP está disponible como imagen de contenedor o como un operador de Kubernetes u Openshift, en este caso vamos a utilizar los binarios tradicionales para hacer una instalación desde cero, lo que nos permitirá tener un mayor entendimiento de los requisitos para su operación.

Requisitos

Antes de iniciar, se espera que podamos contar con lo siguiente:

Servidor Linux: Los comandos que se presentan son compatibles con CentOS 8 o Red Hat Enterprise Linux 8
Disponer del utilitario unzip para descomprimir el binario de JBoss EAP
Tener instalado y configurado Java 1.8 u 11. El detalle de las configuraciones soportadas se pueden encontrar en la siguiente enlace: https://access.redhat.com/articles/2026253#EAP_74
Archivo empaquetado de JBoss EAP 7.4: Se puede descargar el Zip File desde la siguiente dirección: https://developers.redhat.com/products/eap/download

Configuración por defecto

JBoss EAP mantiene la siguiente configuración inicial:

No existen usuarios de administración de JBoss EAP, es necesario crear al menos uno para administrar el servicio remotamente. Este usuario será creado más adelante.
Solamente se escucha en la interfaz 127.0.0.1 (localhost), es decir que solamente están disponibles los servicios desde el mismo servidor.
Los puertos de los servicios principales son:
- Aplicaciones HTTP: 8080
- Aplicaciones HTTPS: 8443
- Administración (Web y por línea de comandos): 9990

Alcance de la instalación y configuración

Esta guía cubre los siguientes puntos:

Instalación de los binarios
Creación del usuario administrador de JBoss EAP
Apertura de las interfaces de red para el acceso remoto

Procedimiento de instalación y configuración

Instalación de los binarios

Se va a necesitar un usuario de sistema operativo (En este caso eap), diferente al usuario root, para levantar los servicios. Como el usuario root ejecutamos este y los siguientes comandos:

# useradd eap

NOTA: Este usuario es diferente al usuario administrador de JBoss EAP (eapadmin) que se creará en el punto 4 de esta sección.
Creación del directorio Home de JBoss EAP, descompresión del archivo empaquetado y asignación de permisos al usuario eap:

# mkdir /opt/jboss/ # cd /opt/jboss/ # unzip /tmp/jboss-eap-7.4.0.zip # chown -R eap:eap /opt/jboss/
Configuración de variables de ambiente para que el usuario eap disponga de los ejecutables de JBoss EAP en el PATH de su sesión:

# echo 'export EAP_HOME=/opt/jboss/jboss-eap-7.4' >> ~eap/.bash_profile # echo 'export PATH=$PATH:$EAP_HOME/bin' >> ~eap/.bash_profile
Crear el usuario administrador de JBoss EAP (eapadmin) con su respectiva contraseña. Hacemos el cambio al usuario eap del sistema operativo para luego ejecutar la creación del usuario:

# su - eap $ add-user.sh -u 'eapadmin' -p '********'

Inicio del servicio y validación de la configuración de red

Utilizando la misma sesión del usuario eap, ejecutamos el script de inicio para subir el servicio en modo Standalone:

$ standalone.sh

NOTA: La terminal quedará ocupada, la dejaremos abierta para no terminar el proceso.
Abrimos una nueva sesión con el usuario eap para confirmar los puertos que fueron abiertos por el servicio:

$ ss -ltn | grep -e 8080 -e 8443 -e 9990

Como lo muestra el comando ss, por defecto JBoss EAP escucha solamente en 127.0.0.1 (localhost).

Actualización de la dirección enlazada a las interfaces de red

Mediante la administración por línea de comandos (JBoss CLI) vamos a consultar la dirección enlazada a la interfaz pública (public: donde estarán disponibles las aplicaciones, puerto 8080 y 8443) para luego cambiarla por el nombre del servidor (server.example.com en este caso) o por su dirección IP:

$ jboss-cli.sh --connect [standalone@localhost:9990 /] /interface=public:read-attribute(name=inet-address)

[standalone@localhost:9990 /] /interface=public:write-attribute(name=inet-address,value="${jboss.bind.address:server.example.com}")
Realizamos algo similar pero con la interfaz de administración (management: servicio de administración, puerto 9990):

[standalone@localhost:9990 /] /interface=management:read-attribute(name=inet-address)

[standalone@localhost:9990 /] /interface=management:write-attribute(name=inet-address,value="${jboss.bind.address.management:server.example.com}")
Procedemos a recargar la configuración del servidor ya que los cambios anteriores requieren de un reinicio del servicio de JBoss EAP. Luego de esto, la sesión de JBoss CLI terminará debido a que ya no es válida por el cambio de la interfaz de administración:

[standalone@localhost:9990 /] reload [disconnected /] exit
Verificamos el cambio en la configuración de red utilizando nuevamente JBoss CLI, la conexión ahora debe indicar el nombre del controller de JBoss EAP (servidor y puerto) donde está el servicio de administración:

$ jboss-cli.sh --connect --controller=server.example.com:9990 [standalone@server.example.com:9990 /] /interface=public:read-attribute(name=inet-address)

[standalone@server.example.com:9990 /] /interface=management:read-attribute(name=inet-address)
Si el servidor Linux tiene levantado el servicio de Firewall será necesario abrir los puertos que utiliza JBoss, para el caso de CentOS 8 o Red Hat Enterprise Linux 8, como usuario root, se puede utilizar lo siguiente:

# firewall-cmd --list-ports # firewall-cmd --add-port 8080/tcp # firewall-cmd --add-port 8443/tcp # firewall-cmd --add-port 9990/tcp # firewall-cmd --runtime-to-permanent # firewall-cmd --list-ports
Finalmente probamos el acceso a los servicios desde un navegador Web:
- http://server.example.com:8080/
- https://server.example.com:8443/
- http://server.example.com:9990/

Conclusiones

JBoss Enterprise Application Platform trae por defecto una configuración que es suficiente para un ambiente de desarrollo pero va a ser necesario aplicar ajustes como los que hemos visto en este artículo para poder hacer uso de sus servicios en escenarios más demandantes.

Les hacemos la invitación a estar atentos ya que en próximas entregas cubriremos otras áreas de la administración y configuración del producto. Hasta entonces.

The post JBoss EAP: Instalación y configuración básica appeared first on Software Evolutivo.

[:es]Implementación de Liferay 6.2 sobre JBoss 6.4.0 – Como[:]

Fernando Paz — Mon, 12 Sep 2016 17:00:42 +0000

[:es]

Esquema Instalación Liferay sobre JBoss usando Docker. Copyleft www.softwareevolutivo.com.ec

Liferay es un producto para gestionar portales empresariales de información, construido sobre Java y con licenciamiento en Software libre LGPL define a esta tecnología como uno de los actores más importante y con mayores implementaciones en el mercado.

Animados por nuestros valores empresariales que considera al conocimiento como fin social, dejamos una experiencia acerca de este portal y su despliegue en infraestructuras de software modernas.

Antes de continuar con la implementación nos referimos a los productos que usamos como software base:

Docker es una tecnología que implementa contenedores livianos que complementan o sustituyen a las estrategias de virtualización tradicionales. Dado el aprovechamiento masivo del hardware y su rápido despliegue y replicación, es muy utilizado en la tendencia actual de la industria especialmente en áreas como: desarrollo de software, implementación de estrategias de entrega continua y provisión de ambientes de producción con alto crecimiento por demanda.
JBoss EAP, es la versión empresarial de Redhat de un servidor de aplicaciones JEE, con una alta ocupación del mercado y una comprobada comunidad que lo desarrolla y potencia.

Instalación:

El desarrollo de esta instalación de Liferay, está apoyada por documentación existente en proyectos complementarios a este objetivo. Los pasos de estos proyectos complementarios, que serán detallados a continuación, cubren las siguientes actividades:

Definición y creación de un contenedor Docker que contenga una implementación activa del servidor de aplicaciones JBoss 6.4.0.
Definición y creación de un contenedor Docker, a partir del contenedor anterior, que contenga una instalación activa del software Liferay 6.2.
Configuración inicial de software Liferay 6.2.

Docker JBoss 6.4.0:

El primer paso es crear el contenedor Docker que soporte al servidor de aplicaciones JBoss 6.4.0, para este fin se puede revisar otra referencia de cómo podemos realizar esta implementación en https://github.com/pazfernando/jboss-eap-6.4.0-docker.

Es muy importante, en este punto, revisar el README.md de este proyecto debido a que previamente requieren descargar por su cuenta la distribución de JBoss (por cuestiones de licencia) y adicionalmente el contenedor se crea con el nombre “jboss-eap:6.4.0” que es con el que partiremos esta instalación de Liferay 6.2.

Docker Liferay 6.2:

La propuesta de esta implementación de Liferay se basa en el contenedor anterior. La siguiente actividad será crear el contenedor Docker mismo de Liferay a partir del proyecto https://github.com/pazfernando/liferay-6.2-jboss-eap-6.4.0-docker. Este proyecto usa el nombre “jboss-eap:6.4.0” como base de su implementación, y apoyado en esta infraestructura instala el producto Liferay. Para la consecución de esta actividad se debe seguir las instrucciones del archivo README.md.

El nombre “jboss-eap:6.4.0” por su puesto puede cambiar pero requerirá que esté coordinado con el primer proyecto base.

Configuración Liferay 6.2:

Esperamos que en este punto tengan instalado Liferay en esta infraestructura correctamente; Liferay en adelante tiene un wizard el cual lo guiará con los pasos de configuración y datos iniciales. Hasta este momento y como pueden haberlo advertido, no se ha mencionado la base de datos, puesto que la definición de la misma es parte del wizard inicial de configuración de Liferay. Nuestra implementación ha sido pensada para ejecutar el producto sobre el motor Oracle 11g, para lo cual se ha adjuntado y configurado el driver en las actividades previas anteriores.

Recomendaciones finales:

Este proyecto por supuesto es una implementación de una solución para ambientes de desarrollo o testing y requerirá de varios cambios para pensar en una automatización en producción.

Si se requiere profundizar en las configuraciones del producto Liferay en la tecnología JBoss, se puede partir de la URL: https://dev.liferay.com/discover/deployment/-/knowledge_base/6-2/installing-liferay-on-jboss-7-1, estas configuraciones se han automatizado en el contenedor Docker utilizado en este tutorial. Básicamente son los mismos pasos, pero existen especificaciones concretas debido a que JBoss 7.2 fue la última versión antes de que Redhat lo renombrara como JBoss EAP Alpha 6.2; y de ahí en adelante al ser la versión comercial tiene ciertas diferencias a las versión Wildfly que es la comunitaria.

Adicionalmente y como siempre si tiene dudas, comentarios, erratas o algo que decir 🙂 los animamos a comentar en este blog para todos tener un mejor conocimiento y entendimiento.[:]

The post [:es]Implementación de Liferay 6.2 sobre JBoss 6.4.0 – Como[:] appeared first on Software Evolutivo.