Greenplum® Command Center 4.10.0 Release Notes

Updated 5/30/2020

About This Release

This document contains release information about Pivotal Greenplum Command Center 4.10.0. Greenplum Command Center 4.10.0 adds new features to Greenplum Command Center and resolves some issues.

See Enhancements and Changes in Greenplum Command Center 4.10.0 for information about new features and changes in this Command Center release.

Supported Platforms

Greenplum Command Center 4.10.0 is compatible with the following platforms.

  • Pivotal Greenplum Database 5.19 and above. (Greenplum Database 6 requires Command Center 6.x.) See Pivotal Greenplum Command Center Supported Platforms for the most current Greenplum Command Center and Greenplum Database compatibility information.
  • Red Hat Enterprise Linux 6.x1 and 7.x
  • CentOS 6.x1 and 7.x
  • SUSE Enterprise Linux 11 SP42

1If you use resource groups and workload management on Red Hat or CentOS 6.x, upgrade your kernel to 2.6.32-696 or higher to benefit from improvements in the Linux cgroups service.

2Greenplum Command Center workload management features are not supported on SUSE Enterprise Linux 11.

Enhancements and Changes in Greenplum Command Center 4.10.0

Command Center Installation Changes

Command Center directory names have changed to omit -web.

  • The Command Center installation directory name changed from greenplum-cc-web-<version> to greenplum-cc-<version>, for example /usr/local/greenplum-cc-4.9.0.

  • The Command Center installer creates a symbolic link greenplum-cc to the Command Center home directory if gpadmin has write permission in the installation directory. If the directory already exists, the link is recreated to link to the new Command Center installation directory. Use the link to access the file in your shell startup script to ensure that you access the most recent installation. For example, add this line to your .bashrc or .bash_profile file:

    source /usr/local/greenplum-cc/
  • If the installation directory is not writable by the gpadmin user, you can create the directory and symbolic link and set the owner to gpadmin before you run gpccinstall.

  • You can run more than one Command Center instance on the same host. For example, if you run a Greenplum Database 5.x system and a Greenplum Database 6.x system on the same cluster, you can install Command Center instances for each system on the same master host. This feature is supported on Greenplum Database 5.28.0 or higher.

    Before you run the installer, choose the Greenplum Database instance by sourcing the environment file ( You must manually edit the $GPCC_HOME/app.conf file for each additional Command Center instance you want to run to choose different port numbers for the httpport, httpsport, rpcport, ws_perf_port, and agent_perf_port parameters.

Recommendations Feature

The new Recommendations feature helps to identify Greenplum Database tables that require maintenance to reduce bloat, improve accuracy of query plans, and reduce skew that affects query performance.

  • Schedule a table scan to run at a designated time and for a specified period of time. The scan can be scheduled to repeat daily or weekly on selected days of the week.
  • Command Center runs queries to collect information about tables, processing as many tables as it can during the scheduled period. The next scan resumes where the previous scan left off. Collected data is saved in the new gpmetrics.gpcc_table_info and [gpmetrics_table_info_history](../topics/ref-gpmetrics.html#gpcc_table_info_history] tables in the gpperfmon database.
  • The Recommendations page lists scanned tables in ranked order with recommendations to VACUUM, VACUUM FULL, ANALYZE, or redistribute tables.

See Recommendations for more information about the Recommendations feature.

I/O Wait Metrics

Command Center now collects CPU IOWait metrics. You can view IOWait metrics on the Host Metrics, Cluster Metrics, and History pages.

  • On the Host Metrics page, the CPU column value is the total of System, User, and IOWait percentages. The chart and pop-up box break out the System, User, IOWait, and Idle percentages separately.

  • On the Cluster Metrics and History pages, the CPU chart shows System and User percentages. The IOWait percentage is included in the System percentage, as in previous Command Center versions. The new IOWait chart shows just the percentage of CPU time spent in IOWait.

Workload Management Improvements

You can now set Memory Spill Ratio % for resource groups on the Workload Management page. Transactions spill to disk when they reach this threshold.

While editing resource group attributes, Command Center recalculates and displays Statement Memory, the amount of memory allocated to a query for each resource group.

See Workload Management for more information about these features.

gpcc stop Utility

  • If the Greenplum system is down, running the gpcc stop command will stop the Command Center agent and web server processes.

Fixed Issues

  • When a query called a UDF that runs an inner query, the top level query could be missing in the Query Monitor view and in query history. This caused some columns in the Query Monitor view to display - instead of the correct value. This issue is fixed.

  • The disk IO read/write calculations in gpcc_system_history and the Cluster Metrics page included R/W rates for multiple devices on the same physical disk. This is fixed. The disk IO read/write rate calculations now exclude:

    • partitions of disk
    • dm (device-mapper)
    • loop device
    • md (multi-device such as raid)

The reported disk IO rate is now the same as the actual IO rate of the physical disk.

  • On the System ⟩ Storage page, values displayed as terrabytes (TB) were incorrectly converted from gigabytes (GB) by dividing by 1000. This is fixed. Values greater than 1024GB are correctly converted to TB by dividing by 1024.

  • Security vulnerability fixes have been added to prevent ClickJacking Attacks and to deny use of risky HTTP request methods.

  • The Running, Queued, and Blocked query counts on the Dashboard were misleading because they were not the current status at the time you were viewing the Dashboard, but the status about 15 seconds earlier. The numbers have been removed to avoid confusion. To view current numbers, go to the real-time Query Monitor by clicking the query graph from the Dashboard.

    • A Disk Full alert was raised when the total disk space for all hosts in the cluster exceeded the threshold. Now an alert is raised if disk usage for any host exceeds the threshold. The alert email includes the name of the host that triggered the alert.
    • The backend scan for the table browser periodically connected to the template1 database. This could prevent a user from creating a new database, because CREATE DATABASE is not allowed when there are any connections to the template1 database. This issue has been fixed. The template1 database is omitted from the backend scan.

Enhancements and Changes in Greenplum Command Center 4.9.0

Command Center Installation Changes

  • The Command Center release download file names have changed to include the Greenplum Database major version, for example

  • The Command Center installer creates four entries in the pg_hba.conf authentication file for the gpmon role if there are no existing gpmon entries.

    local      gpperfmon     gpmon                 md5
    host       all           gpmon   md5
    host       all           gpmon  ::1/128        md5
    host       all           gpmon  samenet        md5

    The samenet entry is new in this release, and the installer will add it to the pg_hba.conf file even when there are existing entries for the gpmon role.

    Note that the Table Browser feature requires all in the database field of the host entries so that gpmon can retrieve table information from each database.

    If you use an authentication method other than md5 for the gpmon user, such as LDAP or Kerberos, edit the pg_hba.conf file to enable connections from all hosts and access to all databases.

Command Center History Data Collection Changes

  • The Command Center version 4.9.0 installer enables History Data Collection.

  • If the gp_enable_gpperfmon Greenplum Database server configuration parameter is on, the Command Center installer sets it to off. You must restart Greenplum Database for this change to take effect.

    Note: Pivotal recommends that you do not use the Greenplum Database gpperfmon service while running Greenplum Command Center because of its effects on Greenplum Database performance.

  • The history_enabled property in the $MASTER_DATA_DIRECTORY/gpmetrics/gpcc.conf file is deprecated and the installer will comment it out if it is present. A new property enable_history is added to the $GPCC_HOME/conf/app.conf configuration file. The default is true. If you disable history data collection on the Command Center Admin> Settings page, enable_history = false is written in the app.conf file.

New and Changed Features

  • A new Table Browser is added to allow administrators to see information about tables in Greenplum Databases. Tables displayed can be filtered by database, schema, owner, and size. The Command Center interface provides details about tables, including table storage types, distribution policies, partitions, sizes, and last access times. It lists recent queries that have accessed the table, with links into the Command Center query history. Notably, the Table Browser displays only metadata for tables; it does not provide access to data stored in tables.

    Note: When you first start Command Center after installing this version, Command Center loads data into the new gpmetrics.gpcc_table_info table in the gpperfmon database. For databases with large numbers of tables, the initial load could take five minutes or longer. Table data will not be available in the Table Browser until it has been loaded.

  • The table browser uses two new tables in the gpmetrics schema: gpcc_table_info and gpcc_table_info_history. See gpmetrics Schema Reference for information about the contents of these tables.

  • The Command Center web server (gpccws) memory consumption is much improved compared to earlier Command Center versions.

  • On the History page, the count of running queries at any point on the Queries graph now includes queries that started and finished in the interval since the previous metrics sample. A new queries_finished column is added to the gpmetrics.gpcc_database_history table to record this count.

  • The metrics collector extension adds a new gpcc.enable_query_profiling server configuration parameter that can be enabled to help with performance troubleshooting. When off, the default, the metrics collector does not collect queries executed by the gpmon user in the gpperfmon database or plan node history for queries that run in less than ten seconds (or min_query_time, if it is set and greater than ten seconds). If you enable gpcc.enable_query_profiling in a session the metrics collector collects those queries. This parameter is introduced in the metrics collector extension included with Greenplum Database 5.24.0 and is not available in earlier Greenplum Database releases.

  • Each night, Command Center archives files in the $GPCC_HOME/ccdata directory that are more than two weeks old. The files in this directory include saved query text files (q*.txt), plan node files (gpccexec*.txt), and table size and statistics information files (gpcc_size_info.dat and gpcc_stat_info.dat). Archive files have names in the format archive_YYYYMMDD_YYYYMMDD.tar.gz, where the dates are the beginning and end dates of the week included in the archive. The archived files are no longer needed by Command Center but may be useful for troubleshooting; you can remove them manually if you do not want to save them.

Resolved Issues

  • [MPP-30259] The gpmetrics.gpcc_plannode_history table definition changed in Command Center 4.7. When upgrading from Command Center 4.4.x, 4.5.x, or 4.6.x to Command Center 4.7.x or 4.8.x, the installer did not upgrade the definition of the existing table. This resulted in a failure to harvest data to the gpcc_plannode_history table. This is fixed. Upgrading from a Command Center version earlier than 4.7 to Command Center 4.9 updates the gpcc_plannode_history table definition in the gpmetrics schema.

  • When a Command Center user signs out of Command Center, the Welcome page is displayed, but the message “Checking DB status…” is displayed for several seconds before the login form is presented. This is fixed. If there are no errors the login form is now displayed immediately.

  • The rightmost edge of system metrics graphs could drop to zero if the metrics data for that period was not yet available to display. This is fixed by cutting the time axis on the right edge of metrics graphs to the last period with available data. As a result of this fix, the time period displayed at the right edge of a graph can be slightly earlier than the last sync time displayed at the top of the page.

  • Users with self-only permissions could see other users’ query history. In Command Center 4.9 users with self-only permission have no access to the query history page, so they cannot see their own or others’ query history. Self-only users will be allowed access to their own query history in a future Command Center release.

  • The script in the $MASTER_DATA_DIRECTORY/gpmetrics directory had a bug that caused some values to be incorrectly expanded when substituted into the template. This is fixed by replacing all occurrences of $ARGUMENT with ${ARGUMENT} in the script. You can implement the same fix if you have created a custom script.

  • The Command Center Storage Status page did not display tablespaces with locations other than pg_default or pg_global. This is fixed. Expanding a hostname now shows each tablespace location. Hovering over the tablespace location displays a pop-up with a list of the data directories at that location. Data directories may not be displayed until Command Center has refreshed the Storage Status page, which occurs every four hours.

  • Transaction performance issues could occur when the workload manager gp_wlm extension was loaded in Greenplum Database and the Command Center workload management feature was not enabled. This is fixed in the gp_wlm extension included with Greenplum Database 5.24.0. For earlier versions of Greenplum Database, you can use one of the following methods to work around the problem:

    • If you are using Greenplum Database resource groups, enable Workload Management in the Greenplum Command Center.
    • If you are using Greenplum Database resource queues for workload management, remove the gp_wlm shared library from the shared_preload_libraries server configuration variable.
    $ gpconfig -s shared_preload_libraries
    Values on all segments are consistent
    GUC          : shared_preload_libraries
    Master  value: metrics_collector,$libdir/gp_wlm
    Segment value: metrics_collector,$libdir/gp_wlm
    $ gpconfig -c shared_preload_libraries -v 'metrics_collector'
    $ gpstop -ar

Enhancements and Changes in Greenplum Command Center 4.8.0

New Features and Changes

  • The Enable GPCC history data collection option on the Admin> Settings page is now on by default. If you turned off this option in your current Command Center installation and you upgrade to Command Center 4.8.0, the option will remain off. Pivotal recommends that you turn it on.

  • Command Center can collect all metrics without the Greenplum Database gpperfmon service. For lower overhead, stop the gpperfmon service if it is running. Set the gp_enable_gpperfmon server configuration parameter to off and restart Greenplum Database.

  • If you include the -W option with the gpccinstall command, the installer prompts you to enter the password for the gpmon role. If the gpmon role does not already exist, the installer creates it with the password you specify. Without the -W option, the installer creates the gpmon role with the default password “changeme”.

  • The installer has a new -u (upgrade) option that installs Command Center using the configuration parameters from the current Command Center installation. You can use this option to reinstall the same version of Command Center or to upgrade to a newer version.

  • Japanese and Russian language options have been added to the Command Center installer.

  • When canceling one or more queries in the Command Center UI, a pop-up box prompts you to enter a message of up to 128 characters to add to the error message that is displayed to the user.

  • On the System> Storage Status view, when you expand a Hostname, the Data Directory column now lists the mount points of partitions on the segment host file system that contain Greenplum segment data directories. When you move your cursor over a mount point, a tooltip lists the data directories the partition contains.

  • History query search performance is greatly improved.

  • Newly created partitions for history tables in the gpmetrics schema will be created with RLE compression and the COMPRESSLEVEL=2 option, for improved compression/performance. Existing partitions are not changed.

  • The Command Center web server now supports only the TLSv1.2 protocol and above for secured connections.

  • Logging improvements. A new log_level parameter in the $GPCC_HOME/conf/app.conf configuration file determines the level of messages that will be logged. The parameter specifies which messages are added to these log files: gpccinstall.log, webserver.log, agent.log, and cli.log.

    The parameter can be set to Debug, Info, or Error, where Debug is the most verbose and Error is the least verbose. The parameter values are not case-sensitive. The default is Info.

Fixed Issues

  • [#166658749] - If the MASTER_DATA_DIRECTORY environment variable is not set when gpcc start is run, the gpmetrics directory is created in the current directory. This issue is resolved. If the MASTER_DATA_DIRECTORY is not set, the gpcc start command will print a message and exit.

  • [#166346339] - If CPUSET is enabled for a resource group, the CPU% value is changed to -1. This value prevented editing resource groups in Command Center. Command Center now accepts a -1 value.

  • [#167156751] - Query text files in the $MASTER_DATA_DIRECTORY/gpmetrics/query_text directory were not cleaned up automatically. This issue is fixed.

  • [MPP-29944] - When Command Center is configured to use Kerberos authentication with the user id as the Command Center user, a query cancelled by the user was logged as cancelled by the gpmon user. This is fixed. If the optimizer is set to GPORCA, an extra message, “Feature not supported: SIRV functions”, is logged. This is a known issue.

Enhancements and Changes in Greenplum Command Center 4.7.0

Greenplum Command Center 4.7.0 contains the following new changes and features.

Command Center Installation New Features and Changes

  • The gpccinstall installation utility now writes details of the installation to the installation log file, gpccinstall.<timestamp>.log. Previously, the log contained a success message or any errors that prevented a successful message. The log now contains the values for the parameters used during the Command Center installation.

  • The gpccinstall utility must be run by the gpadmin user and the installation directory must be writable by the gpadmin user. The option to install Command Center as root and change ownership of the installed files to gpadmin is not supported because the root user cannot connect to Greenplum Database.

  • The new gpccinstall -auto option performs a non-interactive installation, using default values for all of the installation parameters.

  • Added the Korean language option for the Command Center User Interface.

  • It is now recommended to run Command Center on the master host, instead of the standby master host. Saving plan node history, a new feature in this Comand Center release, can generate a large number of messages between the agent running on the master host and the Command Center backend. Running Command Center on the master host keeps this traffic off of the LAN.

gpmetrics Schema Changes

  • When real-time metrics collection is enabled, Command Center saves execution plan node details to the gpmetrics.gpcc_plannode_history table in the gpperfmon database. Details are only saved for queries that execute for at least 10 seconds. The data in this table enable you to view visual query execution plan details when you select a query in the History view.

Query Monitor and History Changes

  • A Planner field is added to the Query Monitor Details view to identify the planner used to plan the query, either GPORCA or Legacy.

  • The detail for a query in the History view includes a visual query execution view that shows the actual rows returned for each plan node. History

  • The visual plan for a query in the Query Monitor shows the Estimated Progress for the query, a calculated percentage using the query plan’s cost estimate for each plan node and the actual rows vs. estimated rows for each node.


  • When sending alert emails, Command Center can authenticate with the SMTP server using NONE, PLAIN, LOGIN, or CRAM-MD5 authentication.

  • The Username and Password fields in the Manage email configuration section of the Alerts page are now optional. These fields are only needed if the SMTP server requires them for authentication.

Logging Changes

  • Every hour, Command Center logs the number of queries that were not saved to the gpmetrics history in the previous hour because they completed in less time than than the threshhold time specified on the Admin> Settings page. The message is logged in the logs/webserver.log file in the Command Center installation directory.

Fixed Issues

  • 165236914 - The gpcc command-line utility did not work with the -W option. This has been fixed. The gpcc command will use the gpmon password entered by the user when the -W option is supplied. If the -W option is not supplied, gpcc will use the PGPASSWORD environment variable, if set, or the .pgpass file in the gpadmin user’s home directory.

  • 165111508 - LDAP authentication fails because Command Center improperly encodes the username in the Greenplum connection string. This is resolved. Command Center correctly escapes the username in the connection string.

  • 164620455 - The Command Center agent memory usage and CPU usage grew very high when executing a query with an inner query. The inner query generated many small queries, sending a large number of packets to the metrics collector. This is fixed. Inner queries are marked so that metrics are not collected for them.

  • 164818798 - When Workload Manager terminates an idle connection, a FATAL error and stack trace were logged. Now Workload Manager logs a WARNING message with no stack trace when an idle connection is terminated.

  • 164263538, 164718926 - Command Center does not show query information for a COPY command, such as COPY <table> FROM STDIN;. The Command Center Query Monitor now displays available information for some COPY commands. A COPY command run by a non-superuser role can be controlled by a resource queue if the resource queue’s ACTIVE_STATEMENTS parameter specifies a maximum limit for the number of queries that can be executed by roles assigned to the queue. (Greenplum Database does not assign cost or memory values to COPY commands, so a COPY command with no ACTIVE_STATEMENTS parameter is not managed by a resource queue.) In Command Center, COPY commands managed by resource queues will now appear in the Query Monitor with available activity information. Command Center caches roles’ resource queue names and, for these commands, the resource queue name is displayed from the cache. If a role has been recently assigned a different resource queue, the cache may be out of date. See Known Issues for more information.

  • 164346696 - Command Center does not display more than one filespace per host. This has been fixed in Command Center.

  • 165589279 - The Command Center Dashboard displayed UTC time when the Europe/Moscow timezone was set in the OS and Greenplum Database. The root cause of this issue is that Greenplum Database 5 does not handle the MSK time zone properly. This is fixed in Command Center and issue 7543 has been opened for Greenplum Database.

Enhancements and Changes in Greenplum Command Center 4.6.0

Greenplum Command Center 4.6.0 contains the following new features:

Display Language Selection

The Greenplum Command Center user interface has been updated with localization support. At installion time, you can choose the language to use in the Command Center user interface. Command Center currently supports English (default) and Chinese languages.

gpmetrics History Schema (Beta)

The Command Center history views currently draw data from the Greenplum Database gpperfmon database, which has a data collection process that is separate from the Command Center real-time metrics collection system.

In this release, you can enable saving data from the real-time metrics collection system to history tables in the gpmetrics schema. When you enable this feature, Command Center uses the gpmetrics history tables to display history data in the user interface. This is a new feature, currently considered experimental. In a future release, the gpmetrics tables will be the only source for history data and Command Center will no longer depend upon the gpperfmon database.

To enable gpmetrics history, visit the Admin> Settings view in Command Center. In addition to enabling history collection, you can set the minimum run-time for queries to be saved in history.

See the gpmetrics Schema Reference for information about the tables in the gpmetrics schema.

Enhancements and Changes in Greenplum Command Center 4.5.0

Greenplum Command Center 4.5.0 contains the following new features:

Alert Rules

On the new Admin> Alerts page, Command Center users with superuser permission can configure alert rules. When an alert rule is matched, a record is logged in the gpmetrics.gpcc_alert_log table and, optionally, an email is sent to a list of addresses you specify. You can also write a custom shell script to send alerts to other messaging systems.

Alert rules can detect the following events:

  • Segment failure
  • Out of memory errors
  • Average memory usage percentage of segment hosts exceeds a specified percentage for a specified number of minutes
  • Memory usage on the master host exceeds a specified percentage for a specified number of minutes
  • Total disk space used on all hosts exceeds a specified percentage
  • Number of Greenplum Database connections exceeds a specified percentage
  • Average CPU usage of segment hosts exceeds a specified percentage for a specified number of minutes
  • Spill files for an active query exceed a specified number of gigabytes
  • Runtime for a query exceeds a specified number of minutes
  • A query is blocked for more than a specified number of minutes

Query Text Download for Long Queries

On the Query Details page, if the query text is longer than 100K characters, Command Center only shows the first 100K characters and, when you click COPY, copies only the first 100K characters to the clipboard. When the query text is longer than 100K characters, Command Center adds a button, Retrieve full query text, which you can click to download a text file containing the entire text of the query. The file is available to download for 24 hours, or until the query is saved to history, when history collection is enabled.

Fixed Issues

  • 161436520 - Panels displaying help text can now be scrolled vertically when the text does not fit in the window.

  • 158278655 - The displayed metrics for a query could be inaccurate if Command Center received the query “done” status before the final metrics arrived. Now the final metrics are updated even when they arrive after the “done” status.

  • 161074984 - Repeated assertion errors logged in the agent.log file caused log files to grow quickly and consume too much disk space. This is fixed. Each type of assertion error will be logged no more than once every 10 minutes.

  • 162114428 - When a user visits Command Center with a browser, the Command Center web server (gpccws process) establishes a websocket connection and runs two goroutines to service the websocket. When the websocket closes, one of the goroutines does not exit. After many connections the gpccws process can occupy gigabytes of memory. This memory leak is fixed.

Enhancements and Changes in Greenplum Command Center 4.4.2

  • The Greenplum Database metrics collector extension is now enabled only when Command Center agents are running. Previously, if an agent process terminated, the metrics collector continued to collect and send data.

Greenplum Command Center 4.4.2 contains the following resolved issues:

  • 160195564 - When Command Center is restarted after a user has submitted a query, and the user submits another query in the same session, the database name and user name are missing from the second query in the Command Center interface. This is fixed.

  • 161077294 - The Authentication view now prevents the user from saving an undefined entry to the pg_hba.conf file.

  • 161274227 - The Command Center installer, gpccinstall, no longer prints errors to the pg_log log file about missing iterators and emc_connect_history tables.

  • 161273865 - The Query Monitor no longer shows runtimes flashing to 0 seconds when a query is cancelled through the user interface.

Enhancements and Changes in Greenplum Command Center 4.4.1

  • The Admin> Authorization view allows entering host names in the Address field.

  • On the visual query plan, a data motion showed a finished status when the send data operation completed. This is changed so that the node completes only after the corresponding data receive operation has also completed.

  • Enabled cross-site request forgery prevention during login.

Resolved Issues in Greenplum Command Center 4.4.1

  • 160679694 - If Command Center is restarted while on the Query Monitor view and the browser is then refreshed, an extra web socket connection is created. This is fixed.

  • MPP-29539 - Command Center agent (ccagent) logging is disabled for a known issue with PL/pgSQL queries.

Enhancements and Changes in Greenplum Command Center 4.4.0

Greenplum Command Center 4.4.0 contains the following features and enhancements.

Workload Management

  • Command Center has a new user interface to assist administrators in enabling resource groups in Greenplum Database, importing existing resource queues to resource groups, and enabling workload management with Command Center. The option to import resource queues to resource groups is presented if no resource groups have been created (other than default_group and admin_group) and Greenplum Database has resource queues to convert (other than pg_default). Once the administrator has imported resource queues, or chosen to skip importing resource queues, the option to import queues is no longer presented.

  • The resource group list on the Workload Management view has a new column to show the minimum (fixed) amount of memory that will be allocated to a query for each resource group. This value is recalculated when you enter new values while editing resource groups.

  • Administrators can now define resource group assignment rules and idle session kill rules with an interactive interface. It is no longer necessary to edit the JSON document for workload management rules. The JSON text field is removed.

  • The Workload Management view changed to a light theme.


  • Command Center users with the Self Only permission level can:

    • see all queries on the query monitor, including queries owned by other users
    • cancel their own queries
    • access the query details view for their own queries
    • hover on a query to see query text for their own queries
    • hover on locking/blocking queries and access details of locking/blocking queries that do not belong to other users

    Users with Self Only permission level cannot see query text or access the details views of others’ queries.

  • The Greenplum Database roles gpcc_basic, gpcc_operator, and gpcc_operator_basic are created during Command Center installation if they do not already exist.

Query Monitor

  • Fixed a bug where the database name and role name were missing from query details when queries are executed in a session after restarting Command Center.

Enhancements and Changes in Greenplum Command Center 4.3.0

Greenplum Command Center 4.3.0 contains the following enhancements.

Resource Group Management

The Admin>Workload Mgmt view has a new user interface you can use to add and remove resource groups and to change the Concurrency, CPU %, and Memory % attributes of resource groups.

Resource Group Role Assignments

The Admin>Workload Mgmt view has a new user interface you can use to view and change Greenplum Database roles’ default resource groups.

Details Added to Visual Query Plan Steps

The metrics collector extension in Greenplum Database release 5.9 is updated to submit additional information about each step in the query plan to the Command Center backend. Command Center displays this information in the visual query plan when you expand a step in the query plan. The new information displayed depends on the operation the step performs and includes details such as hash key, merge key, join condition, or filter condition. Previously, you could only see this information by generating the textual query plan.

Enhancements and Changes in Greenplum Command Center 4.2.0

Greenplum Command Center 4.2.0 contains the following enhancements.

Visual Query Plan

The Command Center Query Details view now includes a visual query plan.

Idle Session Kill Rules

Idle session kill rules can include optional exemptedRoles and message parameters.

  • The value of the exemptedRoles parameter is a list of Greenplum Database roles that are exempted from the rule. The list can include Posix regular expressions to match Greenplum Database role names.
  • The value of the message parameter is a string to include in the message that is displayed when a session is killed.

Command Center Can Run on the Master Host or Standby Master Host

The Greenplum Command Center web server and backend may now be executed on the master host or on the standby master host. Running GPCC on the standby master host is recommended to avoid adding load to the master server, but it is no longer a requirement. After the GPCC software is installed, log in to the host where you want to run GPCC, source the file in the GPCC installation directory, and run the gpcc start command.

Enhancements and Changes in Greenplum Command Center 4.1.0

Greenplum Command Center 4.1.0 contains the following enhancements.

  • Command Center administrators can set permission levels for Command Center users. Permissions are enforced as described in the documentation.
  • On the Query Detail view, clicking Copy in the query text or query plan panel copies the text in the panel to the clipboard.

  • A help icon and in-app help have been added on the Query Monitor and Query Detail views.

The following workload management features, improvements, and bug fixes have been added in the workload management extension included with Greenplum Database 5.8.0.

  • On the Admin>Workload Mgmt view, you can add idle session kill rules for each resource group. When you add these rules, the Greenplum Database workload management extension kills a session after it has been idle for the number of seconds you specify. See Workload Management for syntax and examples.

  • Optimizations have been implemented to reduce the impact on Greenplum Database when the workload management extension is disabled.

  • The workload management extension takes advantage of resource group name-to-id caching added in Greenplum Database.

  • Fixed a bug in the workload management extension that caused errors to print to the psql prompt, even when the extension was disabled.

Greenplum Command Center 4.1.0 contains the following bug fixes.

  • In the History Detail view, when either of the Disk R or Disk W metrics is 0, both are reported to be 0. This is fixed.

  • When using the Kerberos gpmon-only authentication mode, generating an explain plan failed. This is fixed.

  • The Command Center agent failed with the message “Error: can’t find gpcc.query_metrics_port, metrics_collector is not correctly installed.” This occurs when running Command Center on a Greenplum Database system that was upgraded from an earlier Greenplum Database 5.x release. The metrics_collector and gp_wlm extensions are installed with the upgrade, but the upgrade process does not perform the required configuration changes in the postgresql.conf configuration file. The Command Center installation instructions now include steps to manually configure and restart an upgraded Greenplum Database system.

  • When Command Center starts, an error message is written in the Greenplum Database log file: “function gpcc_schema.read_pghba(unknown) does not exist.” This is fixed.

  • A change to time zone handling in Greenplum Database 5.7 can cause Greenplum Command Center 4.0.0 to display an incorrect time if the master host operating system time and Greenplum Database use different time zones. Now Command Center times are displayed using the time zone of the Greenplum Database master host operating system. The current time, last sync time, and timestamps in alert logs, cluster metrics, and query history are all displayed using the master host’s system time zone.

  • On the Admin> Authorization view, when the authorization method is gss and the options field contains text, changing the method to trust does not clear the options field and it is not possible to save changes to the pg_hba.conf file.

  • The Command Center web server, gpccws, spawns ssh processes but does not reap them in a timely manner, leading to many zombie processes. This is fixed.

  • On the Admin> Authentication view, if the number of users listed in the user column is longer than can be displayed, Command Center truncates the list and adds ellipsis (...) to the end. Only administrators can view the complete value, by editing the field. Now any user with access to the view can see the full list of users by hovering over the field.

Enhancements and Changes in Greenplum Command Center 4.0.0

Command Center Installation Changes

Greenplum Command Center 4.x software, unlike previous releases, is installed on every host in the Greenplum Database cluster. The Command Center web server and backend run on the standby master, if your Greenplum Database cluster has a standby master. If there is no standby master, Command Center runs on the master host instead.

To modify the Command Center installation—for example to enable or disable SSL or install Command Center on new or replaced hosts—just re-execute the installer and restart Command Center. It is not necessary to uninstall Command Center before reinstalling.

There is one Command Center installation per Greenplum Database cluster. It is no longer necessary to create Command Center instances after installing the software.

The gpcmdr command-line utility is replaced with the new gpcc utility. Use the gpcc utility to start and stop Command Center and metrics collection agents, check Command Center status, and enable or disable Kerberos authentication.

In previous releases, the gpmon role required only local connections to databases on the Greenplum master host. In Greenplum Command Center 4.x, the gpmon user must be able to connect to databases from the host running the Command Center web server and backend, which requires adding a host entry to the pg_hba.conf authentication configuration file.

Real-time Query Metrics

Greenplum Command Center 4.0 introduces real-time query metrics for Pivotal Greenplum Database 5.7 and above. This new feature combines the following new features in Greenplum Database and Greenplum Command Center:

  • Greenplum Database saves query execution metrics in shared memory while queries execute.
  • A new Greenplum Database metrics collection extension, included with Pivotal Greenplum Database, emits the saved metrics as UDP datagrams.
  • A new Greenplum Command Center metrics collection agent running on each Greenplum Database host receives the datagrams and posts metrics to the Greenplum Command Center backend. The Command Center backend starts and manages the metrics collection agents.

The Command Center Query monitor view updates in real time so you can see queries that are waiting to execute and the current status and resource usage for queries that are running.

Metrics collection now includes lock and spill file information. On the Query Monitor, you can see which queries are blocked and which queries hold the locks blocking them. The Query Monitor shows the total size of spill files created on all segments for each query.

Installing the gpperfmon database remains a prerequisite for Command Center. The gpperfmon database is the source for query history displayed in the Command Center user interface. The new real-time metrics are not persisted and are not directly related to the metrics collected and persisted in the gpperfmon database.

Workload Management

Workload management is now an integrated Command Center feature rather than a separate product. Workload management is available in Command Center only after resource groups have been enabled in Greenplum Database by changing the gp_resource_manager server configuration parameter from 'queue' to 'group' and enabling Linux control groups (cgroups).

In Command Center 4.0, workload management allows you to assign transactions to Greenplum Database resource groups at execution time by evaluating the current database role and query tags against workload assignment filters you define in Command Center. Query tags are user-defined name=value parameters that you define in the gpcc.query_tags database session parameter. You can define multiple query tags separated by semicolons. Set query tags in a Greenplum Database session either as a parameter in the database connection URL or by executing SET gpcc.query_tags TO '<tag1>=<val1>;<tag2>=<val2>;...' in the database session.

When a transaction is about to execute, the current database role and query tags are compared to the workload assignment filters that you have created in Command Center. If a match is found, the transaction is assigned to a resource group according to the workload management filter. Otherwise, the transaction is assigned to the database user’s resource group, which is the default behavior when Command Center workload management is not enabled.

Workload management uses the gp_wlm database extension included with Pivotal Greenplum Database.

Unimplemented Features

Some features available in previous Greenplum Command Center releases have been removed or are not yet implemented in Command Center 4.x.

  • The ability for a Command Center admin to post a message to the Query Monitor view is not yet implemented.
  • The multi-cluster view has been removed.

Known Issues

The following are known issues in the current Greenplum Command Center release.

Command Center Shows Incorrect Statement Memory

Command Center displays an correct value for Statement Memory for resource group entries. This problem is resolved in Command Center version 4.11.0.

Unrecognized Configuration Parameter Error Message

When starting Command Center GPCC 4.10.0 with a Greenplum Database version between 5.19.0 and 5.27.1, the message unrecognized configuration parameter gpcc.metrics_collector_pkt_version is logged. This message is expected and can be ignored. It will be suppressed in the next Greenplum Command Center release.

Customized SSH Path Not Supported with the Upgrade (-u) Option

If you upgrade your Command Center installation using the gpccinstall -u option and you also specify an SSH program using the -ssh-path <path> option, the customized SSH path will not be used during the installation and the ssh_path parameter will not be set in the app.conf file.

Command Center Installer Truncates pg_hba.conf LDAP Entries

When the Command Center gpccinstall installer updates the pg_hba.conf file it truncates LDAP information on entries that use the ldap authentication method. The truncated information must be reinserted manually after the Command Center installation is complete. This issue exists in Command Center versions 4.7 through 4.9, 6.0, and 6.1.

Loading gp_wlm Extension Without Enabling Resource Groups Can Cause Performance Issues

  • A performance issue can occur if Workload Management is not enabled in Command Center and the library is included in the shared_reload_libraries system configuration parameter when Greenplum Database starts. The fix for this issue is in Greenplum Database 5.24.0.

    If you cannot upgrade to Greenplum Database 5.24, you can prevent problems with one of these workarounds:

    • If you are using resource group workload management in Greenplum Database, ensure that Workload Management is enabled in Command Center.
    • If you are using resource queue workload management in Greenplum Database, remove gp_wlm from the shared_preload_libaries configuration parameter and restart Greenplum Database.

Calculated Root Table Size Inaccurate for Some Partitioned Tables

When viewing the Table Browser view, the calculated size for a partitioned table is incorrect if some child partitions are in different schemas than the root table.

Sorting Tables by Size on Partition List Page is Slow

If there are a large number of tables in a schema in a database, sorting the partition table list by size can take a long time to display.

Failure to Auto-Create Monthly Partitions in gpmetrics Schema

In time zones with daylight savings time (DST) ending in the month of October, Greenplum Command Center fails to create new October partitions for tables in the gpmetrics schema because it specifies the same start and end date for the partitions. The error does not occur in time zones that do not have DST, or in time zones with DST ending in November.


Manually create partitions for October 2019.

Log in to the Greenplum master server as the gpadmin user and connect to the gpperfmon database as the gpmon user:

psql -U gpmon gpperfmon

Enter the following commands to create the October 2019 partitions:

ALTER TABLE gpmetrics.gpcc_disk_history
      ADD PARTITION START (date '2019-10-01') INCLUSIVE END (date '2019-11-01') EXCLUSIVE

ALTER TABLE gpmetrics.gpcc_system_history
      ADD PARTITION START (date '2019-10-01') INCLUSIVE END (date '2019-11-01') EXCLUSIVE

ALTER TABLE gpmetrics.gpcc_queries_history
      ADD PARTITION START (date '2019-10-01') INCLUSIVE END (date '2019-11-01') EXCLUSIVE

ALTER TABLE gpmetrics.gpcc_plannode_history
      ADD PARTITION START (date '2019-10-01') INCLUSIVE END (date '2019-11-01') EXCLUSIVE

ALTER TABLE gpmetrics.gpcc_database_history
      ADD PARTITION START (date '2019-10-01') INCLUSIVE END (date '2019-11-01') EXCLUSIVE

ALTER TABLE gpmetrics.gpcc_alert_log
      ADD PARTITION START (date '2019-10-01') INCLUSIVE END (date '2019-11-01') EXCLUSIVE

ALTER TABLE gpmetrics.gpcc_pg_log_history
      SPLIT DEFAULT PARTITION START (date '2019-10-01') INCLUSIVE END (date '2019-11-01') EXCLUSIVE

Query Monitor is Empty When Using HTTP Proxy

When accessing the Command Center frontend or backend with an HTTP proxy in place, no query activity is displayed in the Query Monitor. To work around this issue, the proxy must be disabled for Command Center client browser connections and for ccagent processes connecting to the Command Center backend from the Greenplum master and segment hosts. See Using an HTTP Proxy Server with Command Center for more information about this issue.

Query Monitor is Empty When Using HTTP Proxy

When accessing the Command Center frontend or backend with an HTTP proxy in place, no query activity is displayed in the Query Monitor. To work around this issue, the proxy must be disabled for Command Center client browser connections and for ccagent processes connecting to the Command Center backend from the Greenplum master and segment hosts. See Using an HTTP Proxy Server with Command Center for more information about this issue.

Cyrillic Font Support in the Pivotal UI

The Source Sans Pro font in the Pivotal UI toolkit does not contain Cyrillic symbols, so the Command Center UI falls back to the default sans-serif font. This may cause some cosmetic rendering problems for Russian users.

Unable to View Real Time Queries After Upgrading From a Previous Command Center Release

If you install a new version of Greenplum Command Center using the same port number as the previous version, and you use the Chrome web browser, you may be unable to view real-time queries until after you clear the browser’s cache. See the note in Connecting to the Command Center Console for steps to clear the browser cache.

Resource Queue Name Incorrect for Some Queries

To display the resource queue name for queries in the Query Monitor, Command Center caches user IDs with resource queue names. The cache is updated when the Command Center backend receives a planned query from the metrics collector. Some utility commands are not planned, such as COPY commands that have no SELECT clause. These commands use a resource queue slot, but are not passed through an optimizer. If a user is assigned a different resource queue and then executes an unplanned command, the Command Center Query Monitor will display the resource queue name that was previously cached.

Cannot Set SSH Path When Upgrading Command Center

The Command Center installer -ssh_path <path> command-line option specifies the path to a custom SSH command and also saves the path to the ssh_path parameter of the app.conf configuration file. If both the -u (upgrade) and -ssh_path options are specified on the gpccinstall command line, however, the -ssh_path option is ignored. The installer does not use the custom SSH command and the path is not saved in the app.conf file.