gpperfmon_install
Installs the Command Center database (gpperfmon) and optionally enables the data collection agents.
gpperfmon_install --port <gpdb_port>
[--enable --password <gpmon_password> [--pgpass <path_to_file>] [–verbose]
gpperfmon_install --help | -h | -?
Option | Description |
---|---|
–enable | In addition to creating the gpperfmon database, performs the additional steps required to enable the Command Center data collection agents. When --enable is specified the utility also creates and configure the gpmon superuser account and sets the Command Center server configuration parameters in the postgresql.conf files. |
–password gpmon_password | Required if --enable is specified. Sets the password of the gpmon superuser |
–port gpdb_port | Required. Specifies the connection port of the Greenplum Database master. |
–pgpass path_to_file | Optional if --enable is specified. If the password file is not in the default location of ~/.pgpass , specifies the location of the password file. |
–verbose | Sets the logging level to verbose. |
–help | -h | -? | Displays the online help. |
Description
The gpperfmon_install
utility automates the steps to enable the Command Center data collection agents. You must be the Greenplum system user (gpadmin
) to run this utility. If using the --enable
option, the Greenplum Database instance must be restarted after the utility completes.
When run without any options, the utility just creates the Command Center database (gpperfmon). When run with the --enable
option, the utility also performs the following additional tasks necessary to enable the Command Center data collection agents:
- Creates the
gpmon
superuser role in Greenplum Database. The Command Center data collection agents require this role to connect to the database and write their data. Thegpmon
superuser role uses MD5-encrypted password authentication by default. Use the –password option to set thegpmon
superuser’s password. Use the--port
option to supply the port of the Greenplum Database master instance. Updates the
$MASTER_DATA_DIRECTORY/pg_hba.conf
file. The utility adds the following lines to the host-based authentication file (pg_hba.conf
). This allows thegpmon
user to locally connect to any database using MD5-encrypted password authentication:local gpperfmon gpmon md5 host all gpmon 127.0.0.1/28 md5 host all gpmon ::1/128 md5
Updates the password file (
.pgpass
). In order to allow the data collection agents to connect as thegpmon
role without a password prompt, you must have a password file that has an entry for thegpmon
user. The utility adds the following entry to your password file (if the file does not exist, the utility creates it):*:5432:gpperfmon:gpmon:gpmon_password
If your password file is not located in the default location (
~/.pgpass
), use the--pgpass
option to specify the file location.Sets the server configuration parameters for Command Center. The following parameters must be enabled in order for the data collection agents to begin collecting data. The utility sets the following parameters in the
postgresql.conf
configuration files:-
gp_enable_gpperfmon=on
(in allpostgresql.conf
files) -
gpperfmon_port=8888
(in allpostgresql.conf
files) -
gp_external_enable_exec=on
(in the masterpostgresql.conf
file)
-
Greenplum Command Center requires the gpmon role and the gpperfmon database to use the host’s default timezone. If you have already changed the default timezone for gpmon or gpperfmon, execute the following commands in `psql` to reset them.
alter user gpmon reset timezone;
alter database gpperfmon reset timezone;
Then restart the Greenplum Command Center instance:
$ gpcmdr --restart <instance-name>
Examples
Create the Command Center database (gpperfmon
) only:
$ su - gpadmin
$ gpperfmon_install --port 5432
Create the Command Center database (gpperfmon
), create the gpmon
superuser, and enable the Command Center agents:
$ su - gpadmin
$ gpperfmon_install --enable --password changeme --port 5432
$ gpstop -r