Preparati a eseguire la migrazione da Essbase 11g in locale

Se si dispone di un'applicazione e un cubo Essbase 11g in locale di cui eseguire la migrazione a Essbase 26ai, tenere presenti le considerazioni e le condizioni riportate di seguito.

Differenze tra Essbase 11g in locale ed Essbase 26ai

Flusso task per la migrazione

Nota

  • Se in Essbase 11g On-Premise è stato utilizzato EPM Shared Services per configurare un provider di sicurezza esterno, il passo 1 riportato di seguito non è obbligatorio. In base alla modalità di sicurezza scelta durante la configurazione, potrebbe essere necessario configurare l'istanza EPM di destinazione o WebLogic per utilizzare lo stesso provider di sicurezza esterno utilizzato in Essbase 11g On-Premise.

  • Se si utilizza Oracle Identity Cloud Service, configurarlo per utilizzare lo stesso provider di sicurezza esterno utilizzato in Essbase 11g On-Premise.

  1. Eseguire la migrazione di utenti e gruppi da Essbase 11g On-Premise EPM Shared Services a OCI Identity and Access Management (IAM) o Oracle Identity Cloud Service (IDCS) (per la distribuzione OCI) o EPM Shared Services / WebLogic LDAP (per le distribuzioni indipendenti). Fare riferimento alla sezione Eseguire la migrazione di utenti e gruppi Essbase 11g.

  2. Se si esportano applicazioni Essbase 11g in locale non Unicode, è necessario convertire le applicazioni in Unicode.

    1. Utilizzare Alter System sul server, quindi su una copia di backup dell'applicazione Essbase, prima di eseguire la utility di esportazione LCM 11g, per consentire a Essbase stesso di supportare l'applicazione Unicode.

    2. Per le applicazioni di memorizzazione non Unicode, bloccare, esportare l'applicazione utilizzando l'opzione -converttoutf8 nel comando export. Vedere Opzioni della utility di esportazione LCM 11g.

      Per le applicazioni di memorizzazione non Unicode, aggregare, seguire le istruzioni di conversione Unicode manuali in Converti applicazione di memorizzazione di aggregazione non Unicode in modalità Unicode.

  3. Migra applicazioni 11g:

    1. Esportare le applicazioni Essbase utilizzando la utility di esportazione LCM 11g, scaricata dall'istanza di destinazione Essbase 26ai, quindi eseguire la utility sul computer in cui è installato Essbase 11g in locale.

      Nota

      Per utilizzare la utility di esportazione LCM 11g, è necessario installare Java Development Kit (JDK) 8 o versione successiva e impostare le variabili seguenti: variabile di ambiente JAVA_HOME e variabili EPM_ORACLE_HOME ed EPM_ORACLE_INSTANCE nel terminale shell.

    2. Importare le applicazioni Essbase utilizzando la utility Interfaccia riga di comando Essbase (CLI), scaricata dall'istanza di Essbase 26ai. Eseguire la utility per ogni file zip esportato.

Versioni e percorsi Essbase supportati

Le seguenti release sono state testate per la migrazione: 11.1.2.3.0nn, 11.1.2.4.0nn, 12.2.1 e versioni successive.

Nota

La migrazione da 11.1.2.3 è supportata, tuttavia non è possibile eseguire la migrazione di tutte le applicazioni da 11.1.2.3 a 26ai. Si consiglia di eseguire l'aggiornamento da 11.1.2.3.0.n.n a 11.1.2.4.0.n.n prima di tentare la migrazione a 26ai.

I seguenti percorsi di migrazione non sono supportati:
  • Essbase 19c o 26ai in OCI (distribuzione Marketplace) in Essbase 26ai in Windows (distribuzione indipendente)
  • Essbase 26ai in Linux (distribuzione indipendente) in Essbase 26ai in Windows (distribuzione indipendente)

Artifact 11g migrati

Esaminare gli artifact 11g supportati per la migrazione. Vedere Artifact migrati.

Impostazioni di applicazione e database non supportate

Le seguenti impostazioni a livello di applicazione o di database non sono supportate nella migrazione: volumi disco.

