MySQL Enterprise ユーザ – MySQL Enterprise Web サイトにログインするときに使用する証明書です。これらは、アドバイザファイルの取得と更新、プロダクトキーの取得（必要な場合）に必要です。

MySQL ユーザ – Service Agents が MySQL サーバのステータスを報告するには、このサーバの権限が必要です。エージェントがすべての機能を実行するには、SHOW DATABASES 権限、REPLICATION CLIENT 権限、SUPER 権限、CREATE 権限、SELECT 権限が必要です。つまり、Service Agent には、すべてのデータへの読み取りアクセス権が必要です。このアカウントの詳細については、項2.4.1. 「Service Agent の MySQL ユーザアカウントの作成」を参照してください。

リポジトリユーザ – このユーザは、バンドルの MySQL サーバの mysql データベースにある user テーブルの唯一のユーザです。監視対象の MySQL サーバとの競合を回避するため、本書では、このサーバを repository と記述しています。リポジトリユーザは、インストール中に指定されたパスワードを使用して localhost からログインでき、すべてのデータベースのすべての権限を持ちます。これらの証明書は、リポジトリおよびそのテーブルを作成し、これにデータを記録するときに使用されます。インストール中、このロールのユーザ名のデフォルト値は service_manager です。デフォルトのパスワードは指定されていません。これらの証明書を使用すると、コマンドラインからリポジトリを管理したり、MySQL Administrator などのプログラムを使用することができます。

インストール中、configuration_report.txt ファイルが作成されます。リポジトリマネージャの証明書については、このファイルを参照してください。MySQL Enterprise Service Manager がインストールされたら、次のディレクトリでこのファイルを参照してください。

Root ユーザ – このユーザは、ダッシュボードの管理者です。ダッシュボードに初めてログインする場合、このユーザとしてログインする必要があります。このユーザのデフォルトのユーザ名は admin です。このユーザのデフォルトのパスワードはありません。

Agent ユーザ – Service Agent は、監視している MySQL サーバのステータスを報告しなければなりません。このため、ダッシュボードにログインする必要があります。このユーザのデフォルトのユーザ名は agent です。このユーザのデフォルトのパスワードはありません。

Service Manager のすべてのインストールでは、同じ基本セットのパラメータを使用して Tomcat および MySQL アプリケーションがインストールされます。インストールプロセスで提供されるデフォルトは、すでにインストールされている製品と干渉しないよう、一意になるように設計されています。ただし、問題が発生しないように、インストール前にこれらのパラメータを確認してください。

共通パラメータは、Tomcat サーバに適用されるものと、MySQL サーバ（リポジトリ設定）に適用されるものに分けられます。

インストール中に設定する情報は、常に、Service Manager のインストールディレクトリ内にある configuration_report.txt ファイル内に記録されます。

Windows の場合、使用できるインストールモードは win32 および unattended のみです。unattended モードは、特に、複数のインストールを実行する場合に便利です。詳細については、項2.7. 「無人インストール」を参照してください。

Service Manager を Windows にインストールするには、mysqlmonitor-version-windows-installer.exe（version は 3 つのパートから構成されるバージョン番号）という名前の実行可能ファイルを使用します。

MySQL Enterprise Monitor サービスを Windows で起動する方法については、項2.2.5. 「MySQL Enterprise Monitor サービスの起動/停止: Windows」を参照してください。

Mac OS X では、osx、text、unattended の 3 種類のインストールモードを使用できます。詳細については、項2.7. 「無人インストール」を参照してください。Mac OS X の text モードインストールは、UNIX の text インストールと同じです。text モードインストールについては、項2.2.4. 「Service Manager のインストール: UNIX」を参照してください。

MySQL Enterprise Service Manager を Mac OS X にインストールするには、Java がインストールされている必要があります。バージョンは1.5.0_7以上である必要があります。このバージョンがマシンにインストールされていない場合、Apple からダウンロードできます。また、このバージョンの Java では、バージョン 10.4.5 以上の Mac OS X が必要であるため、インストールのためにオペレーティングシステムのアップグレードが必要な場合もあります。

後方互換性のため、Mac OS X には通常、複数のバージョンの Java がインストールされます。osx モードでインストールする場合、バージョン 1.5.0_7 がデフォルトのバージョンになります。インストール中、通常は問題にならないため、Java 1.5.0_7 はそれ自体をデフォルトとして設定します。

デフォルトを変更した場合はリセットするか、MySQL Enterprise Service Manager を text モードでインストールして、環境変数を設定して正しいバージョンの Java を指定できます。text モードでインストールするには、mysqlmonitor-version-osx-installer.app ディレクトリのすぐ下にある Contents/MacOS ディレクトリで installbuilder ファイルを探してください。MySQL Enterprise Service Manager を text モードでインストールすることは、上記の説明のようにいくつかの違いはありますが、項2.2.4. 「Service Manager のインストール: UNIX」 の手順とほぼ同じです。

GUI（osx）インストールを使用してインストールするには、次の手順を行います。

これで、インストールが完了します。続けて MySQL Enterprise Service Manager の設定を行うには、項2.3. 「MySQL Enterprise Service Manager 構成の設定とアドバイザのインストール」を参照してください。

Service Manager をインストールするには、mysqlmonitor-version-installer.bin（version はバージョン番号、OS、アーキテクチャを示します）という名前のファイルを探します。次のコマンドを入力して、このファイルが実行可能であることを確認します。

shell> chmod +x mysqlmonitor-version-installer.bin

デフォルトディレクトリ（/opt/mysql/enterprise/monitor）にインストールするには、root としてログインする必要があります。権限のないユーザがインストールを行うと、/home/user_name/mysql/enterprise/monitor/ というディレクトリにインストールすることになります。.

次に、コマンドラインからインストールする方法について説明します。Windows Manager 内からインストーラを実行することで、Service Manager をグラフィカルにインストールできます。いずれの場合も手順は同じです。また、Service Manager を unattended モードでインストールすることもできます。これは特に、複数のインストールを実行する場合に便利です。詳細については、項2.7. 「無人インストール」を参照してください。

text モードインストールを実行する場合、Enterprise Dashboard は自動的には起動しません。MySQL Enterprise Service Manager の起動および停止の詳細については、項2.2.6. 「MySQL Enterprise Monitor サービスの起動/停止: UNIX および Mac OS X」を参照してください。

インストール時に MySQL Enterprise Service Manager を起動できます。次のサービスがインストールされます。

Microsoft 管理コンソールサービスウィンドウからサービスを停止または起動できます。「MySQL Enterprise Tomcat」および「MySQL Enterprise MySQL」エントリを探します。

サービスを起動または停止するには、そのサービスを右クリックして、ポップアップメニューのオプションから選択します。

サービスを起動および停止するメニューエントリもあります。「Program」、「MySQL」、「MySQL Enterprise Monitor」、「Services」エントリにナビゲートして、サービスを停止または起動します。

