Actualización desde la versión 8.0.x, 8.1.x o 8.2.x anterior a la versión 8.2.0.7 con migración manual

El instalador de actualización de Marketing Platform puede realizar toda la migración de los datos necesarios para una actualización automática. Sin embargo, si la política de su organización no permite la migración automática, debe completar manualmente el procedimiento de migración para actualizar Marketing Platform. Para actualizar manualmente a Marketing Platform versión 9.1, debe ejecutar scripts SQL específicos e insertar las propiedades de configuración necesarias.

Asegúrese de que tiene los instaladores siguientes en el mismo directorio:

El instalador maestro de IBM®

El instalador de Marketing Platform

Asimismo, asegúrese de que la instalación de Marketing Platform 8.x funciona completamente y que puede ejecutar las herramientas de línea de comandos. La ejecución de las herramientas de línea de comandos requiere el uso de tres utilidades de Marketing Platform que se encuentran en el directorio tools/bin de la instalación de Marketing Platform. La información completa sobre la utilización de estas utilidades, incluidos comandos de ejemplo para las tareas comunes, está disponible en los temas siguientes:

La utilidad populateDb

Utilidad configTool

Utilidad alertConfigTool

Consulte Escenarios de actualización de Marketing Platform para obtener información sobre cómo actualizar desde otras versiones.

Al actualizar desde Marketing Platform versión 8.2 a la Marketing Platform versión 9.1, se visualiza un error en los registros. Puede ignorar este error porque la columna requerida está marcada y es nula. La instalación es satisfactoria.

1.	Complete los pasos siguientes para actualizar la instalación de Marketing Platform a la versión 9.1:

2.	Cree una copia de seguridad de la base de datos de la tabla del sistema de Marketing Platform.

No omita este paso. Si la operación de actualización falla, no puede retrotraer la base de datos y los datos se corrompen.

3.	Anule el despliegue de Marketing Platform.

4.	Ejecute el instalador maestro de IBM® EMM.

Se inicia el instalador maestro IBM® EMM. Siga las instrucciones siguientes después de que se inicie el instalador maestro de IBM® EMM:

Cuando el instalador maestro de IBM® EMM le solicite que elija un directorio de instalación, elija el directorio de instalación raíz, no el directorio de instalación de Marketing Platform que está bajo este directorio raíz.

Cuando el instalador maestro de IBM® EMM le pide que especifique la información de conexión de base de datos de Marketing Platform, especifique la información que pertenece a las tablas del sistema Marketing Platform actual.

El instalador maestro de IBM® EMM se pone en pausa e inicia el instalador de Marketing Platform.

5.	Complete los pasos siguientes mientras el instalador de Marketing Platform se está ejecutando:

a.	Cuando el instalador de Marketing Platform le solicite un directorio de instalación, seleccione el directorio de la instalación actual de Marketing Platform, normalmente, denominado Platform.

b.	Permita que el instalador cree una copia de seguridad de la instalación anterior de Marketing Platform.

c.	Seleccione Configuración manual de base de datos.

d.	Borre la casilla de verificación Ejecutar configuración de Platform.

e.	Siga los pasos restantes del asistente de instalación y especifique la información solicitada.

6.	Utilice la utilidad configTool para completar los pasos siguientes para asegurarse de que los scripts SQL que ejecuta en el paso 7 funcionen correctamente:

a.	Exporte todas las propiedades de configuración del nodo raíz de Affinium.

Por ejemplo, en Windows™, utilice el comando siguiente para exportar las propiedades al archivo config_property_export.xml, que se graba en el directorio install de la instalación de Marketing Platform:

configTool.bat -x -p "Affinium" -f "C:\Unica\Platform\install\config_property_export.xml"

b.	Suprima todas las propiedades de configuración del nodo raíz de Affinium.

Por ejemplo, en Windows™, utilice el comando siguiente para suprimir las propiedades:

configTool.bat -d -o -p "Affinium"

c.	Importe las propiedades de configuración que ha exportado.

Por ejemplo, en Windows™, utilice el comando siguiente para importar las propiedades del archivo config_property_export.xml, que se encuentra en el directorio de instalación de su instalación de Marketing Platform:

configTool.bat -i -o -f "C:\Unica\Platform\install\config_property_export.xml"

7.	Utilice uno de los scripts de la tabla siguiente para localizar los scripts SQL que se proporcionan con la nueva instalación de Marketing Platform en la base de datos de la tabla del sistema de Marketing Platform:

Ejecute los scripts SQL en el orden indicado.

