Actualización de bases de datos de SQL Server

Para SQL Server, inicialice bases de datos nuevas y actualice los esquemas y datos existentes para que las bases de datos funcionen con la nueva versión de IBM® Business Process Manager.

Figura 1. Entorno de ejemplo después de actualizar los esquemas y datos existentes. El entorno de origen no está en ejecución y las bases de datos no está en uso. Las bases de datos contienen esquemas y datos actualizados. El destino no está en ejecución aunque contiene un entorno de despliegue.

Los detalles del diagrama se proporcionan en el título de la figura.

Ejecute el mandato DBUpgrade para modificar los esquemas y datos de bases de datos existentes para utilizarlos IBM Business Process Manager V8.5.6. El programa de utilidad DBUpgrade actualiza los siguientes objetos en V8.5.6:

Toolkit de datos del sistema
Aplicación de proceso Process Portal
Aplicación de proceso de guía de aprendizaje Hiring Sample

Nota: Aunque el programa de utilidad DBUpgrade actualiza el kit de herramientas de datos del sistema a IBM Business Process Manager V8.5.6 no actualiza automáticamente las dependencias existentes. Las dependencias deben actualizarse después de la migración.

Antes de empezar

Verifique que los usuarios que están configurados para acceder a las bases de datos de SQL Server tienen los privilegios necesarios para actualizar las bases de datos. Los siguientes privilegios de bases de datos son necesarios para modificar esquemas de bases de datos existentes de SQL Server para utilizarlos con IBM Business Process Manager V8.5.6.

Los privilegios CONNECT y CREATETAB son necesarios en el nivel de base de datos.
El proceso de actualización accede a las tablas de sistema. Otorgue el privilegio SELECT al usuario que realiza la actualización. Estos privilegios ya están otorgados al grupo público de forma predeterminada; no es necesario volver a otorgarlo, a menos que se hayan revocado.
```
INFORMATION_SCHEMA.COLUMNS.TABLES
INFORMATION_SCHEMA.COLUMNS.COLUMNS
sys.indexes
sys.sysobjects
```
No otorgue el rol de servidor sysadmin a los usuarios. Si un usuario tiene el rol sysadmin, dbo siempre será el esquema predeterminado sin importar qué esquema se asigne. Como resultado, la migración utilizará dbo para crear nuevas tablas o actualizar datos.

Si desea una lista de las versiones de bases de datos soportadas, consulte los requisitos del sistema.

Procedimiento

Para cada entorno de despliegue que vaya a crear, realice los pasos siguientes:

Copie la carpeta entera perfil_gestor_despliegue_destino\dbscripts\Upgrade\ en el sistema de base de datos.
Si no ha creado una nueva base de datos de motor de mensajería y, en lugar de esto, tiene previsto reutilizar el esquema y la base de datos del motor de mensajería anterior, debe descartar manualmente las tablas de motor de mensajería existentes para cada uno.
Consejo: Los nombres de tablas de motor de mensajería utilizan el prefijo SIB.
En el sistema de base de datos, actualice todos los esquemas. Para ver qué esquemas se actualizan, vaya al directorio donde ha copiado la carpeta Upgrade y consulte el archivo upgradeSchemaScriptsHelp_nombre_ed.txt.
Vaya al directorio donde ha copiado la carpeta Upgrade y ejecute el mandato upgradeSchemaAll. Hay un mandato upgradeSchemaAll distinto para cada entorno de despliegue del origen.

Importante: Si está utilizando la autenticación de Windows, no puede ejecutar upgradeSchemaAll y debe ejecutar los scripts SQL directamente utilizando una sesión SQL.
```
upgradeSchemaAll_nombre_ed.bat
```
Se le solicitará que especifique el nombre de usuario y la contraseña para cada conexión de base de datos. Este mandato inicializa los nuevos componentes de base de datos y actualiza los esquemas de todas las bases de datos existentes, excepto para las bases de datos de Process Server y Performance Data Warehouse. Estas dos bases de datos se actualizan posteriormente mediante el mandato DBUpgrade.
De forma alternativa, si desea ejecutar los scripts SQL manualmente, utilice una sesión SQL y ejecute los scripts en la secuencia listada en el archivo carpeta_actualización\upgradeSchemaScriptsHelp_nombre_ed.txt y utilice los parámetros y mandatos siguientes.
```
osql -e -b -U nombre_usuario -P contraseña -i nombre_script -o nombre_registro
```
donde:
- -e especifica que va a hacerse eco del mandato en las solicitudes.
- -b especifica que el script ha de salir cuando haya errores.
- -U especifica el nombre de usuario
- -P especifica la contraseña
- -i especifica el archivo de entrada
- -o especifica que toda la salida se debe redirigir a un archivo
Es posible que vea mensajes de aviso cuando ejecute los scripts para actualizar la base de datos de Business Space que le indiquen que el resultado de una consulta es una tabla vacía o que no se han encontrado filas para FETCH, UPDATE o DELETE. Estos mensajes pueden ignorarse de forma segura.

