Realización de una actualización de versión

Esta sección le proporcionará un tutorial detallado sobre el proceso de actualización y los pasos para identificar y resolver conflictos.

La mejora de la construcción debe llevarse a cabo con cautela, sus efectos deben ser objeto de un examen previo y el procedimiento debe completarse con un alto nivel de disciplina. Para garantizar una actualización correcta, asegúrese de que solo los usuarios expertos realicen los pasos descritos a continuación. Además, recomendamos encarecidamente ponerse en contacto con Servicio de atención al cliente de Adobe antes de iniciar cualquier actualización.

Se necesitan los siguientes requisitos previos:

  • Comprensión de la Arquitectura de Campaña
  • Conocimientos de sistemas y servidores
  • Derechos y permisos administrativos

Puede encontrar más información en estas secciones: Actualizando Adobe Campaign, Migrando a una nueva versión.

En el caso de instancias hospedadas e híbridas, debe solicitar la actualización de la compilación al equipo de operaciones técnicas de Adobe. Para obtener más información sobre esto, consulte la sección Preguntas más frecuentes en la parte inferior si esta página. Consulte también las preguntas frecuentes sobre la actualización de la compilación.

Preparación de la actualización

Antes de iniciar la actualización de la compilación, debe realizar una preparación completa como se describe a continuación.
Una vez que el sistema está listo para ser actualizado, una actualización de la compilación tarda al menos 2 horas.

El proceso de actualización de la compilación requiere los siguientes recursos:

  • un arquitecto de Adobe: para comprender las estructuras de la base de datos (esquemas listos para usar y cualquier esquema adicional que se haya agregado, diseños de campaña y cualquier funcionalidad de ruta crítica que se deba iniciar y probar en un orden específico).
  • un jefe de proyecto: En el caso de que la actualización de la compilación involucre muchas instancias diferentes (producción, ensayo, pruebas) y otros servidores y aplicaciones de terceros (bases de datos, sitios SFTP, proveedores de servicio de mensajería), se considera una práctica recomendada contar con un administrador de proyectos para coordinar todas las pruebas.
  • un administrador de Adobe Campaign: su administrador conoce la configuración del servidor, incluida, entre otras cosas: requisitos de seguridad, presentación de carpetas, sistema de informes e importación/exportación. No realice una actualización de compilación sin el administrador.
  • un operador de Adobe Campaign (usuario de marketing): una actualización correcta depende de la capacidad del usuario para realizar correctamente sus tareas diarias. Por este motivo, incluya siempre al menos uno de los operadores diarios en las pruebas de los servidores actualizados.

Planificación

Estos son los puntos clave sobre cómo planificar una actualización de compilación:

  1. Reserva al menos 2 horas para la actualización.
  2. Distribuya los datos de contacto para el Adobe y el personal del cliente.
  3. Para instancias hospedadas: El personal de Adobes y clientes coordinará el tiempo de la actualización y quién la ejecutará.
  4. Para instancias in situ: el personal del cliente gestiona todo el proceso: si se necesita asistencia para probar flujos de trabajo personalizados y lógica de envío, se deben incorporar servicios de consultoría.
  5. Determine y confirme a qué versión de Adobe Campaign desea actualizar: consulte las notas de la versión de Adobe Campaign Classic.
  6. Confirme la posesión de ejecutables de actualización.

Personas clave

El proceso de actualización de la compilación requiere la participación de las siguientes personas:

  • Adobe, arquitecto: en el caso de las arquitecturas alojadas o híbridas, el arquitecto debe coordinarse con Adobe Campaign Client Care.

  • Administrador de proyectos:

    • para instalaciones in situ: el jefe de proyecto interno del cliente dirige la actualización y administra las pruebas del ciclo vital.

    • para la instalación alojada: el equipo de alojamiento se asociará con el equipo de Adobe Campaign Client Care y el cliente para coordinar la cronología de actualización de todas las instancias.

  • Administrador de Adobe Campaign:

    • para instalaciones in situ: el administrador realiza la actualización.

    • para instalaciones alojadas: el equipo de alojamiento realiza la actualización.

  • Operador de Adobe Campaign\usuario de marketing: el operador ejecuta pruebas en instancias de desarrollo, prueba y producción.

