#安装前准备

# 服务器准备

# 服务器配置

环境配置项 最低要求 说明
操作系统 CentOS 7.6以上、KylinOS V10
处理器架构 X86-64、ARM-64 处理器架构为ARM-64,YMP所需的JDK版本须为JDK11及以上,能够有效解决可能出现的数据库连接慢问题。
CPU核数 4核及以上
可用内存 8G及以上 根据数据库模型复杂度,对内存的使用情况不同,配置参考:迁移常见问题22
磁盘可用空间 SSD,可用大小根据迁移表大小而定 建议不小于待迁移表中的最大单表数据量的3倍

Note:

部署环境配置至少满足最低要求,更低的配置,虽然可以修改配置参数运行YMP系统,但是有可能在任务使用过程中出现卡顿,内存溢出等问题。

# 操作系统参数调整

需确保操作系统max user processes最大用户线程数不小于65535。

Note:

建议修改完毕后使用ulimit -u查看YMP所在用户下的最大限制线程数修改是否生效。

# 查看最大用户线程数
# ulimit -u

# 执行如下命令使最大用户线程数临时生效,重启后无效
# ulimit -u 65536

# 执行执行如下命令将最大用户线程数写入/etc/security/limits.conf文件,重启后参数永久生效
# echo "
#  * soft nproc 65536
#  * hard nproc 65536
#  " >> /etc/security/limits.conf
#
# 同时对于特定的用户可以执行如下命令查看线程限制数
# centos6.5:
# cat /etc/security/limits.d/90-nproc.conf
# centos7:
# cat /etc/security/limits.d/20-nproc.conf
# 修改YMP所在用户下的最大限制线程数
# centos6.5:
# echo "
#  YMP所在用户 soft nproc 65536
#  YMP所在用户 hard nproc 65536
#  " >> /etc/security/limits.d/90-nproc.conf
# centos7:
# echo "
#  YMP所在用户 soft nproc 65536
#  YMP所在用户 hard nproc 65536
#  " >> /etc/security/limits.d/20-nproc.conf
Copied!

# 目录划分

建议在服务器 新建用户以安装部署YMP,注意YMP安装路径不可包含英文句号,以使用新建YMP用户为例,安装路径为/home/ymp。

如安装路径下已存在db目录与bin/yasldr目录(例如/home/ymp/yashan-migrate-platform/db与/home/ymp/yashan-migrate-platform/bin/yashandb_client),需先清空目录。

# 开放端口

安装默认端口号

端口列表请参考:端口列表

YMP监听 数据库监听 主机间通信 yasom yasagent
8090 8091 8092 8093 8094

方式一:关闭防火墙

在主机上执行如下命令关闭防火墙:

# 关闭防火墙
# systemctl stop firewalld 

# 关闭开机自启
# systemctl disable firewalld
Copied!

方式二:添加白名单

如果防火墙不能关闭,则需按如下步骤添加端口到白名单中:

1.查看防火墙端口开放情况:

# firewall-cmd --zone=public --list-ports
Copied!

2.添加端口到防火墙(Firewall):

这里以8090为例演示如何添加端口到防火墙中,其他端口操作方法相同。

# 添加(--permanent 永久生效,没有此参数重启后失效)
# firewall-cmd --zone=public --add-port=8090/tcp --permanent

# 重新载入
# firewall-cmd --reload

# 查看
# firewall-cmd --zone=public --query-port=8090/tcp
Copied!

如需从白名单中删除已添加的端口,使用如下命令:

# 删除已添加的端口
# firewall-cmd --zone=public --remove-port=8090/tcp --permanent
Copied!

# 用户准备

创建一个用户用于安装YMP,以YMP为例,在用户创建和授权后,后续所有安装步骤均在该用户下操作。

# 新建YMP用户
# useradd -d /home/ymp -m ymp
# passwd ymp
Copied!

# 应用环境准备

# 服务器工具准备

# 安装lsof命令工具
# yum install -y lsof
Copied!

# JDK环境准备

YMP的JDK版本要求见:支持的JDK,支持通过Java官方路径下载上述版本的JDK并安装成功后,还需配置如下环境变量:

# 以JDK8安装路径为/usr/tools/jdk8为例
# vi /etc/profile