サービスは、コマンドラインから停止または起動することもできます。Tomcat サービスを起動するには、次のコマンドを入力します。

shell> sc start MySQLEnterpriseTomcat 

または

shell> net start MySQLEnterpriseTomcat 

このサービスを停止するには、次のコマンドを入力します。

shell> sc stop MySQLEnterpriseTomcat

または

shell> net stop MySQLEnterpriseTomcat

同様に、MySQL サーバをコマンドラインから停止または起動できます。サービス名は MySQLEnterpriseMySQL です。

また、mysqlmonitorctl.bat ファイルを使用して、特定のサービスまたは両方のサービスを起動、停止、再起動することもできます。このファイルを実行するには、コマンドラインに移動して、C:\Program Files\MySQL\Enterprise\Monitor ディレクトリにナビゲートします。mysqlmonitorctl.bat help を入力すると、次の出力が表示されます。

usage: mysqlmonitorctl.bat help
       mysqlmonitorctl.bat (start|stop|restart|install|uninstall)
       mysqlmonitorctl.bat (start|stop|restart) tomcat
       mysqlmonitorctl.bat (start|stop|restart) mysql

help       - this screen
start      - start the service(s)
stop       - stop the service(s)
restart    - restart or start the service(s)
install    - install the service(s)
uninstall  - uninstall the service(s)

特定のサービスを停止するには、ステータス変更引数のほかに、引数 tomcat または mysql を渡します。両方のサービスのステータスを変更する場合、サービス名は指定しません。このバッチファイルを使用して、サービスをアンインストールすることもできます。

ダッシュボードの設定は、Service Manager のインストール直後に始まります。Windows インストールを設定するには、次のセクションをスキップして項2.3. 「MySQL Enterprise Service Manager 構成の設定とアドバイザのインストール」に進んでください。

MySQL Enterprise Service Manager には次のサービスが含まれます。

MySQL Enterprise Service Manager を停止、起動、再起動する必要がある場合、/opt/mysql/enterprise/monitor/ ディレクトリ（UNIX）または /Applications/mysql/enterprise/monitor/ ディレクトリ（Mac OS X）にある mysqlmonitorctl.sh ファイルを呼び出します。使用できるすべてのオプションを参照するには、該当するディレクトリにナビゲートして、次のコマンドを入力します。

shell> /opt/mysql/enterprise/monitor/mysqlmonitorctl.sh help

このスクリプトを実行すると、次の出力が表示されます。

usage: ./mysqlmonitorctl.sh help
./mysqlmonitorctl.sh (start|stop|status|restart)
./mysqlmonitorctl.sh (start|stop|status|restart) mysql
./mysqlmonitorctl.sh (start|stop|status|restart) tomcat

help       - this screen
start      - start the service(s)
stop       - stop  the service(s)
restart    - restart or start the service(s)
status     - report the status of the service

このスクリプトを実行すると、すべての Service Manager コンポーネントを停止、起動、再起動できます。実行するには、スタートアップスクリプトから mysqlmonitorctl.sh start を呼び出します。

サービスを実行するには、次のようにします。

shell> ./mysqlmonitorctl.sh start
./mysqlmonitorctl.sh : mysql  started
nohup: redirecting stderr to stdout
Starting mysqld daemon with databases from /opt/mysql/enterprise/monitor/mysql/data/
Using CATALINA_BASE:   /opt/mysql/enterprise/monitor/apache-tomcat
Using CATALINA_HOME:   /opt/mysql/enterprise/monitor/apache-tomcat
Using CATALINA_TMPDIR: /opt/mysql/enterprise/monitor/apache-tomcat/temp
Using JRE_HOME:       /opt/mysql/enterprise/monitor/java

すでに実行しているサービスを起動しようとすると、サービスがすでに実行していることが警告されます。

shell> ./mysqlmonitorctl.sh start
./mysqlmonitorctl.sh : mysql  (pid 18403) already running
./mysqlmonitorctl.sh : tomcat  (pid 18480) already running

サービスを停止するには、次のようにします。

shell>

restart コマンドは、stop と start 操作を続けて実行する効果があります。

このスクリプトを使用して、Tomcat Web サーバまたは MySQL リポジトリのステータスをチェックできます。

shell> ./mysqlmonitorctl.sh status
MySQL Network MySQL is running
MySQL Network Tomcat is running

ダッシュボードの設定は、MySQL Enterprise Service Manager のインストール直後に始まります。

初めてダッシュボードにログインしようとすると、次のような画面が表示されます。

図 2.10. ダッシュボードの初期ログイン

この画面を使用して、次のタスクを実行します。

MySQL Enterprise Product Key およびアドバイザファイルが提供されている場合、「Browse」ボタンをクリックして、これらのファイルを探します。アドバイザファイルの名前は AdvisorScript-version.jar、プロダクトキーは Subscription-level_date.xml です。ダッシュボードから Internet にアクセスできない場合、アドバイザをこのようにインストールする必要があります。この時点でアドバイザをインストールすることをお勧めしますが、後でインストールすることもできます。インストールについては、項2.3.3. 「最初のログイン後のアドバイザのインストール」を参照してください。提供するプロダクトキーが無効な場合、通知が表示され、アドバイザはインポートできません。

ダッシュボードから Internet にアクセスできる場合、MySQL Enterprise 証明書を提供して、MySQL Enterprise Monitor をアクティブにします。MySQL Enterprise Login として電子メールを入力して、MySQL Enterprise パスワードを入力し確認します。指定した証明書が不正な場合、「Unable to connect to verify credentials.」というエラーメッセージが表示されます。

この画面の「Create Administrator」セクションで、ダッシュボード管理者の証明書を入力します。入力すると、項2.1.3. 「最初のログインで作成されるユーザ」 で説明した root user が作成されます。これらの証明書は今後のログインで必要になるので、ユーザ名とパスワードは書き留めておいてください。

この画面の「Configure Agent Credentials」セクションで、エージェントの証明書を入力します。これは、項2.1.3. 「最初のログインで作成されるユーザ」で説明した agent user です。これを報告するには、エージェントはログインする必要があります。エージェントの証明書は書き留めておいてください。この情報は、エージェントのインストール時に必要です。

すべての設定を完了したら、「complete setup」ボタンをクリックします。正常にログインすると、インポートされたグラフとアドバイザの数を示すメッセージが表示されます。この数は、サブスクリプションレベルにより変わります。

アドバイザファイルのインポートが失敗すると、次のメッセージが表示されます。

Unable to import Advisor Jar. You may download the jar 
manually from the Enterprise Portal and import it from the 'Check For Updates' page.

この場合、項2.3.3. 「最初のログイン後のアドバイザのインストール」で説明されているように、アドバイザファイルを Enterprise Web サイトからダウンロードして、インストールできます。

ダッシュボードを初めて起動すると、タイムゾーンとロケールを設定するよう要求されます。ドロップダウンリストボックスから該当する値を選択します。タイムゾーンを設定すると、MySQL Enterprise Advisor からの通知の時間表示が正確になります。