NOTE DI CONFIGURAZIONE

  • Modalità ibrida

    Il processore di calcoli e query predefinito è la modalità ibrida. La modalità ibrida consente ai cubi della memorizzazione a blocchi di disporre di membri sparsi dinamici e di livello superiore nonché di query e calcoli completamente dinamici. È possibile eseguire query sui dati immediatamente dopo averli aggiornati, senza ricorrere a calcoli batch. In modalità ibrida non vi è alcun impatto sui cubi se si sceglie di non applicare il calcolo dinamica ai membri sparsi di livello superiore. Nota: la modalità ibrida non è quella predefinita se si utilizzano script di calcolo: se gli script di calcolo contengono molte dipendenze sparse, considerare l'opportunità di abilitare anche la modalità ibrida per gli script di calcolo.

  • Condivisione implicita

    Se si utilizza l'impostazione di configurazione IMPLIED_SHARE nell'applicazione Essbase 11g in locale, viene eseguita la migrazione dell'impostazione di condivisione implicita per ridurre al minimo l'interruzione. Per ulteriori dettagli sui valori predefiniti di condivisione implicita in Essbase 26ai, vedere l'argomento di configurazione IMPLIED_SHARE_ON_CREATE.

  • Avvertenza relativa all'impostazione di UPPERCASECONNECTION esssql.cfg

    Se nell'ambiente in uso è presente un file esssql.cfg contenente l'impostazione UPPERCASECONNECTION non più supportata, è possibile che venga visualizzato un avviso simile al seguente durante l'esecuzione delle operazioni di caricamento dei dati:

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

    Il modo per risolvere questo problema è rimuovere manualmente l'impostazione UPPERCASECONNECTION da esssql.cfg, che si trova in 

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

    quindi riavviare i server Essbase.

  • Misure testo e data
    A partire da Essbase 21.3 e versioni successive, la configurazione ALLOWOUTOFRANGELOAD non è più valida e il funzionamento sarà lo stesso di "ALLOWOUTOFRANGELOAD TRUE" nelle versioni precedenti. I valori non compresi nell'intervallo e i valori mancanti delle misure digitate verranno caricati e esportati nei cubi con misure testuali. Nell'esempio seguente del file di esportazione dati, <OutOfRange_Name> è "Non valido" e "NoColor" per i valori mancanti.
    "Color1" "Color2"
"Shoes" "Massachusetts" "Q1" "#Txt:NoColor" "#Txt:Yellow"
"Q2" "#Txt:Green"
"Connecticut" "Q1" "#Txt:Green" "#Txt:Invalid"
    Per informazioni sul caricamento di valori fuori intervallo, vedere Caricamento, cancellazione ed esportazione di misure di testo e data.

  • Impostazioni configurazione

    Alcuni valori di configurazione predefiniti sono diversi da quelli presenti in Essbase 11g in locale. Controllare il riferimento configurazione.

    Le impostazioni INDEXCACHESIZE e DATACACHESIZE ora controllano le dimensioni della cache per tutti i cubi di Essbase (ad eccezione dei cubi di memorizzazione di aggregazione). In precedenza queste impostazioni interessavano solo i cubi appena creati o migrati.

    Per modificare i valori predefiniti per le impostazioni di configurazione a livello di applicazione, utilizzare l'interfaccia Web Essbase.

    Oracle consiglia di gestire la maggior parte delle configurazioni a livello di applicazione. Quando si esegue la migrazione delle applicazioni, la configurazione a livello di applicazione viene conservata durante i processi di esportazione e importazione LCM. Tuttavia, alcune configurazioni sono applicabili solo al server Essbase. La maggior parte delle configurazioni server specificate durante la configurazione di Essbase durante la distribuzione, ma è anche possibile cambiare i valori predefiniti di configurazione del server utilizzando essbase.cfg, se necessario.

