pxf
Manage the PXF configuration and the PXF service instance on the local Greenplum Database host.
Synopsis
pxf <command> [<option>]
where <command> is:
cluster
help
init
register
reset
restart
start
status
stop
sync
version
Description
The pxf
utility manages the PXF configuration and the PXF service instance on the local Greenplum Database host.
You can initialize or reset PXF on the master, master standby, or a specific segment host. You can also synchronize the PXF configuration from the master to these hosts.
You can start, stop, or restart the PXF service instance on a specific segment host, or display the status of the PXF service instance running on a segment host.
You can copy the extension files from a PXF installation on the host to the Greenplum installation on the host after a Greenplum upgrade.
(Use the pxf cluster
command to copy extension files to, initialize, or reset PXF on all hosts, synchronize the PXF configuration to the Greenplum Database cluster, or to start, stop, or display the status of the PXF service instance on all segment hosts in the cluster.)
Commands
pxf cluster
.pxf
management utility help message and then exit.--skip-register
option to instruct PXF to skip this initialization step.) 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.$GPHOME
be set, and is typically run after you upgrade your Greenplum Database installation.$PXF_CONF
) from the master to a specific Greenplum Database standby master or segment host. You must run pxf sync
on the master host. By default, this command updates files on and copies files to the remote. You can instruct PXF to also delete files during the synchronization; see Options.Options
The pxf init
command takes the following options:
$PXF_CONF
directory location if the environment variable is not set.The pxf reset
command takes the following option:
The pxf sync
command, which you must run on the Greenplum Database master host, takes the following option and argument:
<gphost>
that are not also present on the master host. If you specify this option, you must provide it on the command line before <gphost>
.<gphost>
must identify the standy master host or a segment host.Examples
Start the PXF service instance on the local segment host:
$ pxf start