タイムゾーンおよびロケールを指定すると、ダッシュボードにより「Monitor」ページが開きます。「Monitor」画面の詳細については、MySQL Enterprise Dashboardを参照してください。

アドバイザは、Service Agent により送信されるデータを解釈し、その結果をダッシュボードに表示します。アドバイザの最小セットは、Service Manager とともに事前にインストールされます。アドバイザの完全なセットを取得し、MySQL Enterprise Monitor を最大限利用するには、アドバイザを MySQL Enterprise からダウンロードする必要があります。

MySQL Enterprise Dashboard に最初にログインした後にアドバイザをインストールしていない場合、ダッシュボードを開いて、「Advisors」タブを表示します。「Check for Updates」リンクを選択します。これにより、MySQL Enterprise Web サイトから最新バージョンのアドバイザがダウンロードされます。このようにしてアドバイザをインストールするには、MySQL Enterprise 証明書を指定する必要があります。この手順については、Global Settingsを参照してください。

ダッシュボードから Internet にアクセスできない場合、アドバイザをロケールファイルからインストールする必要があります。これを実行するには、AdvisorScript-version.jar という名前のアドバイザファイルが必要です。このファイルがない場合、MySQL Enterprise ダウンロードページからダウンロードできます。アドバイザファイルは、ダッシュボードからアクセスできる場所にダウンロードします。「Browse」ボタンを使用しアドバイザファイルを探して、「import」を選択してアドバイザをロードします。

アドバイザのアップグレードプロセスは、初期インストールと同じです。アドバイザは、「Check for Updates」ページの「update」ボタンを選択して更新されます。ダッシュボードから Internet にアクセスできない場合、項2.3.3. 「最初のログイン後のアドバイザのインストール」で説明したように、アドバイザをロケールファイルからインポートできます。

電子メールを介したアラート通知は、MySQL Enterprise Monitor アドバイザソリューションの重要なコンポーネントです。このため、少なくとも一件の受信者の SMTP アカウントをすぐに設定できます。

すぐに設定するには、「Settings」タブを選択し、適切なリンクをクリックして「Global Settings」画面に進みます。この画面で、電子メール設定を構成できます。これらの設定は、現在ログインしているユーザに適用されます。

このページの左側には「Outgoing Email Settings」があります。

図 2.11. 送信電子メール設定

「Enable Email Notifications」チェックボックスが選択されていることを確認して、情報を適切に入力します。

SMTP ポートのデフォルト値は 25 です。電子メールサーバが別のポートで実行している場合、それを指定して、サーバ名をコロンで区切ります。たとえば、メールサーバがポート 587 で実行している場合、email.myserver.com:587 を「SMTP Server」テキ���トボックスに入力します。

電子メール設定ページについては、The Settings Pageで詳しく説明しています。

MySQL サーバを監視するようにエージェントを設定するには、そのサーバのエージェントのユーザアカウントがあることを確認する必要があります。

このユーザアカウントに必要な権限は、MySQL Enterprise Service Agent を使用して収集する情報により異なります。次の権限は、Service Agent が、割り当てられたタスクを制限なしに実行できるように許可します。

たとえば、次の GRANT ステートメントは、必要な SELECT 権、REPLICATION CLIENT 権、SHOW DATABASES 権、SUPER 権をエージェントに付与します。

GRANT SELECT, REPLICATION CLIENT, SHOW DATABASES, SUPER, INSERT, PROCESS
  ON *.* 
  TO  'mysqluser'@'localhost' 
  IDENTIFIED BY 'agent_password';

セキュリティのため、CREATE 権限および INSERT 権限のみをエージェントに付与して、mysql データベース内でのテーブル作成のみを許可できます。

GRANT CREATE, INSERT
  ON mysql.* 
  TO  'mysqluser'@'localhost' 
  IDENTIFIED BY 'agent_password';

一般的な設定では、エージェントは監視対象の MySQL サーバと同じマシンで実行するため、ホスト名は localhost になります。ただし、エージェントが、監視対象 MySQL サーバをホストするマシンとは異なるマシンで実行している場合、このホスト名は変わります。この場合、localhost を適切な値に変更してください。リモート監視の詳細については、項2.6.3. 「リモート MySQL Server を監視するようにエージェントを設定する」を参照してください。

MySQL Enterprise Service Agent を Windows にインストールするには、mysqlserviceagent-version-windows-installer.exe（version は 3 つのパートから構成されるバージョン番号）インストーラをダブルクリックします。

また、Service Agent を unattended モードでインストールすることもできます。これは特に、複数のインストールを実行する場合に便利です。詳細については、項2.7. 「無人インストール」を参照してください。

Service Agent がインストールされたら、これを起動する必要があります。Service Agent の起動および停止の詳細については、項2.5.1. 「エージェントの起動および停止: Windows」を参照してください。

MySQL Enterprise Service Agent を Mac OS X にインストールするには、mysqlserviceagent-version-installer.app.zip を解凍して、mysqlenterpriseagent-version-installer アプリケーションを実行します。

Service Agent がインストールされたら、これを起動する必要があります。Service Agent の起動および停止の詳細については、項2.5.2. 「Agent の起動および停止: Mac OS X」を参照してください。

MySQL Enterprise Service Agent を Linux システムにインストールするには、Linux Standards Base（LSB）初期化機能がインストールされている必要があります。

エージェントをインストールするには、ファイル mysqlserviceagent-version-installer.bin（version はバージョン番号、OS、アーキテクチャの 3 つのパートから構成されます）を含むディレクトリにナビゲートします。次のコマンドを入力して、このファイルが実行可能であることを確認します。

shell> chmod +x mysqlserviceagent-version-installer.bin

デフォルトディレクトリ（/opt/mysql/enterprise/agent）にインストールするには、root としてログインする必要があります。権限を持つユーザとしてインストールすると、/home/user_name/mysql/enterprise/agent ディレクトリにインストールされます。

次に、コマンドラインからインストールする方法について説明します。Windows Manager 内からインストーラを実行することで、Service Agent をグラフィカルにインストールできます。いずれの場合も手順は同じです。また、Service Agent を unattended モードでインストールすることもできます。これは特に、複数のインストールを実行する場合に便利です。詳細については、項2.7. 「無人インストール」を参照してください。

次のコマンドを入力して、コマンドラインからインストールを開始します。

shell> ./mysqlserviceagent-version-installer.bin --mode text

以下には、さまざまなオプションが表示されています。デフォルト値は角括弧内に表示されます。デフォルト値を使用するには、Enter をクリックします。デフォルト値を使用しない場合、新しい値を入力します。

エージェントの起動については、項2.5.3. 「エージェントの起動および停止: UNIX」を参照してください。

最後のインストール画面には、Service Agent を起動するオプションがあります。別の方法は、Start → Program → MySQL → MySQL Enterprise Service Agent で、Start MySQL Enterprise Service Agent を選択します。

