SEE THE “CHANGING TITLE SIZING”

SECTION IN THIS TEMPLATE FOR

HEADLINE SIZING GUIDANCE.
 1. PURPOSE STATEMENT
This document provides an overview of features and enhancements included in release <reference
release>. It is intended solely to help you assess the business benefits of upgrading to <reference
release> and to plan your I.T. projects.

DISCLAIMER
This document in any form, software or printed matter, contains proprietary information that is the
exclusive property of Oracle. Your access to and use of this confidential material is subject to the
terms and conditions of your Oracle software license and service agreement, which has been
executed and with which you agree to comply. This document and information contained herein may
not be disclosed, copied, reproduced or distributed to anyone outside Oracle without prior written
consent of Oracle. This document is not part of your license agreement nor can it be incorporated
into any contractual agreement with Oracle or its subsidiaries or affiliates.

This document is for informational purposes only and is intended solely to assist you in planning for
the implementation and upgrade of the product features described. It is not a commitment to deliver
any material, code, or functionality, and should not be relied upon in making purchasing decisions.
The development, release, and timing of any features or functionality described in this document
remains at the sole discretion of Oracle.

Due to the nature of the product architecture, it may not be possible to safely include all features
described in this document without risking significant destabilization of the code.

DISCLAIMERS FOR PRE-RELEASE, PRE-GA PRODUCTS

The revenue recognition disclaimer on this page is required for any white paper that addresses
future functionality or for products that are not yet generally available (GA). If you are unsure
whether your statement of direction needs the disclaimer, read the revenue recognition policy.
If you have further questions about your content and the disclaimer requirements, e-mail
REVREC_US@oracle.com. If you do not need the disclaimer, you may delete it and the page that it
appears. First, display hidden characters by clicking on the Paragraph icon on the Home toolbar. It is
a small, square icon that appears to the left of the Quick Style Gallery. Then, highlight all the text on
this page and press the Delete key. Notice that there is a section break displayed as a double-dotted
line at the bottom of this page. Continue to press Delete until the page disappears and your cursor is
on the Table of Contents page. Be sure not to remove the section break, or the formatting of the title
page will be incorrect. Delete this note before publishing.

The testing disclaimer in the TM block on the last page (highlighted in yellow) is provided by the
FCC for hardware products. It must appear in the TM block for all pre-release, pre-GA hardware
products. Be sure to remove the yellow highlighting before publishing. When the product becomes
GA, update your collateral by removing the disclaimer from the TM block. If your product is already
GA or if you are writing about a software product, delete the disclaimer from the TM block.

Important: If your product is not GA, then you cannot include any regulatory compliance information
in the statement of direction. Regulatory compliance information may be included for GA products
only if you have completed all required safety and emissions testing, and you have received the
certificates issued by the testing organization.

2 STATEMENT OF DIRE CTION / Como migrar pacote do ICS para OIC

[PAGE TITLE] TABLE OF CONTENTS

[TOC SECTION HEAD] OPTIONAL

1. Purpose Statement .............................................................................. 2

2. Introduction .......................................................................................... 4

3. Identificar a URL de Armazenamento .................................................. 5

4. Exportando do ICS .............................................................................. 7

5. Verificar o status de exportação .......................................................... 7

6. Importar para o OIC ............................................................................. 8

7. Verifique o status da importação ......................................................... 9

8. Como migrar do ICS para o OIC com Postman ................................... 9

9. Exportando os dados do ICS ............................................................. 11

10. Importando os dados para o OIC .................................................... 13

Note: A Table of Contents (TOC) is recommended for documents that are more than 10 pages in
length. If your statement of direction is shorter, you may remove the TOC page. To remove both the
TOC and the page that it appears on, first display hidden characters by clicking on the Paragraph
symbol on the Home toolbar. It is a small, square icon that appears to the left of the Quick Style
Gallery. Notice the page break displayed as a line at the bottom of this page. Next, highlight all the
text on this page and press the Delete key once to remove all the text. Then, highlight the page
break and press the Delete key until the page disappears and your cursor is on the first page of
body text. The TOC will update semi-automatically with the Heading 1 and Heading 2 styles when
you 1) right click on the TOC and then 2) click Update Field in the contextual menu. You may also
manually edit the TOC by placing your cursor within the text. Delete this note before publishing.

