サーバーの停止、起動および確認

Essbaseプラットフォーム・コンポーネントは、WebLogicアプリケーション・サーバー上の管理対象サーバーとして実行されます。これらはすべて、esstoolsstart.shまたはstart.cmdを使用して起動します。stop.shまたはstop.cmdを使用してすべてを停止します。ステータスを一覧表示したり、個々のサーバー・コンポーネントを起動または停止したりすることもできます。

Linuxの場合、Essbaseは起動スクリプトstart.shを使用して起動できます。ステータスを確認するにはstatus.shを使用し、コンポーネントを停止するにはstop.shを使用します。

Windowsの場合、Essbaseは起動コマンドstart.cmdを使用して起動できます。ステータスを確認するにはstatus.cmdを使用します。また、コンポーネントを停止するにはstop.cmdを使用します。

これらは、対象ドメインの構成ディレクトリ(esstools/binの下)にあります。
  • Linuxの場合:
    <Domain_Home>/esstools/bin
  • Windowsの場合:
    <Domain_Home>\esstools\bin

管理対象サーバーのステータスの確認

statusを実行して、Essbaseプラットフォームで実行中の管理対象サーバーを確認します。

  • Linuxの場合:
    <Domain_Home>/esstools/bin/status.sh
    この例では、AdminServerとEssbaseサーバーが実行中であるとスクリプトに表示されています。
    [/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 
     eas_server1       --              Server     --              --                         
    

    statusがエラーで失敗した場合は(ノード・マネージャへの接続が拒否された場合など)、エラーの原因についてログを分析する必要があります。

  • Windowsの場合:
    <Domain_Home>\esstools\bin\status.cmd

    ノート:

    Windowsマシンでは、Windows Servicesのステータスも確認できます。「Windows タスク マネージャー」→「サービス」では、バックグラウンドで実行中のWindowsサービスを表示できます。

すべてのサーバーの起動

引数なしで起動スクリプト(コマンド)を実行して、Essbaseプラットフォームでノード・マネージャ、すべての管理対象サーバーおよびAdminServerを起動します。

  • Linuxの場合:
    <Domain_Home>/esstools/bin/start.sh
  • Windowsの場合:
    <Domain_Home>\esstools\bin\start.cmd

起動スクリプト(コマンド)では、WebLogicノード・マネージャが常に起動されます。前述の例のように引数の指定なしで起動スクリプトを実行すると、ノード・マネージャによってAdminServerが起動され、AdminServerによってEssbaseサーバーを含む管理対象サーバー(および該当する場合はEASサーバー)が起動されます。

また、起動スクリプト(コマンド)にサーバー名の引数を指定すると、特定のサーバーを起動することもできます。
start.sh -i <server name>
起動スクリプトにサーバー名を指定した場合は、指定したサーバーのみがノード・マネージャによって起動されます。たとえば、Essbaseサーバーのみを起動する場合は、次のように指定します
  • Linuxの場合:
    ./start.sh -i essbase_server1
  • Windowsの場合:
    .\start.cmd -i essbase_server1

サーバーの停止前: 停止の準備

Essbaseサービスを停止する必要がある場合、アクティブ・ユーザーへの影響を検討します。コマンドの有効化/無効化を使用して新規の接続を防ぐことができ、待機時間を使用してスクリプトを作成することにより、既存のユーザー操作が終了するまでの時間を確保できます。一部の操作の実行時間が長すぎる場合、セッションおよび個別の操作を終了できます。すべてのユーザーがシステムから接続解除されたら、サービスの停止を続行できます。

アクティブなユーザー・セッションを停止する必要がある場合は、次のワークフローを使用できます。
  1. アプリケーション設定で、接続およびコマンドを無効化します(MaxLのAlter Application disable connects|commands)。
  2. データベース設定で、起動を無効にします(MaxLのAlter Database disable startup)。
  3. Essbaseサーバー・レベルで、すべてのユーザーをシステムからログアウトし、すべてのアクティブ・リクエストを終了します(MaxLのAlter System logout sessionおよびkill request)。
  4. 各キューブで、すべてのセッションおよびリクエストが終了していることを確認します(MaxLのDisplay Session)。
  5. すべてのアプリケーションをシャットダウンします(MaxLのAlter System unload application)。

すべてのサーバーの停止

停止スクリプト(Linux)またはコマンド(Windows)を引数なしで実行して、Essbaseプラットフォームのノード・マネージャ、AdminServerおよびすべての管理対象サーバーを停止します。

  • Linuxの場合:
    <Domain_Home>/esstools/bin/stop.sh
  • Windowsの場合:
    <Domain_Home>\esstools\bin\stop.cmd

停止スクリプト(Linux)またはコマンド(Windows)にサーバー名を指定すると、指定したサーバーがノード・マネージャによって停止されます。たとえば、EASサーバーがインストールされていて、すぐに実行する必要がない場合は、次のスクリプトを使用できます。

./stop.sh -i eas_server1

AdminServerが使用できない場合のセカンダリ管理対象サーバーの起動

Essbaseが高可用性用に構成されている場合、セカンダリ(または追加のフェイルオーバー)ノードで、プライマリ・ノードが使用できなくなったときにWebLogic管理対象サーバーを起動する必要がある場合は、次の手順に従います。AdminServerが使用できない場合でも、セカンダリ・ノードの管理対象サーバー名とAdminServer URLを指定します。プロンプトが表示されたら、WebLogic管理者資格情報も指定します。

  1. Essbaseセカンダリ・ノード(ホスト2)にSSH接続します。

  2. <Domain Home>/binに移動します。

  3. 次の構文を使用して、スクリプトを実行してWebLogic管理対象サーバーを起動します。AdminServerを使用できない場合でも、AdminServerホスト名とAdminServerポートを指定する必要があります。

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

    TLS/SSLを使用したLinuxの例:

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

    TLS/SSLを使用しないLinuxの例:

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

    TLS/SSLを使用したWindowsの例:

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

    TLS/SSLを使用しないWindowsの例:

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

AdminServerが使用できない場合のセカンダリ管理対象サーバーの停止

Essbaseが高可用性用に構成されている場合、セカンダリ(または追加のフェイルオーバー)ノードで、プライマリ・ノードとAdminServerが使用できなくなった場合に備えて、WebLogic管理対象サーバーを個別に停止できます。

  1. Essbaseセカンダリ・ノード(ホスト2)にSSH接続します。

  2. <ORACLE_HOME>/oracle_common/common/binに移動します。

  3. WebLogic Scripting Toolを実行します。

    Linuxの例:

    ./oracle_common/common/bin/wlst.sh

    Windowsの例:

    .\wlst.cmd
  4. wls:/offline>プロンプトで、次の構文を使用して接続します。WebLogic管理者資格証明、およびセカンダリ(フェイルオーバー)ホスト名とポートを指定する必要があります。

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

    TLS/SSLを使用した例:

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

    TLS/SSLを使用しない例:

    connect('WLadminusername','WLadminpassword','t3://essbase_server.example.com:9000')
  5. セカンダリ(フェイルオーバー)ホストを停止します。

    例:

    shutdown('essbase_server2','Server','true',1000, force='true', block='true')
  6. AdminServerへの接続を切断します。

    例:

    disconnect()
  7. WebLogic Scripting Toolを終了します。

    例:

    exit()

Windowsの場合のみ - Essbaseサービスの開始と停止

Windows SCMを使用すると、Essbaseサービスを開始または停止できます。そのためには、Windows SCMを開いて、Essbaseサービスを選択して、Windows SCMでサービスの開始または停止を選択します。

独立(オンプレミス)デプロイメントの場合のみ - Essbaseサーバー・ログのローテーション

独立(オンプレミス)デプロイメントの場合、essbase_server1.outのログ・ローテーションはサポートされておらず、サーバーが停止されたときに、ログ・ファイルを手動でバックアップする必要があります。ファイルは<DOMAIN_HOME>/<DOMAIN_NAME>/servers/essbase_server1/logs/にあります。

バックアップによって古いバージョンのログが保存されます。現在のログ・ファイルはサイズが非常に大きくなるため、バックアップを実行する必要があります。