PXF 安装

本指南将介绍如何在 YMatrix 集群中安装和配置 PXF,以使用 Platform Extension Framework(PXF)和 Foreign Data Wrapper(FDW)的机制访问 YMatrix 数据库外部数据源。

注意!
请确保在集群内所有机器均执行以下安装和配置 PXF 的操作。

注意!
PXF 特性仅在企业版中支持。如有需要请联系:info@ymatrix.cn。

环境要求

  • PXF 需要 Java 8 或 Java 11 的运行环境,并且需要环境变量 $JAVA_HOME 已正确设置。
  • PXF RPM 默认安装路径为 /usr/local/pxf-matrixdb4

安装步骤如下:

1 安装

注意!
此步骤需使用 root 用户或者具有 sudo 权限的普通用户在所有节点执行。

执行以下命令,安装 RPM 包

$ sudo yum install -y pxf-matrixdb4-6.3.0-1.el7.x86_64.rpm

2 配置环境变量

在所有节点上,使用 root 用户或具有 sudo 权限的用户编辑 /etc/profile 文件,添加以下内容。

注意!
需将 JAVA_HOME 替换为当前机器的实际路径。

$ vim /etc/profile
export PXF_HOME=/usr/local/pxf-matrixdb4
export PATH=$PXF_HOME/bin:$PATH
export JAVA_HOME=/usr/local/java/jdk1.8.0_181
export JRE_HOME=${JAVA_HOME}/jre
export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib
export PATH=${JAVA_HOME}/bin:$PATH

保存后刷新环境变量:

$ source /etc/profile

编辑 PXF 的环境配置文件

$ vi /usr/local/pxf-matrixdb4/conf/pxf-env.sh

在文件中确认或添加

export JAVA_HOME=/usr/local/java/jdk1.8.0_181

3 修改文件权限及拷贝文件

注意!
此步骤需使用 root 用户或者具有 sudo 权限的普通用户在所有节点执行。

更改 PXF 安装目录的权限为 mxadmin

$ sudo chown -R mxadmin:mxadmin /usr/local/pxf-matrixdb4

修改 FDW 控制文件的权限:

$ sudo chown mxadmin:mxadmin /opt/ymatrix/matrixdb6/share/postgresql/extension/pxf_fdw.control

拷贝共享库文件至目录下:

$ cp /usr/local/pxf-matrixdb4/fdw/pxf_fdw.so  /opt/ymatrix/matrixdb6/lib/postgresql/

4 初始化 PXF

确保集群已启动后,在 Master 节点下以 mxadmin 用户执行以下命令:

$ pxf cluster register

执行后输出类似如下信息,表示初始化成功(例:Master 与 2 个 Segment 节点均初始化成功):

Initializing PXF on master host and 2 segment hosts...
PXF initialized successfully on 3 out of 3 hosts

5 从 Master 同步 PXF 配置文件到所有 Segment

首先,在所有节点使用 root 用户或者具有 sudo 权限的普通用户下安装 rsync

$ sudo yum install -y rsync

在 Master 使用 mxadmin 用户执行以下命令,同步 PXF 配置文件到集群所有节点上。

$ pxf cluster sync

如下,说明 PXF 配置文件已经同步成功。

Syncing PXF configuration files from master host to 2 segment hosts...
PXF configs synced successfully on 2 out of 2 hosts

6 启动 PXF

在 Master 使用 mxadmin 用户执行以下命令,启动 PXF 服务。

$ pxf cluster start

如下,说明 PXF 启动成功。

Starting PXF on 2 segment hosts...
PXF started successfully on 2 out of 2 hosts

7 检测 PXF 状态

在 Master 使用 mxadmin 用户执行以下命令检测 PXF 状态,确保所有节点正常运行。

$ pxf cluster status

确认 PXF 集群启动成功。

Checking status of PXF servers on 2 segment hosts...
PXF is running on 2 out of 2 hosts