一. 文档说明

本文档主要明确了游乐宝快捷迁移娱乐管家单店版中的工作内容、作业准则、工作要求以及禁止事项，请所有实施相关人员务必认真阅读。

二. 系统版本要求

游乐宝版本： V8.1.6886版本及以上

娱乐管家版本： V10.3.6305版本及以上

需注意：

1）游乐宝系统没有开通漫游功能或者漫游全部召回成功才可以使用迁移工具进行升级（漫游召回失败的情况下使用迁移工具升级，召回失败的数据会丢失）

2）娱乐管家系统需要是新安装的系统，不能有营业数据

三. 提前准备事项

3.1 工具准备

工具下载链接：

https://nos-pulic.nos-eastchina1.126.net/%E5%AE%9E%E6%96%BD%E7%BB%84/%E6%B8%B8%E4%B9%90%E5%AE%9D%E8%BF%81%E7%A7%BB%E5%A8%B1%E4%B9%90%E7%AE%A1%E5%AE%B6%E5%B7%A5%E5%85%B7.zip

3.2 数据转换详情（需和客户同步）

1）可转换数据

• 会员个人信息，包括原会员卡号、手机号、会员生日、会员卡有效期、其他原有系统的个人信息等；
• 会员储值余额：代币、金币、彩票、积分、预存款、成长值；
• 会员卡芯片号（支持不需要换卡直接可以使用会员卡）；
• 商品资料：游戏币套餐，预存款套餐，游乐套票等商品
• 零售商品资料和零售商品库存
• 订单明细数据/游玩记录/报表数据等
• 机台项目及参数（转换成功设备可自动连接娱乐管家系统，无需重新配置）
• 账期做实数据
• 员工账号/角色权限

2）暂不支持转换数据

• 升降级策略
• 盈客宝小程序
• 线上核销平台：抖音美团快手等
• 卡丁车设置（无卡丁车可忽略）
• 零售商品图片
• 会员照片
• 零售商品供应商
• 岗位权限设置

3.3 升级注意事项沟通

1）和客户沟通清楚系统可导入数据，不可导入和数据保留时间等信息。可将下图发给客户

2）沟通具体的升级时间

3.4 游乐宝系统升级和卡头升级

1）游乐宝系统需升级到V8.1.6886版本及以上（本地服务器可在FXP自行下载升级包升级系统）

2）卡头需要在游乐宝系统上升级到最新版本（卡头版本联系硬件同事获取或推送），避免连接不上娱乐管家系统

卡头建议版本（卡头版本过低，可能连接不上娱乐管家系统）：

• 果冻卡头：205及以上
• 反扫卡头：129及以上
• 钻石V2：219及以上
• 油菜盒子：18及以上

卡头升级包存放路径：

• 果冻V2版本升级路径：YCHMall\CltUpdate\Firmware\90
• 反扫卡头路径：YCHMall\CltUpdate\Firmware\120
• 钻石v2路径：YCHMall\CltUpdate\Firmware\150
• 魔方/钻石V9卡头联系硬件同事推送

四. 具体转换流程

第一部分游乐宝系统解绑和设置

1.1 游乐宝系统设置

1）游乐宝系统微信小程序套餐和商品分组需全部删除（忘记删除需要找欧江平清除微信小程序数据）

2）售货机解绑：切换之前需要联系硬件同事解绑售货机（没有售货机可以忽略）

1.2 坐实结账

游乐宝系统必须做实结账之后在升级

第二部分娱乐管家系统安装和升级

2.1 部署娱乐管家单店版系统

使用游乐宝系统的加密狗部署娱乐管家系统，用一个加密狗升级，设备会自动连接（系统不能同时运行）

详情请查看【云服务器安装游乐宝和娱乐管家单店版系统】

2.2 登录娱乐管家系统

1）打开云服务器中的展厅服务器，打开谷歌浏览器

2）将安装备案中部署的娱乐管家单店版系统地址填写到谷歌浏览器里面打开

