ToroDB Stampede 二进制安装指南

ToroDB Stampede 二进制安装指南

前言

ToroDB Stampede 是一个开源的数据库解决方案，它能够将MongoDB的数据实时同步到PostgreSQL中。本文将详细介绍如何通过二进制分发版快速安装和配置ToroDB Stampede，适用于Linux、macOS和Windows操作系统。

系统要求

在开始安装前，请确保您的系统满足以下基本要求：

1. 已安装Java运行环境（JRE 8或更高版本）
2. 已安装并配置PostgreSQL数据库（9.5或更高版本）
3. 系统有足够的资源运行服务

Linux/macOS安装步骤

快速安装方法

对于Linux和macOS用户，可以通过简单的命令行操作完成安装：

# 下载最新版二进制包
wget https://www.torodb.com/download/torodb-stampede-latest.tar.bz2

# 解压下载的压缩包
tar xjf torodb-stampede-*.tar.bz2

# 设置环境变量
export TOROHOME="$(pwd)/torodb-stampede-*"

# 启动ToroDB Stampede
"$TOROHOME/bin/torodb-stampede"

配置为systemd服务（Linux专用）

对于生产环境，建议将ToroDB Stampede配置为系统服务：

1. 创建符号链接：

sudo ln -s "$TOROHOME/bin/torodb-stampede" /usr/bin/.

2. 创建专用用户：

sudo useradd -M -d "$TOROHOME" torodb

3. 复制服务配置文件：

sudo cp "$TOROHOME/systemd/torodb-stampede.service.sample" /lib/systemd/system/torodb-stampede.service

服务管理命令

启用并启动服务：

sudo systemctl enable torodb-stampede
sudo systemctl start torodb-stampede

停止服务：

sudo systemctl stop torodb-stampede

查看日志：

# 查看最新日志
sudo journalctl --no-pager -u torodb-stampede

# 实时跟踪日志
sudo journalctl --no-pager -u torodb-stampede -f

# 查看完整日志
sudo journalctl --no-tail --no-pager -u torodb-stampede

Windows安装步骤

Windows用户可以按照以下步骤安装：

1. 下载Windows版二进制包（ZIP格式）
2. 解压到目标目录（如C:\torodb-stampede）
3. 设置环境变量TOROHOME指向解压目录
4. 通过以下方式启动：
   • 命令行：C:\>%TOROHOME%\bin\torodb-stampede
   • 或双击bin目录中的torodb-stampede.bat文件

配置说明

默认情况下，ToroDB Stampede会使用以下配置：

• 从用户主目录下的.toropass文件读取PostgreSQL连接信息
• 使用标准端口监听MongoDB连接

如需自定义配置，可以修改解压目录中的配置文件，或通过命令行参数指定。

常见问题

1. 权限问题：确保运行服务的用户对安装目录有读写权限
2. 端口冲突：检查默认端口27017是否被占用
3. PostgreSQL连接失败：确认.toropass文件格式正确且包含有效的连接信息

后续步骤

成功安装后，您可以：

• 配置MongoDB源数据库连接
• 设置同步规则和过滤条件
• 监控同步状态和性能

通过以上步骤，您应该已经成功安装了ToroDB Stampede。如需更详细的配置和使用指南，请参考相关文档。