Arrêter, démarrer et vérifier les serveurs

Les composants de la plate-forme Essbase sont exécutés en tant que serveurs gérés sur un serveur d'applications WebLogic. Démarrez-les toutes à l'aide de start.sh ou start.cmd dans esstools. Arrêtez-les tous à l'aide de stop.sh ou stop.cmd. Vous pouvez également répertorier le statut et démarrer ou arrêter des composants de serveur individuels.

Sous Linux, vous pouvez démarrer Essbase à l'aide du script de démarrage start.sh. Utilisez status.sh pour vérifier le statut du serveur et arrêter tous les composants à l'aide de stop.sh.

Sous Windows, vous pouvez démarrer Essbase à l'aide du script de démarrage start.cmd. Utilisez status.cmd pour vérifier le statut du serveur et arrêter tous les composants à l'aide de stop.cmd.

Les scripts décrits ci-dessus se trouvent dans le répertoire de configuration de votre domaine, sous esstools/bin.
  • Pour Linux :
    <Domain_Home>/esstools/bin
  • Pour Windows : 
    <Domain_Home>\esstools\bin

Vérifier l'état du serveur géré

Exécutez le statut pour connaître les serveurs gérés en cours d'exécution sur la plate-forme Essbase :

  • Pour Linux :
    <Domain_Home>/esstools/bin/status.sh
    Dans cet exemple, AdminServer et Essbase Server sont affichés dans le script comme étant en cours d'exécution :
    [/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

    Si le statut échoue avec une erreur, par exemple si la connexion au gestionnaire de noeuds a été refusée, analysez le journal pour déterminer la cause de l'erreur.

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

    Remarques :

    Vous pouvez également vérifier l'état des services Windows. Dans le Gestionnaire des tâches Windows > Services, vous pouvez afficher les services Windows exécutés en arrière-plan.

Lancer tous les serveurs

Exécutez le démarrage, sans argument, pour démarrer le gestionnaire de noeuds, tous les serveurs gérés et AdminServer, sur la plate-forme Essbase :

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

Le démarrage démarre toujours le gestionnaire de noeuds WebLogic. Si aucun argument n'est spécifié pour le script de démarrage, comme dans l'exemple ci-dessus, le gestionnaire de noeuds démarre AdminServer et AdminServer démarre les serveurs gérés, y compris le serveur Essbase.

Le démarrage peut également être utilisé pour démarrer un serveur particulier, si un argument de nom de serveur est fourni : 
start.sh -i <server name>
Si un nom de serveur est spécifié pour le script de démarrage, le gestionnaire de noeuds démarre le serveur spécifié uniquement. Par exemple, pour démarrer uniquement le serveur Essbase,
  • Pour Linux :
    ./start.sh -i essbase_server1
  • Pour Windows :
    .\start.cmd -i essbase_server1

Avant d'arrêter les serveurs : préparation à l'arrêt

Lorsque vous devez arrêter les services Essbase, tenez compte de l'impact sur les utilisateurs actifs. Les commandes Activer/Désactiver permettent d'empêcher de nouvelles connexions et vous pouvez écrire des scripts en utilisant des temps d'attente pour vous assurer que les opérations utilisateur existantes ont du temps à terminer. Si certaines opérations sont exécutées trop longtemps, vous pouvez mettre fin aux sessions et aux opérations individuelles. Une fois que tous les utilisateurs sont hors du système, vous pouvez arrêter les services.

Si vous devez arrêter des sessions utilisateur actives, vous pouvez utiliser le workflow suivant :
  1. Dans les paramètres de l'application, désactivez les connexions et les commandes (dans MaxL, Alter Application disable connect|commands)
  2. Dans les paramètres de la base de données, désactivez le démarrage (dans MaxL, Alter Database désactiver le démarrage)
  3. Au niveau du serveur Essbase, déconnectez tous les utilisateurs du système et mettez fin à toutes les demandes actives (dans MaxL, Alter System logout session et kill request)
  4. Pour chaque cube, vérifiez que toutes les sessions et demandes sont interrompues (dans MaxL, Afficher la session)
  5. Arrêtez toutes les applications (dans MaxL, Alter System unload application)

Arrêter tous les serveurs

Exécutez le script d'arrêt (Linux) ou la commande (Windows), sans aucun argument, pour arrêter le gestionnaire de noeuds, AdminServer et tous les serveurs gérés de la plate-forme Essbase :

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

Si un nom de serveur est spécifié dans le script d'arrêt (Linux) ou la commande (Windows), le gestionnaire de noeuds arrête le serveur spécifié. Exemple :

./stop.sh -i essbase_server1

Démarrer le serveur géré secondaire lorsque AdminServer n'est pas disponible

Lorsque Essbase est configuré pour la haute disponibilité, sur le noeud secondaire (ou tout autre basculement), si vous devez démarrer le serveur géré WebLogic lorsque le noeud principal devient indisponible, suivez ces instructions. Indiquez le nom du serveur géré du noeud secondaire et l'URL du serveur d'administration, même si le serveur d'administration n'est pas disponible. Lorsque vous y êtes invité, fournissez également les informations d'identification de l'administrateur WebLogic.

  1. Connectez-vous via SSH au noeud secondaire Essbase (hôte 2).

  2. Accédez à <Domain Home>/bin.

  3. Exécutez le script pour démarrer le serveur géré WebLogic à l'aide de la syntaxe suivante. Vous devez indiquer le nom d'hôte du serveur d'administration et le port du serveur d'administration, même si ce dernier n'est pas disponible. 

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

    Exemple Linux avec TLS/SSL :

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

    Exemple Linux sans TLS/SSL :

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

    Exemple Windows avec TLS/SSL :

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

    Exemple Windows sans TLS/SSL :

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

Arrêter le serveur géré secondaire lorsque AdminServer n'est pas disponible

Lorsque Essbase est configuré pour la haute disponibilité, sur le noeud secondaire (ou tout autre basculement), vous pouvez arrêter le serveur géré WebLogic indépendamment, au cas où le noeud principal et AdminServer deviendraient indisponibles.

  1. Connectez-vous via SSH au noeud secondaire Essbase (hôte 2).

  2. Accédez à <ORACLE_HOME>/oracle_common/common/bin.

  3. Exécutez l'outil de script WebLogic.

    Exemple Linux:

    ./oracle_common/common/bin/wlst.sh

    Exemple Windows :

    .\wlst.cmd

  4. A l'invite wls:/offline>, connectez-vous en utilisant la syntaxe suivante. Vous devez fournir les informations d'identification et de connexion de l'administrateur WebLogic, ainsi que le nom d'hôte et le port secondaires (de basculement). 

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

    Exemple avec TLS/SSL :

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

    Exemple sans TLS/SSL :

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

  5. Arrêtez l'hôte secondaire (basculement).

    Par exemple :

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

  6. Déconnectez-vous du serveur AdminServer.

    Par exemple :

    disconnect()

  7. Quittez l'outil de script WebLogic.

    Par exemple :

    exit()

Pour Windows uniquement - Démarrer et arrêter le service Essbase

Windows SCM peut être utilisé pour démarrer ou arrêter le service Essbase. Pour ce faire, ouvrez Windows SCM > sélectionnez le service Essbase > sélectionnez et démarrez ou arrêtez le service sous Windows SCM.

Pour les déploiements indépendants (sur site) uniquement - rotation des journaux du serveur Essbase

Pour les déploiements indépendants (sur site), la rotation des journaux de essbase_server1.out n'est pas prise en charge et vous devez effectuer manuellement une sauvegarde du fichier journal lorsque les serveurs sont arrêtés. Le fichier se trouve dans <DOMAIN_HOME>/<DOMAIN_NAME>/servers/essbase_server1/logs/.

La sauvegarde enregistre les anciennes versions du journal et doit être effectuée car la taille actuelle du fichier journal devient très importante.