Prepare-se para Migrar do Essbase 11g On-Premise

Se você tiver um aplicativo e cubo do Essbase 11g On-Premise existente para migrar para o Essbase 26ai, verifique as seguintes considerações e pré-requisitos.

Diferenças entre Essbase 11g On-Premise e Essbase 26ai

Fluxo de Tarefas para Migração

Observação:

  • Se você usou o EPM Shared Services no Essbase 11g On-Premise para configurar um provedor de segurança externo, a etapa 1 abaixo não será necessária. Com base no modo de segurança escolhido durante a configuração, talvez seja necessário configurar sua instância de destino do EPM ou o WebLogic para usar o mesmo provedor de segurança externo usado no Essbase 11g On-Premise.

  • Se você estiver usando o Oracle Identity Cloud Service, configure-o para usar o mesmo provedor de segurança externo usado no Essbase 11g On-Premise.

  1. Migrar usuários e grupos do EPM Shared Services On-Premise de origem para o OCI Identity and Access Management (IAM) ou o Oracle Identity Cloud Service (IDCS) (para implantação do OCI) ou o LDAP do EPM Shared Services / WebLogic (para implantações Independentes). Consulte Migrar Usuários e Grupos do Essbase 11g.

  2. Se você estiver exportando aplicativos não Unicode do Essbase 11g On-Premise, deverá converter os aplicativos em Unicode.

    1. Use Alterar Sistema no servidor e, em seguida, em uma cópia de backup do aplicativo Essbase, antes de executar o Utilitário de Exportação 11g LCM, para ativar o próprio Essbase para suportar o aplicativo Unicode.

    2. Para aplicativos de armazenamento que não sejam Unicode, bloco, exporte o aplicativo usando a opção -converttoutf8 no comando de exportação. Consulte Opções do Utilitário de Exportação do 11g LCM.

      Para aplicativos de armazenamento não Unicode, agregar, siga as instruções manuais de conversão Unicode em Converter Aplicativo de Armazenamento Agregado Não Unicode em Modo Unicode.

  3. Migrar aplicativos 11g:

    1. Exporte aplicativos do Essbase usando o Utilitário de Exportação do 11g LCM, baixado da instância de destino do Essbase 26ai e executando o utilitário no computador em que o Essbase 11g On-Premise está instalado.

      Observação:

      Para usar o Utilitário de Exportação LCM 11g, o JDK (Java Development Kit) 8 ou superior deve ser instalado e as seguintes variáveis devem ser definidas: variável de ambiente JAVA_HOME e variáveis EPM_ORACLE_HOME e EPM_ORACLE_INSTANCE no terminal de shell.

    2. Importe aplicativos do Essbase usando o Utilitário Interface de Linha de Comando (CLI) do Essbase, baixado da instância do Essbase 26ai. Execute o utilitário para cada arquivo zip exportado.

Versões e Caminhos Suportados do Essbase

As seguintes versões foram testadas para migração: 11.1.2.3.0nn, 11.1.2.4.0nn, 12.2.1 e posterior.

Observação:

A migração do 11.1.2.3 é suportada, no entanto, nem todos os aplicativos podem ser migrados do 11.1.2.3 para o 26ai. Recomendamos que você faça upgrade de 11.1.2.3.0.n.n para 11.1.2.4.0.n.n antes de tentar a migração para 26ai.

Os seguintes caminhos de migração não são suportados:
  • Essbase 19c ou 26ai no OCI (implantação do Marketplace) para o Essbase 26ai no Windows (implantação independente)
  • Essbase 26ai no Linux (implantação independente) para o Essbase 26ai no Windows (implantação independente)

Artefatos Migrados do 11g

Revise os artefatos do 11g que são suportados para migração. Consulte Artefatos Migrados.

Definições de Aplicativos e Bancos de Dados não suportados

As seguintes definições no nível do aplicativo ou do banco de dados não são suportadas na migração: volumes de disco.

