Converter Aplicativo de Armazenamento Agregado Não Unicode em Modo Unicode

Antes de exportar um aplicativo de armazenamento agregado do Essbase 11g On-Premise em preparação para migração para o Essbase 26ai, converta-o no modo unicode.

Configuração do cliente - Para configurar o ESSCMD/ESSCMDQ em um Cliente Windows

  1. Na interface Web do Essbase 26ai, faça download do Essbase Client for Windows e do MaxL Client.

  2. Extraia o Cliente MaxL para um diretório MaxLClient.

  3. Extraia o cliente ESSCMD para um diretório EssbaseClient.

  4. Copie o script startMAXL.bat do diretório MaxLClient para o diretório EssbaseClient. Renomeie o script como startEsscmd.bat.

  5. Edite o arquivo startEsscmd.bat e adicione uma nova configuração para chamar esscmd, em vez de esscmd.sh: 

    "%ESSBASEPATH%\bin\esscmd" %*

  6. Salve o arquivo. Execute-o como administrador e teste o log no Essbase 26ai Marketplace ou implantação Independente.

    Sintaxe de login:

    login https://<servername_or_IP>/essbase/agent <user> <password>

  7. Depois de confirmar se ele funciona, faça download do ESSCMDQ para Windows em https://www.oracle.com/middleware/technologies/esscmdq-sampleapps-downloads.html.

  8. Extraia ESSCMDQ.exe para o diretório EssbaseClient/bin.

  9. Copie o script startEsscmd.bat para startEsscmdQ.bat.

  10. Edite o arquivo startEsscmdQ.bat para chamar esscmdq em vez de esscmd: 

    "%ESSBASEPATH%\bin\esscmdq" %*

  11. Salve o arquivo. Execute-o como administrador e teste o log no Essbase 26ai Marketplace ou implantação Independente.

    Sintaxe de login:

    login https://<servername_or_IP>/essbase/agent <user> <password>

Observação:

  • Não use um IDCS/MSAD para estabelecer conexão. Use um usuário 'nativo' para fazer log-in.
  • Se estiver usando um servidor proxy, talvez seja necessário adicionar as seguintes configurações aos scripts startEssmcd/q.bat:
    • definir HTTP_PROXY=<proxyserver>:<porta>
    • definir HTTPS_PROXY=<proxyserver>:<porta>

Configuração do lado do servidor - Para configurar diretamente no servidor do Essbase

  1. Converta o aplicativo de armazenamento agregado copiado para o modo Unicode usando MaxL Shell, conforme descrito abaixo.

  2. Altere o valor de ESSLANG no outline de origem da codificação nativa para UTF-8, conforme descrito abaixo.

Converta o aplicativo de armazenamento agregado copiado no modo Unicode usando MaxL Shell:

  1. Faça logon na instância de origem do Essbase 11g On-Premise usando o MaxL Shell.

  2. Execute a instrução MaxL alter application <copied_app> set type unicode_mode para converter o aplicativo em Unicode.

    Por exemplo: 
    MaxL> alter application SampleBck set type unicode_mode;
    Para obter mais detalhes sobre a MaxL, consulte Alterar Aplicativo (Armazenamento Agregado).

Observação:

Todas as operações a seguir devem ser executadas no aplicativo copiado e não no aplicativo de origem.
Altere o valor de ESSLANG no outline de origem da codificação nativa para UTF-8.

  1. Fazer Download do ESSCMDQ

    1. Faça download da versão "11.1.2.4.010+" específica da plataforma do ESSCMDQ em Faça download do ESSCMDQ para sua instância de origem do EPM 11g.
    2. Descompacte os arquivos diretamente no mesmo diretório onde o ESSCMD está presente na instalação,

      Para Linux

      $ESSBASEPATH/bin
      Por exemplo: 
      ./Middleware/EPMSystem11R1/products/Essbase/EssbaseServer/bin/ESSCMDQ

      Para Windows

      %ESSBASEPATH%\bin
      Por exemplo: 
      .\Middleware\EPMSystem11R1\products\Essbase\EssbaseServer\bin\ESSCMDQ.exe

      Para saber os valores das variáveis de ambiente na instalação do EPM 11g de origem, verifique o arquivo de ambiente.

      Para Linux:
      ./Middleware/user_projects/<epm_instance>/EssbaseServer/essbaseserver1/bin/setEssbaseEnv.sh
      Para Windows:
      ./Middleware/user_projects/<epm_instance>/EssbaseServer/essbaseserver1/bin/setEssbaseEnv.bat

      Por padrão, <epm_instance> seria epmsystem1.

    3. Faça uma cópia do script existente

      Para Linux

      ./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmd.sh

      como

      ./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh

      Para Windows

      .\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmd.bat

      como

      .\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmdQ.bat

      Neste script recém-criado, altere a chamada de ESSCMD para ESSCMDQ.

    4. Pouco antes desta última linha (um pouco antes da chamada para ESSCMDQ), adicione as seguintes linhas:

      Para Linux
      export ESSCMDQ_UTF8MODE=1
