Garantizar el acceso a la instancia

Inmediatamente después del cambio de versión

1. Compruebe la nueva instancia de Oracle Integration 3
2. Actualizar la política de IAM con el nuevo OCID
3. Obtener la URL de la nueva instancia y compartirla

Garantizar conectividad

Inmediatamente después del cambio de versión

1. Configuración completa de reglas de red
2. Cargar nuevos certificados de identidad para conexiones
3. Recupere la conectividad con los agentes que no se han actualizado
4. Servidor de archivos: agregue la dirección IP del servidor de archivos a la lista de permitidos de firewall interno

   Complete esta tarea dentro de una semana después de la actualización.

5. Servidor de archivos: actualizar integraciones y clientes SFTP para utilizar los nuevos valores de puerto e IP

   Complete esta tarea dentro de una semana después de la actualización.

Garantice que las integraciones funcionen

Inmediatamente después del cambio de versión

1. Cambie las llamadas de API incorporadas de Oracle Integration de la autenticación básica a OAuth
2. Compruebe las integraciones si ha seleccionado Ignorar fallos de activación o Ignorar fallos de inicio de programa
3. Tenga cuidado de las solicitudes rechazadas durante el tiempo de inactividad de la actualización

Completar tareas posteriores al cambio de versión para fallos de comprobación previa ignorados

Inmediatamente después del cambio de versión

Completar tareas posteriores al cambio de versión de Visual Builder

Inmediatamente después del cambio de versión

Tareas completas de automatización de procesos posteriores al cambio de versión

Inmediatamente después del cambio de versión

Completar la verificación posterior a la actualización

En dos semanas de actualización

Compruebe la nueva instancia de Oracle Integration 3

La actualización se ha completado si la interfaz tiene este aspecto:

Actualizar la política de IAM con el nuevo OCID

Administrador de políticas de IAM

1. Conéctese a la consola de Oracle Cloud Infrastructure.
2. Obtenga el nuevo valor de OCID para la instancia de Oracle Integration 3. Consulte Visualización de detalles de instancia.
3. Actualice el OCID en la política de IAM. Para obtener instrucciones sobre la actualización de las sentencias en una política existente, consulte Uso de la consola en la documentación de Oracle Cloud Infrastructure.

Obtener la URL de la nueva instancia y compartirla

https://design.integration.region.ocp.oraclecloud.com/?integrationInstance=query_parameter_repersenting_instance

Para obtener la nueva URL:

1. Conéctese a la consola de Oracle Cloud Infrastructure.
2. Abra el menú de navegación y haga clic en Servicios para desarrolladores.
3. En Integración de aplicación, haga clic en Integración.
4. Haga clic en el nombre de la nueva instancia de Oracle Integration 3.
5. A la derecha del campo URL de consola de servicio, haga clic en Copiar.
6. Comparta la URL con cualquier usuario que la necesite.

Configuración completa de reglas de red

1. Conéctese a la consola de Oracle Cloud Infrastructure.
2. Obtenga el valor de OCID para la instancia de Oracle Integration 3.

   Consulte Visualización de detalles de instancia.

3. Siga las reglas del servicio de destino. Por ejemplo, para Oracle Autonomous Database Serverless, consulte Configuración de listas de control de acceso al aprovisionar o clonar una instancia en Uso de Oracle Autonomous Database Serverless.
4. Si el servicio de Oracle Cloud Infrastructure al que está accediendo está en una región diferente de la instancia de Oracle Integration, incluya en la lista de permitidos la dirección de IP de salida de OIC que recopiló al actualizar las otras listas de permitidos antes del cambio de versión.

Cargar nuevos certificados de identidad para conexiones

Solo una persona de su organización necesita realizar estos pasos

Si la instancia incluye conexiones que utilizan certificados de identidad, los certificados de identidad se habrían eliminado durante la actualización, por lo que debe generar nuevos certificados de identidad y configurar nuevos JKS.

Realice los siguientes pasos para cargar un nuevo certificado de identidad, probar las conexiones que utilizan el certificado de identidad y activar cualquier integración que utilice las conexiones:

1. Permite cargar un certificado de identidad nuevo.

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

2. Pruebe las conexiones que utilizan el certificado de identidad para que su estado cambie de Borrador a Configurado.

   Consulte la sección sobre la prueba de la conexión en Using Integrations in Oracle Integration 3.

3. Active las integraciones que utilicen las conexiones.

   Consulte la sección sobre activación de una integración en Using Integrations in Oracle Integration 3.

Recuperar conectividad con agentes que no se actualizaron

Requisitos

Asegúrese de que los agentes de conectividad tienen conectividad con Oracle Cloud Infrastructure Identity and Access Management (IAM) y Oracle Integration 3:

• Debe haber agregado las direcciones IP de IAM y Oracle Integration 3 a las listas de permitidos antes del cambio de versión, como se describe en Actualizar listas de permitidos.
• Agregue la dirección IP en tiempo de diseño de Oracle Integration 3 a las listas de permitidos. Utilice el siguiente comando para obtener la dirección IP en tiempo de diseño, sustituyendo region por la región de la URL de Oracle Integration 3:

  nslookup design.integration.region.ocp.oraclecloud.com