Scripts para actualizar desde la versión 8.0.x
Nombre de script	Ubicación
ManagerSchema_Tipo_BD_81upg.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade80to81
ManagerSchema_Tipo_BD_8201upg.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade82to8201
ManagerSchema_Tipo_BD_85upg.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade82to85
insert_new_85_locales.sql	db\upgrade85to86
ManagerSchema_Tipo_BD_86upg.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade85to86
insert_new_8601_locales.sql	db\upgrade86to8601
active_portlets.sql	db
ManagerSchema_Tipo_BD_90upg.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade86to90
ManagerSchema_Tipo_BD_91upg.sql o ManagerSchema_Tipo_BD_91upg_unicode.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade90to91

Utilice los scripts de la tabla siguiente si está actualizando desde la versión 8.1.x o 8.2.0:

Scripts para actualizar desde la versión 8.1.x o 8.2.0
Nombre de script	Ubicación
ManagerSchema_Tipo_BD_8201upg.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade82to8201
ManagerSchema_Tipo_BD_85upg.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade82to85
insert_new_85_locales.sql	db\upgrade82to85
ManagerSchema_Tipo_BD_86upg.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade85to86
insert_new_8601_locales.sql	db\upgrade86to8601
active_portlets.sql	db
ManagerSchema_Tipo_BD_90upg.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade86to90
ManagerSchema_Tipo_BD_91upg.sql o ManagerSchema_Tipo_BD_91upg_unicode.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade90to91

Utilice los scripts de la tabla siguiente si está actualizando desde la versión 8.2.0.1 y posteriores versiones de parche anteriores a 8.2.0.7:

Scripts para actualizar desde la versión 8.2.0.1 y posteriores versiones de parche anteriores a 8.2.0.7
Nombre de script	Ubicación
ManagerSchema_Tipo_BD_85upg.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade82to85
insert_new_85_locales.sql	db\upgrade82to85
ManagerSchema_Tipo_BD_86upg.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade85to86
insert_new_8601_locales.sql	db\upgrade86to8601
active_portlets.sql	db
ManagerSchema_Tipo_BD_90upg.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade86to90
ManagerSchema_Tipo_BD_91upg.sql o ManagerSchema_Tipo_BD_91upg_unicode.sql donde Tipo_BD es el tipo de la base de datos de la tabla del sistema.	db\upgrade90to91

8.	Ejecute uno de los comandos siguientes:

Para Windows™:

directorio_instalación\platform\tools\bin\upgrade90to91.bat

Para Unix:

directorio_instalaciónplatform/tools/bin/upgrade90to91.sh

9.	Utilice la utilidad populateDb para rellenar las tablas del sistema con las propiedades de configuración, los usuarios y grupos y los roles y permisos de seguridad predeterminados de Marketing Platform.

La utilidad populateDb se encuentra en el directorio tools/bin de la instalación de Marketing Platform.

Ejemplo: populateDb -n Manager

10.	Utilice la utilidad configTool para importar las propiedades de configuración tal como se describe en la tabla siguiente:

La utilidad configTool se encuentra en el directorio tools/bin de la instalación de Marketing Platform. Para obtener detalles completos sobre la función de las propiedades de configuración, consulte la ayuda en línea de la página Configuración o la publicación IBM® Marketing Platform Guía del administrador.

Los comandos de ejemplo de la tabla siguiente son para el sistema operativo Windows™.

Archivos para actualizar desde la versión 8.0.x, 8.1.x o versiones 8.2.x anteriores a la versión 8.2.0.7

Detalles del archivo

Comando de ejemplo

Omita esta importación si la propiedad denominada Búsqueda periódica DN base de LDAP habilitada está presente en la categoría Platform | Seguridad | Detalles del método de Inicio de sesión | Sincronización LDAP. Esta es la propiedad que ha comprobado en el paso 1 de este procedimiento.

Si la propiedad no está presente, realice la siguiente importación.

Archivo: Ldap_Auto_Sync_BaseDN_Settings.xml

Ubicación: directorio conf\upgrade86to90 de la instalación de Marketing Platform

Finalidad: importar una propiedad de configuración que habilite la búsqueda de importación LDAP por DN

configTool.bat -i -p "Affinium|suite|security|ldapSynchronization|ldapProperties" -f "C:\Unica\Platform\conf\upgrade86to90\Ldap_Auto_Sync_BaseDN_Settings.xml"

Archivo: interaction_history_scheduler.xml

Ubicación: directorio conf/upgrade85to86 de la instalación de Marketing Platform

Finalidad: importar las propiedades de configuración del planificador necesarias para Interaction History

configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations" -f "C:\Unica\Platform\conf\upgrade85to86\interaction_history_scheduler.xml"

Archivo: attribution_modeler_scheduler.xml

Ubicación: directorio conf/upgrade85to86 de la instalación de Marketing Platform

Finalidad: importar las propiedades de configuración del planificador necesarias para Attribution Modeler

configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations" -f "C:\Unica\Platform\conf\upgrade85to86\attribution_modeler_scheduler.xml"

