Setup Configuration File

A setup configuration file contains properties used to configure Greenplum Command Center when you perform a non-interactive Command Center installation. The file is passed to the gpccinstall command with the -c option:

$ ./gpccinstall-<version> -c <config_file>

The configuration file contains name: value or name=value entries, one per line. Comments begin with a # or ; character and continue through the end of the line.

See Installing Pivotal Greenplum Command Center for more information about installing Command Center with a configuration file.

Parameters

path
The path to the directory where Greenplum Command Center software will be installed. The directory must be writable by the gpadmin user on all hosts in the Greenplum Cluster.

display_name
The name to display in the Command Center user interface. The default display name is gpcc.

master_port
The Greenplum Database master port. Default: 5432.

web_port
The listen port for the Command Center web server. The default is 28080.

enable_ssl
True if client connections to the Command Center web server are to be secured with SSL. The default is false. If true the ssl_cert_file parameter must be set and the SSL certificate must be installed on the host where you run Command Center.

ssl_cert_file
If enable_ssl is true, set this parameter to the full path to a valid certificate in PEM file format. The certificate must be installed on the host where you run Command Center.

enable_kerberos
Set to true to enable Kerberos authentication.

krb_mode
The Kerberos authentication scheme to use. The default is 1.

  • 1 - normal mode (default) - The Command Center Kerberos keytab file contains the Command Center principal and may contain principals for Command Center users. If the principal in the client’s connection request is in the Command Center’s keytab file, Command Center uses the client’s principal for database connections. Otherwise, Command Center uses the gpmon user for database connections.

  • 2 - strict mode - Command Center has a Kerberos keytab file containing the Command Center service principal and a principal for every Command Center user. If the principal in the client’s connection request is in the keytab file, the web server grants the client access and the web server connects to Greenplum Database using the client’s principal name. If the principal is not in the keytab file, the connection request fails.

  • 3 - gpmon_only mode - Command Center uses the gpmon database role for all Greenplum Database connections. No client principals are needed in the Command Center’s keytab file.

webserver_url
The web server hostname, from the Kerberos HTTP service principal.

keytab
Path to the keytab file containing Kerberos principals for the Command Center web server and users.

Examples

#####
# GPCC 4.0 setup configuration file
#####
path = /opt 
display_name = Greenplum Database Production Cluster
master_port = 5432
webserver_port = 28081
EnableHTTP = true      ; allow both HTTP and HTTPS
EnableHTTPS = true
ssl_cert_file = /etc/ssl/cert.pem
enable_kerberos = false