9.2. Aplicación de parches en Red Hat JBoss BPM Suite 6.1

En Red Hat JBoss BPM Suite, la herramienta de parches se distribuye como un archivo comprimido que incluye scripts .sh y .bat sencillos, que facilitan la aplicación automática de actualizaciones para una instalación JBoss BPM Suite 6.1 (o superior).

Importante

La herramienta de parches es para usar con JBoss BPM Suite 6.1 o superior, y no debería ser utilizada para versiones anteriores. Para obtener más información, consulte https://access.redhat.com/articles/1455733.
El script requiere dos parámetros obligatorios: <path-to-distribution-root> y <type-of-distribution>. Por ejemplo, el siguiente comando aplica las actualizaciones para el lote de JBoss EAP especificado:

Nota

Las actualizaciones de parches no se deben aplicar cuando se está ejecutando una instancia de Red Hat JBoss BPM Suite. Asegúrese de que el servidor sea apagado antes de ejecutar el siguiente comando.
$ ./apply-updates.sh ~/EAP_HOME/jboss-eap-6.4 eap6.x
A continuación, los tipos de distribución que cuentan con soporte:
  • eap6.x
  • eap6.x-bc
  • eap6.x-kie-server
  • eap6.x-dashbuilder
  • generic
  • generic-bc
  • generic-kie-server
  • generic-dashuilder
  • was8
  • was8-bc
  • was8-kie-server
  • was8-dashbuilder
  • wls12c
  • wls12c-bc
  • wls12c-kie-server
  • wls12c-dashbuilder
  • brms-engine
  • planner-engine
  • supplementary-tools
Los inicios rápidos y la herramienta de migración también se incluyen en el parche y están disponibles para descargar como un archivo ZIP.

Nota

Se incluyen únicamente las actualizaciones para BRMS/BPM Suite en la distribución del parche. Los parches de EAP deben aplicarse mediante el mecanismo de parches EAP. Consulte la Guía de instalación Red Hat JBoss EAP.

Funcionalidad de respaldo

Antes de aplicar las actualizaciones, el script de clientes crea un respaldo de la distribución especificada. Copia el archivo de distribución o el directorio en el subdirectorio backup/<current-timestamp>. El directorio de respaldo de nivel superior es creado en el mismo nivel de sistema de archivos que el script apply-updates.

Funcionalidad de lista negra

La herramienta de parches del cliente proporciona una funcionalidad de lista negra que le permite indicarle al script los archivos que no deben ser actualizados. Esta es una funcionalidad muy útil que le ayuda a evitar que sus archivos de configuración sean sobrescritos de forma automática en el proceso de actualización. Igualmente, usted puede especificar los archivos de no configuración, si se requiere.
Para especificar los archivos en lista negra, abra el archivo blacklist.txt que está presente dentro de la distribución de parches. Ingrese la ruta relativa a los archivos que no deben ser actualizados. Cada archivo debe especificarse en una línea individual.
# lines with a '#' are comment lines, like this one
# blank lines are ignored

# we have made changes to the web.xml that must be preserved
WEB-INF/web.xml

# this file has custom modifications
styles/base.css
Los archivos especificados en el archivo blacklist.txt que tienen el archivo de contenido actualizado, no son modificados por la herramienta de actualización. En su lugar, la herramienta copia el nuevo archivo, el archivo actualizado en la misma ubicación y le agrega el sufijo new. Por ejemplo, después de ejecutar la herramienta de parches, estos dos archivos existirán en la carpeta styles, continuando con el archivo blacklist.txt en el ejemplo de arriba.
$ ls styles
base.css base.css.new
Ahora es usted quien debe comparar los dos archivos y fusionar los cambios.
¿Qué sucede si hay archivos que ya no se distribuyen, pero que usted desea conservar? Póngalos también en el archivo blacklist.txt. La actualización de parches no los borra y en su lugar, creará un archivo marcador vacío con el sufijo removed. Dependerá de usted si desea mantenerlos o borrarlos manualmente.
Continuando con el ejemplo anterior, si el archivo base.css fue retirado y si usted lo tenía en la lista del archivo blacklist.txt, entonces después de ejecutar la herramienta de parches, el contenido de los estilos de directorio sería similar a:
$ ls styles
base.css base.css.removed