export ESSLANG=.UTF-8@Binary

      Para Windows

      set ESSCMDQ_UTF8MODE=1
set ESSLANG=.UTF-8@Binary

  2. Certifique-se de ter interrompido o aplicativo copiado antes de converter o outline.

  3. Agora crie uma pasta client em ARBORPATH.

  4. Copie a pasta do aplicativo do diretório ARBORPATH/app para o diretório do cliente. Para o aplicativo ASOBck, por exemplo:

    Para Linux

    $ARBORPATH/app/ASOBck as $ARBORPATH/client/ASOBck

    Para Windows

    %ARBORPATH%\app\ASOBck as %ARBORPATH%\client\ASOBck

  5. Execute os comandos a seguir no ESSCMDQ após iniciar o seguinte.

    Observação:

    O ESSCMDQ é interativo, portanto os parâmetros para cada comando podem ser encontrados no modo interativo. Para ver o que significa um parâmetro, insira o comando, como OpenOtl, e pressione Enter para ver o menu que explica o parâmetro. Ou entre no comando ESSCMDQ e pressione Enter, sem quaisquer parâmetros, e o menu de parâmetros é exibido.

    Exemplo do Linux

    ./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh
openotlex2 1 1 appName dbName outlineName Y Y Locale N 0

    writeotlex 0 1 1 appName dbName outlineName 2

    Exemplo do Windows

    .\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmdQ.bat
openotlex2 1 1 appName dbName outlineName Y Y Locale N 0
    writeotlex 0 1 1 appName dbName outlineName 2

    Observe que Locale deve ser o valor ESSLANG nativo usado no ambiente de origem Essbase 11g On-Premise.

    Por exemplo (sintaxe Linux)

    
mkdir $ARBORPATH/client
cp -r $ARBORPATH/app/ASOBck $ARBORPATH/client

./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh
openotlex2 1 1 ASOBck Basic Basic Y Y "Japanese_Japan.MS932@Binary" N 0
writeotlex 0 1 1 ASOBck Basic Basic 2
exit

  6. Certifique-se de que nenhum erro seja exibido durante a execução dos comandos acima. Em seguida, para cada cubo, copie apenas o arquivo de outline do diretório do cliente de volta para o diretório do aplicativo.

    Por exemplo (sintaxe Linux):
    #Now copy back the converted outline only for each cube. For ASOBck app -
cp $ARBORPATH/client/ASOBck/Basic/Basic.otl $ARBORPATH/app/ASOBck/Basic/Basic.otl

#Note: The artifact files (.txt or .csc), which were created in native locale, may need to be converted to UTF-8 manually using third party tools which help in converting text encoding.

  7. Inicie o ESSCMDQ novamente usando:

    Para Linux

    ./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh

    Para Windows

    .\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmdQ.bat

    e reestruturar cada cubo.

    #Please replace hostname, username, password, appname and cubename with appropriate values
login 'hostname' 'username' 'password'
select appname cubename
openotl 2 1 appname cubename outlinename y y 0
writeotl 0 2 1 appname cubename outlinename
restructotl 1
closeotl 0
unlockobj 1 appname cubename outlinename
logout
exit

    Por exemplo:

    
login localhost:1423 user password
select ASOBck Basic
openotl 2 1 ASOBck Basic Basic y y 0
writeotl 0 2 1 ASOBck Basic Basic
restructotl 1
closeotl 0
unlockobj 1 ASOBck Basic Basic
logout
exit