2 Installation and Upgrades
2.4 Unattended Installation
2.4.1 Command-Line Options
To view the available options for the monitor installer or for the agent installer, at the command line type the executable file name along with the --help option.
On each platform, for each installer, the installer supports a number of different installation modes. Some of these are unique to an individual platform, others are available on all platforms. The table below summarizes the different options available for each platform.
Command-Line Options
Platform Default Mode win32 gtk xwindow osx text unattended
Windows win32 Y N N N N Y
Unix gtk N Y Y N Y Y
Linux gtk N Y Y N Y Y
Mac OS X win32 N N N Y Y Y
2.4.1.1 MySQL Enterprise Service Manager Options
The following listing shows the command line options for the 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 Default: win32
Allowed: win32 unattended --debugtrace <debugtrace> Debug filename
Default:
--installer-language <installer-language> Language selection Default:
Allowed: en jp
--installdir <installdir> Installation directory
Default:/opt/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
The options and their effect on installation are detailed below:
• --help
Display the list of valid options.
• --version
Command-Line Options
• --optionfile
The path to the option file containing the information for the installation. • --mode
The installation mode to be used for this installation. • --debugtrace
The filename to be used for a debug trace of the installation. • --installer-language
The installer language; supported options are en for English and jp Japanese. • --installdir
The installation directory for MySQL Enterprise Service Manager.
The default on Windows is C:\Program Files\MySQL\Enterprise\Monitor
The default on Unix is /opt/mysql/enterprise/monitor/
The default on Mac OS X is /Applications/mysql/enterprise/monitor/
• --tomcatport
The MySQL Enterprise Service Manager port; The default is 18080.
• --tomcatshutdownport
The MySQL Enterprise Service Manager Tomcat shutdown port. The default is 18005.
• --tomcatsslport
The MySQL Enterprise Service Manager SSL port. The default is 18443.
• --usessl
Enable support for SSL communication between the MySQL Enterprise Monitor Agent and MySQL Enterprise Service Manager.
The default is 0. • --adminuser
The MySQL Enterprise Service Manager user name. The default is service_manager.
Warning
The repository user name and password are stored in unencrypted form in the config.properties file. To locate this file on your operating system see Section C.5, “The config.properties File”.
Command-Line Options
The MySQL Enterprise Service Manager password.
• --dbport
The TCP/IP port for the Bundled MySQL database.
The default is 13306.
2.4.1.2 MySQL Enterprise Monitor Agent Options
To view all the options available for an unattended agent installation, invoke the agent installer file passing in the help option. (Under Windows you must redirect the output to a file. You should see a listing similar to the following:
Note
The exact options may vary depending on the operating system on which you are executing the installer.
Usage:
--help Display the list of valid options --version Display product information --optionfile <optionfile> Installation option file Default:
--unattendedmodeui <unattendedmodeui> Unattended Mode UI Default: none
Allowed: none minimal minimalWithDialogs --mode <mode> Installation mode
Default: osx
Allowed: osx text unattended --debugtrace <debugtrace> Debug filename
Default:
--installer-language <installer-language> Language selection Default:
Allowed: en ja
--installdir <installdir> Installation directory Default:
--mysqlconnmethod <mysqlconnmethod>
Default: tcpip
Allowed: tcpip socket --mysqlhost <mysqlhost> MySQL hostname or IP address Default: 127.0.0.1
--checkmysqlhost <checkmysqlhost> Validate MySQL hostname or IP address Default: yes
--mysqlport <mysqlport> MySQL Port Default: 3306 --mysqlsocket <mysqlsocket> MySQL Socket Default: --mysqluser <mysqluser> MySQL Username Default:
--mysqlpassword <mysqlpassword> Password for mysql user Default:
Command-Line Options
--enableproxy <enableproxy> Enable Proxy (recommended) Default: 1
--proxyport <proxyport> Proxy Port Default: 6446
--managerhost <managerhost> Hostname or IP address Default:
--managerport <managerport> Tomcat Server Port Default: 18080 --managersslport <managersslport> Tomcat SSL Port Default: 18443 --usessl <usessl> Use SSL? Default: 0 --agentuser <agentuser> Agent Username Default: agent --agentpassword <agentpassword> Agent Password Default: --proxyuser <proxyuser> User Account Default: root
The options and their effect on installation are detailed below: • --help
Display the list of valid options • --version
Display product information, including the version number of the installer. • --optionfile <optionfile>
Specify the location of an option file containing the configuration options for this installation.
• --unattendedmodeui <unattendedmodeui>
The UI elements to use when performing an unattended installation. The options are none, show now UI elements during the installation; minimal, show minimal elements during installation;
minimalWithDialogs, show minimal UI elements, but include the filled-dialog boxes. The default is none.
• --mode <mode>
Specify the installation mode to use for this installation. • --debugtrace <debugtrace>
Set the filename to use when recording debug information during the installation.
• --installer-language <installer-language>
Set the language to be used for the installer. • --installdir <installdir>
Specify the directory where the software will be installed.
Command-Line Options
The default on Unix is /opt/mysql/enterprise/agent/
The default on Mac OS X is /Applications/mysql/enterprise/agent/
• --mysqlconnmethod <mysqlconnmethod>
Specify the connection method to use to connect to MySQL. Options are tcpip and socket.
The default is tcpip.
• --mysqlhost <mysqlhost>
MySQL hostname or IP address The default is 127.0.0.1.
• --checkmysqlhost <checkmysqlhost>
Validate the MySQL hostname or IP address The default is yes.
• --mysqlport <mysqlport>
Specify the TCP/IP port to use when connecting to MySQL. The default is 3306.
• --mysqlsocket <mysqlsocket>
Specify the filename of the MySQL socket to use when communicating with the monitored MySQL instance.
• --mysqluser <mysqluser>
Specify the username to use when connecting to the MySQL instance. • --mysqlpassword <mysqlpassword>
Specify the password to use when connecting to the MySQL instance. • --enableproxy <enableproxy>
Enable the Proxy. This is recommended and is required if you want to use Query Analyzer. The default is 1 (use the proxy).
• --proxyport <proxyport>
Specify the TCP/IP port to use for the proxy interface. The default is 6446.
• --managerhost <managerhost>
The hostname or IP address of the MySQL Enterprise Service Manager. • --managerport <managerport>
The port number of the MySQL Enterprise Service Manager. The default is 18080.
Unattended Windows Installation
• --managersslport <managersslport>
The port number of the MySQL Enterprise Service Manager for SSL-based communication The default is 18443.
• --usessl <usessl>
Specifies whether SSL should be used to communicate with the MySQL Enterprise Service Manager.
• --agentuser <agentuser>
Specify the agent username to be used when communicating with the MySQL Enterprise Service Manager.
• --agentpassword <agentpassword>
Specify the agent password to be used when communicating with the MySQL Enterprise Service Manager.
• --proxyuser <proxyuser>
The user account for the proxy server. The default is root.