Always-On Monitoring構成アシスタント(EMSCA)の使用方法

Always-On Monitoring構成アシスタントemscaは、Always-On Monitoringインストール・スクリプト・ディレクトリ下にあるスクリプトです。emscaの実行には、bashシェルのインストールが必要です。

データベース管理者の資格証明がある場合、その資格証明をemscaスクリプトに渡すと、Always-On Monitoringユーザーが自動的に作成されます。

データベース管理者の資格証明がない場合は、次のようにする必要があります。

  1. データベース管理者にスクリプトの実行を依頼します。「Always-On Monitoringリポジトリ・ユーザーの作成」を参照してください。

  2. emsca -createEmsDbUser=falseを実行します。

次の使用シナリオの例は、環境変数AOM_HOMEを使用して参照される場所にAlways-On Monitoringがインストールされていることを前提としています。$AOM_HOME/scriptsにある構成アシスタントを実行します。EMSCAはパラメータなしで起動でき、必要な情報を求めるプロンプトを表示します。構成が完了したら、後からEnterprise Managerの構成に使用するために、Always-On MonitoringアップロードURLを記録します。

EMSCAインストール・シナリオの例

Always-On MonitoringをインストールするユーザーはSYSDBAの資格証明を持っています。

Copyright (c) 2017, 2020 Oracle Corporation.  All rights reserved.
---------------------------------------------------------------
Always-On Monitoring Repository Connection String : myserver.myco.com:25059:s307480
 Always-On Monitoring Repository Username [ems] :   
 Always-On Monitoring Repository Password [ems] : 
 
User "ems" cannot be found in the database.
In order to create this user, SYSDBA credentials are required. If you do not want to continue, answer "n" to the question below.
Create the Always-On Monitoring Repository user [y] : 
 Always-On Monitoring Repository SYSDBA Username : sys
 Always-On Monitoring Repository SYSDBA Password : 
 
 Enterprise Manager Repository Connection String : myserver.myco.com:25059:s307480
 Enterprise Manager Repository Username : sysman
 Enterprise Manager Repository Password : 
 
Creating Always-On Monitoring repository user ems
 Agent Registration Password : 
 
 Keystore for host myserver.myco.com created successfully.
 Connecting to Always-On Monitoring Repository.
 Creating Always-On Monitoring Repository schema
 Creating repository storage for Targets data.
 Creating repository storage for Alerts and Availability data.
 Creating repository storage for Notification Metadata data.
 Creating repository storage for Target Metric Metadata data.
 Registering Always-On Monitoring instance
 Always-On Monitoring Upload URL: https://myserver.myco.com:8081/upload

Always-On MonitoringをインストールするユーザーはSYSDBAの資格証明を持っていません。

例1: 次の例に示すように、SYSDBAがAlways-On Monitoringユーザーを作成し、ユーザー権限を付与します。

aomuserは、データベース内のAlways-On Monitoringユーザーの名前です。

次のスクリプトを実行するには、SYSDBA権限が必要です。

create user aomuser identified by <password>;
grant CREATE JOB, 
         CREATE SESSION, 
         ALTER SESSION, 
         CREATE DATABASE LINK, 
         CREATE MATERIALIZED VIEW,
         CREATE PROCEDURE, 
         CREATE PUBLIC SYNONYM, 
         CREATE ROLE, 
         CREATE SEQUENCE, 
         CREATE SYNONYM,
         CREATE TABLE, 
         CREATE TRIGGER, 
         CREATE TYPE, 
         CREATE VIEW, 
         UNLIMITED TABLESPACE, 
         SELECT ANY DICTIONARY to aomuser;
 
grant EXECUTE ON SYS.DBMS_CRYPTO to aomuser;
grant EXECUTE ON SYS.DBMS_AQADM to aomuser;
grant EXECUTE ON SYS.DBMS_AQ to aomuser;
grant EXECUTE ON SYS.DBMS_AQIN to aomuser;
grant EXECUTE ON SYS.DBMS_SCHEDULER to aomuser;
grant EXECUTE ON SYS.DBMS_LOCK to aomuser;

例2: Always-On MonitoringユーザーがEMSCAスクリプトを起動します。

Oracle Enterprise Manager Cloud Control 13c Release 4
Copyright (c) 2017, 2020 Oracle Corporation.  All rights reserved.
---------------------------------------------------------------
 Always-On Monitoring Repository Connection String : myserver.myco.com:25059:s307480
 Always-On Monitoring Repository Username [ems] : aomuser
 Always-On Monitoring Repository Password [ems] : 
 
Always-On Monitoring Repository user "aomuser" has already been created
 Enterprise Manager Repository Connection String : myserver.myco.com:25059:s307480
 Enterprise Manager Repository Username : sysman
 Enterprise Manager Repository Password : 
 
 Agent Registration Password : 
 
 Keystore for host myserver.myco.com created successfully.
 Connecting to Always-On Monitoring Repository.
 Creating Always-On Monitoring Repository schema
 Creating repository storage for Targets data.
 Creating repository storage for Alerts and Availability data.
 Creating repository storage for Notification Metadata data.
 Creating repository storage for Target Metric Metadata data.
 Registering Always-On Monitoring instance
 Always-On Monitoring Upload URL: https://myserver.myco.com:8081/upload

