About the PXF Installation and Configuration Directories
PXF is installed to $GPHOME/pxf
on your master and segment nodes when you install Greenplum Database. If you install the PXF rpm
or deb
package, PXF is installed to /usr/local/pxf-gp<greenplum-major-version>
, or to a directory of your choosing (CentOS/RHEL only). This documentation uses $PXF_HOME
to refer to the PXF installation directory.
PXF Installation Directories
The following PXF files and directories are installed to $PXF_HOME
when you install Greenplum Database or the PXF rpm
or deb
:
Directory | Description |
---|---|
apache‑tomcat/ | The PXF Tomcat directory. |
bin/ | The PXF script and executable directory. |
commit.sha | The commit identifier for this PXF release. |
conf/ | The PXF internal configuration directory. This directory contains the pxf-env-default.sh and pxf-profiles-default.xml configuration files. After initializing PXF, this directory will also include the pxf-private.classpath file. |
gpextable/ | The PXF extension files. The files in this directory are copied to the Greenplum installation ($GPHOME ) on a single host or all hosts in the cluster when you run pxf [cluster] register . |
lib/ | The PXF library directory. |
templates/ | Configuration templates for PXF. |
version | The PXF version. |
PXF Runtime Directories
During initialization and startup, PXF creates the following internal directories in $PXF_HOME
:
Directory | Description |
---|---|
pxf‑service/ | After initializing PXF, the PXF service instance directory. |
run/ | After starting PXF, the PXF run directory. Includes a PXF catalina process id file. |
PXF User Configuration Directories
Also during initialization, PXF populates a user configuration directory that you specify via the PXF_CONF
environment variable with the following subdirectories and template files:
Directory | Description |
---|---|
conf/ | The location of user-customizable PXF configuration files: pxf-env.sh , pxf-log4j.properties , and pxf-profiles.xml . |
keytabs/ | The default location for the PXF service Kerberos principal keytab file. |
lib/ | The default PXF user runtime library directory. |
logs/ | The PXF runtime log file directory. Includes pxf-service.log and the Tomcat-related log catalina.out . The logs/ directory and log files are readable only by the gpadmin user. |
servers/ | The server configuration directory; each subdirectory identifies the name of a server. The default server is named default . The Greenplum Database administrator may configure other servers. |
templates/ | The configuration directory for connector server template files. |
Refer to Initializing PXF and Starting PXF for detailed information about the PXF initialization and startup commands and procedures.