Documentación de Oracle Cloud Infrastructure

Tareas Previas al Cambio de Versión

Hay varias tareas que debe realizar a medida que se aproxima la fecha de cambio de versión para evitar errores durante el cambio de versión y para permitirle realizar una transición sin problemas a la nueva instancia de Oracle Integration 3 después del cambio de versión.

Resumen de Tareas Anteriores a la Actualización

En esta tabla se resumen las tareas previas al cambio de versión de cada área. Los detalles de cada tarea están enlazados en la tabla y se muestran en las siguientes secciones.

Áreas tareas
Agente de conectividad
Instancias
B2B para Oracle Integration
Integraciones
Adaptadores
Visual Builder
Listas de permitidos
Comunicación
Trabajos de desarrollo

Tareas previas a la actualización del agente de conectividad

Tarea Propietario típico Descripción de Tareas

Prepárese para la conversión a OAuth 2.0

 Equipo de operaciones de desarrollo En Oracle Integration Generation 2, el agente de conectividad utiliza la autorización básica para llamar a los puntos finales de Oracle Integration. En su lugar, Oracle Integration 3 utiliza la autenticación basada en token OAuth 2.0, que es más segura. Durante la actualización, las conexiones de los agentes de conectividad se convierten automáticamente del uso de la autenticación básica al uso de OAuth 2.0, por lo que no necesita volver a crear manualmente ninguna conexión.

Sin embargo, antes del cambio de versión, debe prepararse para esta conversión permitiendo la salida de la red del agente al tiempo de diseño y tiempo de ejecución de Oracle Integration y a Oracle Identity Cloud Service o al dominio de identidad, como se describe en Actualizar listas de permitidos.

Y, después de la actualización, como resultado del nuevo método de autenticación, verá tráfico adicional a su firewall. Este tráfico adicional se produce porque el agente de conectividad debe comunicarse con el servidor para obtener nuevos tokens.

Para obtener más información sobre el soporte de OAuth 2.0 en Oracle Integration 3, consulte ¿Cuándo está soportada la autenticación básica en Oracle Integration 3?.

Actualice la configuración de su lista de permitidos

 Equipo de operaciones de desarrollo Si su organización utiliza listas de permitidos, debe actualizar la configuración de la lista de permitidos para los agentes de conectividad. La columna Estado de lista de permitidos de la sección Estado de agente de conectividad muestra el estado de todos los agentes de conectividad de la instancia, indicando si la lista de permitidos se ha actualizado correctamente.

A medida que se acerca la ventana de actualización, realice las tareas descritas en Actualizar listas de permitidos.

Los agentes que están fuera de línea durante la actualización o que no cumplen con los requisitos de actualización no se actualizarán, en cuyo caso deberá realizar pasos posteriores a la actualización para recuperar la conectividad.

Definir la propiedad Cache del servidor proxy

 Equipo de operaciones de desarrollo Defina la propiedad Cache del servidor proxy para las URL de Oracle Integration para que se refresquen con la mayor frecuencia posible.

Por ejemplo, si el servidor proxy utiliza la propiedad Cache-ExpiresDefault, defínala en now.

Tareas previas al cambio de versión de la instancia

Tarea Propietario típico Descripción de Tareas

Empiece a capturar el flujo de actividad en la consola de Oracle Cloud Infrastructure

Administrador Si aún no lo hace, comience a capturar el flujo de actividad en la consola de Oracle Cloud Infrastructure.

Estos son los motivos: el flujo de actividad no se migra. Sin embargo, si captura estos datos en la consola de Oracle Cloud Infrastructure, seguirá teniendo acceso a los datos históricos. Consulte Captura del flujo de actividades de integraciones en la consola de Oracle Cloud Infrastructure.

Configuración completa de reglas de red

 Administrador de la Red Esta tarea se puede completar antes del cambio de versión o inmediatamente después del cambio de versión.

Si alguna de las conexiones de integración tiene como destino un servicio de Oracle Cloud Infrastructure que soporte reglas de red, como Oracle Cloud Infrastructure Object Storage u Oracle Autonomous Database, y ha activado esas reglas, debe completar cualquier configuración de reglas de red, incluida la adición de la VCN del servicio Oracle Integration a la regla.

Consulte Garantía de conectividad.

B2B para tareas previas al cambio de versión de Oracle Integration

Tarea Propietario típico Descripción de Tareas

Asegúrese de que todas las contraseñas B2B coincidan con el almacén de claves

 Administrador Asegúrese de que todas las contraseñas del archivo del almacén de claves sean idénticas. El archivo de certificado de identidad (JKS) requiere dos juegos de contraseñas: contraseñas de clave y contraseña de almacén de claves. Todas las contraseñas deben ser idénticas. Si no son idénticas, edite las contraseñas para que coincidan y vuelva a cargar el archivo del almacén de claves.

Si no tiene el archivo de almacén de claves que se cargó por última vez, vuelva a crear el archivo.

Al cargar el certificado:

  • En Tipo, seleccione X.509 (transporte SSL).
  • En Categoría, seleccione Identidad.

Consulte Carga de un certificado SSL en Uso de integraciones en Oracle Integration Generation 2.

Precaución:

Si no completa este paso, el cambio de versión fallará.

Tareas previas a la actualización de integraciones

Tarea Propietario típico Descripción de Tareas