Preparación de la actualización de la compilación

Antes de iniciar la actualización de la compilación, los clientes internos deben realizar la siguiente preparación:

  1. Asegúrese de que cualquier trabajo de desarrollo se pueda exportar antes de la actualización, exporte como paquetes.

  2. Realice una copia de seguridad completa de las bases de datos para todas las instancias de los entornos de origen y destinatario.

  3. Obtenga la versión más reciente del archivo de configuración del servidor.

  4. Descargue la última compilación. Obtenga más información sobre el centro de descargas.

También necesita conocer todas las líneas de comandos útiles antes de iniciar una actualización de compilación:

  • nlserver pdump: listas que ejecutan procesos
  • nlserver pdump -quien: listas de sesiones de cliente activas
  • monitor nlserver -falta: Faltan propiedades en las listas
  • inicio de NLServer process@instanceName: inicio un proceso
  • nlserver stop process@instanceName: detiene un proceso
  • nlserver Restart process@instanceName: reinicia un proceso
  • nlserver shutdown: detiene todos los procesos de Campaña
  • nlserver watchdog -svc: inicio el vigilante (solo UNIX)

Realizar la actualización

Los procedimientos que se describen a continuación sólo los realizan clientes internos. Para los clientes alojados, el equipo de alojamiento se encarga de ello. Para actualizar Adobe Campaign a una nueva compilación, a continuación se describe el procedimiento detallado.

Duplicado del entorno

Así es como se duplicado un entorno de Adobe Campaign para restaurar un entorno de origen a un entorno de destinatario, lo que resulta en dos entornos de trabajo idénticos.

Para realizar esto, siga los pasos a continuación:

  1. Cree una copia de las bases de datos en todas las instancias del entorno de origen.

  2. Restaure estas copias en todas las instancias del entorno de destinatario.

  3. Ejecute la secuencia de comandos de cauterización nms:PLInstance.js en el entorno de destinatario antes de iniciarla. Esto detendrá todos los procesos que interactúen con el exterior: registros, seguimiento, envíos, flujos de trabajo de la campaña, etc.

    nlserverjavacsriptnms:freezeInstance.js–instance:<dev> -arg:run

  4. Compruebe la cauterización como se indica a continuación:

    • Compruebe que la única parte de envío es la que tiene el ID establecido en 0:

      SELECT * FROM neolane.nmsdeliverypart;

    • Compruebe que la actualización del estado del envío es correcta:

      SELECT iSate, count(*) FROM neolane.nmsdeliveryGroup By iProd;

    • Compruebe que la actualización de estado del flujo de trabajo es correcta:

      SELECT iState, count (*) FROM neolane.xtkworkflowGROUP BY iState;
SELECT iStatus, count (*) FROM neolane.xtkworkflowGROUP BY iStatus;

Cerrar servicios

Para reemplazar todos los archivos con la nueva versión, es necesario que se cierren todas las instancias de nlserverservice.

  1. Cierre los siguientes servicios:

    • Servicios Web (IIS): iisreset /stop
    • Servicio Adobe Campaign: net stop nlserver6
    NOTA

    Asegúrese de que el servidor de redirección (webmdl) está detenido, para que el archivo nlsrvmod.dll utilizado por IIS pueda reemplazarse por la nueva versión.

  2. Valide que no haya tareas activas ejecutando el comando nlserver pdump. Si no hay tareas, la salida debería parecerse a la siguiente:

    C:\<installation path>\bin>nlserverpdump HH:MM:SS > Application Server for Adobe Campaign version x.x (build xxx) dated xx/xx/xxxx No tasks

  3. Consulte el Administrador de Tareas de Windows para confirmar que todos los procesos se han detenido.

