Migrar Aplicativos Usando o Utilitário de Migração

Como Administrador de Serviço do Essbase, você pode usar o Utilitário de Migração (migrationTools.jar) para migrar uma instância inteira do Essbase (todos aplicativos, usuários e grupos e outros artefatos) de uma instância de nuvem para outra em um único processo.

Você pode usar o Utilitário de Migração para migrar de aplicativos de origem e elementos de implantações do Essbase no OCI via Marketplace. O utilitário migra vários aplicativos de uma só vez. Ele também migra artefatos, regras, usuários e grupos.

Observe que os comandos lcmimport e lcmexport da Interface de Linha de Comando (CLI) do Essbase não migram usuários e grupos.

Antes de usar o Utilitário de Migração, conclua o seguinte pré-requisito: Configurar o Certificado SSL.

Casos de Uso do Utilitário de Migração

Veja a seguir alguns casos de uso para migração com o Utilitário de Migração.

Migre usuários do Essbase do LDAP do WebLogic na origem para o OCI Identity and Access Management (IAM) ou o Oracle Identity Cloud Service (IDCS) no destino.
Use o Utilitário de Migração para implantações básicas que não são personalizadas. Se sua implantação incluir personalizações, como soluções personalizadas de sign-on único, use a CLI em vez do Utilitário de Migração.
Quando a implantação do Essbase de origem for de
- Essbase Marketplace no Oracle Cloud Infrastructure, usando o OCI Identity and Access Management (IAM) ou o Oracle Identity Cloud Service (IDCS), ou
- Essbase Marketplace no Oracle Cloud Infrastructure, usando LDAP Incorporado
em seguida, antes de usar as etapas do utilitário de Migração abaixo para exportar, primeiro crie um novo aplicativo confidencial conforme descrito em Criar um Aplicativo de Identidade Confidencial. Além disso, antes de usar o Utilitário de Migração para importar, altere os detalhes do host e do IAM ou IDCS em import.properties para apontar para a instância de destino do Essbase.

Etapas para Migrar Aplicativos e Usuários da Nuvem Usando o Utilitário de Migração

Antes de usar o Utilitário de Migração, caso ainda não o tenha feito, aplique patch à sua instância de origem do Essbase para a versão mais recente.
Caso não esteja instalado, faça download e instale o JDK (Java SE Development Kit) 8 na Oracle Technology Network.
Defina o nome da variável de ambiente JAVA_HOME no seu sistema para indicar a pasta de instalação do JDK. Se o caminho de instalação contiver espaços, inclua o caminho no valor da variável, entre aspas, por exemplo, "C:\Program Files\Java\jdk1.8.0_171".
Acesse a interface Web do Essbase de destino e navegue até o Console.
Na Console, vá para as Ferramentas da Área de Trabalho e expanda Ferramentas de Linha de Comando.
Clique em Fazer Download ao lado do Utilitário de Migração.
Faça download do arquivo zip do Utilitário de Migração para uma unidade local. Para obter melhores resultados, escolha um caminho que não tenha espaços, por exemplo, C:\Oracle.
Extraia o arquivo zip e veja os arquivos extraídos (propriedades, jar e arquivo readme) na pasta migrationTools.

Antes de executar a exportação do Utilitário de Migração, edite o arquivo export.properties, localizado no mesmo diretório do utilitário. Forneça os detalhes da instância de origem do Essbase da qual você está migrando.

