Documentation Home
MySQL Enterprise Monitor 3.0 Manual
Related Documentation Download this Manual
PDF (US Ltr) - 5.7Mb
PDF (A4) - 5.7Mb
EPUB - 3.8Mb
HTML Download (TGZ) - 3.6Mb
HTML Download (Zip) - 3.7Mb


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

Format Description Removed
--adminpassword Password for the database repository
--adminuser Username for the database repository
--backupdir Backup directory path.
--createDataBackup Backup stored data. Upgrade process only.
--dbhost Hostname or IP address of the MySQL server
--dbname Name of the repository database.
--dbport TCP/IP port for the MySQL server
--debuglevel Set the debug information level
--debugtrace File for a debug trace of the installation
--forceRestart Upgrade only. Restarts the services after the upgrade process completes.
--help Display the list of valid options
--installdir Installation directory
--installer-language Language selection
--mode Installation mode
--mysql_installation_type MySQL server to be used by the MySQL Enterprise Monitor
--mysql_ssl Use SSL when connecting to the database
--optionfile Installation option file
--system_size Defines Tomcat and MySQL repository configuration based on installation size.
--tomcatport Server port for the Tomcat component
--tomcatshutdownport Shutdown TCP/IP port for the Tomcat component 3.0.3
--tomcatsslport SSL TCP/IP port for the Tomcat component
--unattendedmodeui Unattended mode user interface
--version Display 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 Values Type string

    Upgrade only. The backup directory.

  • --createDataBackup

    Command-Line Format --createDataBackup
    Permitted Values Type boolean
    Default 1
    Valid Values 0 (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) Type string
    Default gtk
    Valid Values gtk (GTK (X Windows))
    xwindow (X Windows (native))
    text (Text (command-line))
    unattended (Unattended (no dialogs/prompts))
    Permitted Values (OS X) Type string
    Default osx
    Valid Values osx (Mac OS X (native))
    text (Text (command-line))
    unattended (Unattended (no dialogs/prompts))
    Permitted Values (Unix) Type string
    Default xwindow
    Valid Values xwindow (X Windows (native))
    text (Text (command-line))
    unattended (Unattended (no dialogs/prompts))
    Permitted Values (Windows) Type string
    Default win32
    Valid Values win32 (Windows (native))
    unattended (Unattended (no dialogs/prompts))

    The installation mode to use for this installation.

  • --debugtrace

    Command-Line Format --debugtrace
    Permitted Values Type string

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

  • --debuglevel

    Command-Line Format --debuglevel
    Permitted Values Type numeric
    Default 2
    Min Value 0
    Max Value 4

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

  • --installer-language

    Command-Line Format --installer-language
    Permitted Values Type string
    Default en
    Valid Values en (English)
    ja (Japanese)

    The installer language.

  • --installdir

    Command-Line Format --installdir
    Permitted Values (OS X) Type string
    Default /Applications/mysql/enterprise/monitor/
    Permitted Values (Unix) Type string
    Default /opt/mysql/enterprise/monitor/
    Permitted Values (Windows) Type string
    Default C:\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 Values Type string
    Default medium
    Valid Values small (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 Values Type numeric
    Default 18080

    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 Values Type numeric
    Default 18443

    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 Values Type string
    Default default
    Valid Values default (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 Values Type boolean
    Default 0
    Valid Values 0 (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 Values Type string
    Default service_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 (you must remember it), are stored in the config.properties configuration file. To locate this file on your operating system, see Section D.1.3, “The config.properties file”.

  • --unattendedmodeui

    Command-Line Format --unattendedmodeui
    Permitted Values Type string
    Default none
    Valid Values none (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 Values Type string

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

  • --mysql_installation_type

    Command-Line Format --mysql_installation_type
    Permitted Values Type string
    Default bundled
    Valid Values bundled (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 Values Type numeric
    Default 13306

    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 Values Type string
    Default 127.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 which hosts the MySQL Enterprise Service Manager repository.

  • --dbname

    Command-Line Format --dbname
    Permitted Values Type string
    Default mem

    The name of the MySQL Enterprise Service Manager repository.

  • --forceRestart

    Command-Line Format --forceRestart
    Permitted Values Type boolean
    Default 0
    Valid Values 0 (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.