在知识库中专注阅读，并随时返回相关工具与课程
大家好，这里是公众号 DBA学习之路，分享一些学习国产数据库路上的知识和经验。 @TOC目录 本次 YCP 考试还涉及到了 YMP 迁移工具，本文演示如何快速安装部署一套 YMP 环境。 崖山迁移平台（YashanDB Migration Platform，YMP）是 YashanDB 提供的数据库迁移产品，提供异构 RDBMS 与 YashanDB 之间进行迁移评估、离线迁移、数据校验的能力。Y
大家好，这里是公众号 DBA学习之路，分享一些学习国产数据库路上的知识和经验。
本章目标：掌握本章核心知识点 前置要求：完成前序章节学习 预计时长：60 分钟
本次 YCP 考试还涉及到了 YMP 迁移工具，本文演示如何快速安装部署一套 YMP 环境。
崖山迁移平台（YashanDB Migration Platform，YMP）是 YashanDB 提供的数据库迁移产品，提供异构 RDBMS 与 YashanDB 之间进行迁移评估、离线迁移、数据校验的能力。YMP 提供可视化服务，用户只需通过简单的界面操作，即可完成从评估到迁移整个流程的执行与监控，实现低门槛、低成本、高效率的异构数据库迁移。
崖山迁移平台（YashanDB Migration Platform，YMP）的总体架构如下：
支持的源端数据库类型和版本：
支持的目标端数据库类型和版本：
支持的源端数据库数据类型：
官方文档提示：理论兼容版本未进行全部的功能验证，可能需要适配兼容。
官方建议内存至少为 8G，因为安装 YMP 时建议内置安装 YashanDB 用于迁移评估，所以内存不足可能会导致安装失败。
注意：若需要使用数据迁移功能，须保持 YMP 环境与目标端环境的 OPENSSL 版本一致，且都需满足 openssl 版本至少 1.1.1 及以上。
YashanDB 安装建议关闭防火墙：
1systemctl stop firewalld2systemctl disable firewalld需确保操作系统 max user processes 最大用户线程数不小于 65535：
1cat<<-EOF>>/etc/security/limits.d/20-nproc.conf2ymp soft nproc 655363ymp hard nproc 655364EOF创建一个用户用于安装YMP，以YMP为例，在用户创建和授权后，后续所有安装步骤均在该用户下操作：
1useradd -d /home/ymp -m ymp2echo "ymp:ymp" | chpasswd安装 YMP 需要 lsof 命令工具以及 libaio 动态库：
1yum install -y lsof libaio如果没有配置软件源，可以参考：DBA 必备：Linux 软件源配置全攻略。
YMP 的 JDK 版本要求参考如下：
支持通过 Java 官方路径 下载上述版本的 JDK 并安装成功后，还需配置如下环境变量：
1# 以 JDK 安装路径为 /usr/tools/jdk8 为例2cat<<-EOF>>/etc/profile3export JAVA_HOME=/usr/tools/jdk84export PATH=$JAVA_HOME/bin:$PATH5export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar6EOF7# 重新载入配置文件8source /etc/profile9# 安装成功后查看 JDK 版本信息10java -version如需要使用 Oracle 到 YashanDB 的数据迁移功能，请进行 OCI 环境安装，OCI 版本要求参考如下：
OCI 下载地址（链接直达官方下载）：instantclient-basic-linux.x64-19.19.0.0.0dbru.el9.zip
上传 OCI 安装包至 YMP 用户 /home/ymp/ 路径，手动解压即可：
1[root@ymp ~]# chown ymp:ymp /home/ymp/instantclient-basic-linux.x64-19.19.0.0.0dbru.el9.zip2[root@ymp ~]# su - ymp3[ymp@ymp ~]$ unzip -q instantclient-basic-linux.x64-19.19.0.0.0dbru.el9.zip后续安装 YMP 需要指定解压文件路径。
上传 YMP 安装包至 /home/ymp 目录下然后解压：
1# 修改安装包所属用户及用户组为 ymp 用户2[root@ymp ~]# chown ymp:ymp /home/ymp/yashan-migrate-platform-v23.2.1.3-linux-x86-64.zip3[root@ymp ~]# chown ymp:ymp /home/ymp/yashandb-personal-23.2.3.100-linux-x86_64.tar.gz4[root@ymp ~]# su - ymp5[ymp@ymp ~]$ unzip -q yashan-migrate-platform-v23.2.1.3-linux-x86-64.zip依据实际需要对默认内置库安装及 YMP 启动参数进行调整（参数配置文件存放在 /home/ymp/yashan-migrate-platform/conf 目录）：
📢注意：如果系统内存不足 8G，可以在安装 YMP 前将 ymp_memory 参数修改为 2G，默认值为 4G。
YMP 安装时按默认方式自行安装 YashanDB 作为内置库。默认内置库相关信息：
进入安装目录查看帮助文档：
1[ymp@ymp ~]$ cd /home/ymp/yashan-migrate-platform/bin2[ymp@ymp bin]$ ./ymp.sh -h34Usages: ./ymp.sh [<flags>] <command>56Yashan-migrate-platform version: Release v23.2.1.378Flags:9 -h,--help Show detailed help information10 -v,--version Show Yashan-migrate-platform version information1112Commonly used commands:13 install Initialize YMP with the built-in database and start14 --db <package path> new yashandb and yasldr package path15 [ --path <oci path> ] absolute path of the OCI installation16 restart Restart YMP with the built-in database17 status View status of YMP and built-in database18 uninstall Uninstall the built-in database19 [ -f ] force clean the environment20 upgrade Upgrade old version of YMP to new version21 --from <ymp path> path of old version of YMP22 [ --db <package path> ] new yashandb and yasldr package path23 [ --path <oci path> ] absolute path of the OCI installation24 password Change the password of YMP25 --sys <password> change sys password of built-in database in db.properties26 | --user <password> change user password of database in application.properties27 connection Change url、username、password of YMP28 --url <url path> change url in application.properties29 --username <username> change username in application.properties30 --password <password> change password in application.properties313233Other commands:34 start Start YMP with the built-in database35 stop Stop YMP with the built-in database36 startnodb Start YMP with external database37 stopnodb Stop YMP with external database38 restartnodb Restart YMP with external database39 replace Replace yasldr version, need to restart ymp40 --yasldr <package path> new yasldr package path41 installnodb Initialize YMP with external database and start42 --db <package path> new yasldr package path43 [ --path <oci path> ] absolute path of the OCI installation官方建议使用内置库方式安装 YMP，如果不使用内置库方式安装，则需要创建一个 ymp 用户（以 YMP_DEFAULT 为例）并为其授权：
1-- 本文不需要做2SQL> create user YMP_DEFAULT IDENTIFIED BY ymppw602 DEFAULT TABLESPACE users;3SQL> GRANT ALL PRIVILEGES TO YMP_DEFAULT;4SQL> GRANT DBA TO YMP_DEFAULT;依据实际需要对默认内置库安装及 YMP 启动参数进行调整：
1# 进入安装目录执行更改密码命令，以 yasdb_123 为例：2[ymp@ymp ~]$ cd /home/ymp/yashan-migrate-platform/bin/3[ymp@ymp bin]$ ./ymp.sh password --sys yasdb_12342024-09-19 22:40:47 INFO --- [main] com.sics.command.YmpCommandMain : 指令入参：["--operation","password","--sys","yasdb_123"]52024-09-19 22:40:47 INFO --- [main] com.sics.command.serviceimpl.PasswordServiceImpl : Update sys password and salt successfully!62024-09-19 22:40:47 INFO --- [main] com.sics.command.operation.FunctionOperation : YMP update password for SYS user successfully!以上配置仅在安装部署前执行前生效。
执行内置库安装 YMP：
1# （Oracle 做数据源的推荐方案）：安装内置库和 OCI 客户端并启动 YMP2[ymp@ymp ~]$ cd /home/ymp/yashan-migrate-platform/bin/3[ymp@ymp bin]$ ./ymp.sh install --db /home/ymp/yashandb-personal-23.2.3.100-linux-x86_64.tar.gz --path /home/ymp/instantclient_19_1942024-09-19 22:44:43 INFO --- [main] com.sics.command.YmpCommandMain : 指令入参：["--operation","install","--db","/home/ymp/yashandb-personal-23.2.3.100-linux-x86_64.tar.gz","--path","/home/ymp/instantclient_19_19","--ip","192.168.6.167","--memory","4G"]52024-09-19 22:44:46 INFO --- [main] com.sics.command.serviceimpl.CheckServiceImpl : Check for env before install is successfully!62024-09-19 22:44:51 INFO --- [main] com.sics.command.serviceimpl.PackageServiceImpl : Db package unpackage successfully!72024-09-19 22:44:51 INFO --- [main] com.sics.command.serviceimpl.CheckServiceImpl : OCI version is 19.19.0.0.0!82024-09-19 22:44:56 INFO --- [main] com.sics.command.serviceimpl.PackageServiceImpl : Yasldr package unpackage successfully!92024-09-19 22:44:56 INFO --- [main] com.sics.command.util.CommandUtil : host host0001 openssl version: OpenSSL 1.1.1l 24 Aug 2021102024-09-19 22:44:56 INFO --- [main] com.sics.command.util.CommandUtil : OpenSSL version is 1.1.1 or greater112024-09-19 22:44:56 INFO --- [main] com.sics.command.util.CommandUtil : host host0001 openssl version: OpenSSL 1.1.1l 24 Aug 2021122024-09-19 22:44:56 INFO --- [main] com.sics.command.util.CommandUtil : OpenSSL version is 1.1.1 or greater132024-09-19 22:44:56 INFO --- [main] com.sics.command.util.CommandUtil : hostid | group | node_type | node_name | listen_addr | replication_addr | data_path142024-09-19 22:44:56 INFO --- [main] com.sics.command.util.CommandUtil : ----------------------------------------------------------------------------------------------------------------------------152024-09-19 22:44:56 INFO --- [main] com.sics.command.util.CommandUtil : host0001 | dbg1 | db | 1-1 | 0.0.0.0:8091 | 127.0.0.1:8092 | /home/ymp/yashan-migrate-platform/db/data/ymp162024-09-19 22:44:56 INFO --- [main] com.sics.command.util.CommandUtil : ----------+-------+-----------+-----------+--------------+------------------+-----------------------------------------------172024-09-19 22:44:56 INFO --- [main] com.sics.command.util.CommandUtil :182024-09-19 22:44:56 INFO --- [main] com.sics.command.util.CommandUtil : Generate config success192024-09-19 22:45:05 INFO --- [main] com.sics.command.util.CommandUtil : host host0001 openssl version: OpenSSL 1.1.1l 24 Aug 2021202024-09-19 22:45:05 INFO --- [main] com.sics.command.util.CommandUtil : OpenSSL version is 1.1.1 or greater212024-09-19 22:45:05 INFO --- [main] com.sics.command.util.CommandUtil : checking install profile.toml...222024-09-19 22:45:05 INFO --- [main] com.sics.command.util.CommandUtil : install version: yashandb 23.2.3.100232024-09-19 22:45:05 INFO --- [main] com.sics.command.util.CommandUtil : update host to yasom...24 type | uuid | name | hostid | index | status | return_code | progress | cost252024-09-19 22:45:41 INFO --- [main] com.sics.command.util.CommandUtil : ---------------------------------------------------------------------------------------------------------262024-09-19 22:45:41 INFO --- [main] com.sics.command.util.CommandUtil : task | 23c4a3c120ffbc68 | DeployYasdbCluster | - | ymp | SUCCESS | 0 | 100 | 33272024-09-19 22:45:41 INFO --- [main] com.sics.command.util.CommandUtil : ------+------------------+--------------------+--------+-------+---------+-------------+----------+------282024-09-19 22:45:41 INFO --- [main] com.sics.command.util.CommandUtil : task completed, status: SUCCESS29 type | uuid | name | hostid | index | status | return_code | progress | cost302024-09-19 22:45:45 INFO --- [main] com.sics.command.util.CommandUtil : -------------------------------------------------------------------------------------------------------312024-09-19 22:45:45 INFO --- [main] com.sics.command.util.CommandUtil : task | 3aae570c40510c80 | StopYasdbCluster | - | ymp | SUCCESS | 0 | 100 | 3322024-09-19 22:45:45 INFO --- [main] com.sics.command.util.CommandUtil : ------+------------------+------------------+--------+-------+---------+-------------+----------+------332024-09-19 22:45:45 INFO --- [main] com.sics.command.util.CommandUtil : task completed, status: SUCCESS342024-09-19 22:45:45 INFO --- [main] com.sics.command.util.CommandUtil : YashanDB Loader Personal Edition Release 23.2.3.100 x86_64 f3452be35 type | uuid | name | hostid | index | status | return_code | progress | cost362024-09-19 22:45:51 INFO --- [main] com.sics.command.util.CommandUtil : --------------------------------------------------------------------------------------------------------372024-09-19 22:45:51 INFO --- [main] com.sics.command.util.CommandUtil : task | 47a4a6ef3b670c73 | StartYasdbCluster | - | ymp | SUCCESS | 0 | 100 | 4382024-09-19 22:45:51 INFO --- [main] com.sics.command.util.CommandUtil : ------+------------------+-------------------+--------+-------+---------+-------------+----------+------392024-09-19 22:45:51 INFO --- [main] com.sics.command.util.CommandUtil : task completed, status: SUCCESS40[Mem:, 7981, 2902, 969, 13, 4109, 4985]412024-09-19 22:45:51 INFO --- [main] com.sics.command.util.CommandUtil : Sep 19, 2024 10:45:51 PM com.sics.migrate.port.common.jna.CallDts dtscInitLog422024-09-19 22:45:51 INFO --- [main] com.sics.command.util.CommandUtil : INFO: ### call dtscInitLog!432024-09-19 22:45:51 INFO --- [main] com.sics.command.util.CommandUtil : Sep 19, 2024 10:45:51 PM com.sics.migrate.port.common.jna.CallDts dtscInitLog442024-09-19 22:45:51 INFO --- [main] com.sics.command.util.CommandUtil : INFO: ### finished dtscInitLog!452024-09-19 22:45:51 INFO --- [main] com.sics.command.serviceimpl.CheckServiceImpl : Yasdts environment check successfully!462024-09-19 22:45:52 INFO --- [main] com.sics.command.serviceimpl.PasswordServiceImpl : Update sys password and salt successfully!47YMP started successfully!查看运行状态，检查是否安装成功：
1[ymp@ymp ~]$ cd /home/ymp/yashan-migrate-platform/bin/2[ymp@ymp bin]$ ./ymp.sh status32024-09-19 22:46:52 INFO --- [main] com.sics.command.YmpCommandMain : 指令入参：["--operation","status"]42024-09-19 22:46:52 INFO --- [main] com.sics.command.serviceimpl.StatusServiceImpl : YMP is running, pid is 3349.52024-09-19 22:46:52 INFO --- [main] com.sics.command.serviceimpl.StatusServiceImpl : Built-in database is used, pid is 3349.1[ymp@ymp bin]$ ./ymp.sh -v22024-09-19 23:05:08 INFO --- [main] com.sics.command.YmpCommandMain : 指令入参：["--operation","version"]32024-09-19 23:05:08 INFO --- [main] com.sics.command.util.CommandUtil : YashanDB Loader Personal Edition Release 23.2.3.100 x86_64 f3452be42024-09-19 23:05:08 INFO --- [main] com.sics.command.operation.QueryOperation :5Yashan-migrate-platform version: Release v23.2.1.36YashanDB SQL Enterprise Edition Release 23.2.3.100 x86_647YashanDB Loader Personal Edition Release 23.2.3.100 x86_64 f3452beYMP 支持浏览器 Google Chrome、Microsoft Edge 和 Firefox，建议使用当前较新的版本：
访问方式：http://IP:PORT/，PORT 默认 8090，初始账户名和密码是（admin/admin）：
1[ymp@ymp ~]$ cd /home/ymp/yashan-migrate-platform/bin/2[ymp@ymp bin]$ ./ymp.sh start1[ymp@ymp ~]$ cd /home/ymp/yashan-migrate-platform/bin/2[ymp@ymp bin]$ ./ymp.sh stop在任务运行过程中停止或重启 YMP 会造成当前阶段任务运行失败，需重新开始当前阶段任务。
1# 对登录用户密码进行重置时，需保证YMP业务库处于正常运行状态2[ymp@ymp ~]$ cd /home/ymp/yashan-migrate-platform/bin/3[ymp@ymp bin]$ ./ymp.sh password --reset4# 重启YMP5[ymp@ymp bin]$ ./ymp.sh restart卸载YMP时，会删除默认内置库（自定义内置库不受影响）并清空db和yashan_client文件夹，若想替换数据库版本，请在卸载后重新部署：
1$ cd /home/ymp/yashan-migrate-platform/2$ sh bin/ymp.sh uninstall3 4## 使用 uninstall 功能时可携带 -f 参数，强制清理环境5$ sh bin/ymp.sh uninstall -f6 7## 验证8$ ps -ef | grep yas | grep -v grep强制清理功能会使用 kill -9 强制清理当前用户下 YMP 启动的所有进程，并删除内置库及 yasldr 文件夹下所有内容，请谨慎使用，建议在专用的 YMP 用户下使用。最后还需要手动删除 ~/.bashrc 中与 YashanDB 有关的环境变量。