Client command utility for the VMware Tanzu Greenplum streaming server.

Synopsis

gpsscli <subcommand> [<options>]

gpsscli convert
gpsscli dryrun
gpsscli list
gpsscli load
gpsscli progress
gpsscli remove
gpsscli start
gpsscli status
gpsscli stop
gpsscli submit
gpsscli wait

gpsscli {help | -h | --help}

gpsscli {-v | --version}

Description

The Tanzu Greenplum streaming server (GPSS) includes the gpsscli client command utility. gpsscli provides subcommands to manage Tanzu Greenplum streaming server load jobs and to view job status and progress:

Options

--config <gpsscliconfig.json>

The GPSS configuration file. This file includes properties that identify the gpss instance that services the command. When SSL encryption is enabled between the GPSS client and server, you also use this file to identify the file system location of the client SSL certificates. Refer to gpss.json for detailed information about the format of this file and the configuration properties supported.

gpsscli subcommands read the configuration specified in the ListenAddress block of the gpsscliconfig.json file, and ignore the gpfdist configuration specified in the Gpfdist block of the file.

--color

Enable the use of color when displaying front-end log messages. When specified, GPSS colors the log level in messages that it writes to stdout. Color is deactivate by default.

GPSS ignores the --color option if you also specify --csv-log.

--csv-log

Write front-end log messages in CSV format. By default, GPSS writes log messages to stdout using spaces between fields for a more human-readable format.

--gpss-host <host>

The GPSS host. The default host address is 127.0.0.1. If specified, overrides a ListenAddress:Host value provided in gpsscliconfig.json

--gpss-port <port>

The GPSS port number. The default port number is 5000. If specified, overrides a ListenAddress:Port value provided in gpsscliconfig.json

--no-check-ca

Deactivate certificate verification when SSL is enabled between the GPSS client and server. By default, GPSS checks the certificate authority (CA) each time that you invoke a gpsscli subcommand.

-d | --daemon

Run gpss as a daemon. All log messages will be printed on the backend log instead of on the screen log. The daemon will continue running until you manually stop the process.

-U | --username <client_auth_username>

The user name with which the GPSS server instance authenticates the client.

-P | --password <client_auth_passwd>

The password with which the GPSS server instance authenticates the client.

-l | --log-dir <directory>

The directory to which GPSS writes client command log files. GPSS must have write permission to the directory. GPSS creates the log directory if it does not exist.

If you do not provide this option, GPSS writes gpsscli client log files to the $HOME/gpAdminLogs directory.

--verbose

The default behaviour of the command utility is to display information and error messages to stdout. When you specify the --verbose option, GPSS also outputs debug-level messages about the operation.

-h | --help

Show command utility help, and then exit.

-v | --version

Show the versions of gpsscli and the gpss server, and then exit. You may need to also specify the --gpss-host and/or --gpss-port options to identify the server.

See Also

gpsscli convert, gpsscli dryrun, gpsscli list, gpsscli load, gpsscli progress, gpsscli remove, gpsscli start, gpsscli status, gpsscli stop, gpsscli submit, gpsscli wait