Arresta, avvia e controlla server

I componenti della piattaforma Essbase vengono eseguiti come server gestiti in un server applicazioni WebLogic. Avviare tutti i file utilizzando start.sh o start.cmd in esstools. Arrestare tutti utilizzando stop.sh o stop.cmd. È inoltre possibile elencare lo stato e avviare o arrestare singoli componenti del server.

In Linux è possibile avviare Essbase utilizzando lo script di avvio start.sh. Utilizzare status.sh per controllare lo stato del server e arrestare qualsiasi componente utilizzando stop.sh.

In Windows è possibile avviare Essbase utilizzando lo script di avvio start.cmd. Utilizzare status.cmd per controllare lo stato del server e arrestare qualsiasi componente utilizzando stop.cmd.

Gli script sopra descritti si trovano nella directory di configurazione del dominio, sotto esstools/bin.
  • Per Linux:
    <Domain_Home>/esstools/bin
  • Per Windows: 
    <Domain_Home>\esstools\bin

Controlla lo stato del server gestito

Eseguire lo stato per visualizzare i server gestiti in esecuzione nella piattaforma Essbase:

  • Per Linux:
    <Domain_Home>/esstools/bin/status.sh
    In questo esempio, AdminServer e Server Essbase vengono visualizzati nello script come in esecuzione:
    [/scratch/user/oracle_home/user_projects/domains/essbase_domain/esstools/bin]$ ./status.sh
Domain status; Using domainHome:
/scratch/user/oracle_home/user_projects/domains/essbase_domain ...
Initializing WebLogic Scripting Tool (WLST) ...
Welcome to WebLogic Server Administration Scripting Shell
Type help() for help on available commands
Reading domain...
/Servers/AdminServer/ListenPort=7001
Accessing admin server using URL t3://myhost:7001
Server Name       Server Status   Type       Essbase Status  Machine                  
 ...........       .............   ....       .............   ...........              
 AdminServer       RUNNING         Server     --              myhost.example.com    
 essbase_server1   RUNNING         Server     Active          myhost.example.com

    Se lo stato non riesce con un errore, ad esempio se la connessione a Node Manager è stata rifiutata, analizzare il log per individuare la causa dell'errore.

  • Per Windows:
    <Domain_Home>\esstools\bin\status.cmd

    Nota

    È inoltre possibile controllare lo stato di Windows Services. In Gestione attività di Windows > Servizi è possibile visualizzare i servizi di Windows in esecuzione in background.

Avvio di tutti i server

Eseguire l'avvio, senza argomenti, per avviare Node Manager, tutti i server gestiti e AdminServer, nella piattaforma Essbase:

  • Per Linux:
    <Domain_Home>/esstools/bin/start.sh
  • Per Windows:
    <Domain_Home>\esstools\bin\start.cmd

L'avvio avvia sempre Node Manager WebLogic. Se allo script di avvio non è specificato alcun argomento, come nell'esempio precedente, Node Manager avvia AdminServer e AdminServer avvia i server gestiti, incluso il server Essbase.

In alternativa, l'avvio può essere utilizzato per avviare un determinato server, se viene fornito un argomento del nome del server: 
start.sh -i <server name>
Se allo script di avvio viene specificato un nome di server, Node Manager avvia solo il server specificato. Ad esempio, per avviare solo il server Essbase,
  • Per Linux:
    ./start.sh -i essbase_server1
  • Per Windows:
    .\start.cmd -i essbase_server1

Prima dell'arresto dei server: preparare l'arresto

Quando è necessario arrestare i servizi Essbase, considerare l'impatto sugli utenti attivi. Sono disponibili comandi di abilitazione/disabilitazione che consentono di impedire nuove connessioni ed è possibile scrivere script utilizzando tempi di attesa per garantire che le operazioni utente esistenti abbiano il tempo di terminare. Se alcune operazioni sono in esecuzione per troppo tempo, è possibile terminare le sessioni e le singole operazioni. Una volta che tutti gli utenti sono spenti dal sistema, è possibile procedere all'arresto dei servizi.

Se è necessario arrestare le sessioni utente attive, è possibile utilizzare il workflow riportato di seguito.
  1. Nelle impostazioni dell'applicazione disabilitare le connessioni e i comandi (in MaxL, Alter Application disable connect|commands)
  2. Nelle impostazioni del database disabilitare l'avvio (in MaxL, Modifica database disabilita l'avvio)
  3. A livello di server Essbase, eseguire il logout di tutti gli utenti dal sistema e terminare tutte le richieste attive (in MaxL, Sessione di logout Alter System e richiesta di kill)
  4. Per ogni cubo, verificare che tutte le sessioni e le richieste siano terminate (in MaxL, Visualizza sessione)
  5. Arrestare tutte le applicazioni (in MaxL, Alter System unload application)