NOTE GENERALI

  • Tipi di dati indicatore orario SQL importati

    I tipi di dati di indicatore orario SQL precedentemente visualizzati in formato ODBC [yyyy-mm-dd hh:mm:ss] ora sono visualizzati in un formato diverso [dd-MON-yy hh.mm.ss.mmm a] nell'editor di regole dell'interfaccia Web diEssbase e in tutti gli altri punti in cui i tipi di dati di indicatore orario vengono importati. Per caricare l'indicatore orario nel formato desiderato durante i caricamenti di dati o le creazioni delle dimensioni, è possibile convertire gli indicatori orario nel formato stringa scelto utilizzando una funzione di conversione SQL nella sezione della query della regola di caricamento. Nell'esempio di query SQL seguente viene utilizzata la funzione format: SELECT introdate, format(introdate, 'yyyy-MM-dd hh:mm:ss') FROM tbc.dbo.product

  • Aggiornamento delle applicazioni EPM - Calcoli e filtri

    Dopo aver aggiornato le applicazioni a Essbase 26ai, non è possibile eseguire il provisioning dei membri ai calcoli o ai filtri dalla console di EPM Shared Services. Per assegnare i membri, è necessario utilizzare l'interfaccia Web Essbase. Vedere: Assegnazione dei filtri e Accesso ai calcoli.

  • Partizioni

    Durante l'esecuzione di un'operazione di importazione LCM, importare le applicazioni di origine prima delle applicazioni di destinazione. Se le applicazioni di origine non vengono importate prima delle applicazioni di destinazione, la definizione della partizione non funzionerà e sarà necessario ricrearla dopo aver importato le applicazioni di origine.

    Dopo aver eseguito il rollback di un OPatch, potrebbe essere necessario ricreare partizioni trasparenti e replicate e riconvalidare le partizioni.

  • Opzioni di creazione delle applicazioni diverse da LCM

    Oltre a utilizzare la utility LCM per eseguire la migrazione delle applicazioni esportate, è possibile creare le applicazioni anche nei modi riportati di seguito.

    • Importa utilizzando le cartelle di lavoro dell'applicazione Excel
    • Usare l'estensione Cube Designer in Smart View
    • Istruzione MaxL create application

  • Alias di posizione

    LCM non supporta la migrazione delle credenziali alias posizione. Dopo aver eseguito la migrazione delle applicazioni da Essbase 11g in locale, è necessario sostituire gli alias di posizione. È possibile utilizzare il seguente metodo automatico o un metodo manuale utilizzando MaxL.

    Metodo automatizzato per sostituire gli alias di posizione

    1. Decomprimere il file zip esportato LCM.
    2. Andare agli alias {ApplicationName}\Databases{dbName}\Location.
    3. Aprire il file in questa directory. File in formato XML in cui il campo userName e password sono vuoti. È possibile fornire le credenziali.
    4. Zip di nuovo la directory.
    5. Importare l'applicazione utilizzando la directory zip.

      File xml di esempio

      <?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>

    Metodo manuale che utilizza MaxL per sostituire gli alias posizione

    Un metodo manuale di opzione alternativa utilizza MaxL. Dopo aver importato le applicazioni di origine eseguendo il job LCMImport CLI, ricreare gli alias posizione utilizzando Crea alias posizione.

  • Funzioni e macro personalizzate

    PER DEPLOYMENTS INDIPENDENTI - Se si dispone di un file .jar personalizzato utilizzato per funzioni di calcolo e macro personalizzate, la migrazione non viene eseguita dalla utility di esportazione LCM 11g. È necessario spostarli manualmente. A tale scopo,

    1. Prendere nota della posizione di <Essbase Path> e <Application directory> (ARBORPATH) in Essbase 26ai. Se necessario, fare riferimento a Posizioni degli ambienti nella piattaforma Essbase.

    2. Eseguire la migrazione delle funzioni globali (a livello di sistema) copiando i file .jar da <Essbase Path>/java/udf nell'istanza di origine in <Essbase Path>/java/udf nell'istanza di Essbase di destinazione.

    3. Eseguire la migrazione delle funzioni locali (a livello di applicazione) copiando i file .jar dalla directory dell'applicazione nell'istanza di origine alla directory dell'applicazione nell'istanza di Essbase di destinazione. In altre parole, copiare i file .jar da <ARBORPATH>/app/<app_name> sul server 11g in <Application directory>/app/<app_name> sul server 26ai.

    4. Nell'istanza di destinazione di Essbase, aggiungere JVMMODULELOCATION a essbase.cfg, fornendo come argomento il percorso della libreria JVM nel sistema.

  • URL servizio client

    FOR INDEPENDENT DEPLOYMENTS - In Essbase 11g, Provider Services è il provider origine dati di livello intermedio per Oracle Essbase per i client Java API, Smart View e XML FOR Analysis (XMLA).

    La funzionalità Provider Services è integrata con WebLogic. Aggiornare gli URL client al formato corrente.

    Client URL precedente per la connessione di Provider Services al client specifico Nuovo URL in 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 per analisi (XMLA) http://server_name:port/aps/XMLA http://server_name:port/essbase/xmla

  • Ordine risoluzione struttura e misure tipizzate abilitate

    FOR OCI MARKETPLACE DEPLOYMENTS - Dopo aver eseguito la migrazione di un'applicazione Essbase dal server Essbase 11g On Premises a Essbase distribuito su OCI tramite Marketplace, è necessario abilitare le misure digitate nel profilo prima di poter modificare l'ordine di risoluzione del profilo.

    In Essbase distribuito su OCI, la proprietà di profilo Misure con tipo abilitato è impostata su FALSE per impostazione predefinita. Per modificare l'ordine di soluzione, la proprietà Misure digitate abilitate deve prima essere modificata in TRUE. Per modificare questa proprietà, vedere Informazioni sulle misure digitate nel manuale Database Administrator's Guide for Oracle Essbase.