Archivos: coremetrics_configuration.xml y coremetrics_navigation.xml

Ubicación: directorio conf de la instalación de Marketing Platform

Finalidad: importar las propiedades de configuración necesarias para el inicio de sesión único con IBM® Digital Analytics

configTool.bat -i -p "Affinium" -f "C:\Unica\Platform\conf\coremetrics_configuration.xml"

configTool.bat -i -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f "C:\Unica\Platform\conf\coremetrics_navigation.xml"

Archivo: cognos10_integration.xml

Ubicación: directorio conf/upgrade85to86 de la instalación de Marketing Platform

Finalidad: importar las propiedades de configuración necesarias para la creación de informes

configTool.bat -i -p "Affinium|Report|integrations" -f "C:\Unica\Platform\conf\upgrade85to86\cognos10_integration.xml"

Archivo: ningún archivo - eliminación de propiedades

Finalidad: eliminar propiedades de configuración de JMS que ya no se utilizan

configTool.bat -d -o -p "Affinium|suite|jmsServer"

configTool.bat -d -o -p "Affinium|suite|jmsPort"

Archivo: LDAP_Anonymous_bind.xml

Ubicación: directorio conf/upgrade85to86 de la instalación de Marketing Platform

Finalidad: sólo si se actualiza desde la versión 8.2.0 o posterior, importar una nueva propiedad de configuración LDAP

configTool -i -p "Affinium|suite|security|loginModes|LDAPPartitionLogin" -f C:\Unica\Platform\conf\upgrade85to86\LDAP_Anonymous_bind.xml

Archivo: quicklinks_category.xml

Ubicación: directorio conf\upgrade86to90 de la instalación de Marketing Platform

Finalidad: importar propiedades para portlets de panel de control de enlaces rápidos

configTool.bat -i -o -p "Affinium|suite" -f "C:\Unica\Platform\conf\upgrade86to90\quicklinks_category.xml"

Archivo: manager_alerts_registration.xml

Ubicación: directorio conf de la instalación de Marketing Platform

Finalidad: importar propiedades de configuración que crean los elementos del menú de alertas

configTool.bat -i -o -p "Affinium|suite|uiNavigation|alerts" -f "C:\Unica\Platform\conf\manager_alerts_registration.xml"

Archivo: disablePageTagging.xml

Ubicación: directorio conf\upgrade82to85 de la instalación de Marketing Platform

Finalidad: importar una propiedad de configuración que determina si IBM® puede recopilar estadísticas básicas que realicen un seguimiento de las tendencias globales de uso del producto.

configTool.bat -i -o -p "Affinium|suite" -f "C:\Unica\Platform\conf\upgrade82to85\disablePageTagging.xml"

Archivos: coremetrics_configuration.xml y coremetrics_navigation.xml

Ubicación: directorio conf de la instalación de Marketing Platform

Finalidad: importar las propiedades de configuración necesarias para el inicio de sesión único con IBM® Digital Analytics

configTool.bat -i -o -p "Affinium" -f "C:\Unica\Platform\conf\coremetrics_configuration.xml"

configTool.bat -i -o -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f "C:\Unica\Platform\conf\coremetrics_navigation.xml"

Archivo: scheduler.xml

Ubicación: directorio db\upgrade90to91 de la instalación de Marketing Platform

Finalidad: la propiedad booleana para habilitar o inhabilitar la característica del planificador en Marketing Platform.

configtool -i -p "Affinium|suite|scheduler" -f "C:\Unica\Platform\conf\upgrade90to91\scheduler.xml"

Archivo: unknownPolling.xml

Ubicación: directorio db\upgrade90to91 de la instalación de Marketing Platform

Finalidad: importa propiedades para portlets del panel de control de enlaces rápidos

configtool -i -p "Affinium|suite|scheduler" -f "C:\Unica\Platform\conf\upgrade90to91\unknownPolling.xml"

Archivo: communication_email.xml

Ubicación: directorio conf\upgrade86to90 de la instalación de Marketing Platform

Finalidad: importa propiedades de configuración para habilitar las notificaciones por correo electrónico. Cuando se habilita, Marketing Platform intenta enviar correos electrónicos a los usuarios para notificaciones y alertas del sistema.

configTool.bat -i -o -p "Affinium|Manager" -f "C:\Unica\Platform\conf\upgrade86to90\communication_email.xml"

Archivo: notification.xml

Ubicación: directorio conf\upgrade86to90 de la instalación de Marketing Platform

Finalidad: importa propiedades de configuración para la característica de notificación. Se han añadido las propiedades siguientes:

Número de días para retener las alertas: 90

Frecuencia en minutos con la que se envían los correos electrónicos: 30

Número máximo de reintentos para envío y correo electrónico: 1