Exportar Propriedade	Descrição
userName	Obrigatório. Nome de usuário do administrador do Essbase.
senha	Obrigatório. Senha do administrador do Essbase.
host	Obrigatório. Endereço IP do balanceador de carga, se um balanceador de carga tiver sido configurado durante a implantação do Essbase. Caso contrário, o nome do host ou o endereço IP que corresponde ao endereço IP público do Essbase.
porta	Opcional. Porta de listening HTTP da instância do Essbase de origem. Se a instância de origem estiver configurada no modo seguro (TLS) e a porta `isTLS`=true 443 for assumida. Se a instância de origem estiver configurada com o provedor de identidades LDAP, defina a porta como 80.
isTLS	Opcional: true ou false. Se verdadeiro, a instância de origem será configurada no modo seguro (TLS) usando o valor `port` especificado.
proxy	Opcional. Endereço do host do proxy HTTP, se a conexão com a instância de origem do Essbase exigir um proxy. O host proxy e a porta proxy são separados por dois-pontos. Se a porta do proxy for omitida, seu valor será considerado 80. Exemplo com porta omitida: `www-proxy-example.com`. Exemplo com porta incluída: `www-proxy-example.com:80`
skipdata	Opcional. O default é false. Defina como verdadeiro se apenas os esquemas do aplicativo Essbase tiverem que ser exportados.
skipUser	Opcional: true ou false. Definir como verdadeiro somente se não houver necessidade de exportar usuários e/ou grupos. O valor padrão é falso.
IdcsHost	Obrigatório somente ao migrar usuários e/ou grupos de uma instância implantada no OCI via Marketplace. O host do domínio de identidades da origem no serviço IAM ou IDCS. No URL do Domínio de Identidades (exemplo: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`, extraia somente a parte do domínio após a string. Exemplo: `identity.oraclecloud.com`
idcsTenant	Obrigatório apenas para migrar usuários e/ou grupos de uma instância implantada no OCI via Marketplace. O identificador da tenancy do domínio de identidades do host de origem no serviço IAM ou IDCS. No URL do Domínio de Identidades (exemplo: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`, extraia somente `idcs-<string_of_numbers_and_letters>`.
clientId	Obrigatório apenas para migrar usuários e/ou grupos de uma instância implantada no OCI via Marketplace. O identificador do cliente do host de origem para autorização OAuth, encontrado no aplicativo de identidade confidencial integrado.
clientSecret	Obrigatório apenas para migrar usuários e/ou grupos de uma instância implantada no OCI via Marketplace. O segredo do cliente do host de origem para autorização OAuth, encontrado no aplicativo de identidade confidencial integrado.
ID do aplicativo	Obrigatório apenas para migrar usuários e/ou grupos de uma instância implantada no OCI via Marketplace. Identificador do aplicativo de identidade confidencial integrado no domínio de identidades do OCI (IAM ou IDCS). Este aplicativo de identidade deve ser configurado com atribuições de aplicativo concedíveis a usuários e grupos. Essa propriedade permite conceder atribuições a usuários e grupos migrados.

Edite o arquivo import.properties, localizado no mesmo diretório do utilitário. Forneça os detalhes da instância de destino do Essbase para a qual você está migrando.

Importar Propriedade	Descrição
userName	Obrigatório. Nome do usuário administrador do Essbase da instância de destino.
senha	Obrigatório. Senha do administrador do Essbase da instância de destino.
host	Obrigatório. O endereço IP da instância de destino do balanceador de carga, se um balanceador de carga tiver sido configurado durante a implantação do Essbase. Caso contrário, o nome do host ou o endereço IP que corresponde ao endereço IP público do Essbase.
porta	Opcional. Porta de listening HTTP da instância do Essbase de destino. Se a instância de destino estiver configurada no modo seguro (TLS) e a porta `isTLS`=true 443 for assumida. Se a instância de origem estiver configurada com o provedor de identidades LDAP, defina a porta como 80.
isTLS	Opcional: true ou false. Se verdadeiro, a instância de destino será configurada no modo TLS (Secure) usando o valor `port` especificado.
userPassword	Opcional. Senha inicial a ser designada a qualquer novo usuário que o utilitário migre para o aplicativo de identidade integrado no IAM ou no IDCS. Para alterar as senhas após a migração, use a Console do OCI.
proxy	Opcional. Endereço do host do proxy HTTP, se a conexão com a instância de destino do Essbase exigir um proxy. O host proxy e a porta proxy são separados por dois-pontos. Se a porta do proxy for omitida, seu valor será considerado 80. Exemplo com porta omitida: `www-proxy-example.com`. Exemplo com porta incluída: `www-proxy-example.com:80`
skipUser	Opcional: true ou false. Definir como verdadeiro somente se não houver necessidade de importar usuários e/ou grupos. O valor padrão é falso.
IdcsHost	Obrigatório apenas para migrar usuários e/ou grupos para uma instância implantada no OCI via Marketplace. Host do domínio de identidades de destino. No URL do Domínio de Identidades (exemplo: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`, extraia somente a parte do domínio após a string. Exemplo: `identity.oraclecloud.com`
idcsTenant	Obrigatório apenas para migrar usuários e/ou grupos para uma instância implantada no OCI via Marketplace. O identificador da tenancy do domínio de identidades do host de destino. No URL do Domínio de Identidades (exemplo: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`, extraia somente `idcs-<string_of_numbers_and_letters>`.
clientId	Obrigatório apenas para migrar usuários e/ou grupos para uma instância implantada no OCI via Marketplace. O identificador do cliente do host de destino para autorização OAuth, encontrado no aplicativo de identidade confidencial integrado.
clientSecret	Obrigatório apenas para migrar usuários e/ou grupos para uma instância implantada no OCI via Marketplace. O segredo do cliente do host de destino para autorização OAuth, encontrado no aplicativo de identidade confidencial integrado.
ID do aplicativo	Obrigatório apenas para migrar usuários e/ou grupos para uma instância implantada no OCI via Marketplace. Identificador do aplicativo de identidade confidencial integrado no domínio de identidades (IAM ou IDCS) do OCI. Este aplicativo de identidade deve ser configurado com atribuições de aplicativo concedíveis a usuários e grupos. Essa propriedade permite conceder atribuições a usuários e grupos migrados.
overwrite	Opcional. Defina como true se os aplicativos a serem importados já existirem no destino e você quiser substituí-los. O valor padrão é falso.
certificados	Opcional. Caminho completo para todos os arquivos de certificado confiável para todos os servidores TLS/SSL. Para o Windows, escape das barras invertidas com outra barra invertida. Exemplo: `C:\\migrationTools\\all_certs.pem`

Execute o Utilitário de Migração em Java com o comando de exportação para exportar todos os aplicativos, usuários e grupos do catálogo de instâncias de origem do Essbase para um arquivo compactado.

java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar export export.properties <new_tar_file>

Exemplo:

java –jar -Dhttps.proxyHost=www-proxy-abcdef.example.com -Dhttps.proxyPort=80 migrationTools.jar export export.properties export.tar.gz

Execute o Utilitário de Migração em Java com o comando import para importar o arquivo compactado para a instância de destino.
```
java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar import import.properties <existing_tar_file>
```
Depois que você executar a importação, os dados serão migrados para o catálogo do Essbase da instância alvo.