3 STATEMENT OF DIRE CTION / Como migrar pacote do ICS para OIC

 2. INTRODUCTION
O Oracle Integration Cloud (OIC) e o Integration Cloud Service (ICS) são ofertas de iPaaS da Oracle. O ICS foi lançado em 2015 e
agora foi substituído pela OIC. Os clientes no ICS podem escolher estar no ICS ou migrar para o OIC para aproveitar os novos
recursos e serviços incorporados no OIC. A comparação do ICS e OIC está fora do escopo deste documento.

Migração do ICS para o OIC

Atualmente, o ICS tem um recurso para exportar um fluxo / interface de integração do ICS por vez da interface do usuário do
ICS. Depois que um fluxo é exportado do ICS, esse fluxo pode ser importado para o OIC usando a funcionalidade de importação
no console do OIC. Isso deve permitir que um fluxo de integração migre do ICS para o OIC. No entanto, essa abordagem é
incômoda quando há muitos fluxos no ICS que devem ser migrados para o OIC, pois cada fluxo precisa ser exportado e importado
um por um.

Felizmente, o Clone Utility é fornecido para exportação em massa de todas as integrações, conexões, pacotes, bibliotecas e outros
artefatos do ICS para o OIC. O Clone Utility é um conjunto de APIs REST no ICS e OIC. O ICS fornece APIs REST para exportar
artefatos ICS em massa e o OIC fornece APIs REST para importar esses artefatos exportados.

2.1 Softwares utilizados

Esse laboratório pede a utilização da seguinte ferramenta para sua conclusão:

 Postman - https://www.getpostman.com/downloads/
 Curl - https://curl.haxx.se/download.html

4 STATEMENT OF DIRE CTION / Como migrar pacote do ICS para OIC

 2.2 Pré-requisitos

1. Serviço ICS existente com acesso da função Admin ao serviço.

2. Serviço OIC provisionado com acesso de função Admin ao serviço.
3. O recurso Clone Utility (Utilitário de clonagem) NÃO está disponível em geral (GA) ainda. Um sinalizador de recurso deve
estar habilitado no OIC para habilitar esse recurso. Para ativar o sinalizador de recursos, deve-se abrir um SR com
suporte Oracle.
4. Acesso para criar e atualizar um contêiner no Oracle Storage Cloud

2.3 O que pode ser exportado?

O utilitário clone ajuda a exportar todos os artefatos ICS / OIC que esperam o agente e os grupos de agentes. O agente e os
grupos de agentes precisam ser criados manualmente. Aqui está a lista de itens que o utilitário clone exporta e importa –

1. Todos os fluxos de integração de todos os padrões

2. Todas as conexões, incluindo credenciais de url, nome de usuário e senha
3. Todos os pacotes
4. Todas as Bibliotecas
5. Todos os certificados configurados no ICS
6. Todas as pesquisas

3. IDENTIFICAR A URL DE ARMAZENAMENTO

A primeira etapa é criar um contêiner de armazenamento ou usar um contêiner de armazenamento existente. Um contêiner de
armazenamento é necessário para hospedar o arquivo que contém todos os artefatos do ICS.

A primeira coisa necessária é identificar o URL de armazenamento que será usado na chamada da API REST na próxima etapa.

A Oracle oferece dois tipos de ofertas de armazenamento. O primeiro deles é chamado Oracle Storage Cloud Classic e o outro é
chamado de Oracle Object Cloud.

Embora existam muitas diferenças entre essas ofertas de armazenamento, uma das principais diferenças é que o Oracle Storage
Cloud Classic está no Oracle IaaS tradicional oferecendo o Oracle Cloud Infrastructure Classic (OCI-Classic) enquanto o Oracle
Object Storage Cloud está na nova infraestrutura IaaS. (OCI).

Estaremos usando o Oracle Storage Cloud Classic.

Caso deseja –se fazer por Oracle Object Storage.

