pxf

Manage the PXF service instance on a segment host.

Synopsis

pxf <command> [<option>]

where <command> is:

cluster
help
init
restart
start
status
stop
sync
version

Description

The pxf utility manages the PXF service instances on Greenplum Database segment hosts.

You can initialize, start, stop, restart the PXF service instance on a specific segment host. You can display the status of the PXF service instance running on a host. You can also synchronize PXF configuration from the master to a specific Greenplum Database segment host.

To initialize, start, and stop the PXF service instance on all segment hosts in the Greenplum Database cluster, use the pxf cluster command. See pxf cluster.

Commands

cluster
Manage the PXF service instance on all Greenplum Database segment hosts. See pxf cluster.

help
Display the pxf management utility help message and then exit.

init
Initialize the PXF service instance on the host. When you initialize PXF, you must identify the PXF user configuration directory via an environment variable named $PXF_CONF. If you do not set $PXF_CONF prior to initializing PXF, PXF prompts you to accept or decline the default user configuration directory, $HOME/pxf, during the initialization process. See Options.

restart
Restart the PXF service instance running on the segment host.

start
Start the PXF service instance on the segment host.

status
Display the status of the PXF service instance running on the segment host.

stop
Stop the PXF service instance running on the segment host.

sync
Synchronize PXF configuration from the master to a specific Greenplum Database segment host. You must run pxf sync on the master host. See Options.

version
Display the PXF version and then exit.

Options

The pxf init command takes the following option:

-y
Do not prompt, use the default $PXF_CONF directory location if the environment variable is not set.

The pxf sync command takes the following option:

<seghost>
The segment host to which to synchronize PXF configuration.

Examples

Start the PXF service instance on the local segment host:

$ $GPHOME/pxf/bin/pxf start

See Also

pxf cluster