Configurare Essbase in Windows

È necessario configurare Essbase in Windows utilizzando lo strumento di configurazione dopo l'installazione.

Prerequisiti e note

  • Fusion Middleware deve essere già installato e Oracle Essbase deve essere installato nella stessa directory Oracle home. Vedere Installa Fusion Middleware.
  • È necessario installare il database relazionale supportato, come indicato nei prerequisiti di installazione. Vedere Installa un database relazionale.
  • Se si utilizza l'autenticazione EPM Shared Services, è necessario disporre già di una versione supportata di EPM, con gli utenti EPM Shared Services creati e configurati e conoscere i dettagli dell'istanza di Oracle Home ed EPM.
    • Se si utilizza l'autenticazione EPM Shared Services, questa deve essere eseguita durante la configurazione di Essbase. Se EPM Shared Services non è in esecuzione, alcuni numeri di porta devono essere configurati manualmente per evitare conflitti di porta. Quando si configura Essbase, è necessario prestare attenzione e conoscere le porte già utilizzate da qualsiasi servizio EPM su questo host e scegliere e utilizzare solo porte valide non utilizzate da un servizio o da un'applicazione su questo host. È inoltre necessario impostare questi numeri di porta inutilizzati di conseguenza nell'interfaccia utente o nel file di risposta.
  • Se si utilizza Microsoft SQL Server (MSSQL) come database per gli schemi di repository Essbase (RCU), è necessario eseguire il processo per modificare il database e applicare le considerazioni corrette relative al collate e allo schema di indirizzi, prima di eseguire lo strumento di configurazione Essbase. Per ulteriori informazioni, vedere Configurare Microsoft SQL Server come database repository per gli schemi Essbase.
  • Schemi RCU di precreazione per Essbase spiega il processo se si sceglie di creare in anticipo gli schemi RCU prima della configurazione, anziché fare in modo che lo strumento di configurazione li crei automaticamente. Un caso d'uso per la creazione preliminare degli schemi è se si utilizza una connessione HTTPS sicura utilizzando un wallet.
  • In Windows, aprire il Pannello di controllo > Orologio e area geografica > Area, quindi selezionare La scheda Amministrazione. Fare clic su Cambia impostazioni nazionali sistema e selezionare una casella di controllo Beta: utilizzare Unicode UTF-8 per il supporto delle lingue a livello mondiale.
  • Essbase in Windows non può avere più configurazioni o istanze sullo stesso host.

  • È necessario applicare le patch riportate di seguito nella Oracle home prima di creare gli schemi RCU, indipendentemente dal fatto che si utilizzino o meno gli schemi creati in precedenza. Per verificare le versioni di patch appropriate, controllare le patch più recenti nella sezione Note di rilascio di Essbase per Distribuzione indipendente oppure contattare l'assistenza.

    • 28186730 - ultima versione di OPatch 13.9.4.2.x per FMW/WLS
    • 31676526 - patch 12.2.1.4.0 per l'avvertenza TNS_ADMIN RCU
    • 30540494 - patch 12.2.1.4.0 per il bug della utility RCU RAC
    • 30754186 - patch 12.2.1.4.0 per il bug RCU RAC
  • Tutte le porte non devono essere comprese nell'intervallo di porte effimere, né devono essere utilizzate da altri software in esecuzione. Vedere Evitare conflitti tra porte.
  • Ogni server gestito deve essere assegnato a un computer, ovvero la rappresentazione logica del computer che ospita una o più istanze di server. Il nome del computer deve essere univoco rispetto ad altre risorse configurabili nel dominio.
  • Se si prevede di installare e configurare più istanze Essbase in locale, per supportare il failover è necessario un load balancer front-end e le istanze devono essere configurate su host diversi. Come indicato, Essbase in Windows non può avere più configurazioni o istanze sullo stesso host. Vedere Configura un load balancer per supportare il failover.
  • Se il servizio Essbase deve essere configurato o disponibile come servizio Windows Essbase, per avviare e arrestare il servizio Essbase, PowerShell deve trovarsi nella variabile PATH dell'ambiente. È inoltre necessario abilitare il servizio Windows di Essbase durante la configurazione per installare il servizio Windows.
  • Se ci si connette tramite Smart View, utilizzando l'URL /aps/SmartView, è necessario modificare l'URL. Fare riferimento alla sezione Reindirizza a nuovo URL connessione Smart View Essbase. In alternativa, è possibile configurare il reindirizzamento al nuovo URL sul server Web. Se si utilizza Oracle HTTP Server (OHS) o HTTPD Server, reindirizzare l'URL durante la modifica della configurazione di Oracle HTTP Server, come indicato nel punto precedente.
  • Per accedere al file di risposta e utilizzarlo, è necessario impostare le variabili di ambiente TEMP e TMP per l'utente, come indicato di seguito.
    1. Sulla barra delle applicazioni di Windows, fare clic con il pulsante destro del mouse sull'icona di Windows e selezionare Sistema.
    2. Nella pagina Impostazioni, nell'intestazione Impostazioni correlate a destra, fare clic su Informazioni sui sistemi, quindi su Impostazioni di sistema avanzate.
    3. Selezionare Variabili di ambiente.
    4. Fare clic su Nuovo per creare nuove variabili di ambiente TEMP e TMP oppure fare clic su Modifica per modificare le variabili di ambiente esistenti TEMP e TMP, con i valori delle variabili utente. È possibile utilizzare lo stesso valore per entrambi.
    5. Dopo aver impostato, aprire un nuovo cmd o un nuovo prompt dei comandi per riflettere il nuovo set di variabili.

