6.4 Monitoring Agent Graphical Installation Wizard

This section describes how to install the Agent using the Installation Wizard. The steps are identical in the command line installation method.

Note

To install to the default directory (/opt/mysql/enterprise/agent), log in as root first. Installing as an unprivileged user installs to the /home/user_name/mysql/enterprise/agent directory.

To automatically start the agent upon rebooting, you must install while logged in as root. If you install as an unprivileged user, you must start the agent yourself after each reboot.

Note

Although MySQL Enterprise Monitor Agent is installed as the root user, directories and files that the Agent writes to are owned by the mysql user in the mysql group, which includes logs/, spool/, and etc/agentManaged. The Agent is started by, and runs as, the mysql user. If you attempt to install to a directory on which the mysql user cannot act, an error is displayed explaining how to correct the situation.

You can also install the Monitor Agent in unattended mode. For more information on unattended installation, see Section 9.1, “Unattended Installation”.

Note

To install multiple agents on the same machine, use the agentservicename option with the installer to set a unique service name each time. For more information, see installer_agentservicename.

Note

There is no 64-bit agent installation for Microsoft Windows platform.

To install the Agent, do the following:

1. Run the installer as required by your operating system.

2. The Language Selection dialog is displayed. Select your language, and click OK.

   The Installation directory dialog is displayed.

3. Either change the installation directory, or accept the default value, and choose the connection type for the agent.

   • Installation directory: enables you to change the installation path.

   • TCP/IP: select if the agent uses TCP/IP to connect to the monitored database. This option is not available on Microsoft Windows platforms. TCP/IP is used by default.

   • Socket: select if the agent uses socket to connect to the monitored database. This is only possible if the agent is monitoring a local database. This option is not available on Microsoft Windows platforms.

     If you choose Socket, you must enter the path to the socket later in the installation process.

   Click Forward. The Monitoring Options dialog is displayed. The installation starts and the files are copied to the installation directory.

4. You can choose whether to monitor the host on which the agent is installed, or the host and a MySQL instance. If you select host only, you have to configure the connection to the MySQL Enterprise Service Manager, but no other configuration is required. If you select host and database, you must also configure the database connection parameters.

   Click Forward. If you are installing on Apple OS X, the Install as a service dialog is displayed. This dialog enables you to install the agent as a service, which restarts each time the host is restarted. This option requires an Administrator's password.

   On all other platforms, the MySQL Enterprise Monitor Options dialog is displayed.

5. The MySQL Enterprise Monitor Options dialog is displayed. Complete the following:

   • Hostname or IP address: the hostname or IP address of the server where MySQL Enterprise Service Manager is installed.

   • Tomcat SSL Port: the SSL port the MySQL Enterprise Service Manager is listening on.

   • Agent Username: the agent username. This is the username all agents must use to connect to the MySQL Enterprise Service Manager.

   • Agent Password: the agent's password. This is the password all agents must use to connect to the MySQL Enterprise Service Manager.

   • Re-enter: re-enter the agent's password.

   Click Forward. The Monitored Database Configuration Options dialog is displayed.

6. The Monitored Database Configuration Options enables you to choose the remaining steps of the installation. The following options are available:

   • Validate hostname, port, and Admin account privileges: select this option to attempt a test connection to the database with the supplied credentials, defined in the Monitored Database Information dialog. If you do not select this option, the installer does not attempt a test connection to the database with the supplied credentials.

     Note

     It is recommended to validate the connection.

   • Configure encryption settings for user accounts: select this to configure the Encryption Settings dialog. If selected, this dialog is displayed after the Monitored Database Information dialog. The Encryption Settings dialog enables you to define the SSL options for connections to SSL-enabled MySQL Instances.

     Important

     Ensure the MySQL instance is SSL-enabled.

   • Configure less-privileged user accounts: select if you intend to define the less-privileged user accounts, General and Limited.

   Make your selection and click Forward.

   The Monitored Database Information dialog is displayed.

7. The Monitored Database Information dialog enables you to define the connection parameters for the MySQL instance the agent monitors.

   • MySQL hostname or IP address: the IP address or hostname of the server on which the MySQL instance is running.

   • MySQL Port: the port the MySQL instance is listening on.

   • Admin User: the admin user the agent uses. This can be the root user, or another user with the SUPER privilege.

   • Admin Password: the password of the admin user.

   • Re-enter Password: re-enter the admin user's password.

   • Monitor Group: the group to which you want the instance to be added in MySQL Enterprise Service Manager. If the group does not exist, it is created, and the monitored instance added to it.

   Click Forward. If you selected Validate hostname, port, and Admin account privileges on the Monitored Database Configuration Options dialog, the supplied credentials are verified against the MySQL instance.

   If you selected Configure encryption settings for user accounts on the Monitored Database Configuration Options dialog, the Encryption Settings dialog is displayed.

8. The Encryption Settings dialog enables you to define the SSL connection parameters for your connection to the SSL-enabled MySQL Instance.

   • Require Encryption: enforces encrypted connections between the agent and the MySQL instance.

   • Allow Self-Signed Certificates: specifies whether self-signed certificates are permitted.

   • CA Certificate: the path to the CA certificate.

9. If you selected Configure less-privileged user accounts on the Monitored Database Configuration Options, the Less Privileged User Account Creation dialog is displayed.

   • Auto-create Less Privileged Users: select to automatically create the users, using the credentials supplied. If you do not create these users, all agent queries are run as the Admin user.

   • General Username: username of the General user.

   • General Password: password of the General user.

   • Limited Username: username of the Limited user.

   • Limited Password: password of the Limited user.

   Click Forward to create the Agent account and complete the installation.