Actualización de la aplicación Adobe Campaign Server

  1. Ejecute el archivo Setup.exe. Si necesita descargar este archivo, acceda al centro de descargas.

  2. Seleccione el modo de instalación: Actualizar o Reparar.

  3. Haga clic en Next.

  4. Haga clic en Finalizar: el programa de instalación copia los nuevos archivos.

  5. Una vez finalizada la operación, haga clic en Finalizar.

Sincronizar recursos

  1. Abra la línea de comandos.

  2. Ejecute nlserver config -postupgrade -allinstance para realizar lo siguiente:

    • Sincronizar recursos
    • Actualizar esquemas
    • Actualizar la base de datos
    NOTA

    Esta operación solo debe realizarse una vez y sólo en un servidor de aplicaciones web nlserverweb.

    Para sincronizar solo una base de datos, ejecute el siguiente comando:

    nlserver config -postupgrade -instance: <instance_name>

  3. Compruebe si la sincronización ha generado errores o advertencias.

Reiniciar servicios

Es necesario reiniciar los siguientes servicios:

  • Servicios Web (IIS): issreset /inicio
  • Servicio Adobe Campaign: net inicio nlserver6

Actualización de consolas de cliente

La consola de cliente debe estar en la misma compilación que la instancia de servidor.

En el equipo en el que está instalado el servidor de aplicaciones de Adobe Campaign (nlserverweb), descargue y copie el archivo:

Setup-client-7.xxxx.exe in [path of the application]\datakit\nl\en\jsp

La próxima vez que se conecten las consolas de cliente, una ventana informará a los usuarios sobre la disponibilidad de una nueva actualización y les oferta la posibilidad de descargarlas e instalarlas.

Tareas adicionales específicas

Algunas configuraciones requieren tareas adicionales específicas para actualizarse a una nueva compilación.

Mensajería transaccional

Cuando la mensajería transaccional (centro de mensajes) está habilitada en la instancia de Campaña, debe realizar estos pasos adicionales para actualizar:

  1. Actualice el servidor de producción de Message Center a la versión seleccionada.

  2. Ejecute las secuencias de comandos posteriores a la actualización.

  3. Ejecute pruebas y asegúrese de que los mensajes de correo electrónico se reciben correctamente a través de la instancia de producción de Message Center.

  4. Actualice los clientes y borre la caché.

  5. Exportar paquetes:

    • Exportar paquetes mediante la herramienta de exportación de paquetes de cliente
    • Importar paquete de esquema
    • Desconectar y reconectar cliente
    • Actualizar base de datos
    • Desconectar y reconectar
    • Importar paquete de administración
    • Importar paquete de contenido
    • Importar paquete de Gestor de contenido
    • Desconectar y reconectar
    • Realizar una comprobación rápida de la salud de los flujos de trabajo

  6. Publique plantillas de centro de mensajes para asegurarse de que la interfaz entre servidores y la instancia de centro de mensajes funciona.

  7. Ejecute pruebas para asegurarse de que los mensajes de correo electrónico se reciben correctamente a través de la instancia de producción de Message Center.

  8. Ejecute pruebas de flujo de trabajo en producción para asegurarse de que se reciben envíos.

Intermediaria

En el contexto de un entorno de intermediaria, debe realizar estos pasos adicionales para actualizar:

  1. Póngase en contacto con Adobe Customer Care para coordinar la actualización del servidor Intermediaria.

  2. Valide que la versión se haya actualizado ejecutando un vínculo de prueba. Por ejemplo:

    http://[InsertServerURL]/r/test
NOTA

El servidor Intermediaria siempre debe ejecutar la misma versión (o más reciente) que los servidores de marketing.

En caso de conflicto

Identificar conflictos

Debe comprobar el resultado de la sincronización. Este procedimiento sólo lo realizan los clientes locales. Para los clientes alojados, el equipo de alojamiento se encarga de ello. Existen dos formas de vista del resultado de la sincronización:

