Converti applicazione di memorizzazione di aggregazione non Unicode in modalità Unicode

Prima di esportare un'applicazione di memorizzazione di aggregazione da Essbase 11g in locale in preparazione della migrazione a Essbase 26ai, convertirla in modalità Unicode.

Configurazione lato client - Per impostare ESSCMD/ESSCMDQ su un client Windows

  1. Dall'interfaccia Web Essbase 26ai, scaricare il client Essbase per Windows e il client MaxL.

  2. Estrarre il client MaxL in una directory MaxLClient.

  3. Estrarre il client ESSCMD in una directory EssbaseClient.

  4. Copiare lo script startMAXL.bat dalla directory MaxLClient nella directory EssbaseClient. Rinominare lo script in startEsscmd.bat.

  5. Modificare il file startEsscmd.bat e aggiungere una nuova impostazione per chiamare esscmd anziché esscmd.sh: 

    "%ESSBASEPATH%\bin\esscmd" %*

  6. Salvare il file. Eseguire il login come amministratore e verificare il login al Marketplace Essbase 26ai o alla distribuzione indipendente.

    Sintassi di login:

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

  7. Dopo aver confermato che funziona, scaricare ESSCMDQ per Windows da https://www.oracle.com/middleware/technologies/esscmdq-sampleapps-downloads.html.

  8. Estrarre ESSCMDQ.exe nella directory EssbaseClient/bin.

  9. Copiare lo script startEsscmd.bat in startEsscmdQ.bat.

  10. Modificare il file startEsscmdQ.bat per chiamare esscmdq anziché esscmd: 

    "%ESSBASEPATH%\bin\esscmdq" %*

  11. Salvare il file. Eseguire il login come amministratore e verificare il login al Marketplace Essbase 26ai o alla distribuzione indipendente.

    Sintassi di login:

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

Nota

  • Non utilizzare un ID utente IDCS/MSAD per la connessione. Utilizzare un utente 'nativo' per eseguire il login.
  • Se si utilizza un server proxy, potrebbe essere necessario aggiungere le seguenti impostazioni agli script startEssmcd/q.bat:
    • set HTTP_PROXY=<proxyserver>:<porta>
    • set HTTPS_PROXY=<proxyserver>:<porta>

Configurazione lato server - Per eseguire l'impostazione direttamente sul server Essbase

  1. Convertire l'applicazione di memorizzazione di aggregazione copiata in modalità Unicode utilizzando MaxL Shell, come descritto di seguito.

  2. Modificare il valore ESSLANG all'interno del profilo di origine dalla codifica nativa a UTF-8, come descritto di seguito.

Convertire l'applicazione di memorizzazione di aggregazione copiata in modalità Unicode utilizzando MaxL Shell:

  1. Eseguire il login all'istanza Essbase 11g in locale di origine utilizzando MaxL Shell.

  2. Eseguire l'istruzione MaxL alter application <copied_app> set type unicode_mode per convertire l'applicazione in Unicode.

    Ad esempio: 
    MaxL> alter application SampleBck set type unicode_mode;
    Per ulteriori dettagli su MaxL, vedere Modifica applicazione (storage aggregato).

Nota

Tutte le operazioni seguenti devono essere eseguite sull'applicazione copiata e non sull'applicazione di origine.
Modificare il valore ESSLANG nel profilo di origine dalla codifica nativa a UTF-8.

  1. Scarica ESSCMDQ

    1. Scarica la versione "11.1.2.4.010+" di ESSCMDQ specifica della piattaforma da Scarica ESSCMDQ nell'istanza EPM 11g di origine.
    2. Estrarre i file direttamente nella stessa directory in cui è presente ESSCMD nell'installazione,

      Per Linux

      $ESSBASEPATH/bin
      Ad esempio: 
      ./Middleware/EPMSystem11R1/products/Essbase/EssbaseServer/bin/ESSCMDQ

      Per Windows

      %ESSBASEPATH%\bin
      Ad esempio: 
      .\Middleware\EPMSystem11R1\products\Essbase\EssbaseServer\bin\ESSCMDQ.exe

      Per conoscere i valori delle variabili di ambiente nell'installazione EPM 11g di origine, controllare il file di ambiente.

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

      Per impostazione predefinita, <epm_instance> è epmsystem1.

    3. Creare una copia dello script esistente

      Per Linux

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

      come

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

      Per Windows

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

      come

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

      In questo script appena creato, modificare la chiamata da ESSCMD a ESSCMDQ.

    4. Poco prima di quest'ultima riga (appena prima della chiamata a ESSCMDQ), aggiungere le seguenti righe:

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

      Per Windows

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

  2. Assicurarsi di aver interrotto l'applicazione copiata prima di convertire il profilo.

  3. Ora crea una cartella client in ARBORPATH.

  4. Copiare la cartella dell'applicazione dalla directory ARBORPATH/app nella directory client. Per l'app ASOBck, ad esempio:

    Per Linux

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

    Per Windows

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

  5. Eseguire i seguenti comandi in ESSCMDQ dopo aver avviato quanto segue.

    Nota

    ESSCMDQ è interattivo, quindi i parametri per ogni comando possono essere trovati in modalità interattiva. Per vedere cosa significa un parametro, immettere il comando, ad esempio OpenOtl, quindi premere Invio per visualizzare il menu che spiega il parametro. Oppure immettere il comando ESSCMDQ e premere Invio, senza alcun parametro, e viene visualizzato il menu dei parametri.

    Esempio per l'ambiente 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

    Esempio per l'ambiente 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

    Si noti che Locale deve essere il valore ESSLANG nativo utilizzato nell'ambiente Essbase 11g On-Premise di origine.

    Ad esempio (sintassi 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. Assicurarsi che non vengano visualizzati errori durante l'esecuzione dei comandi precedenti. Quindi, per ogni cubo, copiare di nuovo il file di struttura dalla directory client alla directory dell'applicazione.

    Ad esempio (sintassi 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. Avviare nuovamente ESSCMDQ utilizzando:

    Per Linux

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

    Per Windows

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

    ristrutturare ogni 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

    Ad esempio:

    
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