2.3 数据构造

数据构造全部在娱乐管家完成，先登录娱乐管家后台， 且需和游乐宝数据保持一致：
1）构造【会员级别】数据
a）系统后台登录：点击会员→会员级别，创建会员级别数据；
b）需要依据游乐宝系统中的会员级别数据进行创建；
2）构造【商品分类】数据
a）系统后台登录：点击商品 → 商品分类，创建商品分类数据；
b）需要依据游乐宝系统中的商品分类数据进行创建；
3）构造【机台分类】数据
a）系统后台登录：点击终端 → 项目分类，创建项目分类数据 （有碎票机则需要在娱乐管家项目分类添加碎票机项目）；

b）需要依据游乐宝系统中的项目分类数据进行创建；

4）构造【员工角色】数据

a) 系统后台登录: 点击设置→角色管理，创建角色权限设置

b）需要依据游乐宝系统中的角色权限数据进行创建；

2.4 坐实结账

游乐宝系统必须做实结账之后在升级

第三部分 停止游乐宝系统和数据库备份

3.1 停止游乐宝系统

1）找到门店游乐宝系统所在的云服务器地址

说明：运维平台上面可以查询到门店部署的通讯IP和业务端口，跟云服务器电脑的IP地址一致

可在云服务管理界面进行搜索查询具体云服务地址

2）找到对应的游乐宝系统，停止服务

3.2 系统数据库备份

游乐宝和娱乐管家数据库都需要备份，注意不要备份错门店数据，一定要是对应门店的数据库

详情请查看：【数据库备份操作】

3.3 数据库还原

1）找到备份好的游乐宝数据库文件，将数据库复制到Guacamole RDP 上的 JumpServer

2）在部署娱乐管家单店版系统的云服务器上面打开Guacamole RDP 上的 JumpServer，可以看到刚上传的游乐宝数据库备份文件

3）将拷贝的游乐宝数据库放在服务器电脑D盘文件夹，打开服务器电脑的sql server，并连接到娱乐管家单店版数据库

鼠标右击系统数据库，点击还原数据库

在目标数据库输入YLB+编号（编号可随意设置，但是目标数据库不能选择其他娱乐管家数据库），点击源设备

选择拷贝的游乐宝数据库，点击确认还原，进行游乐宝数据库还原

第四部分数据转换

4.1 安装数据转换工具

1）检查服务器电脑磁盘空间，需要保证磁盘空间足够（单店升级至少需要50G的磁盘空间），否则会导致升级失败

2）数据转换工具不能放在桌面，需在服务器电脑D盘创建一个文件夹，将数据转换工具放在文件夹里面，鼠标右击点击以管理员身份运行

4.2 数据转换

数据转换之前需要将游乐宝和娱乐管家系统都停止服务，在数据库地址输入服务器IP地址，账号密码输入数据库账户密码，点击连接数据库

连接数据库之后，选择对应的游乐宝和娱乐管家数据库（注意不要选择错数据库）

核对目标门店是否正确

选择记录保留的时间（一般保留12个月，数据量多的情况下可和客户沟通保留时间），选择门店，点击获取资料

核对之前数据构造的会员级别，机台分类，商品分类，游乐宝系统和娱乐管家系统是否一致。不一致可以点击娱乐管家商品分类下拉框进行修改，确保构造的数据一一对应。

数据转换成功之后，重启娱乐管家系统

第五部分 云互联地址修改

5.1 记录游乐宝系统端口

在运维平台截图，记录游乐宝系统端口

5.2 删除游乐宝云互联

先删除游乐宝udp端口，在删除游乐宝域名服务

5.3 重新配置域名

点击域名配置下面的添加，输入娱乐管家系统云服务器地址和业务端口，点击保存

5.4 重新配置UDP端口

点击udp配置下面的添加，输入娱乐管家云服务器地址和机台端口，配置端口需要和之前游乐宝的配置端口一致（不一致会导致设备连接不上，需要重新配置）

