Configuración gráfica del entorno con el editor de configuración de IBM BPM

El editor de configuración de IBM BPM es una interfaz basada en navegador para configurar el entorno de despliegue nuevo. Puede editar gráficamente el archivo de propiedades de configuración que se ha exportado del entorno de origen mediante el mandato BPMConfig -migrate. Después de modificar el archivo de propiedades en el editor, puede utilizar el mandato BPMConfig -create para crear un entorno de despliegue nuevo que se base en el archivo modificado.

Acerca de esta tarea

La imagen siguiente y la tabla correspondiente describen las partes del editor de configuración que interactúan cuando se configura el entorno de despliegue nuevo. Para la migración, el título también refleja el producto y la versión de origen y destino.

Tabla 1. Descripción de áreas etiquetadas de la imagen de editor de configuración

Etiqueta	Parte	Descripción
A	Topología	Edite las propiedades de todos los componentes disponibles, como las células, los nodos y los entornos de despliegue. Algunas propiedades se han modificado automáticamente durante la exportación y otras requieren entrada manual. Los componentes que están configurados incorrectamente están sombreados de color gris. Las propiedades que tienen valores que faltan o no válidos están rodeadas con un borde rojo y se marcan con un icono de signo de exclamación rojo.
B	Seguridad	Edite las propiedades de LDAP. Edite las personalizaciones de los archivos WebSphere Lombardi Edition, incluyendo Process Admin Console, Process Server y otras propiedades personalizadas. La información que se ve en este separador depende de la configuración de origen.
C	Rendimiento	Edite las propiedades para los orígenes de datos, las agrupaciones de hebras, las especificaciones de activación, los gestores de trabajo, los valores de JVM, las fábricas de conexiones, los datos ORB, los contenedores web y los motores de mensajería.
D	Resumen	Desplácese por todas las propiedades disponibles antes de guardar el archivo de propiedades de configuración. Realice ediciones adicionales.
E	Asistencia de configuración	Mostrar el panel de ayuda según contexto.
1	Célula	Edite las propiedades de célula, como el nombre de célula. Correlacione el rol de administrador de célula con un alias de autenticación.
2	Entorno de despliegue	Edite las propiedades de entorno de despliegue, por ejemplo el tipo de IBM BPM. En Process Server, también puede cambiar las propiedades de conectividad de Process Center.
3	Bases de datos	Edite las propiedades de base de datos o correlacionen los roles de base de datos con alias de usuario.
4	Gestor de despliegue	Edite las propiedades de gestor de despliegue, por ejemplo el nombre de host, nodo, nombre de perfil y puerto SOAP.
5	Nodo	Edite las propiedades para cada nodo, por ejemplo el nombre de nodo, el nombre de host, el puerto y el nombre de perfil.
6	Clúster	Edite las propiedades para cada clúster.
7	Miembro del clúster	Edite las propiedades para cada miembro del clúster.
8	Alias	Edite las correlaciones de alias de autenticación para el administrador de entorno de despliegue, el administrador de base de datos y otros alias con los usuarios y las contraseñas.
9	Bus	Edite las propiedades de bus, por ejemplo las bases de datos a las que hacen referencia.
10	Mensajes de validación	Corrija las propiedades incompletas o incorrectas pulsando los mensajes de esta tabla.

1. Para instalar el editor de configuración de IBM BPM, complete los pasos siguientes:
   1. Extraiga el paquete de editor de configuración BPMConfigurationEditor.zip en un directorio. El paquete está en raíz_instalación/BPM/config/ui/.
   2. Asegúrese de que los siguientes archivos del paquete son ejecutables:
      • raíz_instalación/BPM/config/ui/configEditor.sh
      • raíz_instalación/BPM/config/ui/validation/validate.sh
   3. Edite el archivo configEditor.ini para establecer la ubicación de JAVA_HOME. Por ejemplo, JAVA_HOME=/opt/IBM/BPM856/java/jre.

      Opcionalmente puede cambiar el puerto que el editor utiliza. Si no cambia el puerto, se utiliza el puerto predeterminado 8888. Sin embargo, si ejecuta el mandato configEditor y el puerto 8888 ya está siendo utilizado por un proceso diferente, recibirá el error Error: listen EADDRINUSE. Si recibe el error, puede detener el proceso que ya está utilizando el puerto 8888 o puede especificar un número de puerto nuevo en el archivo configEditor.ini (como puerto 9999).

   4. Inicie el servidor.
      • En el directorio donde se encuentra el ejecutable configEditor.sh, ejecute el mandato configEditor.sh. El archivo BPMConfigEditor.log se escribe en el mismo directorio donde se ejecuta el mandato.
   5. Si un navegador no se abre automáticamente para ejecutar el editor de configuración, abra un navegador manualmente. El editor de configuración solo permite el acceso local. En el sistema donde está instalado el editor, especifique el URL siguiente:

      http://localhost:8888/ibm/bpm/configEditor

      Cambie el número de puerto si lo ha cambiado en el archivo configEditor.ini.