Para actualizar manualmente los agentes y recuperar la conectividad con ellos:

1. Pare el agente de conectividad.
2. Asegúrese de que los requisitos del agente están completos:
   1. Asegúrese de que el agente de conectividad utiliza JDK 17. Si no es así, defina las variables de entorno JAVA_HOME y PATH en JDK17.
   2. Asegúrese de que el agente está utilizando PKCS12 KeyStore. Si no es así, conviértalo mediante los siguientes pasos.
      1. En el servidor que aloja el agente de conectividad, cree una copia de seguridad del archivo keystore.jks, que se encuentra en la siguiente carpeta:

         Agent_Install_Location/agenthome/agent/cert

      2. Mueva el archivo de copia de seguridad a una carpeta diferente.
      3. Convierta JKS KeyStore en PKCS12 KeyStore ejecutando el siguiente comando desde la línea de comandos:

         keytool -importkeystore -srckeystore keystore.jks -destkeystore keystore.p12 -srcstoretype JKS -deststoretype PKCS12 -deststorepass changeit -srcstorepass changeit

      4. Suprima el archivo keystore.jks en la siguiente ubicación:

         Agent_Install_Location/agenthome/agent/cert

3. Descargue el archivo ZIP del instalador de agente desde Oracle Integration 3.
   1. En el panel de navegación, haga clic en Diseño y, a continuación, en Agentes.
   2. Haga clic en Descargar y, a continuación, en Agente de conectividad.
4. Extraiga oic_conn_agent_installer.zip en un nuevo directorio del servidor del agente de conectividad.
5. Suprima la carpeta lib del agente de conectividad existente en Agent_Install_Location/agenthome/ y sustitúyala por la carpeta lib del archivo ZIP.
6. Suprima el archivo version existente en Agent_Install_Location/agenthome/ y sustitúyalo por el archivo version del archivo ZIP.
7. Suprima el archivo connectivityagent.jar existente en Agent_Install_Location y sustitúyalo por el archivo connectivityagent.jar del archivo ZIP.
8. Suprima el archivo cpi_upgradeutility.jar existente en Agent_Install_Location y sustitúyalo por el archivo cpi_upgradeutility.jar del archivo ZIP.
9. En Oracle Integration 3, en la página Agentes, pase el cursor sobre el grupo de agentes, haga clic en Acciones y, a continuación, seleccione Descargar configuración.

   Este paso descarga un archivo InstallerProfile.cfg preconfigurado para el grupo de agentes.

10. Suprima el archivo InstallerProfile.cfg existente en Agent_Install_Location y sustitúyalo por el archivo InstallerProfile.cfg que ha descargado en el paso anterior.
11. Reinicie el agente de conectividad ejecutando el siguiente comando:

    java -jar connectivityagent.jar

12. Reactive las integraciones que están en el grupo de agentes actualizado.

Servidor de archivos: agregue la dirección IP del servidor de archivos a la lista de permitidos de firewall interno

La dirección IP de Oracle Integration Generation 2 sigue funcionando durante cuatro meses después del cambio de versión y, posteriormente, Oracle los retira. Sin embargo, Oracle recomienda actualizar la lista de permitidos de firewall para utilizar la nueva dirección IP ahora. De este modo, no corre el riesgo de olvidar la actualización de la lista de permitidos en el futuro.

Para obtener la dirección IP del servidor de archivos:

1. Conéctese a Oracle Integration 3.
2. En el panel de navegación, haga clic en Configuración, en Servidor de archivos y, por último, en Configuración.
3. En General, obtenga la dirección IP para el servidor SFTP del servidor de archivos.

Servidor de archivos: actualización de integraciones y clientes SFTP para utilizar los nuevos valores de IP y puerto

Los valores de IP y puerto de Oracle Integration Generation 2 siguen funcionando durante cuatro meses después del cambio de versión y, posteriormente, Oracle los retira. Sin embargo, Oracle recomienda actualizar las integraciones y los clientes SFTP para que utilicen los nuevos valores ahora. De este modo, no corre el riesgo de olvidar la actualización de estos valores en el futuro.

1. Conéctese a Oracle Integration 3.
2. En el panel de navegación, haga clic en Configuración, en Servidor de archivos y, por último, en Configuración.
3. En General, obtenga los valores de IP y puerto para el servidor SFTP del servidor de archivos.
4. Actualice todas las integraciones que llamen al servidor de archivos para que utilicen los nuevos valores de IP y puerto.
5. Actualice todos los clientes SFTP para que utilicen los nuevos valores de puerto e IP.

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

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.

Compruebe las integraciones si ha seleccionado Ignorar fallos de activación o Ignorar fallos de inicio de programa

• Si ha seleccionado Ignorar fallos de activación, compruebe el estado de todas las integraciones y active las integraciones según sea necesario.
• Si ha seleccionado Ignorar fallos de inicio de programa, compruebe los programas de las integraciones e inícielos de forma manual si es necesario.

