11.5 Unattended Installation

The MySQL Enterprise Monitor Proxy and Aggregator installers enable you to perform unattended installations. This is useful for large scale installations on multiple machines. The installations can be run using all required options on a command line, or by defining the required options in a configuration file and calling that file for each installation.

Unattended Installation Options

To display the installation options available, run the installer from the command line with the following option:

--help

The following options are available:

Table 11.1 MySQL Enterprise Monitor Proxy and Aggregator Installer Options

Option	Description
--help	Displays the help text listing all options available for the platform on which the installer was run. On Microsoft Windows platforms, this option does not output the list of options in the console window, but in a separate help window.
--version	Displays the product version. On Microsoft Windows platforms, this option does not output the version details in the console window, but in a separate help window.
--debuglevel	Sets the verbosity of the installation log. 0 is the lowest verbosity, 4 is the highest. Default value is 2.
--debugtrace	Sets the path and filename of the installation log file.
--optionfile	Sets the path and filename of the installation options file. For more information, see Unattended Installation with Options File.
--installer-language	Sets the language of the installation. Possible values are: en: English. Default value. ja: Japanese.
--mode	Sets the installation mode. This varies according to the platform. For example, on Linux-based systems, you can choose a GUI-based installer with --mode gtk, or choose a text-only, console-based installation with --mode text. The following is a list of the GUI-based installation options available: Windows: Win32 OS X: osx Solaris: xwindow Linux: gtk (Default) and xwindow. --mode can also initiate text mode and unattended installations. --mode text: starts a text-only, console-based installation process. Text-based installation are not available on Windows platforms. --mode unattended: starts an unattended installation. For more information on unattended installations, see Unattended Installation from the Command Line and Unattended Installation with Options File.
--unattendedmodeui	Sets the graphical elements to use, if any, in the unattended installation. The following options are available: none: no pop-ups, or progress bars are displayed. Errors are displayed, if they occur. minimal: No user interaction is required and a progress bar is displayed showing the installation progress. Errors are displayed, if they occur. minimalWithDialogs:
--installdir	Sets the installation directory for the product.
--use-external-glib	Sets the glib to use, the one delivered in the installer (0, default), or the system glib (1).
--monitorcomponent	Specifies which component to install. The following options are available: proxy: installs both Proxy and Aggregator. This is the default. aggregator: installs the Aggregator only.
Proxy-Specific Options
--proxyservicename	Sets the unique service name for the Proxy service.
--mysqlconnmethod	Sets the connection method used by the proxy to connect to the monitored MySQL instance. The following options are available: tcpip: default value. socket: unavailable on Microsoft Windows platforms.
--proxyport	Sets the port the Proxy listens on for incoming connections. Default value is 6446.
--mysqlhost	Sets the hostname or IP address of the monitored MySQL instance. Default value is localhost.
--mysqlport	Sets the port of the monitored MySQL instance. Default value is 3306.
--mysqlsocket	Sets the socket used by the monitored MySQL instance.
Aggregator-specific Options
--aggregatorservicename	Sets the unique name for the Aggregator service. Default value is mysql-monitor-aggregator.
--aggregatorport	Sets the port the Aggregator listens on. Default value is 14000.
--aggregatorsslport	Sets the SSL port the Aggregator listens on for secure connections. Default value is 14443.
--aggregatorsslcertfile	Sets the location of the SSL certificate.
--aggregatorsslcafile	Sets the location of the SSL CA file.
--managerhost	Sets the hostname or IP address of the MySQL Enterprise Service Manager installation. Default value is localhost.
--managerport	Sets the SSL port number of the MySQL Enterprise Service Manager's Tomcat installation. Default value is 18443.
--agentuser	Sets the agent username which the Aggregator uses to communicate with the MySQL Enterprise Service Manager. Default value is agent.
--agentpassword	Sets the password of the agent used by the Aggregator.

Unattended Installation from the Command Line

To run the unattended installation from the command line, enter the installer name, followed by the --mode unattended option, followed by the options you want to define. If you do not define an option on the command line, the default value is used, if a default exists. If no default value exists, you must define that value in the configuration after the installation is complete.

The following example installs MySQL Enterprise Monitor Proxy and Aggregator on a Linux platform but changes the MySQL Enterprise Service Manager values:

./mysqlmonitoraggregator-4.0.3.3041-linux-x86-b4bit-installer.bin --mode unattended 
--unattendedmodeui none --managerhost service.manager.com --agentuser Agent100 
--agentpassword D4unKotR

This example changes the following:

• Instructs the installer to display no dialogs of any kind. In this mode, errors are displayed if they occur.

• Sets the MySQL Enterprise Service Manager location to service.manager.com. This is the location of your MySQL Enterprise Service Manager installation. The default ports were not changed.

• Sets the Agent username to Agent100 and the Agent password to D4unKotR.

Unattended Installation with Options File

If you use an options file, add the options you want to change to a text file as name=value pairs. Using the example shown in Unattended Installation from the Command Line, the text file contents are:

      mode=unattended
      unattendedmodeui=none
      managerhost=service.manager.com
      agentuser=Agent100
      agentpassword=D4unKotR

If this file was saved as pa-options.txt, the installation command takes the following format:

./mysqlmonitoraggregator-3.4.5.4541-linux-x86-b4bit-installer.bin --optionfile pa-options.txt