# 在文件结尾添加如下
# export JAVA_HOME=/usr/tools/jdk8
# export PATH=$JAVA_HOME/bin:$PATH
# export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

# 重新载入配置文件
# source /etc/profile

# 安装成功后查看JDK版本信息
# java -version
Copied!

# libaio环境准备

YMP运行需要libaio动态库。

# 查看是否已安装libaio动态库
# rpm -qa | grep libaio

# 若未有版本信息打印,安装libaio
# yum install -y libaio
Copied!

# OCI环境准备(可选)

如需要使用Oracle到YashanDB的数据迁移功能,请进行OCI环境安装,OCI版本要求见:支持的OCI

上传安装包至YMP用户/home/ymp/路径:

# 修改安装包所属用户及用户组为ymp用户
# chown ymp:ymp instantclient-xxx

# 从root用户切换至ymp用户
# su - ymp

# 切换至安装路径
$ cd /home/ymp

# 解压OCI安装包
$ unzip instantclient-xxx
Copied!

# YashanDB环境准备(可选)

使用默认内置库时,本步骤可省略。

使用自定义内置库时:

  • 如需一个全新的YashanDB单机环境,参考YashanDB官网文档进行安装部署。

  • 如为一个已有的YashanDB单机环境,则需由DBA在该环境中执行如下脚本:

 -- 创建一个ymp用户(以YMP_DEFAULT为例)并为其授权
 create user YMP_DEFAULT IDENTIFIED BY ymppw602 DEFAULT TABLESPACE users;
 GRANT ALL PRIVILEGES TO YMP_DEFAULT;
 GRANT DBA TO YMP_DEFAULT;
Copied!

# 软件包准备

请根据实际需求向我们的技术支持获取软件包:(xx.xx为软件版本号)

软件包名称 说明 获取方式
yashan-migrate-platform-xx.xx-linux-aarch64.zip
yashan-migrate-platform-xx.xx-linux-x86-64.zip
YMP安装包,用于在Linux x86_64/arm64平台进行YMP的安装和部署。 请根据实际需求向我们的技术支持获取软件包。
yashandb-xx.xx-linux-x86_64.tar.gz
yashandb-xx.xx-linux-aarch64.tar.gz
YashanDB安装包,用于在Linux x86_64/arm64平台下进行默认内置库的安装和部署,要求使用和迁移目标库相同的版本。 请根据实际需求向我们的技术支持获取软件包。

从本步骤开始的后续所有服务端安装步骤,将由YMP安装用户来进行操作,请先切换至YMP用户,或以YMP用户登录至服务器。

将YashanDB安装包上传至YMP用户/home/ymp/路径下:

#修改安装包所属用户及用户组为ymp用户
# chown ymp:ymp yashandb-xx.xx-linux-x86_64.tar.gz

# 从root用户切换至ymp用户
# su - ymp

# 切换至安装路径
$ cd /home/ymp
Copied!

# 三方依赖版本

依赖项 版本要求 说明
JDK JDK8、JDK11、JDK17 1. YMP仅支持在JDK8、JDK11或JDK17的下安装使用。
2.处理器架构为ARM-64,YMP所需的JDK版本须为JDK11及以上,能够有效解决可能出现的数据库连接慢问题。
OCI客户端 19.19.0.0.0及以上版本 准备OCI环境需从Oracle官网 (opens new window)下载OCI客户端并依据官网所列步骤进行安装。
根据处理器架构不同,建议下载和安装的版本信息如下:
1. instantclient-basic-linux.x64-19.19.0.0.0dbru.el9.zip
2. instantclient-basic-linux.arm64-19.10.0.0.0dbru-2.zip
yasldr工具 和YashanDB目标端数据库版本保持一致

Note:

若需要将源端的数据迁移到YashanDB的23.2、23.3版本目标端,须保持YMP环境与目标端环境的OPENSSL版本一致,版本要求参考YashanDB产品文档说明。可能遇到问题见:迁移常见问题

# 客户端浏览器

YMP支持浏览器Google Chrome、Microsoft Edge和Firefox,建议使用当前较新的版本。

浏览器支持 要求版本
Google Chrome 88 及以上版本
Microsoft Edge 88 及以上版本
Firefox 78 及以上版本