Determinar qué hacer con las instancias con fallos

 Equipo de operaciones de desarrollo Las instancias de integración fallidas se encuentran en una de las siguientes categorías, lo que determina cómo puede manejarlas:
  • Instancias asíncronas con fallos: recuperables

    Vuelva a enviar las instancias con fallos y borre la cola. Consulte Volver a enviar mensajes con fallos.

    Si tiene una instancia asíncrona con fallos cuando se cambia la versión de la instancia, no puede volver a enviar la instancia con fallos en Oracle Integration 3, al menos no de inmediato. No puede volver a enviarla ya que los datos de tiempo de ejecución, incluidos los errores y todos los datos del flujo de actividades, no se migran a Oracle Integration 3 como parte del cambio de versión. Sin embargo, una vez completado el cambio de versión, puede ejecutar la integración en Oracle Integration 3, recopilar los datos de error y, a continuación, volver a enviar.

  • Instancias síncronas con fallos: no recuperables

    No puede volver a ejecutar instancias de integración síncronas, por lo que no son recuperables.

Nota

Si captura datos de flujo de actividades en la consola de Oracle Cloud Infrastructure, podrá seguir viendo la actividad histórica de la integración. Consulte Captura del flujo de actividades de integraciones en la consola de Oracle Cloud Infrastructure.

Decidir qué hacer con los mensajes asíncronos

 Equipo de operaciones de desarrollo Decida qué hacer con los mensajes asíncronos del cliente durante el tiempo de inactividad.

Estos son los motivos: durante el tiempo de inactividad, Oracle Integration rechaza todas las solicitudes entrantes. Para prepararse, tiene las siguientes opciones:

  • Antes de que se inicie el cambio de versión, suspenda todos los mensajes asíncronos en el cliente.

    Con este enfoque, el cliente no envía los mensajes y Oracle Integration no los rechaza.

    Si selecciona esta opción, asegúrese de conocer las horas de inicio y finalización del cambio de versión.

  • Una vez finalizado el cambio de versión, determine los pasos siguientes adecuados para los mensajes rechazados.

Cambie las llamadas de API incorporadas de Oracle Integration de Autenticación básica a OAuth

Developer Si aún no ha actualizado las llamadas de API para utilizar OAuth al completar los requisitos, hágalo ahora o inmediatamente después del cambio de versión.

En Oracle Integration Generation 2, puede utilizar la autenticación básica para utilizar la API REST de Oracle Integration y la API REST del servidor de archivos. En Oracle Integration 3, debe utilizar OAuth. Debe actualizar los clientes, scripts, integraciones y comandos que utilizan la API de REST de Oracle Integration o la API de REST del servidor de archivos para conectarse mediante OAuth. Para obtener más información sobre el soporte de métodos de autenticación, consulte Cuándo se soporta la autenticación básica en Oracle Integration 3. Para obtener más información sobre el uso de OAuth con la API de REST de Oracle Integration, consulte Seguridad, autenticación y autorización o con la API de REST del servidor de archivos, consulte Seguridad, autenticación y autorización.

Tareas previas a la actualización de adaptadores

Tarea Propietario típico Descripción de Tareas

Deje de utilizar adaptadores de Microsoft retirados

 Equipo de desarrollo Microsoft retiró las API de REST de Microsoft Outlook en noviembre de 2022. Si utiliza alguno de los siguientes adaptadores, debe utilizar en su lugar las API de REST de Microsoft Graph.
  • Adaptador de calendario de Microsoft Office 365

    Consulte Página Llamada a operaciones en Uso del adaptador de Microsoft Office 365 Calendar con Oracle Integration.

  • Adaptador de Microsoft Office 365 People

    Consulte Página Llamada a operaciones en Uso del adaptador de Microsoft Office 365 People Adapter con Oracle Integration 3.

  • Adaptador de Microsoft Office 365 Outlook

    Consulte Página Invocar operaciones en Uso del adaptador de Microsoft Office 365 Outlook con Oracle Integration 3.

Tareas previas al cambio de versión de Visual Builder

Tarea Propietario típico Descripción de Tareas
Preparación de Visual Builder con un punto final personalizado mediante SSL para la actualización Administrador Si Visual Builder está activado, utiliza un punto final personalizado o puntos finales personalizados alternativos y utiliza SSL, realice los siguientes pasos:
  1. Para permitir el acceso al secreto de certificado SSL para la actualización, agregue las siguientes políticas, sustituyendo MySecretCompartment por el compartimento que incluye los secretos de certificado SSL:
    allow service vb-vbprod to manage secrets in compartment MySecretCompartment
allow service vb-vbprod to manage keys in compartment MySecretCompartment
allow service vb-vbprod to manage vaults in compartment MySecretCompartment
allow service vb-vbprod to read secret-bundle in compartment MySecretCompartment
  2. Actualice la configuración de inquilino y aplicación de Visual Builder, así como cualquier aplicación de integración, para que apunten a la URL original de Oracle Integration Generation 2 en lugar del punto final personalizado. Durante la actualización, el punto final personalizado se configurará en Visual Builder, por lo que, después de la actualización, solo se podrá acceder a las aplicaciones de Visual Builder a través del punto final personalizado.

Preparar Visual Builder para la actualización

Equipo de operaciones de desarrollo Realice las tareas descritas en Preparación de Visual Builder para el cambio de versión en Administración de Oracle Visual Builder en Oracle Integration 3.
Revisar los problemas conocidos Equipo de operaciones de desarrollo Revise las incidencias conocidas de las aplicaciones activas o temporales posteriores al cambio de versión a Oracle Integration 3 en Incidencias conocidas de Oracle Integration 3 en busca de incidencias que puedan provocar que las aplicaciones activas o temporales no funcionen correctamente después del cambio de versión a Oracle Integration 3.