Documentation Home
MySQL Enterprise Monitor 3.1 Manual
Related Documentation Download this Manual
PDF (US Ltr) - 3.4Mb
PDF (A4) - 3.4Mb
EPUB - 2.0Mb
HTML Download (TGZ) - 1.7Mb
HTML Download (Zip) - 1.8Mb


8.1.2 MySQL Enterprise Service Manager Options

The following options let you customize the installation process for MySQL Enterprise Service Manager. The MySQL Enterprise Service Manager supports using a bundled MySQL server, or a separate MySQL server provided by the user. To use your own MySQL server, the server must be installed and running before installation. For more information, see Section 3.2.3, “MySQL Enterprise Monitor Repository”.

Table 8.1 MySQL Enterprise Service Manager Installer Options

FormatDescription
--adminpasswordPassword for the database repository
--adminuserUsername for the database repository
--backupdirBackup directory path.
--createDataBackupBackup stored data. Upgrade process only.
--dbhostHostname or IP address of the MySQL server
--dbnameName of the repository database.
--dbportTCP/IP port for the MySQL server
--debuglevelSet the debug information level
--debugtraceFile for a debug trace of the installation
--forceRestartUpgrade only. Restarts the services after the upgrade process completes.
--helpDisplay the list of valid options
--installdirInstallation directory
--installer-languageLanguage selection
--modeInstallation mode
--mysql_installation_typeMySQL server to be used by the MySQL Enterprise Monitor
--mysql_sslUse SSL when connecting to the database
--optionfileInstallation option file
--system_sizeDefines Tomcat and MySQL repository configuration based on installation size.
--tomcatportServer port for the Tomcat component
--tomcatshutdownportShutdown TCP/IP port for the Tomcat component
--tomcatsslportSSL TCP/IP port for the Tomcat component
--unattendedmodeuiUnattended mode user interface
--versionDisplay the product information

  • --help

    Command-Line Format--help

    Display the list of valid installer options.

  • --version

    Command-Line Format--version

    Display product and version information.

  • --backupdir

    Command-Line Format--backupdir
    Permitted ValuesTypestring

    Upgrade only. The backup directory.

  • --createDataBackup

    Command-Line Format--createDataBackup
    Permitted ValuesTypeboolean
    Default1
    Valid Values0 (Do not create data backup)
    1 (Create data backup)

    Upgrade only. Specifies whether the upgrade process should create a backup of the existing data. If --backupdir is not defined, a Backup directory is created in the root of the installation directory.

  • --optionfile

    Command-Line Format--optionfile

    The path to the option file containing the information for the installation.

  • --mode

    Command-Line Format--mode
    Permitted Values (Linux)Typestring
    Defaultgtk
    Valid Valuesgtk (GTK (X Windows))
    xwindow (X Windows (native))
    text (Text (command-line))
    unattended (Unattended (no dialogs/prompts))
    Permitted Values (OS X)Typestring
    Defaultosx
    Valid Valuesosx (Mac OS X (native))
    text (Text (command-line))
    unattended (Unattended (no dialogs/prompts))
    Permitted Values (Unix)Typestring
    Defaultxwindow
    Valid Valuesxwindow (X Windows (native))
    text (Text (command-line))
    unattended (Unattended (no dialogs/prompts))
    Permitted Values (Windows)Typestring
    Defaultwin32
    Valid Valueswin32 (Windows (native))
    unattended (Unattended (no dialogs/prompts))

    The installation mode to use for this installation.

  • --debugtrace

    Command-Line Format--debugtrace
    Permitted ValuesTypestring

    The filename to use for a debug trace of the installation.

  • --debuglevel

    Command-Line Format--debuglevel
    Permitted ValuesTypenumeric
    Default2
    Min Value0
    Max Value4

    Set the debug information level for log data written to the file specified by debugtrace.

  • --installer-language

    Command-Line Format--installer-language
    Permitted ValuesTypestring
    Defaulten
    Valid Valuesen (English)
    ja (Japanese)

    The installer language.

  • --installdir

    Command-Line Format--installdir
    Permitted Values (OS X)Typestring
    Default/Applications/mysql/enterprise/monitor/
    Permitted Values (Unix)Typestring
    Default/opt/mysql/enterprise/monitor/
    Permitted Values (Windows)Typestring
    DefaultC:\Program Files\MySQL\Enterprise\Monitor

    The installation directory for MySQL Enterprise Service Manager, or the previous installation directory when performing an update. Installation only. It is not possible to change the installation directory in an upgrade.

  • --system-size

    Command-Line Format--system_size
    Permitted ValuesTypestring
    Defaultmedium
    Valid Valuessmall (5 to 10 MySQL Servers monitored from a laptop or low-end server with no more than 4GB of RAM.)
    medium (Up to 100 MySQL Servers monitored from a medium-sized, but shared, server with 4 to 8GB of RAM.)
    large (More than 100 MySQL Servers monitored from a high-end, dedicated server, with more than 8GB RAM.)

    Defines the installation type. This choice sets parameters which suit your installation type. Installation only. It is not possible to change the system size in an upgrade.

  • --tomcatport

    Command-Line Format--tomcatport
    Permitted ValuesTypenumeric
    Default18080

    The TCP/IP port for the MySQL Enterprise Service Manager. This port is used by MySQL Enterprise Monitor Agent and as the port for the interface to the MySQL Enterprise Monitor User Interface. Installation only. It is not possible to change the Tomcat port in an upgrade.

  • --tomcatsslport

    Command-Line Format--tomcatsslport
    Permitted ValuesTypenumeric
    Default18443

    The TCP/IP port to use for SSL communication to the MySQL Enterprise Service Manager. Installation only. It is not possible to change the Tomcat SSL port in an upgrade.

  • --mysql-identity-source

    Command-Line Format--mysql-identity-source
    Permitted ValuesTypestring
    Defaultdefault
    Valid Valuesdefault (Default)
    host_plus_datadir (host_plus_datadir)

    The mechanism used to generate a unique identity for the MySQL instance if one does not already exist. Passing in "default" uses either the "server_uuid" variable if present, or generates a random new one. Passing in "host_plus_datadir" uses a hash of the host identity and the path to the MySQL instance's data directory, to create a unique identity.

    Note

    This option is only available in unattended installation mode.

    Note

    host_plus_datadir is not allowed when the Agent is remote monitoring a MySQL instance, as MySQL Enterprise Monitor is unable to definitively compute a known-unique host identity in this case.

  • --mysql_ssl

    Command-Line Format--mysql_ssl
    Permitted ValuesTypeboolean
    Default0
    Valid Values0 (Do not use SSL when connecting to the database)
    1 (Use SSL when connecting to the database)

    Use SSL when connecting to the database.

  • --adminuser

    Command-Line Format--adminuser
    Permitted ValuesTypestring
    Defaultservice_manager

    The user name to use for connecting to the database repository used by MySQL Enterprise Service Manager. If you install the bundled MySQL server, this user is configured in the new database. If you use an existing MySQL server, specify an existing user with rights to access the database.

    Note

    The repository user name and encrypted password are stored in the config.properties configuration file.

  • --unattendedmodeui

    Command-Line Format--unattendedmodeui
    Permitted ValuesTypestring
    Defaultnone
    Valid Valuesnone (No dialogs)
    minimal (Critical dialogs)
    minimalWithDialogs (Minimal UI with dialogs)

    The UI elements to use when performing an unattended installation. The options are none, show no UI elements during the installation; minimal, show minimal elements during installation; minimalWithDialogs, show minimal UI elements, but include the filled-dialog boxes.

  • --adminpassword

    Command-Line Format--adminpassword
    Permitted ValuesTypestring

    The MySQL Enterprise Service Manager password for connecting to the MySQL database repository.

  • --mysql_installation_type

    Command-Line Format--mysql_installation_type
    Permitted ValuesTypestring
    Defaultbundled
    Valid Valuesbundled (Use the bundled MySQL server)
    existing (Use an existing (user supplied) MySQL server)

    Specifies whether the installer should configure MySQL Enterprise Service Manager to install the bundled MySQL server, or use a MySQL server that you have already installed to store the repository data.

  • --dbport

    Command-Line Format--dbport
    Permitted ValuesTypenumeric
    Default13306

    The TCP/IP port for the MySQL database used to store MySQL Enterprise Service Manager repository data. If you install the bundled MySQL server, this is the port where the new database listens for connections. If you use an existing MySQL server, specify the port used for connections by that MySQL server.

  • --dbhost

    Command-Line Format--dbhost
    Permitted ValuesTypestring
    Default127.0.0.1

    The hostname for the MySQL database. When installing MySQL Enterprise Service Manager to use an existing MySQL server, this should be the hostname of the server that will store the database repository.

  • --dbname

    Command-Line Format--dbname
    Permitted ValuesTypestring
    Defaultmem

    The name of the MySQL Enterprise Service Manager repository.

  • --forceRestart

    Command-Line Format--forceRestart
    Permitted ValuesTypeboolean
    Default0
    Valid Values0 (Do not restart services)
    1 (Restart services)

    Force a restart of MySQL Enterprise Service Manager services.


User Comments
Sign Up Login You must be logged in to post a comment.