PXF提供了两个管理命令:

  • pxf cluster - 管理Greenplum数据库集群中的所有PXF服务实例
  • pxf - 在特定的Greenplum数据库主机上管理PXF服务实例

pxf cluster支持 init, start, status, stop, and sync 子命令。在Greenplum数据库master主机上运行 pxf cluster 子命令时,将在Greenplum数据库集群中的所有segment主机上执行该操作。PXF还在standby主机上运行initsync命令。

pxf支持init, start, stop, restart, status 操作。这些操作在本地执行,也就是说,如果要在特定的Greenplum数据库segment主机上启动或停止PXF代理,需要登录到该主机并运行命令。

启动PXF

初始化PXF之后,必须在Greenplum数据库集群中的每个segment主机上启动PXF。PXF服务启动后,将以gpadmin用户身份在默认端口5888上运行。只有gpadmin用户可以启动和停止pxf服务。

如果要更改默认的PXF配置,则必须在启动PXF之前更新配置。

$PXF_CONF/conf 包含用户自定义的配置文件:

  • pxf-env.sh - 运行时配置参数
  • pxf-log4j.properties - 日志记录配置参数
  • pxf-profiles.xml - 自定义配置文件定义

pxf-env.sh 包含以下用户可自定义的配置文件:

ParameterDescriptionDefault Value
JAVAHOMEJava JRE家目录/usr/java/default
PXF_LOGDIRPXF日志目录$PXF_CONF/logs
PXF_JVM_OPTSPXF Java虚拟机的默认选项-Xmx2g -Xms1g
PXF_KEYTABPXF服务Kerberos主体密钥表文件的绝对路径$PXF_CONF/keytabs/pxf.service.keytab
PXF_PRINCIPALPXF服务Kerberos主体gpadmin/HOST@EXAMPLE.COM

您必须将对pxf-env.shpxf-log4j.propertiespxf-profiles.xml所做的所有变更同步到Greenplum数据库集群,并在每个segment节点上(重新)启动PXF。

准备

在Greenplum数据库集群中启动PXF之前,请确保:

  • Greenplum数据库集群已启动并正在运行
  • PXF已经被初始化

过程

执行以下过程以在Greenplum数据库集群中的每个segment主机上启动PXF。

  1. 登录greenplum master节点

    1. $ ssh gpadmin@<gpmaster>
  2. 在每个segment主机上运行pxf cluster start命令启动pxf服务

    1. gpadmin@gpmaster$ $GPHOME/pxf/bin/pxf cluster start

停止PXF

如果必须停止PXF,例如如果要升级PXF,则必须在Greenplum数据库集群中的每个segment主机上停止PXF。只有gpadmin用户可以停止PXF服务

准备

在Greenplum数据库集群中停止PXF之前,请确保Greenplum数据库集群已启动并正在运行。

过程

执行以下过程在Greenplum数据库集群中的每个segment主机上停止PXF。

  1. 登录greenplum master节点

    1. $ ssh gpadmin@<gpmaster>
  2. 在每个segment主机上运行pxf cluster stop命令停止pxf服务。 例如:

    1. gpadmin@gpmaster$ $GPHOME/pxf/bin/pxf cluster stop

重启PXF

如果必须重新启动PXF,例如在$PXF_CONF/conf中更新了PXF用户配置文件,则可以在Greenplum数据库集群中先停止服务然后再启动PXF服务。

只有gpadmin用户可以重启PXF服务。

准备

在Greenplum数据库集群中重新启动PXF之前,请确保Greenplum数据库集群已启动并正在运行。

过程

执行以下过程在Greenplum数据库集群中的每个segment上重启PXF。

  1. 登录greenplum master节点:

    1. $ ssh gpadmin@<gpmaster>
  2. 重启PXF:

    1. gpadmin@gpmaster$ $GPHOME/pxf/bin/pxf cluster stop
    2. gpadmin@gpmaster$ $GPHOME/pxf/bin/pxf cluster start