2. Pulse Examinar y seleccione el archivo de propiedades que se ha creado al ejecutar BPMConfig -migrate. Por ejemplo, DE1-Standard-PS-SingleCluster-DB2.properties. Pulse Abrir editor para empezar a configurar el nuevo entorno.
3. Configure el entorno de destino.
   • Tenga en cuenta las propiedades de base de datos que elige cuando añada nuevas prestaciones de base de datos. Creará las bases de datos nuevas necesarias en el paso siguiente.
     Consejo: En IBM® BPM V8.5.6, la base de datos común está dividida en dos partes. Una tiene ámbito de célula y se utiliza para toda la célula. La otra, que incluye el gestor de sucesos anómalos y la secuencia de sucesos, tiene ámbito de entorno de despliegue, y se debe configurar para cada entorno de despliegue.
   • El entorno de destino utilizará las mismas bases de datos que el entorno de origen, a menos que cambie los valores predeterminados. Si utiliza bases de datos clonadas para probar la migración, haga una copia de seguridad del archivo de propiedades BPMConfig exportado poder restaurar las propiedades de base de datos correctas después de finalizar y probar la migración. A continuación, actualice la información de base de datos en el archivo para utilizar las bases de datos clonadas.
   • Para Oracle, si está utilizando un URL personalizado para una base de datos Oracle en el entorno de origen, se migrará el URL. Puede comprobar el valor para cada capacidad de base de datos en el área de datos del editor en la pestaña Opciones avanzadas. Actualice el valor URL de base de datos, si es necesario o, en su lugar, establezca el Host de base de datos y Puerto en la pestaña Opciones básicas. La propiedad URL de base de datos o las propiedades Host de base de datos y Puerto se deben dejar vacías, pero la propiedad Nombre de base de datos siempre se debe establecer.

     Si está migrando desde un release anterior a IBM BPM V8.0 y está utilizando una base de datos Oracle con la característica de nombre de servicio habilitada, deberá borrar la propiedad URL de base de datos y establecer las propiedades Host de base de datos y Puerto en su lugar, para que los URL de base de datos de formato SCAN predeterminados se creen en la configuración de IBM BPM.

   • Si está migrando más de un entorno de despliegue, asegúrese de que el nombre del alias de autenticación para cada base de datos es diferente si hay un nombre de usuario distinto en cada entorno de despliegue. De lo contrario, la creación del segundo entorno de despliegue fallará porque el alias de autenticación utiliza un nombre de usuario diferente.
     Por ejemplo, su primer entorno de despliegue tiene el alias de autenticación BPM_DB_ALIAS como user1 como nombre de usuario.

     bpm.de.authenticationAlias.3.name=BPM_DB_ALIAS
     bpm.de.authenticationAlias.3.user=user1
     bpm.de.authenticationAlias.3.password=

     Antes de crear el segundo entorno de despliegue, compruebe el archivo de propiedades BPMConfig para asegurarse de que no existe el mismo alias de autenticación con un nombre de usuario distinto. En ese caso, cambie el nombre del alias de autenticación. Por ejemplo:

     bpm.de.authenticationAlias.3.name=BPM_DB_ALIAS_2
     bpm.de.authenticationAlias.3.user=user2
     bpm.de.authenticationAlias.3.password=

   • Si está migrando a IBM BPM Advanced y tiene previsto utilizar la función de gestión de casos básicos, debe crear un entorno de despliegue Advanced o Standard. La gestión de caso no está soportada en el entorno de despliegue AdvancedOnly.
   • Asegúrese de que los caracteres especiales del nombre de usuario y la contraseña del entorno de origen son compatibles en la nueva versión. Modifique el nombre de usuario y la contraseña, si es necesario. Deben contener solo los caracteres siguientes:

     a-zA-Z0-9!()-._`~@

   • Si el entorno de origen está configurado para un servidor web o un servidor de equilibrio de carga, el archivo de propiedades generado tiene entradas para bpm.de.processServer. En el editor, estas propiedades están en la pestaña Seguridad en propiedades personalizadas de Process Server. Por ejemplo:

     bpm.de.processServer.processAdminPrefix=https://mzwin7-bpm1/ProcessAdmin
     bpm.de.processServer.teamworksWebAppPrefix=https://mzwin7-bpm1/teamworks
     bpm.de.processServer.clientLink=https://mzwin7-bpm1/teamworks
     bpm.de.processServer.commonPortalPrefix=https://mzwin7-bpm1/portal

     Debe cambiar estos URL para que coincidan con el entorno de destino. Si no está seguro sobre cuáles son las nuevas URL, suprima estas entradas en el archivo de propiedades o elimínelas en el editor. Después de completar la migración, siga el procedimiento estándar para configurar el servidor web.
   • Arregle todos los errores de validación para garantizar un entorno de destino correcto y completo.
   • Pulse Guardar para guardar el archivo de propiedades de configuración.
     Importante: Guarde el archivo de propiedades en la misma ubicación (donde lo ha creado al ejecutar BPMConfig -migrate), porque hace referencia a otros archivos de configuración exportados.

ps -ef | grep node
kill -9 process_id