OBSERVAÇÕES DE CONFIGURAÇÃO

  • Modo Híbrido

    O processador padrão de cálculo e consulta é híbrido. O modo híbrido permite aos cubos de armazenamento em blocos ter membros esparsos dinâmicos e de nível superior, além de consulta e cálculo totalmente dinâmicos. Você pode consultar dados imediatamente depois de atualizá-los, sem executar cálculos em batch. No modo híbrido, não haverá impacto nos cubos se você optar por não aplicar o cálculo dinâmico aos membros esparsos do nível superior. Observação: o modo Híbrido não é o padrão se estiver usando scripts de cálculo - se seus scripts de cálculo contiverem muitas dependências esparsas, considere também ativar o modo híbrido para scripts de cálculo.

  • Compartilhamento Implícito

    Se você usar a configuração IMPLIED_SHARE no seu aplicativo Essbase 11g On-Premise, sua configuração de compartilhamento implícito será migrada para o mínimo de interrupção. Para obter mais detalhes sobre padrões de compartilhamento implícitos no Essbase 26ai, consulte o tópico de configuração IMPLIED_SHARE_ON_CREATE.

  • Aviso Sobre a Definição de UPPERCASECONNECTION esssql.cfg

    Se o seu ambiente tiver um arquivo esssql.cfg contendo a definição UPPERCASECONNECTION não suportada, você poderá receber um aviso como o seguinte ao executar operações de carregamento de dados:

    WARNING – 1021037 - SQL Config file syntax error [UpperCaseConnection], ignored.

    A maneira de corrigir isso é remover manualmente a configuração UPPERCASECONNECTION do esssql.cfg, que está localizada no 

    <DOMAIN_HOME>/config/fmwconfig/essconfig/essbase/esssql.cfg

    e reinicie os servidores do Essbase.

  • Medidas de Texto e Data
    A partir do Essbase 21.3 e superior, a configuração ALLOWOUTOFRANGELOAD está obsoleta e o comportamento será o mesmo que "ALLOWOUTOFRANGELOAD TRUE" nas versões anteriores. Valores fora do intervalo e ausentes de medidas digitadas serão carregados e exportados de cubos que tenham medidas textuais. No exemplo de arquivo de exportação de dados a seguir, o <OutOfRange_Name> is" Invalid" e "NoColor" para valores Ausentes.
    "Color1" "Color2"
"Shoes" "Massachusetts" "Q1" "#Txt:NoColor" "#Txt:Yellow"
"Q2" "#Txt:Green"
"Connecticut" "Q1" "#Txt:Green" "#Txt:Invalid"
    Para obter informações sobre como carregar valores fora do intervalo, consulte Carregando, Limpando e Exportando Medidas de Texto e Data.

  • Definições de Configuração

    Alguns valores de configuração padrão são diferentes dos do Essbase 11g On-Premise. Verifique a Referência de Configuração.

    As configurações de INDEXCACHESIZE e DATACACHESIZE agora controlam tamanhos de cache para todos os cubos do Essbase (exceto para cubos de armazenamento agregado). Anteriormente, essas definições só afetavam cubos recém-criados ou migrados.

    Para modificar os valores padrão das definições de configuração no nível do aplicativo, use a interface Web do Essbase.

    A Oracle recomenda gerenciar a maioria das configurações no nível do aplicativo. Quando você migra aplicativos, sua configuração no nível do aplicativo é preservada durante os processos de exportação e importação do LCM. Algumas configurações, no entanto, só se aplicam ao Essbase Server. A maioria dessas configurações de servidor que você especifica ao configurar o Essbase durante a implantação, mas também pode alterar os padrões de configuração do servidor usando essbase.cfg, se necessário.

OBSERVAÇÕES GERAIS

  • Tipos de Dados de Timestamp SQL Importados

    Os tipos de dados de timestamp SQL que antes eram exibidos no formato ODBC [yyyy-mm-dd hh:mm:ss] agora exibem em um formato diferente [dd-MON-yy hh.mm.ss.mmm a], no editor de regras da Interface Web do Essbase e em qualquer outro lugar que os tipos de dados de timestamp sejam importados. Para carregar o timestamp no formato de sua escolha durante cargas de dados ou criações de dimensões, você pode converter os timestamps no formato de string desejado usando uma função de conversão SQL na seção de consulta da regra de carga. O exemplo da seguinte consulta SQL usa a função de formato: SELECT introdate, format(introdate, 'yyyy-MM-dd hh:mm:ss') FROM tbc.dbo.product

  • Atualização de Aplicativos EPM - Cálculos e Filtros

    Depois de atualizar os aplicativos para o Essbase 26ai, não é possível provisionar membros para cálculos ou filtros no console do EPM Shared Services. Você deve usar a interface Web do Essbase para atribuir membros. Consulte: Atribuindo Filtros e Acesso a Cálculos.

  • Partições

    Quando você executar a operação de importação de LCM, importe os aplicativos de origem antes dos aplicativos de destino. Se você não importar os aplicativos de origem antes dos de destino, a definição de partição não funcionará e será necessário recriá-la após a importação dos aplicativos de origem.

    Depois de reverter um OPatch, talvez seja necessário recriar partições transparentes e replicadas e revalidar as partições.

  • Opções de Criação de Aplicativo além do LCM

    Além de usar o LCM para migrar aplicativos exportados, você também pode criar aplicativos das seguintes maneiras:

    • Importar usando pastas de trabalho do aplicativo Excel
    • No Smart View, use a extensão do Cube Designer
    • Instrução create application do MaxL

  • Alias do Local

    O LCM não suporta migração de credenciais de alias de Local. Depois de migrar seus aplicativos do Essbase 11g On-Premise, você deverá substituir seus aliases de local. Você pode usar o seguinte método automatizado ou um método manual usando MaxL.

    Método automatizado para substituir aliases de local

    1. Descompacte o zip exportado do LCM.
    2. Vá para {ApplicationName}\Databases{dbName}\Location Aliases.
    3. Abra o arquivo neste diretório. Este é um arquivo de formato XML, no qual o campo userName e senha estão vazios. Você pode fornecer as credenciais.
    4. Compactar o diretório novamente.
    5. Importe o aplicativo usando o diretório zip.

      Arquivo xml de amostra

      <?xml version="1.0" encoding="UTF-8"?>