また、次のコマンドを入力して、エージェントをコマンドラインから起動することもできます。

shell> sc start MySQLEnterpriseServiceAgent

または

shell> net start MySQLEnterpriseServiceAgent

コマンド agentctl.bat start を使用して、エージェントを起動することもできます。エージェントを停止するには、引数 stop を使用します。このバッチファイルは、Agent ディレクトリにあります。

サービスが実行しているかどうかは、Microsoft 管理コンソールサービスウィンドウで確認できます。サービスのステータスを確認するには、コントロールパネルから「Administrative Tools」を選択し、「Service」のリンクをクリックします。次に、MySQL Enterprise Service Agent という名前のサービスを探して、「状態」列の下を参照します。

「Start」メニューまたはコマンドラインからではなく、このウィンドウからエージェントを起動することもできます。「MySQL Enterprise Service Agent」を右クリックして、ポップアップメニューから「Start」を選択します。このウィンドウからエージェントを起動すると、監視する MySQL サーバに接続できない場合、エラーダイアログボックスが開きます。エージェントが MySQL Enterprise Service Manager に接続できない場合は、エラーは表示されません。

エージェントを起動するポップアップメニューは、エージェントを停止するオプションも提供します。エージェントをコマンドラインから停止するには、次のコマンドを入力する必要があります。

shell> sc stop MySQLEnterpriseServiceAgent

または

shell> net stop MySQLEnterpriseServiceAgent

Mac OS X でエージェントを起動するスクリプトは、/Applications/mysql/enterprise/agent/etc/init.d ディレクトリにあります。エージェントを起動するには、このディレクトリに移動して、コマンドラインで次のコマンドを入力します。

shell> ./mysql-monitor-agent start

エージェントが実行しているか確認するには、次のコマンドを使用します。

shell> ./mysql-monitor-agent status

結果のメッセージでは、エージェントが実行しているかどうかが示されます。エージェントが実行していない場合、次のコマンドを使用して、エージェントログファイルの最後の 10 のエントリを表示します。

shell> tail /Applications/mysql/enterprise/agent/log/mysql-monitor-agent.log

エージェントのトラブルシューティングの詳細については、項2.6.5. 「エージェントのトラブルシューティング」を参照してください。

インストールすると、/Applications/mysql/enterprise/agent ディレクトリが作成されます。また、このディレクトリのすぐ下にある etc ディレクトリの mysql-monitor-agent.ini ファイルに設定が保存されます。log ディレクトリも、agent ディレクトリのすぐ下にあります。

サービスエージェントを実行するときに使用できるすべてのコマンドラインオプションを参照するには、/Applications/mysql/enterprise/agent/etc/init.d ディレクトリに移動して、mysql-monitor-agent help を起動します。次のメッセージが表示されます。

Usage: ./mysql-monitor-agent {start|stop|restart|status} [ini-file-name]

ini-file-name オプションを使用する必要があるのは、ini ファイルがデフォルトの位置にインストールされていない場合、または ini ファイルの名前を変更した場合だけです。複数のエージェントを同じマシンにインストールする場合、このオプションを使用する必要があります。フルパスを ini ファイルに渡します。たとえば、/Applications/mysql/enterprise/agent/etc/init.d ディレクトリに移動してから、次のコマンドを入力します。

shell> ./mysql-monitor-agent start /Applications/mysql/enterprise/agent/etc/new-mysql-monitor-agent.ini

複数のエージェントを特定のマシンで実行する場合、エージェントを停止するときに ini ファイルのパスを指定する必要があります。ini ファイルを指定せずに mysql-monitor-agent stop を実行すると、デフォルトの ini ファイルに関連付けられたエージェントのみが停止します。

追加エージェントの作成の詳細については、項2.6.2. 「MySQL Server（agent-instance.ini）の設定」を参照してください。

root としてエージェントをインストールした場合、再起動時に、mysql-monitor-agent デーモンが自動的に起動します。権限がないユーザとしてエージェントをインストールすると、再起動時にエージェントを手動で起動するか、このタスクを実行するスクリプトを作成する必要があります。同様に、項2.6.2. 「MySQL Server（agent-instance.ini）の設定」の説明に従いエージェントを追加した場合、再起動時にこのエージェントを起動するには、オペレーティングシステムに適切なシステム初期化スクリプトを作成します。エージェントが実行しているかどうかを確認するには、init.d ディレクトリに移動して、./mysql-monitor-agent status コマンドを入力します。

インストールが終了したら、次のコマンドを入力して、サービスエージェントをコマンドラインから起動できます。

shell> /opt/mysql/enterprise/agent/etc/init.d/mysql-monitor-agent start

エージェントが実行しているか確認するには、次のコマンドを使用します。

shell> ./mysql-monitor-agent status

結果のメッセージでは、エージェントが実行しているかどうかが示されます。エージェントが実行していない場合、次のコマンドを使用して、エージェントログファイルの最後の 10 のエントリを表示します。

shell> tail /opt/mysql/enterprise/agent/log/mysql-monitor-agent.log

エージェントのトラブルシューティングの詳細については、項2.6.5. 「エージェントのトラブルシューティング」を参照してください。

インストールすると、/opt/mysql/enterprise/agent ディレクトリが作成されます。また、このディレクトリのすぐ下にある etc ディレクトリの mysql-monitor-agent.ini ファイルに設定が保存されます。log ディレクトリも、agent ディレクトリのすぐ下にあります。

サービスエージェントを実行するときに使用できるすべてのコマンドラインオプションを参照するには、/opt/mysql/enterprise/agent/etc/init.d ディレクトリに移動して、mysql-monitor-agent help を起動します。次のメッセージが表示されます。

Usage: ./mysql-monitor-agent {start|stop|restart|status} [ini-file-name]

ini-file-name オプションを使用する必要があるのは、ini ファイルがデフォルトの位置にインストールされていない場合、または ini ファイルの名前を変更した場合だけです。複数のエージェントを同じマシンにインストールする場合、このオプションを使用する必要があります。フルパスを ini ファイルに渡します。たとえば、/opt/mysql/enterprise/agent/etc/init.d ディレクトリに移動してから、次のコマンドを入力します。

shell> ./mysql-monitor-agent start /opt/mysql/enterprise/agent/etc/new-mysql-monitor-agent.ini

複数のエージェントを特定のマシンで実行する場合、エージェントを停止するときに ini ファイルのパスを指定する必要があります。ini ファイルを指定せずに mysql-monitor-agent stop を実行すると、デフォルトの ini ファイルに関連付けられたエージェントのみが停止します。同様に、エージェントのステータスを確認するには、その ini ファイルを指定します。

追加エージェントの作成の詳細については、項2.6.2. 「MySQL Server（agent-instance.ini）の設定」を参照してください。

