#安装与卸载

# 解压

上传YMP安装包至/home/ymp目录下然后解压：

# 切换至YMP安装目录
$ cd /home/ymp/
$ unzip yashan-migrate-platform-xx.x.x.x-linux-xxx.zip

Copied!

# 安装参数调整

依据实际需要对默认内置库安装及YMP启动参数进行调整。

参数及配置选项详见：内置库安装配置参数说明
参数及配置选项详见：YMP配置参数说明
参数及配置选项详见：YMP日志配置参数说明

# 密码要求

密码长度为8-64位且必须同时包含数字、大写字母、小写字母和特殊字符。
特殊字符暂不支持单引号（'）、双引号（"）、与（&）。

# 更改用户密码

更改用户密码时存在如下限制：

无论使用内置库还是外置库，密码都需符合密码要求。
使用外置库时创建的业务库密码也需符合密码要求。

# 执行安装命令

您可通过以下命令查看脚本参数及其使用方法：

# 进入安装目录查看帮助
$ cd /home/ymp/yashan-migrate-platform/
$ sh bin/ymp.sh -h

Copied!

# 默认内置库安装YMP（推荐方案）

YMP安装时按默认方式自行安装YashanDB作为内置库。默认内置库相关信息：

部署形态：单机
集群名称：ymp
安装目录：/home/ymp/yashan-migrate-platform/db

# 更改内置库SYS用户默认密码（可选）

修改密码存在以下额外限制：

仅在安装部署执行前生效。
参考密码要求，且密码中不能包含sys字符串。

# 进入安装目录执行更改密码命令,以yasdb_123为例：
$ cd /home/ymp/yashan-migrate-platform/
$ sh bin/ymp.sh password --sys yasdb_123

Copied!

# 执行安装

方式一：安装内置库并启动YMP

# 进入安装目录执行安装命令
$ cd /home/ymp/yashan-migrate-platform/
$ sh bin/ymp.sh install --db /home/ymp/yashandb-23.2.1.0-linux-x86_64.tar.gz

Copied!

方式二（Oracle做数据源的推荐方案）：安装内置库和OCI客户端并启动YMP

# 进入安装目录执行安装命令
$ cd /home/ymp/yashan-migrate-platform/
$ sh bin/ymp.sh install --db /home/ymp/yashandb-23.2.1.0-linux-x86_64.tar.gz --path /home/ymp/instantclient_xxx

Copied!

# 查看运行状态

 $ cd /home/ymp/yashan-migrate-platform/
 $ sh bin/ymp.sh status
 YMP is running, pid is 7747.
 Built-in database is used, pid is 7617.

Copied!

# 自定义内置库安装YMP

使用自定义内置库指使用外部的YashanDB数据库作为YMP的业务库使用，YMP安装时不再安装YashanDB数据库。

不能使用迁移的目标库作为自定义内置库。

修改配置文件

# 修改yashan-migration-platform/conf/application.properties文件

# 进入安装目录
$ cd /home/ymp/yashan-migrate-platform/

# 执行更改连接信息指令，指定自定义内置库的url，格式为 IP:PORT；默认可不指定username与password，即为默认的"YMP_DEFAULT"与"Ymppw602."
$ sh bin/ymp.sh connection --url 192.168.x.x:xxxx

# 若需要在指定自定义数据库的时候修改用户信息（以用户YMP_NEW的密码为ymp_new为例），则可参考如下命令：
$ sh bin/ymp.sh connection --url 192.168.x.x:xxxx --username YMP_NEW --password ymp_new

Copied!

# 执行安装

方式一：安装yasldr依赖库并启动YMP

如无需使用Oracle到YashanDB的数据迁移功能，可通过这种方式部署。

# 进入安装目录执行卸载命令
$ cd /home/ymp/yashan-migrate-platform/
$ sh bin/ymp.sh installnodb --db /home/ymp/yashandb-23.2.1.0-linux-x86_64.tar.gz

Copied!

方式二：（Oracle做数据源的推荐方案）安装yasldr依赖库和OCI客户端并启动YMP

# 进入安装目录执行安装命令
$ cd /home/ymp/yashan-migrate-platform/
$ sh bin/ymp.sh installnodb --db /home/ymp/yashandb-23.2.1.0-linux-x86_64.tar.gz --path /home/ymp/instantclient_xxx

Copied!

# 查看运行状态

 $ cd /home/ymp/yashan-migrate-platform/
 $ sh bin/ymp.sh status
 YMP is running, pid is 24116.
 Built-in database is not used!

Copied!

# 查看版本

 $ cd /home/ymp/yashan-migrate-platform/
 $ sh bin/ymp.sh -v
 Yashan-migrate-platform version: Release v23.2.1.0
 YashanDB SQL Enterprise Edition Release v23.2.1.0 x86_64
 YashanDB Loader Enterprise Edition Release v23.2.1.0 x86_64 faec879

Copied!

# 访问YMP

访问方式：http://IP:PORT/，PORT默认8090，初始账户名和密码是（admin/admin）。

测试访问页面

# 卸载YMP

 $ cd /home/ymp/yashan-migrate-platform/
 $ sh bin/ymp.sh uninstall
 
 # 使用uninstall功能时可携带-f参数，强制清理环境
 $ sh bin/ymp.sh uninstall -f
  
 # 验证
 $ ps -ef | grep yas
 ymp       20840  6322  0 10:02 pts/14   00:00:00 grep --color=auto yas

Copied!

卸载YMP时，会删除默认内置库（自定义内置库不受影响）并清空db和yashan_client文件夹，若想替换数据库版本，请在卸载后重新部署。
强制清理功能会使用kill -9强制清理当前用户下YMP启动的所有进程，并删除内置库及yasldr文件夹下所有内容，请谨慎使用，建议在专用的YMP用户下使用。
最后还需要手动删除~/.bashrc中与YashanDB有关的环境变量。