SYSDBAがロールを作成してAlways-On Monitoringユーザーに割り当てた後、emscaが実行されます。

サイトによっては、ロールを作成し、そのロールをAlways-On Monitoringユーザーに割り当てる方が好ましい場合があります。このような状況では、次の例に示すスクリプトを実行する必要があります。

例1: SYSDBAがロールを作成してAlways-On Monitoringユーザーに割り当てます。
create user <aom_user> identified by <aom_password>;
create role ems_role;
grant CREATE SESSION, 
         ALTER SESSION, 
         CREATE DATABASE LINK, 
         CREATE MATERIALIZED VIEW, 
         CREATE PROCEDURE, 
         CREATE PUBLIC SYNONYM, 
         CREATE ROLE, 
         CREATE SEQUENCE, 
         CREATE SYNONYM, 
         CREATE TABLE, 
         CREATE TRIGGER, 
         CREATE TYPE, 
         CREATE VIEW, 
         SELECT ANY DICTIONARY to ems_role;
grant ems_role to <aom_user>;
例2: SYSDBAが次の権限をAlways-On Monitoringユーザーに直接付与します。
grant CREATE JOB, 
         UNLIMITED TABLESPACE to <aom_user>;
 
grant EXECUTE ON SYS.DBMS_CRYPTO to <aom_user>;
grant EXECUTE ON SYS.DBMS_AQADM to <aom_user>;
grant EXECUTE ON SYS.DBMS_AQ to <aom_user>;
grant EXECUTE ON SYS.DBMS_AQIN to <aom_user>;
grant EXECUTE ON SYS.DBMS_SCHEDULER to <aom_user>;
grant EXECUTE ON SYS.DBMS_LOCK to <aom_user>;
例3: Always-On Monitoringユーザーがemscaスクリプトを起動します。
Oracle Enterprise Manager Cloud Control 13c Release 4
Copyright (c) 2017, 2020 Oracle Corporation.  All rights reserved.
---------------------------------------------------------------
 Always-On Monitoring Repository Connection String : myserver.myco.com:25059:s307480
 Always-On Monitoring Repository Username [ems] : 
 Always-On Monitoring Repository Password [ems] : 
 
Always-On Monitoring Repository user "ems" has already been created
 Enterprise Manager Repository Connection String : myserver.myco.com:25059:s307480
 Enterprise Manager Repository Username : sysman
 Enterprise Manager Repository Password : 
 
 Agent Registration Password : 
 
 Keystore for host myserver.myco.com created successfully.
 Connecting to Always-On Monitoring Repository.
 Creating Always-On Monitoring Repository schema
 Creating repository storage for Targets data.
 Creating repository storage for Alerts and Availability data.
 Creating repository storage for Notification Metadata data.
 Creating repository storage for Target Metric Metadata data.
 Registering Always-On Monitoring instance
 Always-On Monitoring Upload URL: https://myserver.myco.com:8081/upload

レスポンス・ファイルによるEMSCAの実行

-responseFileオプションを使用すると、レスポンス入力ファイルを使用してパラメータをスクリプトに指定することもできます。たとえば
$ emsca -responseFile=<response_filename>
response_filenameは、次のスクリプト・パラメータが指定されているレスポンス・ファイルです。
emsRepConnectString=localhost:1521:xe
emsRepUsername=ems
emsRepPassword=ems
emRepConnectString=mymachine.mycompany.com:15044:semgc3
emRepUsername=sysman
emRepPassword=sysman
#
emsPort=8081
http.protocol=http
#

次の表に使用可能なEMSCAパラメータを示します。

表17-3 EMSCAのパラメータ

EMSCAプロンプト 説明

Always-On Monitoringリポジトリ接続文字列

Always-On Monitoringリポジトリの検索に使用される接続文字列。有効なサービス記述子またはhost:port:sidの場合があります。

Always-On Monitoringリポジトリ・ユーザー名

Always-On Monitoringリポジトリに関連付けられたユーザー名。詳細は、「Always-On Monitoringリポジトリ・ユーザーの作成」を参照してください。

Always-On Monitoringリポジトリ・パスワード

Always-On Monitoringリポジトリ・ユーザーに関連付けられたパスワード。詳細は、「Always-On Monitoringリポジトリ・ユーザーの作成」を参照してください。

Enterprise Managerリポジトリ接続文字列

Enterprise Managerリポジトリの検索に使用される接続文字列。有効なサービス記述子またはhost:port:sidの場合があります。

Enterprise Managerリポジトリ・ユーザー名

Enterprise Manager SYSMANユーザーのユーザー名。

Enterprise Managerリポジトリ・パスワード

Enterprise Manager SYSMANユーザーのパスワード。