#安装前准备
# 服务器准备
# 服务器配置
环境配置项 | 最低要求 | 说明 |
---|---|---|
操作系统 | 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
# 目录划分
建议在服务器 新建用户以安装部署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
方式二:添加白名单
如果防火墙不能关闭,则需按如下步骤添加端口到白名单中:
1.查看防火墙端口开放情况:
# firewall-cmd --zone=public --list-ports
2.添加端口到防火墙(Firewall):
这里以8090为例演示如何添加端口到防火墙中,其他端口操作方法相同。
# 添加(--permanent 永久生效,没有此参数重启后失效)
# firewall-cmd --zone=public --add-port=8090/tcp --permanent
# 重新载入
# firewall-cmd --reload
# 查看
# firewall-cmd --zone=public --query-port=8090/tcp
如需从白名单中删除已添加的端口,使用如下命令:
# 删除已添加的端口
# firewall-cmd --zone=public --remove-port=8090/tcp --permanent
# 用户准备
创建一个用户用于安装YMP,以YMP为例,在用户创建和授权后,后续所有安装步骤均在该用户下操作。
# 新建YMP用户
# useradd -d /home/ymp -m ymp
# passwd ymp
# 应用环境准备
# 服务器工具准备
# 安装lsof命令工具
# yum install -y lsof
# 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
# libaio环境准备
YMP运行需要libaio动态库。
# 查看是否已安装libaio动态库
# rpm -qa | grep libaio
# 若未有版本信息打印,安装libaio
# yum install -y libaio
# 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
# 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;
# 软件包准备
请根据实际需求向我们的技术支持获取软件包:(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
# 三方依赖版本
依赖项 | 版本要求 | 说明 |
---|---|---|
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 及以上版本 |