Tenga cuidado de las solicitudes rechazadas durante el tiempo de inactividad de la actualización

Oracle Integration ha rechazado todas las solicitudes enviadas durante el tiempo de inactividad del cambio de versión. Si es necesario, realice acciones en las solicitudes que haya enviado cualquier cliente a Oracle Integration durante el tiempo de inactividad.

Cambiar nombre de instancia de servicio

Después de cambiar de versión de Oracle Integration Generation 2 a Oracle Integration 3, el nombre de arrendamiento se agrega al final del nombre de instancia de servicio (nombre mostrado de instancia de servicio) con el siguiente formato: <service instance name>-<tenancy name>. Por ejemplo, si el nombre de la instancia de servicio es myinstance y el nombre del arrendamiento es mytenancy, se cambiará a myinstance-mytenancy después de actualizar a Oracle Integration 3. Por lo tanto, si las integraciones utilizan el nombre de instancia de servicio, actualice las integraciones para que utilicen el nuevo nombre de instancia de servicio; de lo contrario, fallarán.

• Adaptador de servicio de Oracle CX Sales y B2B
• Adaptador de Oracle ERP Cloud
• Adaptador de Oracle HCM Cloud
• Adaptador de Oracle Field Service Cloud
• Adaptador de Salesforce
• Adaptador de ServiceNow

Integraciones de enrutamiento básico: las integraciones de enrutamiento básico no están soportadas en Oracle Integration 3 y mostrarán un lienzo en blanco. Debe suprimir esas integraciones y volver a crearlas como integraciones controladas por aplicaciones.

• Adaptador de Automation Anywhere
• Adaptador de Evernote
• Adaptador de Oracle Messaging Cloud Service
• Adaptador de Oracle Monetization Cloud
• Adaptador de Oracle Taleo Business Edition (TBE)
• Adaptador de Robotic Process Automation de UiPath

Debe crear conexiones de adaptador REST para sustituir las conexiones de adaptador no soportadas suprimidas.

Debe volver a procesar esas integraciones mediante los siguientes pasos:

1. Suprima la llamada correspondiente a la conexión de adaptador no soportada y sustitúyala por la nueva conexión de adaptador REST.
2. Después de configurar y activar la integración, inicie el programa.

Debe crear nuevas conexiones con adaptadores de Oracle Integration 3 equivalentes para sustituir las conexiones de adaptador personalizado suprimidas.

Debe volver a procesar esas integraciones mediante los siguientes pasos:

1. Suprima la llamada correspondiente a la conexión del adaptador personalizado y sustitúyala por la nueva conexión que ha creado.
2. Una vez configurada y activada la integración, inicie el programa.

Debe volver a procesar esas integraciones para que no usen este patrón. Por ejemplo, utilice una operación listFile para mostrar los archivos y utilice una acción for-each para leer cada archivo individualmente.

• URL del catálogo de metadatos
• URL de definición de Swagger
• URL de definición de RAML

Debe actualizar esas conexiones mediante uno de los siguientes métodos:

• Si utilizaba RAML o el catálogo de metadatos de Oracle, puede solicitar al proveedor de servicios REST una definición de Swagger (si está disponible). Oracle Fusion Applications debe tener una opción de Swagger disponible, ya que esta es una directriz para todos Oracle Fusion Applications.

  Si no hay disponible una especificación alternativa, utilice la plantilla básica en el adaptador de REST seleccionando URL base de API de REST como URL de conexión y definiendo la solicitud de API de destino mediante el asistente de configuración de punto final de adaptador.

• Otra opción si estaba utilizando RAML, es convertir RAML en una especificación OpenAPI.
• Si utilizaba la URL de definición de Swagger, puede utilizar la nueva opción unificada del adaptador de REST para especificar todas las especificaciones OpenAPI en un solo campo. Esta opción proporciona un soporte más sólido y completo para las especificaciones de Swagger/OpenAPI.

Consulte Configure Connection Properties for Invoke Connections en Using the REST Adapter with Oracle Integration 3.

Debe volver a procesar esas integraciones mediante los siguientes pasos:

1. Active la integración
2. Una vez activada la integración, inicie el programa.

Debe volver a crear el punto final personalizado.

Si utiliza Visual Builder y tiene un punto final personalizado o puntos finales personalizados alternativos, actualice el CNAME del registro de DNS de punto final personalizado con el nombre de host de la instancia de Visual Builder.

Nota: no puede utilizar el mismo punto final personalizado para Visual Builder y Oracle Integration después del cambio de versión. Si utiliza el mismo punto final personalizado, puede que tenga problemas.

Completar tareas adicionales posteriores al cambio de versión

Complete las tareas de verificación posteriores al cambio de versión de su organización

Complete las tareas de verificación posteriores al cambio de versión de su organización, como la realización de pruebas de regresión.

Realice pruebas de carga de integración en una instancia de desarrollo/etapa antes de mover las integraciones a una instancia de producción.