Esegui strumento di configurazione

  1. Se non si continua con la configurazione alla fine dell'installazione, avviare lo strumento di configurazione.
    1. Nella directory della Oracle home, in cui sono installati Essbase e Fusion Middleware, aprire un terminale in \essbase\bin. Ad esempio, aprire un terminale in <Oracle_Home>\essbase\bin.
    2. Avviare lo strumento di configurazione utilizzando lo script del comando config.cmd.
      config.cmd
      Lo script può essere eseguito con parametri quali -mode, -log, -log Priority, -responseFile. Se si utilizza il parametro responseFile, tutti i campi vengono compilati con le voci di configurazione precedenti, ad eccezione delle password. Per ulteriori informazioni sulle opzioni degli script di configurazione, eseguire: config.cmd -help.
  2. Nella pagina di benvenuto, fare clic su Avanti.
  3. Nella pagina Dettagli dominio, effettuare le operazioni riportate di seguito.
    1. Accettare l'impostazione predefinita (se corretta) o immettere il nome del dominio, ad esempio essbase_domain.
    2. Accettare l'impostazione predefinita (se corretta) o immettere il percorso radice del dominio, ad esempio:
      C:\Oracle_home\dist\domains
    3. Accettare l'impostazione predefinita o immettere la directory dell'applicazione, ad esempio
      C:\Oracle_home\dist\applications\essbase
      Si consiglia di separare la directory delle applicazioni dai file di configurazione.
    4. Immettere il nome e la password di un account amministratore WebLogic che verrà utilizzato per la gestione dei server Essbase e middleware.
      • Se si utilizza WebLogic Embedded LDAP, a questo amministratore viene assegnato anche un ruolo di amministratore del servizio Essbase.
      • Se si utilizza EPM Shared Services, questo amministratore è solo per l'istanza WebLogic del dominio Essbase. All'utente amministratore di EPM Shared Services verrà assegnato il ruolo utente di Essbase: Amministratore servizi.
    5. Fare clic su Avanti.
  4. Nella pagina Connessione al database, effettuare le operazioni riportate di seguito.
    1. Accettare l'impostazione predefinita o immettere il tipo di database. Si tratta del database relazionale supportato, ad esempio Oracle Database.
    2. Immettere la stringa di connessione, ad esempio
      myhost.example.com:1521/orcl
      Vedere Formati stringa di connessione.
    3. Scegliere se creare nuovi schemi ora oppure utilizzare gli schemi creati in precedenza utilizzando la utility RCU Fusion Middleware in Schemi RCU pre-creati per Essbase, come task del workflow di pre-configurazione. Se si utilizza Microsoft SQL Server (MSSQL) nella configurazione, vedere i prerequisiti correlati riportati sopra.
    4. Immettere un prefisso di schema, ad esempio ESS26AI. Deve essere una nuova stringa univoca contenente da 1 a 12 caratteri alfanumerici e iniziare con una lettera.
    5. Immettere una password di schema che verrà condivisa per tutti i nuovi schemi.
    6. Per il nome utente e la password dell'amministratore, immettere le credenziali di qualsiasi utente a cui è stato concesso un ruolo sysdba per Oracle Database. Può essere l'utente di sistema predefinito o l'amministratore del database Microsoft. Il nome utente deve iniziare con una lettera e contenere da 5 a 128 caratteri alfanumerici. La parola d'ordine deve iniziare con una lettera, avere un numero compreso tra 8 e 30 caratteri, contenere almeno un numero e, facoltativamente, il numero qualsiasi di caratteri speciali ($ # _).
    7. Fare clic su Avanti.
  5. Nella pagina Configurazione di Node Manager, effettuare le operazioni riportate di seguito.
    1. Accettare le impostazioni predefinite o immettere la stringa per il nome del computer Node Manager, che gestisce i cluster. Tutte le porte non devono essere comprese nell'intervallo di porte effimere, né devono essere utilizzate da altri software in esecuzione. Vedere Avoid Port Conflicts.
    2. Per Indirizzo di ascolto Node Manager, è possibile immettere o selezionare il nome host completamente qualificato (dove WebLogic viene installato insieme all'installazione di Fusion Middleware). Può anche essere un indirizzo del sistema operativo. Per riferimento, vedere Configura indirizzi di ascolto.
    3. Fare clic su Avanti.
  6. Nella pagina Configurazione porte server WebLogic, eseguire la configurazione in base alle scelte effettuate durante l'installazione.
    Accettare i valori predefiniti o immettere i valori. I valori nella schermata precedente sono solo esempi. Specificare porte chiare e sicure per ciascun server. Vedere Opzioni di configurazione del server. Tutte le porte non devono essere comprese nell'intervallo di porte effimere, né devono essere utilizzate da altri software in esecuzione. Vedere Evitare conflitti tra porte.
    1. Per proteggere le connessioni mediante TLS Everywhere (Transport Layer Security), selezionare la casella di controllo Secure Connection Mode; il certificato autofirmato viene quindi riconosciuto. In caso contrario, esaminare questo argomento: Informazioni sulla protezione delle comunicazioni e della rete. Se la sicurezza TLS viene distribuita, la porta predefinita è la porta Managed Server Secure. Il valore predefinito della porta è 9000 per le porte non protette e 9001 per le porte protette. Si consiglia di utilizzare la protezione (9001).

      Se si configura Essbase per l'utilizzo di un database relazionale non Oracle come database del repository RCU, potrebbe essere necessario eseguire ulteriori operazioni, al termine della distribuzione di Essbase, per configurare i driver ODBC del sistema in modo da supportare la cifratura sicura/TLS. Consultare le istruzioni di configurazione del driver di database.

    2. [Facoltativo] Per limitare l'accesso a host specifici (per ambienti multihome), specificare o selezionare un dominio, ad esempio localhost, nei campi dell'indirizzo di ascolto. Se non si selezionano o immettono i valori degli indirizzi di ascolto, gli indirizzi di ascolto vengono applicati a tutte le interfacce e a tutti gli indirizzi e tutti gli host mappati sono accessibili.
    3. Fare clic su Avanti.
  7. Nella pagina Configurazione porte Essbase, effettuare le operazioni riportate di seguito.
    1. Accettare i valori predefiniti o immettere i valori per la porta agente, la porta sicura agente (utilizzata per la comunicazione sicura mediante TLS) e le porte minime e massime per i server applicazioni Essbase.
      • Porta agente specifica la porta per l'agente Essbase. L'impostazione predefinita è 1423.
      • La porta sicura dell'agente specifica la porta utilizzata dall'agente Essbase per la comunicazione sicura quando è attiva la modalità di connessione sicura con TLS (Transport Layer Security). L'impostazione predefinita è 6423.
      • Quando vengono installate più istanze del server Essbase su un unico host, è necessario specificare un numero della porta univoco per ogni istanza.
      • Tutte le porte non devono essere comprese nell'intervallo di porte effimere, né devono essere utilizzate da un altro software in esecuzione. Vedere Evitare conflitti tra porte.
      • L'intervallo tra le porte Min e Max deve essere almeno 1000, a seconda della quantità utilizzata.
    2. Fare clic su Avanti.
  8. Nella pagina di configurazione del provider di identità, effettuare le operazioni riportate di seguito.
    1. Se non lo si è già fatto, vedere l'argomento Seleziona provider di autenticazione.
    2. WebLogic è l'impostazione predefinita. Se si utilizza EPM Shared Services e si desidera continuare, selezionare la casella di controllo Abilita provider di identità EPM Shared Services. L'esempio di finestra mostra il provider EPM selezionato. Quando questa opzione è abilitata, i campi EPM sono disponibili per confermare o specificare le posizioni Oracle home EPM e istanza Oracle. Per informazioni dettagliate su questi argomenti, vedere Informazioni sulla home Middleware, sulla Oracle home EPM e sull'istanza EPM Oracle.
    3. Per configurare o rendere disponibile il servizio Windows Essbase, per avviare e arrestare il servizio Essbase, PowerShell deve trovarsi nella variabile di ambiente PATH. È inoltre necessario abilitare il servizio Windows di Essbase durante la configurazione per installare il servizio Windows. Per utilizzare questa funzione, è necessario selezionare Abilita servizio Windows Essbase in questa pagina per installare il servizio Windows. L'avvio e l'arresto del servizio Windows di Essbase vengono eseguiti utilizzando Windows SCM.
    4. Fare clic su Avanti.
  9. Esaminare la pagina Riepilogo configurazione. Prendere nota della posizione del file di log (se visualizzata) e del file di risposta. Questo esempio di finestra può variare a seconda delle voci o dei valori selezionati. È possibile utilizzare il file response (.rsp) per salvare le scelte di configurazione e compilare gli stessi valori di campo (escluse le password) in una futura configurazione basata su interfaccia utente o in modalità Silent. Se si desidera eseguire una configurazione futura utilizzando un file .rsp, è anche possibile eseguire la configurazione fino alla pagina di riepilogo, quindi fare clic su Annulla anziché su Configura e riutilizzare il file di risposta in un secondo momento. Il file .rsp viene salvato nella posizione temporanea elencata nel riepilogo come posizione del file di risposta. Se si prevede di utilizzarla per automatizzare una configurazione futura, assicurarsi di salvarla in un luogo più permanente, poiché la pulizia delle directory tmp potrebbe essere eseguita regolarmente. Vedere File e parametri di risposta di esempio.
  10. Fare clic su Configura. Nella pagina Avanzamento configurazione, vicino alla fine dell'elaborazione dello strumento di configurazione, vengono avviati i componenti della piattaforma Essbase. Quando l'avanzamento raggiunge il 100%, fare clic su Successivo.
  11. Nella pagina Configurazione completata, esaminare i dettagli e fare clic su Fine. Si noti che questo esempio di finestra non riflette necessariamente le voci o i valori selezionati. È ora possibile eseguire il login a Essbase. Per gli URL di login, vedere URL client Essbase, REST e Smart View.

    Nota

    Se Essbase è stato configurato in modo sicuro con un database esterno che utilizza un alias TNS_ADMIN, ad esempio adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS, è necessario eseguire le operazioni riportate di seguito per consentire l'elaborazione della connessione da parte del server Essbase.

    1. icona Modifica: 
      <DOMAIN_HOME>\bin\setStartupEnv.cmd
    2. Aggiungere la riga seguente allo script di avvio, prima dell'utilizzo di -DODBC_URL=: 
      set TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS
    3. Modificare la riga seguente: 
      -DODBC_URL='OCI;SERVICE=adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS'

      to

      -DODBC_URL='OCI;SERVICE='adwsql_low'
Le opzioni e i task avanzati e successivi alla configurazione possono essere esaminati in Argomenti sulla configurazione avanzata. Sono inclusi argomenti sull'eliminazione degli schemi RCU, sulla configurazione di Essbase e del server HTTP Oracle e altro ancora.