Criar Object Storage - https://videohub.oracle.com/playlist/dedicated/94612561/1_s0datryv/1_1wnwwjyx

Siga os passos abaixo para identificar a localização do URL de armazenamento.

1. Navegue até o painel myservices

2. No painel, clique em Storage Classic como mostrado. Se o Storage Classic não for exibido, clique em Personalizar
painel e torne o Storage Classic visível no painel.

5 STATEMENT OF DIRE CTION / Como migrar pacote do ICS para OIC

 1. O URL de armazenamento será aquele destacado na figura abaixo.

O URL de armazenamento, neste caso, é https://Storage-<some identifier> .us.storage.oraclecloud.com / v1 / Storage- <algum

identificador>
Copie este url no bloco de notas porque você precisará disso na próxima etapa.

6 STATEMENT OF DIRE CTION / Como migrar pacote do ICS para OIC

 4. EXPORTANDO DO ICS
A segunda etapa é exportar todos os artefatos do ICS usando a API abaixo. A API REST ExportArtifacts exporta todos os
artefatos, como conexões, integrações, pacotes e bibliotecas. O agente não é exportado e precisa ser configurado manualmente.
Comando:

curl -k -v -x POST -u admin_user:admin_pwd H "Content-Type:application/json" -d '{"storageInfo":{"storageUrl":"https://Storage

URL","storageUser":"username","storagePassword":"password"}}'
https://ICSServer:port/icsapis/v2/clonepod/exportArtifacts

Request:

