Migrar um Aplicativo Local do Essbase 11g

Você pode exportar aplicativos das versões 11.1.2.3.0nn, 11.1.2.4.0nn, 11.1.2.4.5nn ou 12.2.1, usando o Utilitário de Exportação do LCM 11g, e importá-los para a versão de destino usando o Utilitário CLI. Observe que você também pode executar o LCMImport na guia Jobs do Essbase para importar aplicativos.

Este é o workflow para migrar do 11g:

Fazer Download do Utilitário de Exportação 11g LCM: Na interface Web do Essbase, clique em Console, expanda Ferramentas de Linha de Comando e faça download do Utilitário de Exportação 11g LCM (EssbaseLCMUtility.zip). O utilitário baixado deve ser copiado e executado na mesma máquina da instalação do Essbase 11g On-Premise ou do 12.2.1, para que as funções do Enterprise Performance Management (EPM) sejam exportadas.

Definir parâmetros de exportação: Se a opção –exportepmroles estiver ativada, você deverá definir os seguintes parâmetros antes de executar a exportação do LCM.

Para Linux:

export EPM_ORACLE_HOME=/scratch/Oracle/Middleware/EPMSystem11R1
export EPM_ORACLE_INSTANCE=/scratch/Oracle/Middleware/user_projects/epmsystem1

Para Windows:

set EPM_ORACLE_HOME=C:\Oracle\Middleware\EPMSystem11R1
set EPM_ORACLE_INSTANCE=C:\Oracle\Middleware\user_projects\epmsystem1

Configurar o Utilitário de Exportação LCM 11g: Antes de executar o utilitário, você deve definir e exportar as variáveis de ambiente EPM_ORACLE_HOME e EPM_ORACLE_INSTANCE no terminal shell. Essas variáveis devem ser as mesmas usadas no ambiente de origem do EPM 11g. Para obter detalhes, consulte Sobre o Middleware Home, o EPM Oracle Home e o EPM Oracle Instance. Além disso, no arquivo baixado descompactado, execute EssbaseLCM.bat (Windows) ou EssbaseLCM.sh (Linux), com base na plataforma na qual você deseja executar o utilitário. Consulte também Opções do Utilitário de Exportação do 11g LCM.
Verifique o diretório /tmp: talvez seja necessário alterar a localização do diretório tmp. Se estiver cheio, o Utilitário de Exportação do LCM 11g poderá falhar.
Executar a exportação: Quando você exporta aplicativos de armazenamento em blocos não Unicode, use a opção -converttoutf8 no comando de exportação do LCM. Quando você exportar aplicativos de armazenamento agregado não Unicode, converta-os manualmente usando as etapas em Converter Aplicativo de Armazenamento Agregado Não Unicode em Modo Unicode.
Sintaxe de exportação LCM: No prompt de comando, informe a seguinte sintaxe de comando para exportar um ou mais aplicativos para um arquivo .zip:
```
EssbaseLCM.bat|.sh export -server essbasehost:port -user username -password password -application
      appname -zipfile zipfilename [-nodata] [-include-server-level] [-converttoutf8] [-forceutf8]
      [-generateartifactlist] [-exportepmroles] [-allApp] [-exportdata]
          [-cube] [-filetype] [-partitions] [-filters]
```
Especifique estas opções:

-exportepmroles : (opcional) Exporta funções do Enterprise Performance Management (EPM)

-include-server-level : (opcional) Inclui artefatos no nível do servidor, como variáveis de substituição no nível do servidor ou atribuições no nível do servidor

-generateartifactlist : (opcional) Gera lista de artefatos

Por exemplo:
```
EssbaseLCM.sh export -server localhost:1423 -user admin -password password -application Sample -zipfile Sample.zip -include-server-level -exportepmroles -generateartifactlist
```
Isso exporta artefatos adicionais: atribuições no nível do servidor de usuários e grupos, atribuições no nível do aplicativo, cálculos e associações de filtros.
Executar a importação: Para importar um ou mais aplicativos, use o Utilitário de Interface de Linha de Comando (CLI) do Essbase para fazer upload do arquivo .zip para o aplicativo de destino.
A sintaxe do comando lcmimport da CLI é a seguinte:
```
lcmImport [-verbose] -zipfilename filename [-overwrite] [-targetappName targetApplicationName][-include-server-level][-artifactlist artifactList][-restEncryPassword]
```
Consulte: LcmImport: Restaurar Arquivos de Cubo.
Quando houver partições na origem entre um aplicativo ou banco de dados de origem e um aplicativo ou banco de dados de destino, só as partições do destino serão exportadas para o sistema de arquivos. Quando houver partições entre os cubos que estão sendo migrados, importe a origem de dados antes do destino dos dados. Caso contrário, as definições de partição poderão não ser restauradas.

As atribuições só serão definidas se os usuários estiverem disponíveis no Oracle Identity Cloud Service. Você pode substituir o mapeamento de atribuição padrão alterando o mapeamento no CSSMappings.xml fornecido com o Utilitário de Exportação LCM 11g.
As partições federadas não são migradas; portanto, ao mover o aplicativo e o cubo para outro servidor ou versão, você precisa excluir a partição federada e recriá-la no novo ambiente. Consulte Manutenção e Resolução de Problemas de Cubo Federado.
Fazer upgrade da versão do outline de armazenamento agregado: Após a importação de aplicativos de armazenamento agregado, o outline deverá ser atualizado usando o ESSCMDQ. Consulte Fazer Upgrade da Versão do Outline de Armazenamento Agregado.
Validar: Faça logon na interface web do Essbase para ver o aplicativo e o cubo na página Aplicativos.