4.3 Installing the Service Manager on Unix and Linux

To install the Service Manager find the file named mysqlmonitor-version-installer.bin (where version indicates the version number, the OS, and the architecture). Ensure that this file is executable by typing:

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

To install to the default directory (/opt/mysql/enterprise/monitor), login as root. An unprivileged user installs to the /home/user_name/mysql/enterprise/monitor/ directory.

What follows describes installation from the command line using text mode. You can install the Service Manager graphically by running the installer from within a windows manager. In both cases, the steps are identical. You can also install the Service Manager in unattended mode. This is especially useful if you are doing multiple installations. For more information on this topic, see Section 8.1, “Unattended Installation”.

  1. Begin installation by typing:

      shell> ./mysqlmonitor-version-installer.bin --mode text
    
  2. First choose the language for the installation:

    
    Language Selection
    
    Please select the installation language
    [1] English - English
    [2] Japanese - 日本語
    Please choose an option [1] :
    
    
  3. Throughout the installation process, you are asked the configuration questions for different options. Default values are shown between square brackets; to use the default press Enter. Otherwise, enter the new value and press Enter:

    First, select the directory to install MySQL Enterprise Service Manager. The default is /opt/mysql/enterprise/monitor/. Make sure that the location you choose has enough space to hold the installation files and the database information that is created when MySQL Enterprise Service Manager is running.

    Welcome to the setup wizard for the MySQL Enterprise Monitor
    
    ----------------------------------------------------------------------------
    Please specify the directory where the MySQL Enterprise Monitor will be 
    installed
    
    Installation directory [/opt/mysql/enterprise/monitor/]:
    
  4. Now set the Tomcat Server options. For more details on these parameters, see Section 4.1, “Service Manager Installation Common Parameters”.

    ----------------------------------------------------------------------------
    Tomcat Server Options
    
    Please specify the following parameters for the bundled Tomcat Server
    
    Tomcat Server Port [18080]:
    
    Tomcat SSL Port [18443]:
    
    Note

    Prior to MySQL Enterprise Monitor 3.0, you were prompted to enable SSL support, but it is required now. SSL support lets your agents and the monitor communicate with each other using SSL. Using SSL means that the data exchanged by the agent and MySQL Enterprise Service Manager are secure and can be used to monitor servers securely, or to monitor agents over a public connection.

  5. Set the repository (embedded MySQL server) configuration options. For more details on these parameters, see Section 4.1, “Service Manager Installation Common Parameters”.

    ----------------------------------------------------------------------------
    Database Installation
    
    Please select which database configuration you wish to use
    
    [1] I wish to use the bundled MySQL database
    [2] I wish to use an existing MySQL database *
    Please choose an option [1] : 1
    
    * Please note that the Enterprise Monitor requires a specific version of the 
    MySQL server for its own data repository in order to operate correctly. We will 
    validate the version of your existing server during the installation. See the 
    documentation for details based on the version of the Enterprise Monitor you are 
    installing.
    
    ----------------------------------------------------------------------------
    Repository Configuration
    
    Please specify the following parameters for the bundled MySQL server
    
    Repository Username [service_manager]: 
    
    Password :
    Re-enter :
    MySQL Database Port [13306]: 
    
    Use SSL when connecting to the database [y/N]:
    
  6. Confirm the installation process.

    ----------------------------------------------------------------------------
    Setup is now ready to install MySQL Enterprise Monitor on your computer.
    
    Do you want to continue? [Y/n]: Y
    
    ----------------------------------------------------------------------------
    Please wait while Setup installs MySQL Enterprise Monitor on your computer.
    

    The installation process could take a few minutes to complete. Upon completion, you see:

     Installing
     0% ______________ 50% ______________ 100%
     #########################################
    
    ----------------------------------------------------------------------------
    Completed installing files
    
    Setup has completed installing the MySQL Enterprise Monitor files on your 
    computer
    
    Uninstalling the MySQL Enterprise Monitor files can be done by invoking:
    /opt/mysql/enterprise/monitor/uninstall
    
    To complete the installation, launch the MySQL Enterprise UI and complete 
    the initial setup. Refer to the readme file for additional information and a 
    list of known issues.
    
    To complete the installation, launch the MySQL Enterprise UI and complete
    the initial setup and product activation information. Refer to the readme file
    for additional information and a list of known issues.
    
    Press [Enter] to continue :
    
  7. Important notes and information is displayed, such as:

    WARNING: To improve security, all communication with the Service Manager uses 
    SSL. Because only a basic self-signed security certificate is included when the 
    Service Manager is installed, it is likely that your browser will display a 
    warning about an untrusted connection. Please either install your own 
    certificate or add a security exception for the Service Manager URL to your 
    browser. See the documentation for more information.  
    
  8. Finally, you can read the Readme file that contains important information about how to use and start your MySQL Enterprise Service Manager.

    ----------------------------------------------------------------------------
    Setup has finished installing MySQL Enterprise Monitor on your computer.
    
    View Readme File [Y/n]: Y
    

    Once the Readme file has been displayed, or if you did not elect to read the file, the installation provides information about how to continue with your installation.

    Info: To configure the MySQL Enterprise Monitor please visit the following page:
    following page: https://localhost:18443/Auth.action
    
    Press [Enter] to continue :
    
  9. Note that a configuration_report.txt file will be created and added to your MySQL Enterprise Monitor installation directory. It contains some of your settings, such as port numbers, but not sensitive information like passwords.

The MySQL Enterprise Monitor User Interface does not start up automatically if you perform a text mode installation. For more information on starting and stopping MySQL Enterprise Service Manager, see Section 4.6, “Starting/Stopping the MySQL Enterprise Monitor Service on Unix and Mac OS X”.