Para construir a solicitação, obtenha o URL que foi copiado no STEP1 e anexe o nome do contêiner do Passo 1.
Por exemplo - https://Storage-<some identifier>.us.storage.oraclecloud.com/v1/Storage-https://Storage-<some
identifier>/testContainer
Nota: Você também precisará do StorageUser e StoragePassword. Note que o StorageUser pode ser diferente do usuário do ICS!
{
"storageInfo":{
"storageUrl":"https://Storage-https://Storage-<some identifier>.us.storage.oraclecloud.com/v1/Storage-
https://Storage-<some identifier>/testContainer",
"storageUser":"username",
"storagePassword":"password"
}

Response:
{
"archiveFilename": "archive_Local_Suite_Instance-7c4b9cb1-3557-421e-9c9b-d0d25035c134.zip","jobID": "7c4b9cb1-3557-421e-
9c9b-d0d25035c134",
"location":"https://Storage-<some identifier>.us.storage.oraclecloud.com/v1/Storage-<some identifier>/testContainer","status":
"Starting"

5. VERIFICAR O STATUS DE EXPORTAÇÃO

Para verificar o status do trabalho de exportação, use a API abaixo.
Comando:

curl -k -v -X GET -u admin_user: admin_password https: // ICSServer / icsapis / v2 / clonepod / exportStatus

Response:

{"status": "RUNNIG"}

Quando o trabalho de exportação estiver em execução, você verá um status como RUNNIG.

{"status": "COMPLETED"}

Quando o trabalho de exportação for concluído com êxito, você verá um status COMPLETED. Quando o status for COMPLETE,

7 STATEMENT OF DIRE CTION / Como migrar pacote do ICS para OIC

você deverá ver um arquivo morto gerado no armazenamento. Para verificar o arquivo, navegue até a nuvem de armazenamento e
clique no container usado no STEP3. No nosso caso, o contêiner é chamado testContainer. Aqui você pode ver o arquivo
gerado. O nome do arquivo de archive obtido na resposta no STEP3 deve corresponder ao arquivo morto no contêiner de
armazenamento.

{"status": "FAILED"}

Às vezes, você pode ver um status como FAILED quando o trabalho de exportação falha. As APIs REST oferecem pouca ajuda
para diagnosticar o problema, pois informações detalhadas sobre por que a tarefa de exportação falhou não fazem parte da
resposta. No momento, a única maneira de fazer a triagem do problema é baixar os arquivos de log do ICS da interface do usuário
do ICS. Você terá que procurar especificamente por logs do servidor Admin para diagnosticar o problema. Mesmo depois de
analisar os registros, se você não conseguir identificar o problema, aumente o tíquete de suporte com o Oracle.

6. IMPORTAR PARA O OIC

Depois de ter assegurado que o archive do ICS foi gerado com êxito, esse archive pode ser importado para o OIC usando a API
importServiceInstanceArchive.
Comandos:
Esta API tem 3 modos que são auto-explicativos. Veja os comandos abaixo para os 3 modos.
ImportActivateMode
Nesse modo, todas as integrações / fluxos são importadas e, após a importação bem-sucedida, as integrações / fluxos são
ativadas.

curl -k -v -X POST -u admin_user: admin_password -H "Tipo de conteúdo: aplicativo / json" -d '{"archiveFile": "Nome do arquivo de
arquivamento do comando de exportação", " importActivateMode ": "ImportActivate", " storageInfo ": {" storageUrl ":" https: //
Storage- <algum identificador> .us.storage.oraclecloud.com / v1 / Storage- <algum identificador> / testContainer "," storageUser ":"
username "," storagePassword ":" senha "}} ' https: // OICSserver / ic / api / common / v1 / importServiceInstanceArchive

ImportOnly
Nesse modo, todas as integrações / fluxos são importadas apenas, mas não ativadas.

curl -k -v -X POST -u admin_user: admin_password -H "Tipo de conteúdo: aplicativo / json" -d '{"archiveFile": "Nome do arquivo de
arquivamento do comando de exportação", "importOnly ":" ImportActivate "," storageInfo ": {" storageUrl ":" https: //

8 STATEMENT OF DIRE CTION / Como migrar pacote do ICS para OIC

Armazenamento- <algum identificador> .us.storage.oraclecloud.com / v1 / Storage- <algum identificador> / testContainer ","
storageUser ":" nome de usuário "," storagePassword ":" senha "}} ' https: // OICSserver / ic / api / common / v1 /
importServiceInstanceArchive

ActivateOnly
Esse modo pode ser usado se o modo ImportOnly for usado e todas as integrações / fluxos precisarem ser ativadas

curl -k -v -X POST -u admin_user: admin_password -H "Tipo de conteúdo: aplicativo / json" -d '{"archiveFile": "Nome do arquivo de
arquivamento do comando de exportação", " activateOnly ": "ImportActivate", " storageInfo ": {" storageUrl ":" https: // Storage-
<algum identificador> .us.storage.oraclecloud.com / v1 / Storage- <algum identificador> / testContainer "," storageUser ":"
username "," storagePassword ":" password "}} ' https: // OICServer / ic / api / common / v1 / importServiceInstanceArchive

Response:

{
"jobId":"1583",
"status":"NOT_STARTED"
}

A mensagem de resposta da API importServiceInstanceArchive possui 2 valores JobID e Status. Mantenha o JobID acessível,
pois você precisará desse ID para verificar o status do trabalho de importação na próxima etapa.

7. VERIFIQUE O STATUS DA IMPORTAÇÃO

Para verificar o status de importação use o JobID obtido na etapa anterior. Use o comando abaixo.

Comando:
curl -k -v -X GET -u admin_user: admin_password https: // OICServer / ic / api / common / v1 / importServiceInstanceArquivo /
JobID

Response:
{
"jobId":"1583",
"status":"RUNNING"
}

{
"jobId":"1583",
"status":"COMPLETED"
}

8. COMO MIGRAR DO ICS PARA O OIC COM POSTMAN

Neste documento, gostaria de mostrar a você como migrar Metadados de uma instância do ICS (Integration Cloud Service) para a
instância OIC (Oracle Integration Cloud). Os metadados que serão migrados incluem o seguinte:

 Integrações, Conexões, Pesquisas, Bibliotecas, Pacotes, Grupos de Agentes, Adaptadores Personalizados, etc.
 Integrações em qualquer estado (em andamento, ativado etc.) serão migradas.
 Todos os recursos, como Pesquisas, Conexões que não são referenciados por integrações, também serão
migrados.

 Configuração de terminal (configurada em conexões).

 Certificados

9 STATEMENT OF DIRE CTION / Como migrar pacote do ICS para OIC

  Credenciais armazenadas no repositório do CSF.

 Configurações como banco de dados, notificação.

A ferramenta de migração automatiza algumas das tarefas abaixo que, caso contrário, teriam de ser feitas manualmente se você
usar exportação e importação manuais:

 Exportação em massa de todas as integrações junto com suas dependências (como Conexões, Pesquisas, etc.) em

um pacote de migração.

 Migração de configuração de terminal e credenciais

 Substituição automática de host / porta da instância do ICS de origem para a instância OIC de destino para casos de

uso "Integration calling Integration".

 "Conexão de Teste Automática"

 Ativação automática de integrações ativadas anteriormente.

8.1 Ativando a migração no OIC

Um sinalizador de recurso deve estar habilitado no OIC para importar conteúdo para o OIC como parte da migração. Para ativar o
sinalizador de recurso, abra uma solicitação de serviço com suporte Oracle.

8.2 Ciclo de Vida de Migração

10 STATEMENT OF DIRECTION / Como migrar pacote do ICS para OIC

Etapas de alto nível que precisam ser executadas para a migração:

1. Crie um depósito de armazenamento de objetos no ambiente subjacente do Oracle Cloud Infrastructure (se o destino de
migração for OIC autônomo). Isso é necessário para transferir o pacote de migração entre o ICS e o OIC.
0. Verifique neste link as etapas detalhadas sobre como criar um intervalo de armazenamento.
2. Depois que a etapa acima for concluída, usando a URL de armazenamento e as credenciais de armazenamento, chame a
API REST de exportação no ambiente do ICS. Isso copiará os dados do ICS para o serviço de armazenamento.
3. Invoque uma API REST para fornecer o status da operação de exportação, se necessário.
4. Para obter informações sobre quais objetos foram exportados ou qualquer erro ou aviso que foi gerado como parte da
migração, pode ser recuperado de um relatório de migração.
5. Em seguida, execute a operação de importação no ambiente OIC passando o URL de armazenamento e as credenciais
de armazenamento. Isso importará o conteúdo do armazenamento para o OIC.
6. Invoque uma API REST para fornecer o status da operação de exportação, se necessário.
7. Para obter informações sobre quais objetos foram importados ou qualquer erro ou aviso que foi gerado como parte da
migração, pode ser recuperado do relatório de migração.

9. EXPORTANDO OS DADOS DO ICS

Exportar os dados de um ambiente ICS usando as etapas abaixo: (Consulte a seção " Exportando os dados da OIC " para
exportar da OIC)

Usando o acesso de administrador, execute a API REST de exportação. Uma amostra é mostrada abaixo usando o cliente REST
do Postman:

Pedido de Exportação:

Construa o URL de armazenamento com base na configuração feita no serviço de armazenamento com base no formato
" https://swiftobjectstorage.region.oraclecloud.com/v1/tentancy/bucket", passando também as credenciais de
armazenamento.
Verifique este link para mais detalhes sobre como criar um intervalo de armazenamento.

Resposta:

Estado de verificação:

11 STATEMENT OF DIRECTION / Como migrar pacote do ICS para OIC

Verificando o arquivo de migração:

12 STATEMENT OF DIRECTION / Como migrar pacote do ICS para OIC

 10. IMPORTANDO OS DADOS PARA O OIC
Importe os dados de um ambiente OIC usando as etapas abaixo:

O utilitário de migração suporta diferentes modos para o processo de importação

Não valor importActivateMode Descrição

1 ImportOnly Este modo importa apenas os objetos e não ativa integrações. Usado
no caso de uma operação manual precisar ser executada, como a
instalação do agente do adaptador.

2 ImportActivate Este modo importa e ativa todas as integrações ativadas

anteriormente .

3 ActivateOnly Este modo ativa somente as integrações ativadas anteriormente.

Usando o acesso de administrador, execute a API REST de importação. Uma amostra é mostrada abaixo usando o cliente REST
do Postman:

Pedido ImportOnly:

Construa o URL de armazenamento com base na configuração feita no serviço de armazenamento com base no formato
" https://swiftobjectstorage.region.oraclecloud.com/v1/tentancy/bucket", passando também as credenciais de armazenamento.

13 STATEMENT OF DIRECTION / Como migrar pacote do ICS para OIC

Solicitação ImportActivate:

Pedido ActivateOnly:

Resposta:

14 STATEMENT OF DIRECTION / Como migrar pacote do ICS para OIC

Verificando o status de importação:
 Nota: O jobId retornado na carga útil da solicitação de Importação é passado como parte do recurso. No exemplo
abaixo, o jobId é "405"

Verificando o relatório de migração

O resultado do processo de importação de migração pode ser verificado usando as etapas abaixo:

Localização do relatório de migração:

15 STATEMENT OF DIRECTION / Como migrar pacote do ICS para OIC

Relatório de amostra:

Exportando os dados do OIC

16 STATEMENT OF DIRECTION / Como migrar pacote do ICS para OIC

Exporte os dados de um ambiente OIC usando as etapas abaixo:

Usando o acesso de administrador, execute a API REST de exportação. Uma amostra é mostrada abaixo usando o cliente REST
do Postman:

Pedido de Exportação:

Resposta de Exportação:

Estado de verificação:

Coisas para lembrar

O Clone Utility não exporta as configurações do agente. As configurações do Agente, como Grupos de Agentes, terão que ser

17 STATEMENT OF DIRECTION / Como migrar pacote do ICS para OIC

recriadas manualmente e os testes de conectividade devem ser realizados com os Agentes executados no local.

Se você tivesse permitido endereços IP ICS para se conectar a aplicativos Oracle SaaS ou aplicativos de terceiros, essas listas de
permissões devem ser alteradas para refletir os endereços IP da OIC. Um ticket de suporte da Oracle precisa ser gerado para
obter os endereços IP da OIC.

As regras de senha foram alteradas entre o ICS e o OIC. O ICS permitia senhas com no mínimo 8 caracteres, enquanto o OIC
permitia no mínimo 12 senhas de caracteres. Isso não deve ser um problema, a menos que haja integrações nas quais o ICS
chama o ICS. Nesse caso, a senha de conexão deve ser atualizada manualmente após a importação.

O Clone Utility não só pode ser usado para migrar do ICS para o OIC, mas também pode ser útil em cenários de Teste para
Produção (T2P) ou Produção para Teste (P2T).

Resumo
O ICS e o OIC fornecidos pelo Clone Utility podem ser usados para exportar artefatos do ICS para o OIC. As APIs REST
fornecidas pelo Clone Utility podem migrar todos os artefatos do ICS para o OIC. O Clone Utility não só ajuda a migrar do ICS para
o OIC, como também pode ajudar a clonar ambientes OIC existentes em cenários T2P ou P2T.

18 STATEMENT OF DIRECTION / Como migrar pacote do ICS para OIC

ORACLE CORPORATION

Worldwide Headquarters
500 Oracle Parkway, Redwood Shores, CA 94065 USA

Worldwide Inquiries
TELE + 1.650.506.7000 + 1.800.ORACLE1
FAX + 1.650.506.7200
oracle.com

CONNECT W ITH US
Call +1.800.ORACLE1 or visit oracle.com. Outside North America, find your local office at oracle.com/contact.

blogs.oracle.com/oracle facebook.com/oracle twitter.com/oracle

Copyright © 2019, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the contents hereof are
subject to change without notice. This document is not warranted to be error-free, nor subject to any other warranties or conditions, whether expressed
orally or implied in law, including implied warranties and conditions of merchantability or fitness for a particular purpose. We specifically disclaim any
liability with respect to this document, and no contractual obligations are formed either directly or indirectly by this document. This document may not be
reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without our prior written permission. This device has
not been authorized as required by the rules of the Federal Communications Commission. This device is not, and may not be, offered for sale or lease,
or sold or leased, until authorization is obtained. (THIS FCC DISLAIMER MAY NOT BE REQUIRED. SEE DISCLAIMER SECTION ON PAGE 2 FOR
INSTRUCTIONS.)
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or
registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks
of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 0819