安装¶
从软件包安装¶
访问我们的发布页面 下载 synchdb 软件包。
.deb 包¶
-
从官方 apt 存储库安装 PostgreSQL（版本 16 为例）：
1 2 3
sudo apt install -y postgresql-common sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh sudo apt install postgresql-16 -
安装 Java 运行时环境：
1sudo apt install openjdk-17-jre-headless -
更新共享库路径：
1 2 3 4 5
JAVA_PATH=$(which java) JRE_HOME_PATH=$(readlink -f ${JAVA_PATH} | sed 's:/bin/java::') JRE_LIB_PATH=${JRE_HOME_PATH}/lib echo "$JRE_LIB_PATH" | sudo tee /etc/ld.so.conf.d/java.conf sudo ldconfig -
安装 SynchDB：
1dpkg -i synchdb-1.1-1.ub22.pg16_x86_64.deb - SynchDB 应该已准备就绪。请参阅 快速入门 页面开始使用
.rpm 软件包¶
- 从官方 rpm 仓库安装 PostgreSQL（版本 16 为例）：
其他 PostgreSQL 版本的官方 rpm 下载说明，请参考此处 (https://www.postgresql.org/download/linux/redhat/)
1 2 3
sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm sudo dnf -qy module disable postgresql sudo dnf install -y postgresql16-server postgresql16-contrib -
安装 Java 运行环境：
1sudo dnf install -y java-17-openjdk -
更新共享库路径：
1 2 3 4 5
JAVA_PATH=$(which java) JRE_HOME_PATH=$(readlink -f ${JAVA_PATH} | sed 's:/bin/java::') JRE_LIB_PATH=${JRE_HOME_PATH}/lib echo "$JRE_LIB_PATH" | sudo tee /etc/ld.so.conf.d/java.conf sudo ldconfig -
安装 SynchDB：
1sudo dnf install -y synchdb-1.1-1.el9.pg16.x86_64.rpm - SynchDB 应该已准备就绪。请参阅 快速入门 页面开始使用
从预编译的二进制文件安装¶
访问我们的发布页面 下载预编译二进制文件。我们目前支持基于 Debian 的 Linux 系统（如 Ubuntu）系统上的预编译二进制文件。其他平台将在不久的将来得到支持。SynchDB 预编译二进制文件需要先安装 PostgreSQL。它所需的 PostgreSQL 版本在包名称中描述。例如，synchdb-1.1-1.ub22.pg16_x86_64.tar.gz 是在 Ubuntu 22.04 上针对 PostgreSQL 16 编译的二进制文件。
预编译二进制文件¶
-
解压预编译二进制文件的 tar.gz 包：
1tar xzvf synchdb-1.1-1.ub22.pg16_x86_64.tar.gz -C /tmp -
找出当前 PostgreSQL 的 lib 和 share 目录
1 2
LIBDIR=$(pg_config | grep -w LIBDIR | awk -F ' = ' '/LIBDIR/ {print $2}') SHAREDIR=$(pg_config | grep -w SHAREDIR | awk -F ' = ' '/SHAREDIR/ {print $2}') -
将预编译的二进制文件复制到相应目录：
1 2
cp /tmp/synchdb-1.1-1.ub22.pg16_x86_64/usr/lib/postgresql/16/lib/* $LIBDIR cp /tmp/synchdb-1.1-1.ub22.pg16_x86_64/usr/share/postgresql/16/extension/* $SHAREDIR -
安装 Java Runtime Environment：
1sudo apt install openjdk-17-jre-headless -
更新共享库路径：
1 2 3 4 5
JAVA_PATH=$(which java) JRE_HOME_PATH=$(readlink -f ${JAVA_PATH} | sed 's:/bin/java::') JRE_LIB_PATH=${JRE_HOME_PATH}/lib echo "$JRE_LIB_PATH" | sudo tee /etc/ld.so.conf.d/java.conf sudo ldconfig -
SynchDB 应该已准备就绪。请参阅 快速入门 页面开始使用
源代码编译及安装¶
此选项要求您从源代码构建和安装 PostgreSQL 和 SynchDB。
系统要求¶
构建和运行SynchDB需要以下软件。列出的版本是开发过程中测试过的版本。较旧的版本可能仍然可用。
- Java Development Kit 22. 下载地址：点击这里
- Apache Maven 3.9.8. 下载地址：点击这里
- PostgreSQL 源代码. Git克隆地址：点击这里. PostgreSQL编译要求请参考此wiki
- Docker compose 2.28.1 (用于测试). 参考安装指南
- 基于Unix的操作系统，如Ubuntu 22.04或MacOS
Openlog Replicator 连接器支持的额外要求（如果在构建过程中启用）
- libprotobuf-c v1.5.2。请参阅此处 从源代码构建。
准备源代码（以16.3为例）¶
克隆PostgreSQL源代码并切换到16.3发布标签
1 2 3 | |
在扩展文件夹中克隆SynchDB源代码 注意：目前使用(synchdb-devel)[https://github.com/Hornetlabs/synchdb/tree/synchdb-devel]分支进行开发。
1 2 | |
准备工具¶
→ Maven¶
## 在 Ubuntu 上
sudo apt install maven
## 在 MacOS 上
brew install maven
→ Java (OpenJDK)¶
如果您使用的是 Ubuntu 22.04.4 LTS，请按如下方式安装 OpenJDK：
## 在 Ubuntu 上
sudo apt install openjdk-21-jdk
## 在 MacOS 上
brew install openjdk@22
→ libprotobuf-c（可选）¶
警告：如果要构建 SynchDB 并支持 openlog replicator，则需要此库。请参阅此处 从源代码构建。
编译和安装PostgreSQL¶
按照PostgreSQL官方文档这里从源代码编译和安装PostgreSQL。通常，步骤包括：
警告：SynchDB 依赖 pgcrypto 来加密和解密敏感访问信息。请确保 PostgreSQL 支持 SSL。
1 2 3 4 | |
您还应该编译和安装默认扩展：
1 2 3 | |
构建 SynchDB 主要组件¶
→ 构建 Debezium Runner Engine¶
以下命令将构建 Debezium Runner Engine jar 文件并将其安装到 PostgreSQL 的 lib 文件夹中。
cd /home/$USER/postgres/contrib/synchdb
make build_dbz
sudo make install_dbz
→ 构建 Oracle 解析器（可选）¶
此 Oracle 解析器（一个共享库）是 IvorySQL Oracle 解析器的修改版和独立版本，Openlog 复制器需要它来处理传入的 Oracle DDL 语句。以下命令将 Oracle 解析器安装到 PostgreSQL 的 lib 文件夹中。
警告：如果 SynchDB 构建时支持 Openlog 复制器，则需要此解析器。
cd /home/$USER/postgres/contrib/synchdb
make clean_oracle_parser
make oracle_parser
sudo make install_oracle_parser
→ 构建 SynchDB¶
以下命令将构建 SynchDB 扩展并将其安装到 PostgreSQL 的 lib 和共享文件夹中。
cd /home/$USER/postgres/contrib/synchdb
make
sudo make install
SynchDB 可以在构建时添加额外的 Openlog Replicator Connector 支持。
cd /home/$USER/postgres/contrib/synchdb
make WITH_OLR=1 clean
make WITH_OLR=1
sudo make WITH_OLR=1 install
警告：Openlog Replicator Connector 支持需要“libprotobuf-c”和“oracle parser”。
配置 Linker 以访问 Java（Ubuntu）¶
最后，我们还需要告诉系统的 Linker 新添加的 Java 库 (libjvm.so) 在系统中的位置。
# 动态设置 JDK 路径
JAVA_PATH=$(which java)
JDK_HOME_PATH=$(readlink -f ${JAVA_PATH} | sed 's:/bin/java::')
JDK_LIB_PATH=${JDK_HOME_PATH}/lib
echo $JDK_LIB_PATH
echo $JDK_LIB_PATH/server
sudo echo "$JDK_LIB_PATH" ｜ sudo tee -a /etc/ld.so.conf.d/x86_64-linux-gnu.conf
sudo echo "$JDK_LIB_PATH/server" | sudo tee -a /etc/ld.so.conf.d/x86_64-linux-gnu.conf
运行 ldconfig 重新加载：
sudo ldconfig
确保 synchdo.so 扩展可以链接到系统上的 libjvm Java 库：
ldd synchdb.so
linux-vdso.so.1 (0x00007ffeae35a000)
libjvm.so => /usr/lib/jdk-22.0.1/lib/server/libjvm.so (0x00007fc1276c1000)
libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007fc127498000)
libdl.so.2 => /lib/x86_64-linux-gnu/libdl.so.2 (0x00007fc127493000)
libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007fc12748e000)
librt.so.1 => /lib/x86_64-linux-gnu/librt.so.1 (0x00007fc127489000)
libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x00007fc1273a0000)
/lib64/ld-linux-x86-64.so.2 (0x00007fc128b81000)
如果 SynchDB 构建时支持 openlog replicator，请确保它可以链接到你系统上的 libprotobuf-c 库：
ldd synchdb.so
linux-vdso.so.1 (0x00007ffde6ba5000)
libjvm.so => /home/ubuntu/java/jdk-22.0.1/lib/server/libjvm.so (0x00007f3c8e191000)
libprotobuf-c.so.1 => /usr/local/lib/libprotobuf-c.so.1 (0x00007f3c8e186000)
libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f3c8df5d000)
libdl.so.2 => /lib/x86_64-linux-gnu/libdl.so.2 (0x00007f3c8df58000)
libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007f3c8df53000)
librt.so.1 => /lib/x86_64-linux-gnu/librt.so.1 (0x00007f3c8df4c000)
libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x00007f3c8de65000)
/lib64/ld-linux-x86-64.so.2 (0x00007f3c8f69e000)