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 Command Center Console Parameters 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 MASTER_DATA_DIRECTORY is not set when you run gpcc start, gpcc prints an error message and exists.

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
check-circle-line exclamation-circle-line close-line
Scroll to top icon