configTool.bat -i -o -p "Affinium|suite" -f "C:\Unica\Platform\conf\upgrade86to90\notification.xml"

Archivo: is_clustered.xml

Ubicación: directorio conf\upgrade86to90 de la instalación de Marketing Platform

Finalidad: la propiedad booleana para especificar si la instancia de Marketing Platform está en clúster. Si instala Marketing Platform en un despliegue en clúster, establezca esta propiedad en True. De lo contrario, conserve el valor predeterminado False.

configtool -i -p "Affinium|suite" -f "C:\Unica\Platform\conf\upgrade90to91\is_clustered.xml"

Archivo: taskNotification.xml

Ubicación: directorio conf\upgrade86to90 de la instalación de Marketing Platform

Finalidad: importa el campo Nombre de grupo donde puede especificar los grupos a los que se notifica con notificaciones planificadas.

Archivo: config_data_filter_cache.xml

Ubicación: directorio conf\upgrade90to91 de la instalación de Marketing Platform

Finalidad: permite configurar la memoria caché de filtro de datos. Si la propiedad de configuración se establece en True, la memoria caché de filtro de datos se habilita para mejorar el rendimiento. Si la propiedad de configuración se establece en False, la memoria caché no se habilita, y todas las operaciones se completan mediante la conexión a la base de datos para cada solicitud de filtro de datos. La propiedad de configuración está visible en la interfaz de usuario.

configTool.bat -vp -p "Affinium|Manager|datafiltering" -f "C:\Unica\Platform\conf\upgrade90to91\Config_data_filter_cache.xml"

Si cambia este valor, debe reiniciar Marketing Platform para que los cambios entren en vigor.

Archivo: Refresh_data_filter_cache.xml

Ubicación: directorio conf\upgrade90to91 de la instalación de Marketing Platform

Finalidad: si la memoria caché de filtro de datos está habilitada, esta propiedad de configuración asegura que la memoria caché se renueva cada vez que hay un cambio en las definiciones de filtro de datos.

configTool.bat -vp -p "Affinium|Manager|datafiltering" -f "C:\Unica\Platform\conf\upgrade90to91\Refresh_data_filter_cache.xml"

Archivos: navigation.xml and emm_spss_configuration.xml

Ubicación: conf\upgrade90to91

Finalidad: importar propiedades de configuración de IBM® SPSS® Modeler Advantage Marketing Edition.

configTool -i -o -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f "C:\Unica\Platform\conf\emm_spss_navigation.xml"

configTool -i -o -p "Affinium" -f "C:\Unica\Platform\conf\emm_spss_configuration.xml"

11.	Ejecute la utilidad alertConfigTool desde el directorio tools\bin de la instalación de Marketing Platform para registrar las alertas y notificaciones de Marketing Platform.

Comando de ejemplo (Windows™):

alertConfigTool.bat -i -f "C:\Platform\conf\Platform_alerts_configuration.xml"

12.	Ejecute el script upgrade85Dashboard desde el directorio tools\bin de la instalación de Marketing Platform para actualizar el panel de control.

13.	Vaya a Ayuda > Acerca de y complete los pasos siguientes para actualizar la página Acerca de:

a.	Emplee la utilidad configTool para exportar la categoría Affinium \| Manager \| acerca de.

Affinium | Manager | acerca de no está visible en la página Configuración porque se ha marcado como oculto.

Ejemplo (Windows™):

configTool.bat -x -p "Affinium|Manager|about" -f "C:\Unica\Platform\conf\about.xml"

b.	Edite el archivo XML exportado que acaba de crear (about.xml en el ejemplo) para cambiar el número de versión y el nombre de visualización. Busque la propiedad releaseNumber y cambie el valor a la versión actual de Marketing Platform.

En el ejemplo siguiente, cambie 8.0.0 por su nueva versión:

<property name="releaseNumber" type="string">
<displayNameKey>about.releaseNumber</displayNameKey>
<value>9.1.0.0.0.número_compilación</value>
</property>

c.	Utilice la utilidad configTool para importar el archivo revisado. Debe utilizar la opción -o para sobrescribir el nodo. Debe especificar el nodo padre al importar.

Ejemplo (Windows™):

configTool.bat -i -p "Affinium|Manager" -f "about.xml" -o

14.	Despliegue y verifique la instalación según se describe en el capítulo Despliegue de Marketing Platform.

Después de que el proceso de actualización sea satisfactorio y la aplicación esté en funcionamiento, suprima las tablas liferay utilizando el script drop-liferay-tables.sql. drop-liferay-tables.sql se encuentra en el directorio Instalación_Platform/db/upgrade86to90/drop-liferay-tables.sql.

Consulte la publicación IBM® EMM Reports Guía de instalación y configuración para ver los pasos adicionales necesarios para las actualizaciones de informes.