En la interfaz de la línea de comandos, los errores se materializan mediante un triple elemento de cadena '>>>' y la sincronización se detiene automáticamente. Las advertencias son materializadas por un doble de chevron '>>' y deben resolverse una vez finalizada la sincronización. Al final de la posactualización, se muestra un resumen en el símbolo del sistema. Puede tener este aspecto:

YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 info log =========Summary of the update==========
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 info log <instance name> instance, 6 warning(s) and 0 error(s) during the update.
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 warning log The document with identifier 'mobileAppDeliveryFeedback' and type 'xtk:report' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 warning log The document with identifier 'opensByUserAgent' and type 'xtk:report' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.750Z 00002E7A 1 warning log The document with identifier 'deliveryValidation' and type 'nms:webApp' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.750Z 00002E7A 1 warning log Document of identifier 'nms:includeView‘ and type 'xtk:srcSchema' updated in the database and found in the file system. You will have to merge the two versions manually.

Si la advertencia se refiere a un conflicto de recursos, se requiere la atención del usuario para resolverlo.

El archivo postupgrade_ServerVersionNumber_TimeOfPostupgrade.log contiene el resultado de la sincronización. Está disponible de forma predeterminada en el siguiente directorio: installationDirectory/var/instanceName/postupgrade. Los errores y las advertencias se indican mediante los atributos de error y advertencia.

Analizar conflictos

¿Cómo se encuentra un conflicto?

Los conflictos se pueden encontrar dentro del archivo post-upgrade.log en el servidor en cuestión o dentro de la interfaz de cliente de Campaña (Administración > Configuración > Administración de paquetes > Editar conflictos).

El documento con el identificador "stockOverview" y el tipo "nms:webApp" está en conflicto con la nueva versión.

Si se encuentra un conflicto, compruebe si coinciden las siguientes condiciones:

  • ¿El cliente ha modificado o personalizado el objeto?
  • ¿Ha cambiado el objeto en el producto?

Si ninguna de estas condiciones se aplica, se trata de un falso positivo. Si ambas condiciones se aplican, se ha encontrado un conflicto real.

¿El cliente ha modificado el objeto?

  1. Identifique el objeto en conflicto.
  2. Pregunte al cliente si ha modificado el objeto.
  3. ¿Hay algo inusual con el objeto?
  4. ¿Se ha establecido la fecha de la última modificación en el código del objeto?
  5. Examine el código XML desde el conflicto para ver los atributos "_Conflict". ¿Parece una personalización?

¿Se ha cambiado el objeto en la nueva compilación?

  1. ¿Algún "sospechoso habitual"? Informes o aplicaciones Web integradas (por ejemplo: 'deliveryValidation', 'deliveryOverview', 'budget').
  2. Examine los registros de cambios en busca de actualizaciones.
  3. Pregunte a los expertos de Adobe Campaign.
  4. Realice una "diferencia" en el código.

Resolver un conflicto

Para resolver conflictos, aplique el siguiente proceso:

  1. En el explorador de Adobe Campaign, vaya a Administración > Configuración > Administración de paquetes > Editar conflictos.

  2. Seleccione el conflicto que desee resolver en la lista.
    Existen tres opciones para resolver conflictos: Acepte la nueva versión, Mantenga la versión actual, Combine el código (y declare como resuelto), Ignore el conflicto (no se recomienda).

¿Cuándo puedo aceptar la nueva versión?

  • Si desea las funciones estándar.
  • Si no tiene personalizaciones (todas las personalizaciones se eliminarán)

¿Cuándo puedo mantener la versión actual?

  • Si tiene personalizaciones
  • Si no desea combinar
  • Si no necesita ninguna corrección en el objeto en conflicto de la actualización