root としてエージェントをインストールした場合、再起動時に、mysql-monitor-agent デーモンが自動的に起動します。権限がないユーザとしてエージェントをインストールすると、再起動時にエージェントを手動で起動するか、このタスクを実行するスクリプトを作成する必要があります。同様に、項2.6.2. 「MySQL Server（agent-instance.ini）の設定」の説明に従いエージェントを追加した場合、再起動時にこのエージェントを起動するには、オペレーティングシステムに適切なシステム初期化スクリプトを作成します。エージェントが実行しているかどうかを確認するには、init.d ディレクトリに移動して、./mysql-monitor-agent status コマンドを入力します。

mysql-monitor-agent.ini ファイルには、MySQL Enterprise Service Agent の基本設定情報が含まれています。このファイルは、エージェント全体でサポートされる機能に関する重要な情報が含まれています。

この設定ファイルの例を次に示します。

# WARNING - the UUID defined below must be unique for each agent.
#
# To use this .ini file as a template for configuring additional
# agents, do not simply copy and start a new agent without first
# modifying the UUID.
#
# Refer to the documentation for more detailed information and
# instructions.
# 
# Version: 20080718_230416_r7011

[mysql-proxy]

plugins=proxy,agent
agent-mgmt-hostname = http://agent:password@monitor-server:18080/merlin/heartbeat
mysqld-instance-dir= etc/instances
agent-item-files = share/mysql-proxy/items/quan.lua,share/mysql-proxy/items/items-mysql-monitor.xml
proxy-address=:4040
proxy-backend-addresses = 127.0.0.1:3306
proxy-lua-script        = share/mysql-proxy/quan.lua


agent-uuid = 8770ead5-3632-4b29-a413-4a7c92437e26
log-file = mysql-monitor-agent.log
pid-file=/Applications/mysql/enterprise/agent/mysql-monitor-agent.pid

メイン設定情報は、設定ファイルの [mysql-proxy] セクション内になければなりません。このファイル内のメイン設定パラメータを次に示します。

mysql-monitor-agent.ini ファイルでは、多くのオプションパラメータを設定できます。

監視する MySQL サーバに対して、mysql-monitor-agent.ini メインファイル内の mysqld-instance-dir 設定パラメータで指定されているディレクトリ内に agent-instance.ini を作成する必要があります。

agent-instance.ini ファイルには、エージェントで監視する MySQL サーバに接続するときに使用するホスト名およびユーザ証明書が含まれます。このファイルのフォーマットを次に示します。

# WARNING - the displayname defined below must be unique for each
# MySQL server being monitored.
#
# To use this .ini file as a template for configuring additional
# instances to monitor, do not simply copy and start a new agent
# without first modifying the displayname.
#
# Refer to the documentation for more detailed information and
# instructions.
# 
# Version: 20080718_230416_r7011

[mysqld]
hostname = 127.0.0.1
port     = 3306
user     = root
password = 

個々の設定パラメータは、次のように定義できます。

通常、エージェントは、監視する MySQL サーバと同じマシンで実行します。しかし、これは必須条件ではないので、使用できるエージェントがないオペレーティングシステムで実行している MySQL サーバを監視する場合、その MySQL サーバをホストするマシンとは別のマシンにエージェントをインストールできます。

エージェントをインストールしてリモートマシンの MySQL サーバを監視するプロセスは、項2.4. 「Service Agent のインストール」で説明されているプロセスと同じです。この手順に従う場合、MySQL Enterprise Service Manager および MySQL サーバの IP アドレスまたはホスト名を正しく設定するように注意してください。エージェントが MySQL サーバと同じマシンで実行していないため、デフォルトの localhost は使用できません。

また、localhost とは別のホストから MySQL サーバにログインする権利をエージェントに付与し、MySQL サーバにより使用されるポート（通常、3306）をリモートアクセス用に開く必要があります。エージェントで必要なデータベース証明書の詳細については、項2.4.1. 「Service Agent の MySQL ユーザアカウントの作成」を参照してください。

エージェントは、MySQL Enterprise Service Manager にログインできなければなりません。このとき、通常は 18080 ポートが使用されます。適切なポートが開いていることを確認してください。

MySQL Enterprise Service Manager をホストするマシンで SSH サーバを実行し、エージェントをホストするマシンで SSH クライアントを実行する場合、エージェントがファイアウォールをバイパスできるように SSH トンネルを作成できます。この場合、まず、.ini ファイルの [merlind] セクションで指定されている hostname 値を調整する必要があります（.ini ファイルの内容および位置の詳細については、項2.6.1. 「MySQL Enterprise Service Agent（mysql-monitor-agent.ini）の設定」を参照してください）。エージェントを停止して、次のように hostname 値を変更します。

hostname = http://agent_name:password@localhost:18080/merlin/heartbeat

agent_name と password を適切な値に変更します。同様に、ポート 18080 でダッシュボードを実行していない場合、このポートを変更します。エージェントは SSH トンネルを介して接続するので、ホスト名に localhost を使用します。

エージェントが実行するマシンで次のコマンドを実行します。

shell> ssh -L 18080:Dashboard_Host:18080 -l user_name -N Dashboard_Host

プロンプトが表示されたら、user_name のパスワードを入力します。

MySQL Enterprise Service Manager をポート 18080 で実行しない場合、適切なポート番号に変更します。同様に、Dashboard_Host を正しい値に変更します。user_name は、MySQL Enterprise Service Manager をホストするマシンの有効なオペレーティングシステムユーザを表わします。

hostname の新しい値を有効にするため、エージェントを再起動します。エージェントの再起動については、以下を参照してください。

エージェントのトラブルシューティングは、エージェントが実行しているかどうかを確認することから始まります。確認するには、以下を参照してください。

監視する MySQL サーバのログインするための証明書がエージェントで正しく指定されていない場合、エージェントは起動時に実行しません。監視対象の MySQL サーバにログインして、エージェントの証明書を確認します。mysql.user テーブルの Host フィールド、User フィールド、Password フィールドの値と mysql-monitor-agent.ini の [mysqld] セクションに示されている値を比較します。ini ファイルで指定されている証明書が正しくない場合、これを修正して、エージェントを再起動します。ini ファイルの変更は、エージェントを再起動するまで有効にならないので注意してください。

Service Manager ログインに正しい証明書が指定されていない場合、エージェントは起動しません。Service Manager へのログインに使用する証明書が正しくない場合、エージェントログファイルにエントリが作成されます。このログファイルの位置については、項A.3. 「エージェント ログと PID ファイル」を参照してください。

エージェントは起動したが、ダッシュボードにサーバが表示されていない場合、mysql-monitor-agent.ini ファイルの [merlind] セクションで指定されている hostname を確認します。証明書、IP アドレスまたはポートが正しくない場合、これらはすべて MySQL サーバがダッシュボードに表示されない原因となります。また、このファイルに指定されているポートが、MySQL Enterprise Service Manager をホストするマシンでブロックされていないことを確認してください。