Arresta tutti i server

Eseguire lo script stop (Linux) o il comando (Windows) senza alcun argomento per arrestare Node Manager, AdminServer e tutti i server gestiti nella piattaforma Essbase:

  • Per Linux:
    <Domain_Home>/esstools/bin/stop.sh
  • Per Windows:
    <Domain_Home>\esstools\bin\stop.cmd

Se viene specificato un nome di server per lo script stop (Linux) o il comando (Windows), Node Manager arresta il server specificato. Ad esempio:

./stop.sh -i essbase_server1

Avvia server gestito secondario quando AdminServer non è disponibile

Quando Essbase è configurato per l'alta disponibilità, nel nodo secondario (o di failover aggiuntivo), se è necessario avviare il server gestito WebLogic quando il nodo primario diventa non disponibile, attenersi alle istruzioni riportate di seguito. Fornire il nome del server gestito del nodo secondario e l'URL del server di amministrazione, anche se il server di amministrazione non è disponibile. Quando richiesto, fornire anche le credenziali di amministratore di WebLogic.

  1. SSH al nodo secondario Essbase (host 2).

  2. Passare a <Domain Home>/bin.

  3. Eseguire lo script per avviare il server gestito WebLogic utilizzando la sintassi seguente. È necessario fornire il nome host AdminServer e la porta AdminServer, anche se AdminServer non è disponibile. 

    startManagedWebLogic.sh <failover-managed-server-name> t3(s)://<AdminServer-Host>:<AdminServer-Port>

    Esempio di Linux con TLS/SSL:

    ./startManagedWebLogic.sh essbase_server2 t3s://adminserver:7002

    Esempio Linux senza TLS/SSL:

    ./startManagedWebLogic.sh essbase_server2 t3://adminserver:7001

    Esempio di Windows con TLS/SSL:

    .\startManagedWebLogic.cmd essbase_server2 t3s://adminserver:7002

    Esempio di Windows senza TLS/SSL:

    .\startManagedWebLogic.cmd essbase_server2 t3://adminserver:7001

Arresta server gestito secondario quando AdminServer non è disponibile

Quando Essbase è configurato per l'alta disponibilità, sul nodo secondario (o su qualsiasi altro failover aggiuntivo), è possibile arrestare il server gestito WebLogic in modo indipendente, nel caso in cui il nodo primario e AdminServer non siano più disponibili.

  1. SSH al nodo secondario Essbase (host 2).

  2. Passare a <ORACLE_HOME>/oracle_common/common/bin.

  3. Eseguire lo strumento WebLogic Scripting Tool.

    Esempio per l'ambiente Linux:

    ./oracle_common/common/bin/wlst.sh

    Esempio per Windows

    .\wlst.cmd

  4. Al prompt wls:/offline>, eseguire la connessione utilizzando la sintassi seguente. È necessario fornire le credenziali dell'amministratore WebLogic e il nome host e la porta secondari (di failover). 

    connect('<weblogic-admin-user>','<weblogic-admin-user-password>','t3(s)://<failover-managedServer-host>:<failover-managedServer-port>')

    Esempio con TLS/SSL:

    connect('WLadminusername','WLadminpassword','t3s://essbase_server.example.com:9001')

    Esempio senza TLS/SSL:

    connect('WLadminusername','WLadminpassword','t3://essbase_server.example.com:9000')

  5. Arrestare l'host secondario (failover).

    Esempio:

    shutdown('essbase_server2','Server','true',1000, force='true', block='true')

  6. Disconnettersi dal server di amministrazione.

    Esempio:

    disconnect()

  7. Uscire dallo strumento di script WebLogic.

    Esempio:

    exit()

Solo per Windows - Avvia e arresta il servizio Essbase

È possibile utilizzare Windows SCM per avviare o arrestare il servizio Essbase. A tale scopo, aprire Windows SCM > selezionare il servizio Essbase > selezionare e avviare o arrestare il servizio in Windows SCM.

Solo per distribuzioni indipendenti (in locale): rotazione dei log del server Essbase

Per le distribuzioni indipendenti (in locale), la rotazione del log di essbase_server1.out non è supportata ed è necessario eseguire manualmente un backup del file di log quando i server vengono arrestati. Il file si trova in <DOMAIN_HOME>/<DOMAIN_NAME>/servers/essbase_server1/logs/.

Il backup salva le versioni precedenti del log e dovrebbe essere eseguito man mano che la dimensione del file di log corrente diventa molto grande.