gpcc

Manages the Greenplum Command Center web service and metrics collection agents.

gpcc <action> [-W]

gpcc [--version | -v ]

gpcc [--help | -h]

gpcc [--settings]

Actions

start
Starts the Command Center web service and metrics collection agents. Add the -W flag to force a prompt for the gpmon user password.

stop
Stops the Command Center web service and metrics collection agents. Add the -W flag to force a prompt for the gpmon user password.

status
Displays the status, either Running or Stopped, of the web server and metrics collection agents. Add the -W flag to force a prompt for the gpmon user password.

krbenable
Enables Kerberos authentication for Command Center.

Use the gpcc krbenable command to set up Kerberos authentication for Command Center users if Command Center was initially installed without enabling Kerberos. When you run gpcc krbenable, gpcc prompts for:

  • the web server name
  • the name of the Greenplum Database Kerberos service
  • the Command Center Kerberos authentication mode
  • the path to the keytab file on the Command Center host.

Before you run gpcc krbenable, see Enabling Authentication with Kerberos to check prerequisites and for help preparing the Command Center host to allow Kerberos authentication.

krbdisable
Disables Kerberos authentication for Command Center.

help
Displays syntax and help text for the gpcc command.

Options

--settings
Displays the current values of the Command Center configuration parameters. See Setup Configuration File for a list of the configuration parameters.

--version or -v
Displays the Greenplum Command Center version.

-W <password>
The optional -W option specifies the password for the gpmon user. The gpcc command normally gets the password from the $PGPASSWD environment variable or the .pgpass file in the gpadmin user’s home directory. If the password is not available with either of these methods, the -W option must be included to specify the password whenever you run gpcc.

Description

The Greenplum Database MASTER_DATA_DIRECTORY environment variable must be set when you run the gpcc command. This environment variable is usually set in the gpadmin user’s shell initialization script (/home/gpadmin/.bashrc, for example). If you start gpcc without first setting MASTER_DATA_DIRECTORY, the gpmetrics directory could be created in the current directory instead of in the Greenplum Database master data directory. This can cause problems if you later start Command Center with the MASTER_DATA_DIRECTORY variable set properly.

Once started, the Command Center backend monitors the metrics agents with a heartbeat. If a failed agent is detected, the backend spawns a new agent process.

Examples

Start Command Center and the metrics agents, prompting for the gpmon password.

$ gpcc start -W
Password for GPDB user gpmon:
Starting the gpcc agents and webserver…
2018/03/22 17:51:51 Agent successfully started on 7/8 hosts
2018/03/22 17:51:51 View Greenplum Command Center at http://smdw:28080