エージェントが Service Manager にログインできるかを確認する簡単な方法は、http://Dashboard_Host:18080/merlin/heartbeat を Web ブラウザのアドレスバーに入力することです。この場合、ホスト名およびポート名は適切な値を使用してください。HTTP 認証ダイアログボックスが表示されたら、エージェントのユーザ名およびパスワードを入力します。正常にログインしたら、次のメッセージが表示されます。

<exceptions>
<error>E1031:  Agent payload parameter NULL.</error>
</exceptions>

上記のように正常にログインでき、エージェントが実行している場合、mysql-monitor-agent.ini ファイルにエラーがあります。ini ファイルのホスト名、ポート、エージェント名、パスワードと、Web ブラウザのアドレスバーに入力した値を比較してください。

HTTP 認証が失敗した場合、使用しているエージェントの証明書が間違っています。正しくない証明書を使用して Service Manager にログインしようとすると、エージェントログファイルにエントリが作成されます。このログファイルの位置については、項A.3. 「エージェント ログと PID ファイル」を参照してください。

HTTP 認証ダイアログボックスが表示されず、接続ができない場合、指定したホスト名またはポートが間違っている可能性があります。configuration_report.txt ファイルの Application hostname and port:で示している値と入力した値を確認してください。接続が失敗した場合、MySQL Enterprise Service Manager をホストするマシンでポートがブロックされている可能性もあります。

ブロックされているポートが問題かどうか確認するには、一時的にファイアウォールから外します。これで、エージェントが接続できた場合、インストール中に指定したポートを開いて、エージェントを再起動します。必要な場合、SSH トンネルを使用してファイアウォール外を監視します。詳細については、項2.6.4. 「SSH トンネルでのファイルウォール外の監視」を参照してください。

エージェントエラーログファイルは、問題の解決に役立ちます。次のようなエラーで、ブロックされているポートを示していることがあります。

(critical) connection to  merlin-server 
'http://agent:test@172.11.1.1:18080/merlin/heartbeat' failed:
"connect() timed out!" error.

エージェントエラーログファイルの位置については、項A.3. 「エージェント ログと PID ファイル」を参照してください。

log-level エントリを ini ファイルに設定することも、デバッグに役立ちます。詳細については、項2.6.1. 「MySQL Enterprise Service Agent（mysql-monitor-agent.ini）の設定」を参照してください。

コマンドラインからエージェントを実行すると、エージェントをメニューオプションから起動したときにはログファイルや画面には表示されないエラーが表示されることがあります。エージェントをコマンドラインから起動するには、このセクション冒頭の説明を参照してください。

同じマシンで複数のエージェントを実行する場合、UUID が一意でなければならず、log-file および pid-file も異なる値でなければなりません。詳細については、項2.6.2. 「MySQL Server（agent-instance.ini）の設定」を参照してください。

監視する MySQL サーバをホストするマシンとは異なるマシンでエージェントが実行している場合、エージェントアカウントに正しい host が指定されていることを確認してください。正しいポートは、通常 3306 で、リモートログインに開かれている必要があります。リモート監視の詳細については、項2.6.3. 「リモート MySQL Server を監視するようにエージェントを設定する」を参照してください。

モニターインストーラまたはエージェントインストーラで使用できるオプションを表示するには、コマンドラインで、help オプションに実行可能ファイルの名前を入力します。

--help                         Display the list of valid options

--version                      Display product information

--optionfile <optionfile>      Installation option file

                               Default: 

--mode <mode>                  Installation mode

                               (Windows)Default: win32                                
                               (Unix)Default: gtk
                               (Mac OS X)Default: osx 
                               (Windows)Allowed: win32 unattended
                               (Unix)Allowed: gtk text xwindow unattended  
                               (Mac OS X)Allowed: osx text unattended

--debugtrace <debugtrace>      Debug filename
                               Default: 
                               
--installer-language <installer-language> Language selection
                               Default:
                               Allowed: en  jp                               

--installdir <installdir>      Installation directory
                               (Windows)Default:C:\Program »
                               Files\MySQL\Enterprise\Monitor
                               (Unix)Default:/opt/mysql/enterprise/monitor/
                               (Mac OS X)Default:/Applications/mysql/enterprise/monitor/


--tomcatport <tomcatport>      Tomcat Server Port
                               Default: 18080

--tomcatshutdownport <tomcatshutdownport> Tomcat Shutdown Port
                               Default: 18005

--tomcatsslport <tomcatsslport>Tomcat SSL Port
                               Default: 18443

--usessl <usessl>              Should communication between the Dashboard »
                                      and Service Manager be encrypted?
                               Default: 0


--adminuser <adminuser>        Repository Username 
                               Default: service_manager


--adminpassword <adminpassword>Password
                               Default: 

--dbport <dbport>              Bundled MySQL Database Port
                               Default: 13306
                               
--dbbasedir <dbbasedir>        Base Directory  
                               Default: /apache-tomcat/webapps/merlin/mysql

--dbdatadir <dbdatadir>        Data Directory  
                               Default: /apache-tomcat/webapps/merlin/mysql/data
                                   
                                   

--help                         Display the list of valid options

--version                      Display product information
                               Default: 

--optionfile <optionfile>      Installation option file
                                Default: 

--mode <mode>                  Installation mode
                               (Windows)Default: win32 
                               (Unix)Default: gtk
                               (Mac OS X)Default: osx
                               (Windows)Allowed: win32 unattended
                               (Unix)Allowed: gtk text xwindow unattended
                               (Mac OS X)Allowed: osx text unattended

 
--debugtrace <debugtrace>      Debug filename
                               Default: 

--installer-language <installer-language> Language selection
                               Default:
                               Allowed: en  jp

--installdir <installdir>      Installation directory
                               (Windows)Default: C:\Program Files\MySQL\Enterprise\Agent
                               (Unix)Default:/opt/mysql/enterprise/agent
                               (Mac OS X)Default:/Applications/mysql/enterprise/agent

--mysqlhost <mysqlhost>         MySQL hostname or IP address
                                Default: 127.0.0.1

--checkmysqlhost <checkMysqlhost>Validation of MySQL hostname or IP address
                                Default: yes

--mysqlport <mysqlport>         MySQL port on 127.0.0.1
                                Default: 3306

--mysqluser <mysqluser>         User name on 127.0.0.1:3306
                                Default:

--mysqlpassword <mysqlpassword> Password for mysqluser on 127.0.0.1:3306
                                Default: 

--managerhost <managerhost>     Hostname or IP address
                                Default: 127.0.0.1

--tomcatport <tomcatport>       Port on 127.0.0.1
                                Default: 18080

--agentuser <agentuser>         Agent username on 127.0.0.1:18080
                                Default: agent

--agentpassword <agentpassword> Agent password for agent on 127.0.0.1:18080
                                Default: 

--servername <servername>       Hostname to display
                                Default: 

Windows での無人インストールの場合、options.server.txt という名前のオプションファイルを作成します。オプションファイルの内容の例を次に示します。

