U8C数据拆分/转换操作手册一、初次使用登录增值服务平台（友户通用户名/密码）：https://vasp.yyu8c.com第一步：创建网关【网关管理】-【新增】注意事项：（1）网关可对租户授权（非必填）网关对租户授权后，此网关可对拥有此租户管理权限的所有用户共享。即拥有授权租户管理权限的所有用户，也可使用此网关。（2）IP白名单（非必填）可设置网关启动的机器的白名单。设置后，网关启动时会校验网关启动时机器的IP地址，未在白名单中，则网关会启动失败。（3）MAC白名单（非必填）可设置网关启动的机器的MAC白名单。设置后，网关启动时会校验网关启动时机器的MAC地址，未在白名单中，则网关会启动失败。第二步：工具下载（1）拆分/转换客户端下载【数据拆分/转换】-【使用指南】点击下载按钮，进行下载。下载可能需要几分钟，请耐心等待。下载完毕，打开现在目录找到【databaseMigration.7z】解压到任意盘符的根路径即可，建议C盘或D盘根路径（注意路径不可有中文）。第三步：服务启停准备好下载的附件。（1）拆分/转换客户端（1.1）windows环境启停（1.1.1）解压启动工具到任意盘符根路径（注意路径中不要有中文）（1.1.2）启动tomcat【databaseMigration/apache-tomcat-9.0.63/bin/startup.bat】启动：右击startup.bat，以管理员身份运行；停止：右击shutdown.bat，以管理员身份运行；（1.1.3）启停标志启动成功标志：停止成功标志：上述TOMCAT窗口关闭。（1.2）linux环境启停（1.2.1）上传并解压启动工具到任意目录（1.2.2）授权进入到databaseMigration解压后目录cddatabaseMigration执行以下两条授权命令：chmod777./jre-8u271-unix-x64/bin/*chmod777./apache-tomcat-9.0.63/bin/*.sh（1.2.3）启动tomcat【databaseMigration/apache-tomcat-9.0.63/bin/startup.sh】先进入到tomcat的bin目录下【cdapache-tomcat-9.0.63/bin】（必须在bin目录下执行）启动：./startup.sh停止：./shutdown.sh操作截图如下：进入bin目录下，启动：停止：（1.2.4）启停标志启动成功标志：执行命令【ps-ef|grepjava】，发现此tomcat进程。查看日志【tail-f-n500./apache-tomcat-9.0.63/bin/logs/catalina.out】停止成功标志：执行命令【ps-ef|grepjava】，发现tomcat进程已被停止。（2）网关客户端（2.1）windows环境启停（2.1.1）下载网关code文件【网关管理】-【网关code下载】下载文件如下【gateway.txt】：文件放入databaseMigration\gateway-client\conf（注意文件名必须是gateway.txt）。（2.1.2）启动服务databaseMigration\gatewayclient-windows-start.bat启动：右击gatewayclient-windows-start.bat，以管理员身份运行；停止：右击gatewayclient-windows-stop.bat，以管理员身份运行；（2.1.3）启停标志启动成功标志：停止成功标志：启动时的CMD窗口关闭，网关状态为下线（执行停止脚本后，注意有30秒的延迟）。（2.2）linux环境启停（2.2.1）下载网关code文件【网关管理】-【网关code下载】下载文件如下【gateway.txt】：文件放入databaseMigration\gateway-client\conf（注意文件名必须是gateway.txt）。（2.2.2）授权进入到databaseMigration解压目录下，执行以下两条授权命令：chmod-R777../databaseMigration/*.shchmod777./jre-8u271-unix-x64/bin/*（2.2.3）启动服务databaseMigration\gatewayclient-linux-startup.sh启动：./gatewayclient-linux-startup.sh停止：./gatewayclient-linux-stop.sh启动操作：查看日志：【tail-f-n500gateway-client/logs/all.log】停止操作：（2.2.4）启停标志启动成功标志：停止成功标志：网关状态为下线状态（执行停止脚本后，注意有30秒的延迟）。二、应用激活第一步：拆分/转换客户端前检查（1）拆分/转换客户端客户端是否启动请见拆分/转换客户端客户端启动启动（2）网关客户端是否启动请见网关客户端启动第二步：创建激活任务填写激活信息点击确认按钮后，后台开始进行激活，稍等片刻，刷新页面，状态便可变为激活成功。激活状态可能是中间状态，请勿重复激活。激活成功如有异常报错信息需具体支持，请联系开发运维人员（17610026937-王潮）。三、拆分/转换任务第一步：拆分/转换前检查（1）拆分/转换客户端是否启动请见拆分/转换客户端启动启动（2）网关客户端是否启动请见网关客户端启动第二步：创建拆分/转换任务（1）复制网关code（2）创建拆分/转换任务（2.1）整库转换（2.2）条件拆分点击下拉选时，会对源数据库进行数据检索，并将查询结果返回。如果下拉选长时间无数据：（1）检查网关客户端、拆分/转换客户端是否启动（2）确认源数据库信息是否正确，并确保数据库可正常连接第三步：开始任务如果任务类型为条件拆分，则还需要对任务目标库进行U8C金盘安装，安装成功之后，方可开始执行任务。点击【开始执行】按钮第四步：获取任务结果（1）查看任务进度点击【查看日志】按钮（2）任务执行成功任务完全执行成功的标识：任务执行完毕，且未有出错信息如有异常报错信息需具体支持，请联系开发运维人员（17610026937-王潮）。如图：（3）任务执行异常当任务异常终止时，可查看异常原因。常见异常原因：（1）数据库连接异常数据库连接超时：可能数据库连接信息配置错误、oracle监听未启动等（2）程序异常终止可能原因：数据库连接数已满，导致后续拆分/转换客户端任务无法建立连接、程序异常关闭（3）任务执行完毕，关闭客户端直接关闭任务黑窗口即可（2个）。（A）拆分/转换客户端关闭；（B）网关客户端关闭；四、拆分/转换客户端客户端升级将之前下载的工具包完全删除，重新下载解压即可，具体请见工具下载章节