¿Cuándo realizar una combinación?

  • Solo se pueden combinar formularios, informes y aplicaciones web.
  • Algunas combinaciones menores se pueden resolver sin comprender el código.
  • Las fusiones más complejas deben ser realizadas por alguien con las habilidades y capacidades adecuadas.
  • Consulte Realizar una combinación.

¿Qué pasa si ignoro los conflictos?

  • El conflicto seguirá
  • No se actualizará el objeto
  • Efectos a largo plazo: incompatibilidades de versiones, el cliente no se beneficiará de las correcciones de errores.
IMPORTANTE

Se recomienda encarecidamente resolver los conflictos.

Realizar una combinación

Existen diferentes tipos de combinaciones:

  1. Combinación sencilla: los elementos personalizados y nuevos son pequeños y no están relacionados, y no se requiere codificación.
  2. Sin cambios: aceptar nueva versión, solo se cambió la fecha de la última actualización, solo los comentarios, las fichas, los espacios o las líneas nuevas. Ejemplo: guardar accidentalmente.
  3. Cambios triviales: sólo se cambió una línea. Ejemplo: xpathToLoad
  4. Combinación compleja: cuando se requiera la codificación. Se necesitan habilidades de desarrollo. Consulte Combinaciones complejas.

¿Cómo combinar?

  1. Obtenga las tres versiones: la versión original, la nueva versión y la versión personalizada.
  2. Ejecute una "diferencia" entre la versión original y la nueva.
  3. Aísle los cambios.
  4. Si no hay cambios, resuelva manteniendo la versión actual.

¿Dónde encontrar el código?

  1. El código integrado se almacena en archivos XML de la carpeta de datos. Busque el archivo XML que coincide con el objeto en conflicto. Ejemplo: installationDirectory\datakit\nms\fra\form\recipient.xml
  2. Recuperar la versión original: mediante el Centro de descarga u otra instalación no actualizada del producto.
  3. Recuperar la nueva versión: mediante el centro de descarga o los archivos instalados del cliente.
  4. Recuperar la versión personalizada: recupere el código fuente del objeto desde el cliente de Campaña.

¿Cómo hacer una diferencia?

  1. Instale un editor de texto o de combinación, por ejemplo Bloc de notas ++, AraxisMerge, WinMerge.
  2. Abra el archivo original y el nuevo archivo en el editor.
  3. Ejecute la diferencia (compare los dos archivos).
  4. Identificar cualquier diferencia.

¿Cómo combinar?

  1. Inicio de la versión personalizada.
  2. Aplique los cambios.
  3. Resuelva el conflicto declarándolo resuelto.
  4. Compruebe la existencia de no regresiones.

Si decide resolver el conflicto manualmente, siga este procedimiento:

  1. En la sección inferior de la ventana, busque la cadena_de_conflicto para localizar las entidades con conflictos. La entidad instalada con la nueva versión contiene el nuevo argumento; la entidad que coincide con la versión anterior contiene el argumento personalizado.
  2. Elimine la versión que no desee conservar. Elimine la cadena argumento_conflicto de la entidad que mantiene.
  3. Vaya al conflicto que ha resuelto. Haga clic en el icono Acciones y seleccione Declarar como resueltas.
  4. Guarde los cambios: el conflicto ya está resuelto.

Combinaciones complejas

  1. Comprender lo que hace el cambio: haga ingeniería inversa de los cambios, examine los registros de cambios y realice un seguimiento con expertos de Adobe Campaign.
  2. Decida qué hacer con el cambio.
  3. Comprender lo que hacen las personalizaciones: ingeniería inversa de los cambios

Estos son los pasos para realizar una combinación compleja:

  1. Copiar bits de código del conjunto de cambios
  2. Pegar en la versión personalizada
  3. Prueba de no regresiones de personalización
  4. Prueba de la función de los cambios
  5. Realizar prueba de aceptación del usuario
  6. Realizar en el entorno de prueba
IMPORTANTE

Se necesitan habilidades de desarrollo para realizar combinaciones complejas.

Temas relacionados

En esta página