debugtrace=C:\Program Files\MySQL\Enterprise\install.debugtrace.log
mode=unattended
installdir=C:\Program Files\MySQL\Enterprise
tomcatport=8080
tomcatshutdownport=8005
tomcatsslport=8443
adminpassword=myadminpassword
dbport=3300

このファイルは、ログファイルのディレクトリおよびファイル名を示し、mode を unattended に設定し、installdir オプションを使用してインストールディレクトリを指定します。他の残りのオプションは、表示されているままの意味です。

モニターインストーラファイルおよびオプションファイルが同じディレクトリにあることを確認します。また、オプションファイルを options.server.txt として保存している場合、次のコマンドを入力して、コマンドラインから無人インストールを開始できます。

  C:\ mysqlmonitor-version-windows-installer.exe --optionfile options.server.txt

同じ方法で、MySQL Enterprise Service Agent をインストールできます。エージェントオプションファイルを作成し、optionfile オプションを使用してエージェントインストーラを呼び出します。

エージェントインストールでは、少なくとも、mode オプション（コマンドラインで指定していない場合）、mysqluser オプション、installdir オプション、mysqlpassword オプション、installdir オプション、managerhost オプション、agentpassword オプションを指定する必要があります。これらの値を含むファイルを作成して、無人エージェントインストールで optionfile オプションとともに使用します。

必要な場合、適切な optionfile オプションを渡して、Service Manager と Service Agent の両方のプログラムを呼び出すスクリプトを作成します。

UNIX での無人インストールの場合、options.server.txt という名前のオプションファイルを作成します。UNIX でのインストールの場合のオプションファイルの内容の例を次に示します。

debugtrace=/opt/mysql/enterprise/install.debugtrace.monitor.log
mode=unattended
installdir=/opt/mysql/enterprise/monitor
tomcatport=8080
tomcatshutdownport=8005
tomcatsslport=8443
adminpassword=myadminpassword
dbport=3300

このファイルは、ログファイルのディレクトリおよびファイル名を示し、mode を unattended に設定し、installdir オプションを使用してインストールディレクトリを指定します。他の残りのオプションは、表示されているままの意味です。

モニターインストーラファイルおよびオプションファイルが同じディレクトリにあることを確認します。また、オプションファイルを options.server.txt として保存している場合、次のコマンドを入力して、コマンドラインから無人インストールを開始できます。

  shell> mysqlmonitor-version-installer.bin --optionfile options.server.txt

同じ方法で、MySQL Enterprise Service Agent をインストールできます。エージェントオプションファイルを作成し、optionfile オプションを使用してエージェントインストーラを呼び出します。

エージェントインストールでは、少なくとも、mode オプション（コマンドラインで指定していない場合）、mysqluser オプション、installdir オプション、mysqlpassword オプション、agentpassword オプションを指定する必要があります。これらの値を含むファイルを作成して、無人エージェントインストールで optionfile オプションとともに使用します。

必要な場合、適切な optionfile オプションを渡して、Service Manager と Service Agent の両方のプログラムを呼び出すスクリプトを作成します。

Mac OS X でのエージェントの無人インストールの手順は、UNIX での手順と同じです。

MySQL Enterprise Service Manager で必要なサービスを起動する方法については、項2.2.5. 「MySQL Enterprise Monitor サービスの起動/停止: Windows」（Windows）および 項2.2.6. 「MySQL Enterprise Monitor サービスの起動/停止: UNIX および Mac OS X」（UNIX、Mac OS X）を参照してください。

MySQL Enterprise Service Agent の起動については、以下を参照してください。

必要な場合、これらのサービスを起動するスクリプトを作成できます。

既存のインストールを MySQL Enterprise Monitor 1.3 から MySQL Enterprise Monitor 2.0 にアップグレードするには、監視する各マシンで MySQL Enterprise Service Manager と MySQL Enterprise Service Agent の両方をアップグレードする必要があります。

更新プロセスを実行するには、update インストーラを使用する必要があります。これにより、現在の設定情報が新しいバージョンの MySQL Enterprise Service Manager に移行されます。

移行を開始する前に、各監視対象のホストで MySQL Enterprise Service Manager および MySQL Enterprise Service Agent をシャットダウンします。次に、更新された MySQL Enterprise Service Manager アプリケーションをインストールして、メインアプリケーションとリポジトリの設定およびデータを移行します。新しい MySQL Enterprise Service Manager を実行すると、各エージェントの更新および移行を開始できます。

MySQL Enterprise Service Manager のアップグレードの詳細については、項2.9.1.1. 「MySQL Enterprise Service Agent 2.0 へのアップグレード」を参照してください。MySQL Enterprise Service Agent のアップグレードの詳細は、項2.9.1.2. 「MySQL Enterprise Service Agent 2.0 へのアップグレード」を参照してください。

2.9.1.1. MySQL Enterprise Service Agent 2.0 へのアップグレード

MySQL Enterprise Service Manager をアップグレードするには、更新インストーラを使用する必要があります。更新インストーラは、インストール中いくつもの操作を実行します。

• 2.0 機能のサポートに必要な新しいデータベースが作成されます。

• 重要なダッシュボード、ユーザ、ルール情報は、古いデータベースから新しいデータベースに移行されます。

• MySQL Enterprise Service Manager の重要な設定パラメータは、MySQL Enterprise Monitor 1.3 から MySQL Enterprise Monitor 2.0 に移行されます。

更新インストーラを使用して新しいソフトウェアをインストールする場合、次の基本手順を行います。

1. インストール言語を要求します。

2. 現在の MySQL Enterprise Service Manager インストールの位置を確認します。

3. 古いサーバ、アプリケーション、データベースファイルのコピーを保持するかどうかを指定します。

4. 新しいサーバがエージェントからの SSL 接続をサポートするかどうかなど、Tomcat サーバの設定を行います。

5. 必要な場合、新しいアプリケーションがインストールされる前に、アプリケーションおよびデータベース情報がバックアップおよびアップグレードされます。

インストールプロセスは、すべてのプラットフォームで同じです。Max OS X のプロセスの例を次に示します。

1. 更新インストーラをダブルクリックします。更新インストーラのファイル名は update が追加されます。たとえば、mysqlmonitor-2.0.0.7101-osx-update-installer.app です。

2. ソフトウェアインストール時に使用する言語を確認します。

   図 2.23. MySQL Enterprise Service Manager 更新のインストール:言語

   

   「OK」をクリックします。

3. インストールするアプリケーションを示す情報画面が表示されます。「Next」をクリックして次に進みます。

4. MySQL Enterprise Service Manager の直前のインストールを指定または参照します。デフォルト位置内にサーバをインストールした場合、アプリケーションの現在のバージョンは自動的に検出されます。

   図 2.24. MySQL Enterprise Service Manager 更新のインストール:直前のインストール

   