<java version="$VERSION$" class="java.beans.XMLDecoder">
<object class="oracle.essbase.lcm.essbase.EssbaseLocationAlias">
<void property="aliasAppName">
<string>
{appName}
</string>
</void>
<void property="aliasCubeName">
<string>
{dbName}
</string>
</void>
<void property="aliasHostName">
<string>localhost</string>
</void>
<void property="password">
<string>password</string>
</void>
<void property="userName">
<string>lauser</string>
</void>
</object>
</java>

    Método manual usando MaxL para substituir aliases de local

    Um método manual de opção alternativa usa MaxL. Depois de importar aplicativos de origem executando o job CLI LCMImport, recrie aliases de local usando Criar Alias de Local.

  • Funções e Macros Definidas pelo Cliente

    FOR INDEPENDENT DEPLOYMENTS - Se você tiver um arquivo .jar personalizado usado para funções e macros de cálculo definidas personalizadas, elas não serão migradas pelo Utilitário de Exportação LCM 11g. Você deve movê-los manualmente. Para fazer isso,

    1. Observe o local do seu <Essbase Path> e <Application directory> (ARBORPATH) no Essbase 26ai. Se necessário, consulte Locais de Ambiente na Plataforma Essbase.

    2. Migre funções globais (no nível do sistema) copiando seus arquivos .jar de <Essbase Path>/java/udf na sua instância de origem para <Essbase Path>/java/udf na sua instância de destino do Essbase.

    3. Migre as funções locais (no nível do aplicativo) copiando os arquivos .jar do diretório do aplicativo na instância de origem para o diretório do aplicativo na instância de destino do Essbase. Em outras palavras, copie os arquivos .jar do <ARBORPATH>/app/<app_name> no servidor 11g para o <Application directory>/app/<app_name> no servidor 26ai.

    4. Na instância de destino do Essbase, adicione JVMMODULELOCATION a essbase.cfg, fornecendo como argumento o caminho para a biblioteca JVM no sistema.

  • URLs de Serviço do Cliente

    FOR INDEPENDENT DEPLOYMENTS - No Essbase 11g, Provider Services é o provedor de origem de dados de nível intermediário para clientes Oracle Essbase FOR Java API, Smart View e XML FOR Analysis (XMLA).

    A funcionalidade do Provider Services é integrada ao WebLogic. Atualize os URLs do cliente para o formato atual.

    Clientes Antigo URL para Conectar o Provider Services ao Cliente Especificado Novo URL no Essbase 26ai
    API Java http://server_name:port/aps/JAPI http://server_name:port/essbase/japi
    Smart View http://server_name:port/aps/SmartView http://server_name:port/essbase/smartview
    XML para Análise (XMLA) http://server_name:port/aps/XMLA http://server_name:port/essbase/xmla

  • Ordem de Resolução do Esboço e Medidas Digitadas Ativadas

    FOR OCI MARKETPLACE DEPLOYMENTS - Depois de migrar um aplicativo Essbase do servidor Essbase 11g On Premises para o Essbase implantado no OCI via MARKETPLACE, você deve ativar as medidas digitadas no outline para poder alterar a ordem de resolução do outline.

    No Essbase implantado no OCI, a propriedade de outline Medidas Digitadas Ativadas é definida como FALSO por padrão. Para alterar a ordem de resolução, primeiro a propriedade Medidas Digitadas Ativadas precisa ser alterada para VERDADEIRO. Para alterar essa propriedade, consulte About Typed Measures no Database Administrator's Guide for Oracle Essbase.