5.5 重启域名服务

1）运维平台晚上11点会自动重启域名服务，云互联生效

2）升级时间超过了11点，需要重启域名服务，生效云互联（半个小时之内只能重启一次，第二次重启必须最少间隔半个小时）,先点击检查域名服务，再点击重启域名服务。重启失败需找运维同事处理

云互联生效之后，可通过域名访问娱乐管家系统，设备会自动连接

第六部分 微信小程序修改

1）进入微信小程序管理平台，在业务管理模块点击平台商家管理，输入门店加密狗编号

查询到对应的门店，点击编辑，建所属平台改成娱乐管家

不修改微信小程序平台会导致存币机连接不上，域名解析失败，微信小程序使用不了

第七部分 原游乐宝系统需要保留

有一些客户需要保留游乐宝系统进行数据查询，需要修改原游乐宝系统加密狗（同一个加密狗只能运行一套系统）

详情请查看【游乐宝系统修改加密狗编号】

第八部分 娱乐管家系统设置

8.1收银台设置

1）收银电脑需安装娱乐管家单店版收银台软件

2）商品收银台分组需要重新设置，转换之后收银台分组默认都是未分组

8.2 微信小程序设置

1）微信小程序套餐需要重新发布

2）微信小程序装修需要重新设置

8.3 抖音美团快手绑定

1）抖音美团账号和套餐需重新绑定到娱乐管家系统，才可以正常核销

详情请查看：【抖音团购核销对接】【美团团购对接】

2）抖音美团结算价格需要重新设置

8.4 设备重新绑定

1）部分连接不上娱乐管家系统的硬件设备，需重置重新绑定到娱乐管家系统

详情请查看：【卡头类调试目录】【自助设备类安装调试】

2）部分特殊机台有在游乐宝系统修改机台参数的机台，需要重新设置机台参数重新调试

第九部分数据和设备检查

9.1 数据检查

1）检查会员数据是否一致（包括会员储值余额，会员个人信息）；

a)  登录游乐宝后台--会员--会员资料查询/会员储值余额查询数据，和娱乐管家系统后台--会员--会员查询/会员管理数据是否一致

b）登录娱乐管家收银台，读取游乐宝会员实体会员卡，查询会员数据是否和游乐宝系统数据一致

2）检查商品资料数据是否一致（游戏币套餐，游乐套票，组合商品，入会套餐等）

a)  登录娱乐管家后台--商品--游乐宝套餐等商品，和游乐宝系统后台--商品--商品管理，核对商品资料数据是否一致

b)  登录娱乐管家收银台核对收银台上架的商品是否一致

3）检查零售商品资料和库存数据是否一致

a）登录娱乐管家后台--仓库--库存查询，和游乐宝系统后台--商品--库存查询，核对商品库存是否一致

4）检查财务数据报表是否一致（主要账期做实，商品订单报表）

5)  检查员工账号是否能正常登录娱乐管家系统

9.2 设备检查

1）检查游乐项目和端口是否一致

a)  登录娱乐管家后台--终端--游乐项目，和游乐宝--设备--游乐项目是否一致

2）检查测试卡头设备是否正常连接

a)  登录娱乐管家后台--终端--项目监控--查看卡头连接情况，用实体会员卡刷卡头测试能否正常扣费启动机台，娱乐管家系统后台是否有对应测试数据

3）测试自助设备是否正常连接

a)  用实体会员卡测试自助设备，看能否正常使用，且娱乐管家系统后台是否有对应数据记录

9.3 支付测试

1）测试微信支付和支付宝支付是否正常收款

a)  在收银台软件测试微信支付和支付宝支付能否正常收款

b) 在自助兑币机上测试微信和支付宝能否正常收款

c) 查看客户的收款账号是否到帐，使用汇付则查询汇付平台

2）需要将游乐宝系统的支付方式禁用，避免收银员登录游乐宝收银台收银