5. インストーラは、データの完全なバックアップを MySQL Enterprise Monitor リポジトリデータベース内に保存するなど、既存のアプリケーションのバックアップコピーを保持できます。

   図 2.25. MySQL Enterprise Service Manager 更新のインストール:直前のインストールのバックアップ

   

   バックアップの位置を指定します（デフォルトでは、インストールディレクトリ内の backup ディレクトリを使用します）。メインアプリケーションのほかにデータベースをバックアップすると、ファイルをコピーしなければならないため、インストール時間が長くなるので注意してください。リポジトリデータのサイズが大きいほど、インストールプロセスの時間が長くなります。

6. Tomcat Server オプションを指定します。Tomcat Server Port は、MySQL Enterprise Dashboard のアクセスに使用するデフォルトポートです。MySQL Enterprise Service Manager との通信に SSL を使用してエージェントをサポートする場合、「Is SSL support required?」を選択する必要があります。

7. インストールを続行するか確認します。インストールが開始されると、既存のアプリケーション（およびデータベース）のバックアップが開始します。このプロセスには、時間がかかる場合があります。このプロセスが完了するまで待機してください。

8. プロセスが完了すると、今後必要に応じてアプリケーションをアンインストールする方法など、インストールプロセスの通知が提供されます。エラーが発生した場合、ここで報告されます。

   図 2.26. MySQL Enterprise Service Manager 更新のインストール:インストールファイルの完了

   

9. インストールが完了しました。このページのチェックボックスを選択することで、MySQL Enterprise Service Manager を自動的に起動し、添付されている Readme ファイルを表示できます。

10. これで、インストーラを終了できます。

インストールが完了してから初めて MySQL Enterprise Dashboard にログインするとき、ログイン証明書がサーバ設定で確認できない場合は、これを提供するように要求されます。または、MySQL Enterprise Service Manager バージョンに適した Advisor jar のコピーを提供するよう要求されます。

図 2.27. MySQL Enterprise Service Manager 更新のインストール:最後の設定

MySQL Enterprise Monitor が更新されたので、各エージェントを MySQL Enterprise Service Agent 2.0 に更新する必要があります。正しい情報を MySQL Enterprise Service Manager に提供してください。

MySQL Enterprise Service Manager の無人更新を実行するときに使用できるオプションを次に示します。

--help                         Display the list of valid options

--version                      Display product information

--optionfile <optionfile>      Installation option file
                               Default: 

--mode <mode>                  Installation mode
                               (Windows)Default: win32
                               (Unix)Default: gtk
                               (Mac OS X)Default: osx
                               (Windows)Allowed: win32 unattended
                               (Unix)Allowed: gtk text xwindow unattended
                               (Mac OS X)Allowed: osx text unattended

--debugtrace <debugtrace>      Debug filename
                               Default:                                
                               
--installer-language <installer-language> Language selection
                                Default:
                                Allowed: en  jp

--installdir <installdir>      Previous Installation
                               Default: 
                                
--createDataBackup <createDataBackup>
   
                               Default: 1
                               
--backupDir <backupDir>        Backup directory 
                               Default:
                               

エージェントの無人更新のオプションが異なることは、createDataBackup オプションが createBackup に置換されることです。

MySQL Enterprise Service Manager をデフォルトディレクトリにインストールしなかった場合、installdir オプションを指定する必要があります。また、無人更新を実行する場合、mode も指定する必要があります。デフォルトディレクトリにインストールした場合、無人更新プロセスは、項2.7. 「無人インストール」で説明したプロセスと同じです。

監視対象の MySQL サーバをアップグレードする場合、まず、エージェントを停止します。エージェントを停止するには、以下を参照してください。

MySQL サーバを停止し、アップグレードを実行します。Windows での MySQL サービスの停止および再起動については、項2.2.5. 「MySQL Enterprise Monitor サービスの起動/停止: Windows」を参照してください。

UNIX および Mac OS X での MySQL デーモンの停止および再起動については、項2.2.6. 「MySQL Enterprise Monitor サービスの起動/停止: UNIX および Mac OS X」を参照してください。

サービス/デーモンが停止されたら、サーバをアップグレードできます。MySQL サーバのアップグレードについては、使用しているサーババージョンに関するリファレンスマニュアルを参照してください。アップグレードが完了したら、MySQL サーバを再起動します。

監視する MySQL サーバを変更する場合、MySQL Enterprise Service Agent を再インストールする必要はありません。別のサーバを監視するように、既存のエージェントを調整できます。

このようにするには、サービスエージェントを停止して、監視するサーバを削除します。エージェントを停止するには、以下を参照してください。

サーバを削除する方法については、項5.3.2. 「ダッシュボードからサーバの削除」を参照してください。

エージェントが停止され、サーバがダッシュボードから削除されたら、mysql-monitor-agent.ini、またはエージェント instances インスタンスディレクトリ内の agent-instance.ini ファイルを変更できます。ディレクトリの位置は、mysql-monitor-agent.ini の mysqld-instance-dir パラメータの値で確認できます。

監視対象の MySQL サーバを変更する場合、agent-instance.ini ファイルを編集します。必要に応じて、user、password、hostname、port の値を変更します。詳細については、項2.6.2. 「MySQL Server（agent-instance.ini）の設定」を参照してください。

プロキシサポート（Query Analyzer で必要）、管理ホスト、エージェントで使用されるポート番号など、その他の設定を変更するには、mysql-monitor-agent.ini ファイルを変更します。詳細については、項2.6.1. 「MySQL Enterprise Service Agent（mysql-monitor-agent.ini）の設定」を参照してください。

エージェントを再起動するには、以下を参照してください。

Dashboard にログインすると、All Servers グループに新しいサーバが追加されています。

監視対象のサーバをダウン状態にしなければならない場合があります。この場合、まず、エージェントを停止します。エージェントを停止すると、「Server is unreachable」 イベントの生成を回避できます。

たとえば、バックアップのためにサーバを停止するとします。この手順を次に示します。

エージェントを停止または起動するには、以下を参照してください。

MySQL サービス/デーモンを停止するには、使用しているサーババージョンに適した MySQL リファレンスマニュアルを参照してください。このマニュアルは http://dev.mysql.com/doc/refman からオンラインで参照できます。

上記の手順に従うことで、問題なくサーバをバックアップできます。これと対照的に、エージェントを実行したままサーバをダウン状態にすると、「Server is unreachable」 イベントが発生します。

エージェントを停止する場合、ルールに関連するロジックを変更することもできます。たとえば、ルール 「Server is unreachable」 のしきい値を変更しました。

%server.reachable% == THRESHOLD

上記を以下のように変更します。

%server.reachable% == THRESHOLD  && CURTIME() NOT BETWEEN '22:00:00' AND '23:00:00'

これにより、バックアップを実行できる午後 10 時～11 時まで、ルールは事実上停止します。

ルールの編集の詳細については、図 6.2. 「ルール編集画面」を参照してください。特定のサーバ、またはサーバのグループに関するすべてのイベントを停止するには、項6.6. 「スクリプタブルなアドバイザのブラックアウト」を参照してください。