Darrin Mison
Misty Stanley-Jones
Tom Wells
Plataforma de aplicaciones
empresariales JBoss 6.2
Guía de Instalación
Para uso con la plataforma de aplicaciones empresariales JBoss de Red
Hat
Para uso con la plataforma de aplicaciones empresariales JBoss de Red
Hat
Edición 1
Darrin Mison Misty Stanley-Jones [email protected] Tom Wells [email protected]Copyright © 2014 Red Hat, Inc..
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux ® is the registered trademark of Linus Torvalds in the United States and other countries. Java ® is a registered trademark of Oracle and/or its affiliates.
XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js ® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack ® Word Mark and OpenStack Logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Abstract
Este libro es un manual para la instalación de la plataforma de aplicaciones empresariales JBoss 6 y sus lanzamientos de parches.
. . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents
Prefacio1. Convenciones del Documento 1.1. Convenciones tipográficas 1.2. Convenciones del documento 1.3. Notas y Advertencias
2. Cómo obtener ayuda y hacer sus comentarios 2.1. ¿Necesita ayuda?
2.2. ¡Necesitamos sus comentarios!
Capítulo 1. Sinopsis del producto
1.1. Plataforma de aplicaciones empresariales JBoss de Red Hat (JBoss EAP 6) 1.2. Funcionalidades de JBoss EAP 6
Capítulo 2. Introducción
2.1. Sobre el portal del cliente de Red Hat
Capítulo 3. Requerimientos del sistema
3.1. Prerequisitos de instalación de JBoss EAP 6
Capítulo 4. Instrucciones de instalación
4.1. Métodos de instalación de JBoss EAP 6 4.2. Instalación zip
4.2.1. Descargar JBoss EAP 6 (instalación zip) 4.2.2. Instalación de JBoss EAP 6 (instalación zip) 4.2.3. Desinstalación de JBoss EAP 6 (instalación zip) 4.3. Instalador
4.3.1. Descargar JBoss EAP 6 (instalador)
4.3.2. Ejecute el instalador de la plataforma de aplicaciones empresariales JBoss 4.3.3. Desinstalar JBoss EAP 6 (instalador)
4.4. Instalación gráfica RPM
4.4.1. Instalación de JBoss EAP 6 (instalación gráfica RPM) 4.5. Instalación RPM basada en texto
4.5.1. Instalación de JBoss EAP 6 (instalación RPM basada en texto) 4.6. Instalación automatizada
4.6.1. Instalación de múltiples instancias de JBoss EAP 6 (instalador) 4.7. Configuración de servicios
4.7.1. Configuración de JBoss EAP 6 como un servicio en Red Hat Enterprise Linux (método RPM)
4.7.2. Configuración de JBoss EAP 6 como un servicio en Red Hat Enterprise Linux (zip, instalador)
4.7.3. Configuración de JBoss EAP 6 como servicio en el servidor de Microsoft Windows (zip, instalador)
Capítulo 5. Aplicación de parches y actualización de JBoss EAP 6
5.1. Parches y actualizaciones 5.2. Instalación de parches
5.2.1. Mecanismos para uso de parches
5.2.2. Suscripción a las listas de correo de parches 5.2.3. Instalación de parches en forma zip
5.2.3.1. El comando patch
5.2.3.2. Instalación de parches en forma zip usando el comando patch
5.2.3.3. Deshacer la aplicación de un parche en forma zip usando el comando patch 5.2.4. Instalación de parches en forma RPM
4 4 4 5 6 6 6 7 8 8 8 10 10 11 11 12 12 12 12 13 13 14 14 15 18 19 19 20 20 21 21 21 21 22 23 27 27 27 27 28 28 28 30 31 32
. . . .
. . . .
. . . . 5.2.5. Clasificación de severidad e impacto de los parches de seguridad de JBoss
5.3. Instrucciones de actualización
5.3.1. Actualización de la instalación ZIP de JBoss EAP 6 5.3.2. Actualización de la instalación RPM de JBoss EAP 6 5.3.3. Actualización del clúster JBoss EAP de 6.0 a 6.1
Material de referencia
A.1. Descargas disponibles para JBoss EAP 6 A.2. Estructura de directorios de JBoss EAP 6 A.3. Lista de paquetes RPM para JBoss EAP 6
A.4. Archivos de configuración de la instalación RPM para JBoss EAP 6
Tomas de pantalla del instalador
B.1. Selección del idioma
B.2. Acuerdo de licencia del usuario final B.3. Ruta de instalación
B.4. Creación del usuario administrativo B.5. Instalación de inicio rápido
B.6. Configuración JDK
B.7. Configuración del repositorio Maven B.8. Instalación del paquete
B.9. Configuración de enlace de sockets
B.10. Configuración (autónoma) de enlaces de socket B.11. Configuración de enlaces de socket (dominio)
B.12. Configuración de enlaces de socket Bindings (dominio ha) B.13. Configuración de enlaces de socket (dominio completo)
B.14. Configuración de enlaces de socket Bindings (dominio ha completo)
Historial de revisiones 34 35 35 36 37 39 39 41 44 45 48 48 48 49 50 51 52 53 54 55 56 57 58 59 60 62
Prefacio
1. Convenciones del Documento
Este manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atención sobre ciertas partes específicas de información.
En ediciones PDF y de papel, este manual utiliza tipos de letra procedentes de Liberation Fonts. Liberation Fonts también se utilizan en ediciones de HTML si están instalados en su sistema. Si no, se muestran tipografías alternativas pero equivalentes. Nota: Red Hat Enterprise Linux 5 y siguientes incluyen Liberation Fonts predeterminadas.
1.1. Convenciones tipográficas
Se utilizan cuatro convenciones tipográficas para llamar la atención sobre palabras o frases específicas. Dichas convenciones y las circunstancias en que se aplican son las siguientes:
Negrita m onoespaciado
Utilizado para resaltar la entrada del sistema, incluyendo los comandos de shell, nombres de archivos y rutas. También sirve para resaltar teclas y combinaciones de teclas. Por ejemplo:
Para ver el contenido del archivo my_next_bestselling_novel en su directorio actual de trabajo, escriba el comando cat my_next_bestselling_novel en el intérprete de comandos de shell y pulse Enter para ejecutar el comando.
El ejemplo anterior incluye un nombre de archivo, un comando de shell y una tecla . Todo se presenta en negrita-monoespaciado y distinguible gracias al contexto.
Las combinaciones de teclas se pueden distinguir de las individuales con el signo más que conecta cada partee de la combinación de tecla. Por ejemplo:
Pulse Enter para ejecutar el comando.
Pulse Ctrl+Alt+F2 para pasar a una terminal virtual.
El primer ejemplo resalta una tecla particular a pulsar. El segundo ejemplo, resalta una combinación de teclas: un set de tres teclas pulsadas simultáneamente.
Si se discute el código fuente, los nombres de las clase, los métodos, las funciones, los nombres de variables y valores de retorno mencionados dentro de un párrafo serán presentados en
Negrita-m onoespaciado. Por ejeNegrita-mplo:
Las clases de archivo relacionadas incluyen filename para sistema de archivos, file para archivos y dir para directorios. Cada clase tiene su propio conjunto asociado de permisos.
Negrita proporcional
Esta denota palabras o frases encontradas en un sistema, incluyendo nombres de aplicación, texto de cuadro de diálogo, botones etiquetados, etiquetas de cajilla de verificación y botón de radio; títulos de menú y títulos del submenú. Por ejemplo:
Seleccione Sistema → Preferencias → Ratón desde la barra del menú principal para lanzar Preferencias de ratón. En la pestaña de Botones, seleccione la cajilla de ratón
de m ano izquierda y luego haga clic en Cerrar para cambiar el botón principal del
ratón de la izquierda a la derecha (adecuando el ratón para la mano izquierda). Para insertar un carácter especial en un archivo gedit, seleccione Aplicaciones →
Accesorios → Mapa de caracteres de la barra del menú. Luego, seleccione Búsqueda → Buscar… de la barra del menú de Mapa de caracteres, escriba el nombre del carácter en
el campo de Búsqueda y haga clic en Siguiente. El carácter que buscó será resaltado en la Tabla de caracteres. Haga doble clic en ese carácter resaltado para colocarlo en el campo de Texto a copiar y luego haga clic en el botón Copiar. Ahora regrese al documento y elija Modificar → Pegar de la barra de menú de gedit.
El texto anterior incluye nombres de aplicación; nombres y elementos del menú de todo el sistema; nombres de menú de aplicaciones específicas y botones y texto hallados dentro de una interfaz gráfica de usuario, todos presentados en negrita proporcional y distinguibles por contexto.
Itálicas-negrita monoespaciado o Itálicas-negrita proporcional
Ya sea negrita monoespaciado o negrita proporcional, la adición de itálicas indica texto reemplazable o variable. Las itálicas denotan texto que usted no escribe literalmente o texto mostrado que cambia dependiendo de la circunstancia. Por ejemplo:
Para conectar a una máquina remota utilizando ssh, teclee ssh nombre de
usuario@ dominio.nombre en un intérprete de comandos de shell. Si la máquina remota
es example.com y su nombre de usuario en esa máquina es john, teclee ssh
john@ exam ple.com .
El comando mount -o remount file-system remonta el sistema de archivo llamado. Por ejemplo, para volver a montar el sistema de archivo /home, el comando es mount -o
rem ount /hom e.
Para ver la versión de un paquete actualmente instalado, utilice el comando rpm -q
paquete. Éste entregará el resultado siguiente: paquete-versión-lanzamiento.
Observe que las palabras resaltadas en itálicas — nombre de usuario, dominio.nombre, sistema de archivo, paquete, versión y lanzamiento. Cada palabra es un marcador de posición, ya sea de texto a ingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema.
Aparte del uso estándar para presentar el título de un trabajo, las itálicas denotan el primer uso de un término nuevo e importante. Por ejemplo:
Publican es un sistema de publicación de DocBook.
1.2. Convenciones del documento
Los mensajes de salida de la terminal o fragmentos de código fuente se distinguen visualmente del texto circundante.
Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y se presentan así:
books Desktop documentation drafts mss photos stuff svn books_tests Desktop1 downloads images notes scripts svgs
Los listados de código fuente también se muestran en romano monoespaciado, pero se presentan y resaltan de la siguiente manera:
package org.jboss.book.jca.ex1;
import javax.naming.InitialContext;
public class ExClient {
public static void main(String args[]) throws Exception
{
InitialContext iniCtx = new InitialContext();
Object ref = iniCtx.lookup("EchoBean"); EchoHome home = (EchoHome) ref;
Echo echo = home.create(); System.out.println("Created Echo");
System.out.println("Echo.echo('Hello') = " + echo.echo("Hello")); }
}
1.3. Notas y Advertencias
Finalmente, utilizamos tres estilos visuales para llamar la atención sobre la información que de otro modo se podría pasar por alto.
Nota
Una nota es una sugerencia, atajo o enfoque alternativo para una tarea determinada. Ignorar una nota no debería tener consecuencias negativas, pero podría perderse de algunos trucos que pueden facilitarle las cosas.
Importante
Los cuadros con el título de importante dan detalles de cosas que se pueden pasar por alto fácilmente: cambios de configuración únicamente aplicables a la sesión actual, o servicios que necesitan reiniciarse antes de que se aplique una actualización. Ignorar estos cuadros no ocasionará pérdida de datos, pero puede causar enfado y frustración.
Aviso
Las advertencias no deben ignorarse. Ignorarlas muy probablemente ocasionará pérdida de datos.
2. Cómo obtener ayuda y hacer sus comentarios
2.1. ¿Necesita ayuda?
Si encuentra dificultades con alguno de los procedimientos descritos en este documento, visite el Portal del cliente de Red Hat en http://access.redhat.com. A través del portal del cliente, usted podrá:
buscar o navegar a través de la base de artículos de soporte técnico sobre productos de Red Hat. enviar un caso de soporte a Servicios de Soporte Global de Red Hat (GSS)
acceder a otra documentación del producto.
Red Hat alberga una lista grande de correos electrónicos para discutir sobre software de Red Hat y tecnología. Encontrará un listado de las listas de correo disponibles al público en
https://www.redhat.com/mailman/listinfo. Haga clic en el nombre de la lista a la que quiera suscribirse o para acceder a los archivos de listados.
2.2. ¡Necesitamos sus comentarios!
Si encuentra algun error o si se le ocurre una manera de mejorar este manual, nos encantaría escuchar sus sugerencias. Complete un reporte en Bugzilla frente al producto JBoss Enterprise
Application Platform 6 y el componente doc-Installation_Guide. El siguiente enlace le
llevará a un reporte de error ya completado para este producto: https://bugzilla.redhat.com/.
Llene la siguiente plantilla en el campo de Description de Bugzilla. Sea tan especifico como le sea posible al describir el problema, esto ayudará a asegurarnos de que lo podemos solucionar
rápidamente.
URL del documento:
Número de la sección y nombre: Describa el problema:
Sugerencias para mejorar: Información adicional:
Capítulo 1. Sinopsis del producto
1.1. Plataforma de aplicaciones empresariales JBoss de Red Hat
(JBoss EAP 6)
La plataforma de aplicaciones empresariales JBoss 6 de Red Hat (JBoss EAP 6) es una plataforma middleware poderosa, rápida y segura construída con base en estándares libres y cumple con los requerimientos de la especificación Java empresarial edición 6. Integra el servidor de aplicaciones JBoss 7 con clústers de alta disponiblidad, mensajería poderosa, caché distribuído y otras tecnologías para crear una plataforma estable y escalable.
La nueva estructura modular permite habilitar servicios sólamente cuando se requiera, incrementando de manera importante la velocidad. La consola de administración y la interfaz de la línea de comandos de administración eliminan la necesidad de modificar archivos de configuración XML manualmente, agregando la habilidad para utilizar scripts y automatizar tareas. Además, incluye APIs y marcos de trabajo de desarrollo que se pueden utilizar para desarrollar aplicaciones Java EE seguras, poderosas y escalables de manera rápida.
Reportar un error
Tabla 1.1. Funcionalidades 6.1.0
Funcionalidad Descripción
Certificación Java Implementación certificada del perfil completo de la edición 6 de Java empresarial y las
especificaciones del perfil web. Dominio administrado
Administración centralizada de múltiples instancias del servidor y hosts físicos, mientras que un servidor autónomo permite solo una instancia del servidor.
Las configuraciones, implementaciones, enlaces de socket, módulos, extensiones y propiedades del sistema se pueden
administrar por grupo de servidores.
La seguridad de aplicaciones incluyendo los dominios de seguridad se administran de manera central para una configuración simplificada.
Consola de administración y CLI de gestión Las nuevas interfaces se proporcionan para administrar el dominio o servidor autónomo. Ya no se requiere la modificación manual de
archivos de configuración XML. El CLI de gestión también ofrece un modo grupal que puede utilizar scripts y automatizar tareas de administración. Estructura del directorio simplificada El directorio modules/ ahora contiene los módulos
del servidor de aplicaciones en lugar de utilizar los directorios específicos y comunes del servidor
lib/. Los directorios domain/ y standalone/
contienen los artefactos y archivos de configuración para las implementaciones de dominio y autónomas.
Mecanismo modular de carga de clases Los módulos se cargan y descargan cuando se necesite para brindar beneficios de rendimiento y seguridad y un tiempo de arranque y reinicio más rápidos.
Administración optimizada de la fuente de datos Los controladores de la base de datos se pueden implementar tal como los otros servicios.
Además, las fuentes de datos se crean y se administran directamente en la consola de administración o CLI de administración. Tiempos de inicio y para detener más rápidos La plataforma de aplicaciones empresariales
JBoss 6 utiliza menos recursos y es
extremadamente eficiente en su uso de recursos del sistema. Este beneficia en especial a los desarrolladores.
Capítulo 2. Introducción
2.1. Sobre el portal del cliente de Red Hat
El portal del cliente de Red Hat es la plataforma centralizada para los recursos de subscripción de Red Hat. Use el portal del cliente de Red Hat para:
Administrar y mantener derechos y contratos de soporte a Red Hat; Descargar software soportado oficialmente;
Acceder la documentación de productos y la base de conocimiento de Red Hat; Contactar los servicios de soporte global y
Registrar errores de productos de Red Hat.
El portal del cliente está disponible aquí: https://access.redhat.com. Reportar un error
Capítulo 3. Requerimientos del sistema
3.1. Prerequisitos de instalación de JBoss EAP 6
Cada proceso de instalación para JBoss EAP 6 tiene un número de prerequisitos. Esta sección aborda los requerimientos comunes así como los específicos de la instalación.
Prerequisitos comunes
Establezca una cuenta en el portal del cliente de Red Hat en https://access.redhat.com. Para mayor información consulte: Sección 2.1, “Sobre el portal del cliente de Red Hat”.
Revise las configuraciones soportadas y asegúrese de que su sistema sea soportable: https://access.redhat.com/site/articles/111663.
Asegúrese de que su sistema esté actualizado con las actualizaciones y erratas ya emitidas de Red Hat.
Prerequisitos de ZIP/instalador
Privilegios de administración para el directorio de instalación.
Asegúrese de que el JDK escogido ya se extrajo (o instaló). Consulte la documentación de JDK para encontrar mayor información sobre cómo hacer esto.
En un servidor Microsoft Windows, asegúrese de que se han configurado las variables de entorno JAVA_HOME y PATH de otra manera los atajos no funcionarán.
En Hewlett-Packard HP-UX, asegúrese de que se ha instalado una funcionalidad unzip.
Prerequisitos RPM
Registre el servidor en la red de Red Hat.
Suscríbase al canal software base Red Hat Enterprise Linux Server apropiado para su versión de Red Hat Enterprise Linux.
Suscríbase al sub-canal JBoss Application Platform for Server en el grupo JBoss
Enterprise Platform .
Se requiere un JDK Java 6. Se puede obtener suscribiéndose al canal de software supplementary para su instalación de Red Hat Enterprise Linux. Por ejemplo; el canal para la versión 6 de Red Hat Enterprise Linux instalado en la arquitectura i386 es rhel-i386-server-supplementary-6.
Importante
Se requiere un JDK Java 6 incluso si desea usar un JDK Java 7. Reportar un error
Capítulo 4. Instrucciones de instalación
4.1. Métodos de instalación de JBoss EAP 6
Hay diferentes maneras de instalar JBoss EAP 6. Cada método es apropiado para ciertas situaciones. Este tema proporciona una pequeña sinopsis para cada tipo de instalación y enlaza a las secciones que abordan los procesos de instalación relevantes.
Tabla 4.1. Métodos de instalación
Método Descripción Instrucciones
Instalación zip El archivador zip es apropiado para la instalación en todos los sistemas operativos soportados. Este proceso se debe utilizar si desea extraer la instancia manualmente.
Sección 4.2.2, “Instalación de JBoss EAP 6 (instalación zip)”
Instalador JAR El instalador JAR se puede ejecutar en una consola o como un asistente gráfico. Ambas opciones proporcionan
instrucciones paso a paso para instalar y configurar la instancia del servidor. Con el instalador también es posible realizar configuraciones adicionales incluyendo los inicios rápidos y el repositorio Maven.
Sección 4.3.2, “Ejecute el instalador de la plataforma de aplicaciones
empresariales JBoss”
Instalación RPM JBoss EAP 6 se puede instalar con el instalador gráfico del paquete RPM soportado o con una interfaz de la línea de comandos. Este método es apropiado para instalaciones soportadas de Red Hat Enterprise Linux 5 y 6.
Sección 4.4.1, “Instalación de JBoss EAP 6 (instalación gráfica RPM)”
Sección 4.5.1, “Instalación de JBoss EAP 6 (instalación RPM basada en texto)”
Reportar un error
4.2. Instalación zip
4.2.1. Descargar JBoss EAP 6 (instalación zip)
Prerequisitos:
Sección 3.1, “Prerequisitos de instalación de JBoss EAP 6”
Resumen
El archivo zip de JBoss EAP 6 está disponible en https://access.redhat.com. La instalación del archivo zip no depende de la plataforma y es la manera preferida de instalar JBoss EAP 6 en todas las
plataformas soportadas. Este tema aborda los pasos para descargar el archivador.
Procedimiento 4.1. Descargar el archivo zip
1. Inicie sesión en https://access.redhat.com.
2. Seleccione la opción del menú Downloads → JBoss Enterprise Middleware → Downloads. 3. Seleccione Application Platform del menú desplegable Product.
4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Version. 5. Haga clic en Download al lado de la opción Application Platform 6.1.0.
Resultado
JBoss EAP 6 se descargó exitosamente en la máquina destino y está lista para la instalación.
Siguiente paso en Instalación zip
Sección 4.2.2, “Instalación de JBoss EAP 6 (instalación zip)” Reportar un error
4.2.2. Instalación de JBoss EAP 6 (instalación zip)
Paso anterior en Instalación zip
Sección 4.2.1, “Descargar JBoss EAP 6 (instalación zip)”
Resumen
Este tema aborda los pasos para instalar JBoss EAP 6 usando el archivo zip descargable.
Procedimiento 4.2. Instalación del archivo zip
1. Mueva el archivador zip a la ubicación deseada.
Mueva el archivo zip al servidor y directorio en donde instalará JBoss EAP 6. El usuario que va a detener e iniciar el servidor debe tener acceso de lectura y escritura en este directorio.
2. Use una aplicación apropiada para extraer el archivador zip en la ubicación deseada. En un entorno Red Hat Enterprise Linux use la funcionalidad unzip para extraer el contenido del archivador zip.
En un entorno Microsoft Windows haga clic con el botón derecho del ratón en el archivo y seleccione Extract All.
En un entorno Hewlett-Packard HP-UX use la funcionalidad unzip para extraer el contenido del archivador zip.
Resultado
JBoss EAP 6 se ha instalado exitósamente. El directorio creado por el archivador zip que realiza la extracción es el directorio superior para el servidor. Se conoce como EAP_HOME/.
Siguiente paso en Instalación zip
Sección 4.2.3, “Desinstalación de JBoss EAP 6 (instalación zip)” Reportar un error
Paso anterior en Instalación zip
Sección 4.2.2, “Instalación de JBoss EAP 6 (instalación zip)”
Prerrequisitos
Realice una copia de seguridad de los archivos de configuración modificados y las implementaciones que puede que se vuelvan a utilizar posteriormente.
Resumen
Esta sección aborda los pasos requeridos para desinstalar una instalación zip de JBoss EAP 6.
Procedimiento 4.3. Desinstalación de JBoss EAP 6 (instalación zip)
1. Vaya al directorio en donde había extraído la carpeta de JBoss EAP 6 del archivo zip. 2. Borre el directorio de instalación.
JBoss EAP 6 instala un sólo directorio cuando usa el método de instalación Zip. Borre el directorio de instalación para desinstalar JBoss EAP 6.
3. Opcional: borre cualquier script de inicialización que haya creado.
Si creó scripts de inicialización u otros scripts que dependían de que JBoss EAP 6 estuviese instalado en su computador entonces bórrelos.
Resultado
JBoss EAP 6 se desinstala del servidor. Reportar un error
4.3. Instalador
4.3.1. Descargar JBoss EAP 6 (instalador)
Prerequisitos:
Sección 3.1, “Prerequisitos de instalación de JBoss EAP 6”
Resumen
El archivador del instalador de JBoss EAP 6 está disponible en https://access.redhat.com. El archivador .jar se puede utilizar para ejecutar los instaladores gráficos o basados en texto. Este tema aborda los pasos para descargar el archivador.
Procedimiento 4.4. Descargue el instalador
1. Inicie sesión en https://access.redhat.com.
Figura 4.1.
3. Seleccione Application Platform del menú desplegable Product que aparece en la siguiente pantalla.
4. Seleccione Application Platform 6.1.0 Installer. 5. Haga clic en Download.
Resultado
JBoss EAP 6 se descargó exitosamente en la máquina destino y está lista para la instalación.
Siguiente paso en Instalador
Sección 4.3.2, “Ejecute el instalador de la plataforma de aplicaciones empresariales JBoss” Reportar un error
4.3.2. Ejecute el instalador de la plataforma de aplicaciones empresariales JBoss
Paso anterior en Instalador
Sección 4.3.1, “Descargar JBoss EAP 6 (instalador)”
El instalador JBoss EAP se puede ejecutar en modo gráfico o de texto. Este tema aborda el comando para ejecutar el instalador en cada modo y también detalla las pantallas y opciones de configuración individuales que forman parte del proceso de instalación.
Procedimiento 4.5. Inicie el instalador
1. Ejecute uno de los siguientes comandos para iniciar el proceso de instalación: A. Modo gráfico
java -jar jboss-eap-6.1.1.ER4-installer.jar B. Modo de texto
java -jar jboss-eap-6.1.1.ER4-installer.jar -console 2. Siga los pasos, etc.
Tabla 4.2. Pantallas del instalador JBoss EAP
Nombre Aparece Descripción Material de referencia
Sección B.1, “Selección del idioma”
Siempre Seleccione el idioma requerido para el instalador y haga clic en siguiente.
N/A
Sección B.2, “Acuerdo de licencia del usuario final”
Siempre El EULA para JBoss
Enterprise Middleware. Seleccione "I accept the terms of this license agreement" y haga clic en siguiente.
N/A
Sección B.3, “Ruta de instalación”
Siempre Configure la ruta de instalación para JBoss EAP 7 y haga clic en siguiente.
N/A
Sección B.4, “Creación del usuario
administrativo”
Siempre Cree un usuario de administración y asigne una contraseña. La contraseña debe tener por lo menos ocho caracteres con un dígito y un caracter que no sea alfanumérico. Luego haga clic en siguiente.
N/A
Sección B.5,
“Instalación de inicio rápido”
Siempre Instale los ejemplos de inicio rápido. Si no desea instalarlos haga clic en siguiente. Si si desea instalarlo haga clic en Si, configure la ubicación de la instalación y luego haga clic en siguiente.
N/A
Sección B.6,
“Configuración JDK”
Si decide instalar los ejemplos de inicio rápido
Seleccione la ruta de archivo del JDK y luego haga clic en siguiente.
N/A
Sección B.7, “Configuración del repositorio Maven”
Si decide instalar los ejemplos de inicio rápido Si quiere saltarse la configuración del repositorio maven entonces seleccione siguiente. Para configurar el repositorio maven seleccione "Especificar la ruta (o URL) a un repositorio maven existente", establezca la ubicación del repositorio maven y del archivo settings.xml
de maven y haga clic en siguiente.
Sección B.8, “Instalación del paquete”
Siempre Seleccione los
paquetes a instalar. Despliegue el paquete JBoss Core y borre el seleccionador para los paquetes
AppClient/Docs si piensa que no son necesarios. Luego haga clic en siguiente.
N/A
Sección B.9, “Configuración de enlace de sockets”
Siempre Determine si la
instalación utilizará los enlaces de puerto predeterminados o enlaces personalizados. Si selecciona enlaces personalizados entonces seleccione si debe configurar los puertos para modo autónomo, modo de dominio o ambos. Luego haga clic en siguiente. N/A Sección B.10, “Configuración (autónoma) de enlaces de socket” Si selecciona el configurar los enlaces de puertos
predeterminados para modo autónomo
Configure los puertos y propiedades del
sistema tal como se requiere y luego haga clic en siguiente. N/A Sección B.11, “Configuración de enlaces de socket (dominio)” Si selecciona el configurar los enlaces de puerto
predeterminados para el modo de dominio
Configure los puertos y propiedades del
sistema tal como se requiere y luego haga clic en siguiente.
N/A
Sección B.12, “Configuración de enlaces de socket Bindings (dominio ha)”
Si selecciona el configurar los enlaces de puerto
predeterminados para el modo de dominio
Configure los puertos y propiedades del
sistema tal como se requiere y luego haga clic en siguiente. N/A Sección B.13, “Configuración de enlaces de socket (dominio completo)” Si selecciona el configurar los enlaces de puerto
predeterminados para el modo de dominio
Configure los puertos y propiedades del
sistema tal como se requiere y luego haga clic en siguiente. N/A Sección B.14, “Configuración de enlaces de socket Bindings (dominio ha completo)” Si selecciona el configurar los enlaces de puerto
predeterminados para el modo de dominio
Configure los puertos y propiedades del
sistema tal como se requiere y luego haga clic en siguiente.
Lanzar el servidor Siempre Seleccione la opción de arranque requerida. Si desea lanzar el servidor inmediatamente puede seleccionar el lanzar un navegador se complete la instalación. Luego haga clic en siguiente.
N/A
Resultado
La instalación está completa y JBoss EAP 6 está instalada en su máquina destino.
Siguiente paso en Instalador
Sección 4.3.3, “Desinstalar JBoss EAP 6 (instalador)” Reportar un error
4.3.3. Desinstalar JBoss EAP 6 (instalador)
Paso anterior en Instalador
Sección 4.3.2, “Ejecute el instalador de la plataforma de aplicaciones empresariales JBoss”
Resumen
Esta sección detalla los pasos requeridos para desinstalar una instancia de JBoss EAP 6 que se instaló usando el instalador gráfico o basado en texto.
Procedimiento 4.6. Desinstalación de JBoss EAP 6 (instalación gráfica)
1. Durante la instalación de JBoss EAP 6 en la maquina destino se creó un directorio llamado
Uninstaller en el directorio en donde tenía instalado JBoss EAP 6. Este directorio contiene un
archivo llamado uninstaller.jar. Navegue a este directorio en una terminal. 2. Lance el desinstalador GUI con el siguiente comando:
java -jar uninstaller.jar
3. La ejecución del comando lanzará el desinstalador gráfico como se puede ver en la siguiente figura. Seleccione la casilla si desea borrar el directorio de instalación de JBoss EAP 6.
4. Presione el botón Uninstall para iniciar el proceso de desinstalación.
5. Cuando el proceso de desinstalación ha terminado, presione el botón Quit para salir del desinstalador.
6. Después de que ha desinstalado de manera exitosa, es posible que quiera borrar manualmente el directorio Uninstaller desde donde lanzó el desinstalador.
Procedimiento 4.7. Proceso de desinstalación basado en texto
1. En una consola, navegue al directorio Uninstaller creado durante el proceso de instalación. Este se puede encontrar un nivel arriba de EAP_HOME.
2. Lance el desinstalador basado en texto ejecutando el siguiente comando:
java -jar uninstaller.jar -console
3. Siga los pasos para desinstalar JBoss EAP 6.
Resultado:
JBoss EAP 6 se desinstala de su servidor. Reportar un error
4.4. Instalación gráfica RPM
4.4.1. Instalación de JBoss EAP 6 (instalación gráfica RPM)
Prerequisitos:
Sección 3.1, “Prerequisitos de instalación de JBoss EAP 6”
Resumen
El metodo del paquete RPM gráfico de instalación de JBoss EAP 6 es apropiado para Red Hat
Enterprise Linux 5 y Red Hat Enterprise Linux 6. Este tema aborda los pasos requeridos para completar la instalación.
Procedimiento 4.8. Instalación de JBoss EAP 6 (instalación gráfica RPM)
Use PackageKit para instalar gráficamente JBoss EAP 6 en su máquina destino. 1. Lanzar PackageKit
PackageKit es un software de administración de paquetes de código abierto instalado como parte de Red Hat Enterprise Linux. En la máquina destino lance PackageKit seleccionando System →
Administration → Add/Remove Software.
2. Escriba jboss-eap6
en la casilla de búsqueda y luego presione el botón Find. Se le presentará el paquete JBoss EAP 6 en la casilla de resultados.
Figura 4.3. Instalación de PackageKit JBoss EAP 6
4. Siga el resto de los pasos para instalar JBoss EAP 6 en su máquina destino.
Resultado
La instalación está completa y JBoss EAP 6 está instalada en su máquina destino. Reportar un error
4.5. Instalación RPM basada en texto
4.5.1. Instalación de JBoss EAP 6 (instalación RPM basada en texto)
Prerequisitos:
Sección 3.1, “Prerequisitos de instalación de JBoss EAP 6”
Resumen
El metodo del paquete RPM de instalación de JBoss EAP 6 es apropiado para Red Hat Enterprise Linux 5 y Red Hat Enterprise Linux 6. Este tema aborda los pasos requeridos para instalar una instancia usando la línea de comandos.
Procedimiento 4.9. Pasos de instalación basados en texto
Acceso e instalación del paquete RPM usando la instalación YUM por medio de Red Hat Network. 1. Instalación del paquete RPM usando YUM y Red Hat Network.
Puede utilizar YUM para instalar el paquete predeterminado del grupo de JBoss EAP 6 usando el comando groupinstall.
[user@host ~]$ yum groupinstall jboss-eap6 2. Configuración de las opciones de inicio.
La instalación RPM contiene scripts de inicialización para lanzar el servidor. La configuración para estos scripts se encuentra en varios archivos adicionales. Consulte Sección A.4, “Archivos de configuración de la instalación RPM para JBoss EAP 6” para obtener los detalles sobre estos archivos y las opciones en ellos.
Resultado
La instalación está completa. La ruta predeterminada EAP_HOME para la instalación RPM es
/usr/share/jbossas. Consulte Sección A.3, “Lista de paquetes RPM para JBoss EAP 6” para ver una lista completa de todos los paquetes instalados..
Reportar un error
4.6. Instalación automatizada
4.6.1. Instalación de múltiples instancias de JBoss EAP 6 (instalador)
Prerrequisitos
Generar un script automatizado usando el instalador gráfico o basado en texto:
Sección 4.3.2, “Ejecute el instalador de la plataforma de aplicaciones empresariales JBoss”.
Resumen
Se pueden instalar múltiples instancias idénticas de JBoss EAP 6 usando un script automatizado,
generado durante el proceso de instalación, usando el instalador gráfico o el basado en texto. Este tema aborda los pasos requeridos para instalar JBoss EAP 6 usando un script generado.
Procedimiento 4.10. Instalación automatizada
En una terminal, ejecute el siguiente comando para instalar JBoss EAP 6 usando el script automatizado:
java -jar jboss-eap-6.1.0-installer.jar SCRIPT_NAME.xml
Resultado
Se ha instalado una instancia idéntica de JBoss EAP 6 basada en el script generado automáticamente. Reportar un error
4.7. Configuración de servicios
4.7.1. Configuración de JBoss EAP 6 como un servicio en Red Hat Enterprise Linux
(método RPM)
Prerrequisitos
Instalación de JBoss EAP 6 usando el método RPM (gráfico o basado en texto). Sección 4.4.1, “Instalación de JBoss EAP 6 (instalación gráfica RPM)”
Sección 4.5.1, “Instalación de JBoss EAP 6 (instalación RPM basada en texto)” Se requieren privilegios de administrador en el servidor.
Resumen
Use el siguiente procedimiento para instalar JBoss EAP 6 como un servicio en Red Hat Enterprise Linux cuando la instalación se ha realizado usando el método RHN (RPM).
Procedimiento 4.11. Configure JBoss EAP 6 como un servicio usando el método RPM en Red Hat Enterprise Linux
1. Instalación de JBoss EAP 6
Instale JBoss EAP 6 por medio del método RPM usando uno de los pasos listados en las secciones de prerequisitos mencionadas anteriormente.
2. Habilitar el servicio
El método de instalación RPM para JBoss EAP 6 instala los archivos requisitos del servicio en los lugares correctos. Todo lo que necesita hacer para configurarlo como un servicio es emitir el siguiente comando:
chkconfig jbossas on
Resultado
JBoss EAP 6 inicia de manera automática cuando Red Hat Enterprise Linux llega a su nivel de ejecución predeterminado y se detiene automáticamente cuando el sistema operativo lleva acabo su rutina de apagado.
Reportar un error
4.7.2. Configuración de JBoss EAP 6 como un servicio en Red Hat Enterprise Linux
(zip, instalador)
Prerrequisitos
Instale JBoss EAP 6 usando la instalación zip, el instalador gráfico o el instalador basado en texto: Sección 4.2.2, “Instalación de JBoss EAP 6 (instalación zip)”.
Sección 4.3.2, “Ejecute el instalador de la plataforma de aplicaciones empresariales JBoss”. Se requieren privilegios de administrador en el servidor.
Resumen
Use el siguiente procedimiento para instalar JBoss EAP 6 como un servicio en Red Hat Enterprise Linux cuando la instalación se ha realizado usando el método gráfico, zip o de texto. Este proceso no aplica cuando la instalación se realiza usando el método RHN (RPM).
Procedimiento 4.12. Configure el servicio
Nota
Los pasos a continuación describen la ejecución de JBoss EAP 6 como un servicio en modo autónomo. Con el fin de ejecutar JBoss EAP 6 como un servicio en modo de dominio, use los mismos pasos pero reemplace jboss-as-standalone.sh con jboss-as-domain.sh. 1. Ubique el script de arranque y el archivo de configuración
EAP_HOME/bin/init.d/. Abra el archivo de configuración jboss-as.conf para modificarlo.
2. Personalice las opciones de arranque en el archivo jboss-as.conf
Hay varias opciones dentro del archivo jboss-as.conf. Como mínimo, especifique los valores correctos para las variables JBOSS_HOME y JBOSS_USER. Si estas variables no están presentes entonces agréguelas.
3. Copie archivos en los directorios del sistema
a. Copie el archivo de configuración modificado en el directorio /etc/jboss-as.
[user@host init.d]$ sudo mkdir /etc/jboss-as
[user@host init.d]$ sudo cp jboss-as.conf /etc/jboss-as/
b. Copie el script de arranque en el directorio /etc/init.d.
[user@host init.d]$ sudo cp jboss-as-standalone.sh /etc/init.d
4. Agregue el script de arranque como servicio.
Agregue el nuevo servicio jboss-as-standalone.sh a la lista de servicios iniciados automáticamente usando el comando de administración del servicio chkconfig.
[user@host init.d]$ sudo chkconfig --add jboss-as-standalone.sh
5. Inicie el servicio.
Pruebe que el servicio haya sido instalado correctamente usando la sintaxis estándar para iniciar los servicios de Red Hat Enterprise Linux.
[user@host bin]$ sudo service jboss-as-standalone.sh start
Si todo ha tenido lugar correctamente entonces debe ver un [OK] verde. Si obtiene un error, chequee los registros de errores y asegúrese de que sus rutas son correctas en el archivo de configuración.
6. Haga que el servicio inicie automáticamente cuando reinicie su servidor.
Para agregar el servicio a la lista de servicios que inician automáticamente cuando su servidor re-inicia, emita el siguiente comando.
[user@host init.d]$ sudo chkconfig jboss-as-standalone.sh on
Resultado
JBoss EAP 6 inicia de manera automática cuando Red Hat Enterprise Linux llega a su nivel de ejecución predeterminado y se detiene automáticamente cuando el sistema operativo lleva acabo su rutina de apagado.
Reportar un error
4.7.3. Configuración de JBoss EAP 6 como servicio en el servidor de Microsoft
Windows (zip, instalador)
Prerrequisitos
Instale JBoss EAP 6 usando la instalación zip, el instalador gráfico o el instalador basado en texto: Sección 4.2.2, “Instalación de JBoss EAP 6 (instalación zip)”.
Sección 4.2.2, “Instalación de JBoss EAP 6 (instalación zip)”.
Sección 4.3.2, “Ejecute el instalador de la plataforma de aplicaciones empresariales JBoss”. Se requieren privilegios de administrador en el servidor.
Se debe configurar la variable de entorno del sistema JAVA_HOME. La instancia del servidor JBoss EAP 6 no debe estar ejecutando.
Resumen
Use los siguientes procedimientos para configurar JBoss EAP 6 como un servicio en el servidor de Microsoft Windows.
Procedimiento 4.13. Configure un servicio para JBoss EAP 6 en el servidor de Microsoft Windows
1. Crear variables del entorno del sistema Crear dos variables de entorno del sistema:
JBOSS_HOME apuntando al directorio de instalación de JBoss EAP 6. NOPAUSE=1
2. Si todavía no está configurado, descargue y extraiga el paquete de funcionalidades
nativas para su arquitectura
Si las funcionalidades nativas para el paquete del servidor Windows no se ha instalado como parte de la instalación de JBoss EAP 6, descargue el paquete relevante de 32-bits o 64-bits del pportal del cliente de Red Hat en https://access.redhat.com. Extraiga el archivador zip de funcionalidades nativas a través de la instalación de JBoss EAP 6.
Esto generará un directorio native en la siguiente ubicación en la instalación JBoss EAP 6:
EAP_HOME\m odules\system \layers\base\
3. Instale el servicio
Abra una terminal y vaya al directorio
EAP_HOME\m odules\system \layers\base\native\sbin
Se puede crear un nuevo servicio con el comando service install con las opciones disponibles que se pueden ver en la siguiente tabla.
Tabla 4.3. opciones service install
Opción o argumento Descripción
/controller HOST:PORT El host y puerto de la interfaz de administración. Si se omite entonces el valor predeterminado es localhost:9999.
/host [DOMAIN_HOST] Indica que el modo de dominio se utilizará, opcionalmente
especificando el nombre del controlador de dominio. Si se omite el nombre del controlador de dominio entonces el nombre
predeterminado es master.
/loglevel LEVEL El nivel de registro para el servicio puede ser: ERROR, INFO, WARN o
DEBUG. Si se omite entonces el valor predeterminado es INFO
/name SERVICE_NAME El nombre del servicio a crearse no debe contener espacios. Si se omite, el valor predeterminado es JBossEAP6
/desc "DESCRIPTION" La descripción del servicio. Si se omite, el valor predeterminado es
"JBoss Enterprise Application Platform 6"
/serviceuser
DOMAIN\USERNAME
Especifica el nombre de la cuenta bajo la cual el servicio ejecutará. Use un nombre de cuenta con el formato DOMAIN\USERNAME. Si se omite entonces el servicio ejecuta como la cuenta del sistema local. /servicepass
PASSWORD
Contraseña para la cuenta /serviceuser.
/jbossuser USERNAME Opcional, el nombre de usuario JBoss EAP 6 a utilizar para el comando de apagado.
/jbosspass PASSWORD Se requiere contraseña para la cuenta /jbossuser, si se especifica /jbossuser.
A continuación encontrará ejemplos básicos de un comando install para crear un nuevo servicio en modo autónomo o de dominio. Ejecute el siguiente comando, ajustando el nivel de registro para el servicio tal como se requiere:
A. Modo autónomo:
service.bat install /loglevel INFO
B. Modo de dominio:
Si no está usando el maestro predeterminado para su controlador de dominios JBoss EAP 6 reemplace master con el nombre correcto de host o alias del controlador de dominio de JBoss EAP.
service.bat install /host master /loglevel INFO
Se creará un nuevo servicio Windows con el nombre JBossEAP6. 4. Verifique el nuevo servicio en la consola de servicios
Ejecute el siguiente comando en una terminal para abrir la consola de servicios Windows:
services.msc
Si se utilizó el nombre predeterminado del servicio en la lista de servicios Windows entonces el nuevo servicio presentará el nombre: JBoss Enterprise Application Platform 6. Desde la consola de servicios puede iniciar y detener el servicio así como cambiar su configuración y la manera y el cuándo inicia.
Para iniciar el servicio desde una terminal, use el siguiente comando, cambiando el nombre del servicio si es necesario:
net start JBossEAP6
Para detener el servicio desde una terminal, use el siguiente comando, cambiando el nombre del servicio si es necesario:
net stop JBossEAP6
Resultado
Un servicio JBoss EAP 6 se configura en el servidor de Microsoft Windows.
Procedimiento 4.14. Desinstalar el servicio JBoss EAP 6 del servidor de Microsoft Windows
Si el servicio está ejecutando, primero abra una terminal y detenga el servicio ejecutando el comando net stop con el nombre del servicio:
net stop JBossEAP6
En una terminal vaya al directorio EAP_HOME\modules\system\layers\base\native\sbin y ejecute el siguiente comando:
service uninstall
Resultado
Se borró el servicio JBoss EAP 6 del servidor Microsoft Windows. Reportar un error
Capítulo 5. Aplicación de parches y actualización de JBoss EAP
6
5.1. Parches y actualizaciones
El mecanismo de parches en JBoss EAP 6 aplica actualizaciones que se hacen disponibles para una versión 'menor' especifica de JBoss EAP 6, por ejemplo JBoss EAP 6.2. Los parches pueden contener actualizaciones de seguridad, una sola actualización o acumulativas.
El actualizar entre lanzamientos importantes y menores de JBoss EAP (por ejemplo, de 6.1 a 6.2) requiere un proceso diferente.
Ver tambi�n:
Sección 5.2, “Instalación de parches”
Sección 5.3, “Instrucciones de actualización” Reportar un error
5.2. Instalación de parches
5.2.1. Mecanismos para uso de parches
Los parches de JBoss se lanzan de dos formas.Actualizaciones asincrónicas: parches únicos que se lanzan por fuera del ciclo normal de
actualización del producto existente. Estos pueden incluir parches de de seguridad así como otros parches únicos proporcionados por los servicios globales de soporte de Red Hat (GSS) para arreglar problemas específicos.
Actualizaciones planeadas: estas incluyen parches acumulativos así como actualizaciones menores, mayores o micro actualizaciones de un producto existente. Los parches acumulativos incluyen todas las actualizaciones asincrónicas desarrolladas anteriormente para esa versión del producto.
El decidir si un parche se lanza como parte de una actualización planeada o como una actualización asincrónica depende de la gravedad del problema que se está arreglando. Un problema de bajo impacto usualmente se pospone y se resuelve en el siguiente parche acumulativo o lanzamiento menor de los productos afectados. Los problemas de impacto moderado o mayor usualmente se abordan en orden de importancia con una actualización del producto con un lanzamiento asincrónico y solo contiene una solución para un problema específico.
Los parches acumulativos y de seguridad para los productos de JBoss se distribuyen en dos formas: zip (para todos los productos) y RPM (para un subgrupo de productos).
Importante
Una instalación del producto JBoss siempre se debe actualizar utilizando un sólo método de parche: ya sea parches zip o RPM.
Las actualizaciones de seguridad para los productos JBoss se proporcionan por medio de erratas (para métodos zip y RPM). Las erratas encapsulan una lista de las fallas resueltas, el grado de severidad, los productos afectados, la descripción textual de las fallas y una referencia a los parches. Las
actualizaciones de los arreglos de errores no se anuncian por medio de erratas.
Para obtener mayor información sobre la manera en que Red Hat evalúa las fallas de seguridad de JBoss, consulte: Sección 5.2.5, “Clasificación de severidad e impacto de los parches de seguridad de JBoss”
Red Hat mantiene una lista de correo para notificar a los suscriptores sobre las fallas relacionadas con la seguridad. Consulte Sección 5.2.2, “Suscripción a las listas de correo de parches”
Reportar un error
5.2.2. Suscripción a las listas de correo de parches
Resumen
El grupo de JBoss en Red Hat mantiene una lista de correo para anuncios de seguridad para los productos middleware empresariales de Red Hat. Este tema aborda lo que necesita hacer para suscribirse a esta lista.
Prerrequisitos
Ninguno
Procedimiento 5.1. Suscribirse a la lista de observación de JBoss
1. Haga clic en el siguiente enlace para ir a la página de la lista de correo de observación de JBoss: Lista de correo de observación de JBoss.
2. Ingrese su dirección de correo-e en la sección Subscribing to Jboss-watch-list. 3. [También puede ingresar su nombre y seleccionar una contraseña. Esto es completamente
opcional pero se recomienda.]
4. Presione el botón Subscribe para iniciar el proceso de suscripción.
5. Puede navegar los archivadores de la lista de correo dirigiéndose a : JBoss Watch Mailing List Archives.
Resultado
Después de confirmar su dirección de correo-e se le suscribirá para recibir anuncios relacionados con seguridad de la lista de correo de parches de JBoss.
Reportar un error
5.2.3. Instalación de parches en forma zip
5.2.3.1. El comando patch
El comando patch se utiliza para aplicar parches zip descargados en una sola instancia del servidor JBoss EAP 6. No se puede utilizar para aplicar parches de manera automática las instancias del servidor JBoss EAP 6 a través de un dominio administrado, pero se pueden aplicar parches de manera
Importante
Las instancias del servidor JBoss EAP 6 que se han instalado usando el método RPM no se pueden actualizar usando el comando patch. Consulte Sección 5.2.4, “Instalación de parches en forma RPM” para actualizar los servidores JBoss EAP 6 instalados por medio de RPM.
Nota
El comando patch solo se puede utilizar con los parches producidos para las versiones de JBoss EAP 6.2 y posteriores. Para los parches para las versiones de JBoss EAP previas a 6.2 se debe referir a la versión relevante de la documentación disponible en
https://access.redhat.com/site/documentation/.
Además de aplicar los parches, el comando patch puede proporcionar información básica sobre el estado de parches instalados y también proporciona una manera de deshacer inmediatamente la aplicación de un parche.
Antes de iniciar la aplicación de un parche o una operación para deshacer, la herramienta patch
verificará los módulos y otros archivos misceláneos que estén cambiando para cualquier modificación de usuario. Si se detecta una modificación de usuario y no se ha especificado una opción para el manejo de conflictos entonces la herramienta patch abortará la operación y advertirá que hay un conflicto. La advertencia incluirá una lista de los módulos y otros archivos que estén en conflicto. Para completar la operación, el comando patch se debe volver a ejecutar con una opción que especifique la manera de resolver el conflicto: ya sea preservando las modificaciones del usuario o sobreescribiéndolas.
Tabla 5.1. Opciones y argumentos del comando patch
Opción o argumento Descripción
apply Aplica un parche.
--override-all Si hay un conflicto entonces la operación parche sobreescribe las modificaciones de cualquier usuario.
--override-m odules Si hay un conflicto generado por cualquiera de los módulos modificados, esta opción sobreescribe estas modificaciones con el contenido de la operación de aplicación del parche.
--override=path(,path) Sólo para archivos misceláneos especificados, esto sobreescribirá los archivos modificados en conflicto con los archivos en la operación de aplicación del parche.
--preserve=path(,path) Sólo para archivos misceláneos especificados, esto preservará los archivos modificados en conflicto.
info Retorna información sobre los parches instalados
actualmente.
rollback Deshace la aplicación de un parche.
--reset-configuration=TRUE|FALSE Se requiere para revertir, especifica si debe reestablecer los archivos de configuración del servidor como parta de la operación para revertir. Reportar un error
5.2.3.2. Instalación de parches en forma zip usando el comando patch Prerequisitos:
Sección 3.1, “Prerequisitos de instalación de JBoss EAP 6”
Resumen
Esta tarea describe la manera de utilizar el comando patch para instalar parches para JBoss EAP 6 que se encuentren en formato zip.
Importante
El comando patch es una funcionalidad que se agregó en JBoss EAP 6.2. Para las versiones de JBoss EAP previas a 6.2, el proceso para instalar parches en forma zip es diferente y debe consultar la documentación de la versión relevante disponible en
https://access.redhat.com/site/documentation/.
Prerrequisitos
Acceso y suscripción válidos al portal del cliente de Red Hat.
Una suscripción actual a un producto JBoss instalado en un formato zip.
Acceso al CLI de administración para la instancia del servidor se va a actualizar. Consulte el
Procedimiento 5.2. Aplique un parche zip a una instancia del servidor JBoss EAP 6 usando el comando patch
Aviso
Antes de instalar un parche, debe realizar una copia de seguridad de su producto JBoss junto con todos los archivos de configuración personalizados.
1. Descargue el archivo zip parche del portal del cliente en https://access.redhat.com/downloads/ 2. Desde el CLI de administración, aplique el parche con el siguiente comando con la ruta apropiada
al archivo parche:
[standalone@localhost:9999 /] patch apply /path/to/downloaded-patch.zip La herramienta patch le advertirá si hay algún conflicto al tratar de aplicar el parche. Consulte Sección 5.2.3.1, “El comando patch” para ver las opciones disponibles para volver a ejecutar el comando para resolver cualquier conflicto.
3. Reinicie la instancia del servidor JBoss EAP 6 para que el parche tenga efecto: [standalone@localhost:9999 /] shutdown --restart=true
Resultado
Se aplica el parche de la última actualización a la instancia del servidor JBoss EAP 6. Reportar un error
5.2.3.3. Deshacer la aplicación de un parche en forma zip usando el comando patch Resumen
Esta tarea describe la manera de utilizar el comando patch para deshacer la aplicación de un parche zip aplicado previamente en JBoss EAP 6.
Aviso
El deshacer la aplicación de un parche usando el comando patch no es una funcionalidad general de desinstalación. Sólo se debe utilizar inmediatamente después de la aplicación de un parche que tuvo consecuencias no deseadas.
Importante
El comando patch es una funcionalidad que se agregó en JBoss EAP 6.2. Para las versiones de JBoss EAP previas a 6.2, el proceso para deshacer parches en forma zip es diferente y debe consultar la documentación de la versión relevante disponible en
https://access.redhat.com/site/documentation/.
Un parche que se aplicó previamente usando el comando patch.
Acceso al CLI de administración para la instancia del servidor. Consulte Launch the Management CLI en la Administration and Configuration Guide.
Procedimiento 5.3. Deshacer un parche de una instancia del servidor JBoss EAP 6 usando el comando patch
1. Desde el CLI de administración, use el comando patch info para encontrar el ID del parche que se va a deshacer.
A. Para los parches acumulativos, el ID del parche es el valor del primer
cumulative-patch-id que se puede ver en la salcumulative-patch-ida patch info.
B. Los IDs de parches para solucionar errores o parches únicos de seguridad se listan como el valor del primer patches que se puede ver en la salida patch info con el parche único aplicado más recientemente listado de primero.
2. Desde el CLI de administración, deshaga el parche con el ID de parche apropiado del paso anterior.
Aviso
Tenga cuidado al especificar el valor de la opción --reset-configuration.
Si se configura como TRUE entonces el proceso para deshacer el parche también deshará los archivos de configuración del servidor de JBoss EAP 6 a su estado previo antes de aplicar el parche. Los cambios realizados a los archivos de configuración del servidor JBoss EAP 6 después de que se aplicó el parche también se perderán.
Si se configura como FALSE entonces los archivos de configuración del servidor no se desharán. En esta situación, es posible que el servidor no inicie después de deshacer los cambios ya que es posible que el parche ya haya alterado la configuración tal como los espacios de nombres, los cuales pueden que ya no sean válidos y se tengan que arreglar manualmente.
[standalone@localhost:9999 /] patch rollback PATCH_ID
--reset-configuration=TRUE
La herramienta patch le advertirá si hay algún conflicto al tratar de deshacer el parche. Consulte Sección 5.2.3.1, “El comando patch” para ver las opciones disponibles para volver a ejecutar el comando para resolver cualquier conflicto.
3. Reinicie la instancia del servidor JBoss EAP 6 para que se deshagan los cambios de manera efectiva:
[standalone@localhost:9999 /] shutdown --restart=true
Resultado
Se deshacen los cambios del parche y opcionalmente también los archivos de configuración en la instancia del servidor JBoss EAP 6.
Reportar un error
5.2.4. Instalación de parches en forma RPM
Sección 3.1, “Prerequisitos de instalación de JBoss EAP 6”
Resumen
Los parches de JBoss se distribuyen de dos formas: zip (para todos los productos) y RPM (para un subgrupo de productos). Esta tarea describe los pasos que necesita tomar para instalar los parches por medio del formato RPM.
Prerrequisitos
Una subscripción válida a Red Hat Network.
Una suscripción actual a un producto JBoss instalado por medio de un paquete RPM.
Procedimiento 5.4. Aplicar un parche a un producto JBoss por medio del método RPM.
Las actualizaciones de seguridad para los productos JBoss se proporcionan por medio de erratas (para los métodos zip y RPM). Las erratas encapsulan una lista de las fallas resueltas, el grado de severidad, los productos afectados, la descripción textual de las fallas y una referencia a los parches.
Para las distribuciones RPM de los productos JBoss, la errata incluye referencias a los paquetes RPM actualizados. El parche se puede instalar usando yum.
Aviso
Antes de instalar un parche, debe realizar una copia de seguridad de su producto JBoss junto con todos los archivos de configuración personalizados.
1. Obtenga notificaciones sobre el parche de seguridad ya sea suscribiéndose a la lista de correo de observación de JBoss o navegando los archivadores de la lista de correo de observación de JBoss.
2. Lea la errata para el parche de seguridad y confirme que aplica a un producto JBoss en su entorno.
3. Si el parche de seguridad aplica a un producto JBoss en su entorno entonces siga el enlace para descargar el paquete RPM actualizado, incluído en la errata.
4. Uso
yum update
para instalar el parche.
Importante
Al actualizar una instalación RPM, su producto JBoss se actualiza de manera acumulativa con todos los arreglos lanzados en el RPM.
Resultado
El producto JBoss recibe el parche con la última actualización usando el formato RPM. Reportar un error
5.2.5. Clasificación de severidad e impacto de los parches de seguridad de JBoss
Para comunicar el riesgo de cada falla de seguridad de JBoss, Red Hat usa una escala de severidad de cuatro puntos: bajo, moderado, importante y crítico, además de los puntajes base de la versión 2 del sistema de puntaje de vulnerabilidad común (CVSS del inglés Common Vulnerability Scoring System), los cuales se pueden utilizar para identificar el impacto de la falla.Tabla 5.2. Clasificación de severidad de los parches de seguridad de JBoss
Intensidad Descripción
Crítico Esta clasificación se da para las fallas que
puedan ser explotadas fácilmente por parte de un atacante no autenticado remoto y llevar a
comprometer el sistema (ejecución arbitraria de código) sin requerir interacción con el usuario. Estos son los tipos de vulnerabilidades que pueden ser explotadas por parte de los gusanos. Las fallas que requieren un usuario remoto autenticado, un usuario local o una configuración poco probable no se clasifican como de impacto crítico.
Importante Esta calificación se le da a las fallas que pueden fácilmente comprometer la confidencialidad, integridad o la disponibilidad de los
recursos.Estos son los tipos de vulnerabilidades que le permiten a los usuarios locales el ganar privilegios, permitirle a los usuarios remotos no autenticados el ver recursos que de otra manera deben estar protegidos por la autenticación, permitirle a los usuarios remotos autenticados el ejecutar código arbitrario o permitirle a los usuarios locales o remotos el generar una negación de servicio.
Moderado Esta calificación se le da a las fallas que puedan ser más difíciles de explotar pero que podrían conllevar a comprometer la confidencialidad, integridad o disponibilidad de los recursos, bajo ciertas circunstancias. Estos son los tipos de vulnerabilidades que podrían haber tenido un impacto crítico o importante pero que se explotan de manera menos fácil con base en una
evaluación técnica de la falla o afectan muy poco probablemente las configuraciones.
Bajo Esta calificación se le da a los otros problemas
que tengan impacto en la seguridad. Estas son los tipos de vulnerabilidades que se cree que requieren circunstancias poco posibles para que se puedan explotar o en donde si se explotara de manera exitosa entonces generaría
consecuencias mínimas.
El componente impacto de una calificación CVSS v2 se basa en una evaluación combinada de tres impactos potenciales: confidencialidad (C), integridad (I) y disponibilidad (A). Cada una de estas se
puede calificar como Ninguno (N), Parcial (P) o Completo (C).
Debido a que el proceso del servidor JBoss ejecuta como un usuario no privilegiado y se aisla del sistema operativo host, las fallas de seguridad de JBoss sólo se califican con un nivel de impacto de Ninguno (N) o Parcial (P).
Ejemplo 5.1. Calificación de impacto CVSS v2
El ejemplo a continuación muestra una calificación de impacto CVSS v2, en donde el explotar la falla no tendría impacto en la confidencialidad del sistema, impacto parcial en la integridad del sistema e impacto completo en la disponibilidad del sistema (es decir, el sistema quedaría en estado
completamente no disponible para cualquier uso, por ejemplo, a través de un fallo del kernel).
C:N/I:P/A:C
Combinado con la calificación de severidad y el puntaje CVSS, las organizaciones pueden realizar decisiones con la suficiente información sobre el riesgo que cada problema conlleva en su entorno único y programar actualizaciones de acuerdo con esto.
Para mayor información sobre CVSS2, por favor consulte: CVSS2 Guide. Reportar un error
5.3. Instrucciones de actualización
5.3.1. Actualización de la instalación ZIP de JBoss EAP 6
Prerrequisitos
Asegúrese de que el sistema operativo base esté actualizado.
Determine los archivos que se han modificado desde que se instaló JBoss EAP 6.
Realice una copia de seguridad de los archivos de configuración modificados, las implementaciones y todos los datos del usuario.
Sección 4.2.1, “Descargar JBoss EAP 6 (instalación zip)”.
Resumen
Este procedimiento aborda la actualización de una instalación zip JBoss EAP 6 entre versiones menores (por ejemplo, de JBoss EAP 6.1 a 6.2). Para instalar los parches para una versión menor específica consulte la sección Patch Installation. El actualizar al último lanzamiento de JBoss EAP 6 requiere algo de trabajo inicial para realizar una copia de seguridad de la instalación existente.
Aviso
Para los dominios administrados primero se debe actualizar la instancia del controlador host maestro (o controlador de dominio) antes de actualizar cada controlador host.
Procedimiento 5.5. Actualización a la última versión de JBoss EAP 6
1. Mueva el archivador zip descargado a la ubicación deseada. Se recomienda que sea una ubicación diferente a la de la instalación de JBoss EAP 6 que ya existe.
Importante
Si desea instalar la última versión de JBoss EAP 6 en el mismo directorio que la instalación existente, necesitará mover la instalación existente a un lugar diferente antes de proceder. Esto previene la pérdida de los archivos de configuración modificados, las
implementaciones y actualizaciones.
2. Descomprima el archivador. Este paso instala una instancia limpia del último lanzamiento de JBoss EAP 6.
3. Manualmente agrupe sus cambios de los directorios EAP_HOME/domain/ y
EAP_HOME/standalone/ de la versión previa en la nueva instalación.
Aviso
Los archivos de configuración no se deben copiar de la versión anterior a la nueva instalación. Los cambios se deben realizar manualmente.
4. Revise los cambios realizados al directorio bin de la instalación anterior y realice las modificaciones equivalentes al nuevo directorio.
Aviso
Los archivos en el directorio bin no deben ser sobreescritos por los archivos de versiones anteriores. Los cambios se deben realizar manualmente.
5. Revise los archivos modificados que quedan de la instalación anterior y mueva estos cambios a la instalación. Estos archivos pueden incluir:
El directorio welcome-content.
Módulos personalizados en el diretcorio modules. Paquetes personalizados en el directorio bundles.
Resultado
La instalación zip de JBoss EAP 6 se actualizó exitosamente al último lanzamiento. Reportar un error
5.3.2. Actualización de la instalación RPM de JBoss EAP 6
Prerrequisitos
Asegúrese de que el sistema operativo base esté actualizado y que el sistema esté suscrito y habilitado para obtener actualizaciones para el canal SO Base.
Asegúrese de que el canal correcto RHN de JBoss EAP 6 esté habilitado. Por ejemplo, en una arquitectura x86, 64 bits, este será la plataforma de aplicaciones JBoss (v 6) para el canal 6Server x86_64 (jbappplatform-6-x86_64-server-6-rpm).
Realice una copia de seguridad de los archivos de configuración modificados, las implementaciones y todos los datos del usuario.