Los archivos result.log se encuentran en carpeta_actualización\nombre_célula o nombre_célula.nombre_ed\tipo_base_datos\nombre_base_datos.nombre_esquema.
Copie el archivo migration.properties de ejemplo y renómbrelo por target_migration.properties. Actualice el archivo con la información de configuración para el entorno de destino. Compruebe todas las propiedades destino y edítelas, si es necesario, siguiendo las instrucciones del archivo de ejemplo. El archivo de ejemplo está en raíz_instalación_8.5\util\migration\resources\migration.properties.
Asegúrese de que todas las propiedades se han cambiado en el entorno de destino (no origen). Asegúrese de que el valor de la propiedad target.config.property.file está establecido en la vía de acceso completa del archivo de propiedades de configuración que ha utilizado para crear el entorno de destino. También debe establecer el valor de profile.name en el nombre del perfil de gestor de despliegue nuevo.
Si está utilizando SQL Server con la autenticación de Windows habilitada, copie el archivo sqljdbc_auth.dll de inicio_WAS\jdbcdrivers\SQLServer\auth\plataforma a inicio_WAS\java\jre\bin antes de ejecutar el programa de utilidad DBUpgrade.
Para actualizar las bases de datos en V8.5.6, ejecute el programa de utilidad DBUpgrade en el sistema del gestor de despliegue en el entorno de destino. El mandato DBUpgrade actualiza automáticamente el esquema y los datos para Process Server y Performance Data Warehouse.
Consejo: De forma predeterminada, DBUpgrade actualiza tanto el esquema como los datos para bases de datos de Process Server y Performance Data Warehouse. Si desea instrucciones para ejecutar la actualización del esquema por separado, consulte el tema de referencia de la utilidad de línea de mandatos DBUpgrade.

Importante: Asegúrese de que el gestor de despliegue y todos los nodos gestionados del entorno de origen se han detenido antes de ejecutar este programa de utilidad.
```
raíz_instalación\bin\DBUpgrade.bat -propertiesFile archivo_propiedades_migración_destino
```
donde:
- archivo_propiedades_migración_destino es la vía de acceso completa del archivo de propiedades de migración en el cual ha especificado la información de configuración para el entorno de destino.
Por ejemplo:
```
raíz_instalación\bin\DBUpgrade.bat -propertiesFile "C:\bpm 85\util\migration\resources\target_migration.properties"
```
El mandato muestra cada acción de actualización de base de datos a medida que se ejecuta. Después de que todas las actualizaciones hayan finalizado, verá un mensaje similar al mensaje siguiente:
```
Todos los pasos de actualización se han completado satisfactoriamente.
```
La ubicación del registro se lista en la salida. Si hay errores o excepciones, aparecen en el registro.
Si está migrando desde 7.5.x y obtiene un error de falta de memoria que indica que hay demasiados registros de datos o que son demasiado grandes, puede intentar incrementar el tamaño de almacenamiento dinámico de la JVM para el mandato DBUpgrade. Abra el archivo DBUpgrade.bat en raíz_instalación\bin y busque -Xmx2048m en este archivo. Indica que el tamaño de almacenamiento dinámico máximo de la JVM es de 2048 megabytes. Puede aumentar este valor para actualizar el tamaño de almacenamiento dinámico.

Qué hacer a continuación

Es posible que vea mensajes de aviso similares al siguientes en el registro de actualización:No se ha podido cargar el recurso META-INF*****. Estos mensajes pueden ignorarse de forma segura.