| 修改日期 | 修改人 | 备注 |
| 2025-05-07 14:45:09[当前版本] | 陈彦峰 | 内容更新 |
| 2025-05-07 14:40:42 | 陈彦峰 | 内容更新 |
| 2025-05-07 14:28:03 | 陈彦峰 | 创建版本 |
本文档主要明确了本地服务器游乐宝快捷迁移娱乐管家单店版中的工作内容、作业准则、工作要求以及禁止事项，请所有实施相关人员务必认真阅读。
1）可转换数据
2）暂不支持转换数据
需注意：
1）转换前需要当天营业结束后，并对当日的账期进行做实才能开始转换；
2）游乐宝系统没有开通漫游功能或者漫游全部召回成功才可以使用迁移工具进行升级（漫游召回失败的情况下使用迁移工具升级，召回失败的数据会丢失）；
3）娱乐管家系统需要是新安装的系统，不能有营业数据，不支持在已经在营业的娱乐管家系统中进行转换。
游乐宝版本： V8.1.6886版本及以上
娱乐管家版本： V10.3.6305版本及以上，但是需要低于V10.3.8
卡头建议版本（卡头版本过低，可能连接不上娱乐管家系统，如果低于该版本，需要提前升级卡头版本后再进行升级）：
| 准备类型 | 准备内容 |
| 沟通准备 | 沟通可导入数据内容 |
| 确认升级时间 | |
| 工具准备 | 转换工具下载 |
| 系统准备 | 安装娱乐管家系统 |
| 设置娱乐管家参数（必要） | |
| 硬件准备 | 推送卡头升级程序 |
| 服务器准备 | 确认服务器的磁盘空间是否足够 |
| 培训准备 | 培训客户使用娱乐管家系统 |
可参考第二点描述的内容来和客户沟通，并将以下注意事项可将以下图片发送给客户
沟通内容二：与客户确认升级时间，确认整体切换流程
（具体计划可自行编写同步到群里面）
工具下载链接：（暂无）
由于近期工具还在不断更新，请确认工具是否最新版本，如果提示非最新版本，请找陈彦峰、高晓钦、梁建宁获取最新更新工具。
注意事项：工具下载完，请复制到D盘，并新建一个文件夹进行存放，切记不要放到桌面或C盘，会有异常。
（重要）注意：娱乐管家单店安装的路径一定要更改！！一定要更改！！一定要更改！！避免和其他门店系统相同路径，导致将其他门店系统覆盖从而导致其他门店系统异常。
需要在云服务器上面，安装娱乐管家单店版系统，娱乐管家单店版系统需升级到V10.3.6305 版本及以上
详情请查看：【云服务器系统部署流程】
需要在云服务器上面，安装娱乐管家单店版系统，娱乐管家单店版系统需升级到V10.3.6305 版本及以上
详情请查看：【云服务器系统部署流程】
请找陈彦峰、高晓钦、梁建宁在云服务器安装娱乐管家系统。
打开云服务器中的展厅服务器，打开谷歌浏览器
将云服务器安装备案中部署的娱乐管家单店版系统地址填写到谷歌浏览器里面打开
1）构造【会员级别】数据
a）娱乐管家系统后台登录：点击会员→会员级别，创建会员级别数据；
b）需要依据游乐宝系统中的会员级别数据进行创建；
2）构造【商品分类】数据
a）娱乐管家系统后台登录：点击商品 → 商品分类，创建商品分类数据；
b）需要依据游乐宝系统中的商品分类数据进行创建；
3）构造【机台分类】数据
a）娱乐管家系统后台登录：点击终端 → 项目分类，创建项目分类数据 （有碎票机则需要在娱乐管家项目分类添加碎票机项目）；
b）需要依据游乐宝系统中的项目分类数据进行创建；
4）构造【员工角色】数据
a) 娱乐管家系统后台登录: 点击设置→角色管理，创建角色权限设置
b）需要依据游乐宝系统中的角色权限数据进行创建；
5）构造【供应商】数据
a) 娱乐管家系统系统后台登录: 点击联营→供应商设置，创建供应商
b）需要依据游乐宝系统中的供应商数据进行创建；
卡头需要在游乐宝系统上升级到最新版本（卡头版本联系硬件同事获取或推送），避免连接不上娱乐管家系统；在营业期间可提前将卡头版本进行推送，等待晚上营业结束后可一次性断电等待自动升级完成
卡头建议版本（卡头版本过低，可能连接不上娱乐管家系统）：
卡头升级包存放路径：
检查云服务器电脑磁盘空间，需要保证磁盘空间足够（至少需要游乐宝数据库大小*2的磁盘空间，如游乐宝数据库低于50G建议预留50G磁盘空间），否则会导致升级失败。
着重针对两个系统的差异性进行培训（着重培训客户升级娱乐管家想使用的功能）。
| 顺序 | 关联设备 | 执行内容 |
| 1 | 游乐宝系统 | 账期坐实 |
| 2 | 游乐宝系统 | 升级到对应版本以上 |
| 3 | 卡头 | 升级到对应版本以上 |
| 4 | 旧服务器 | 游乐宝文件及数据库备份 |
| 5 | 游乐宝系统 | 解绑相应内容（小程序、第三方平台、售货机/兑换柜 |
| 6 | 确认剩余菜籽 | |
| 7 | 服务器 | 修改settings参数 |
| 8 | 停止所有服务 | |
| 9 | 新服务器 | 娱乐管家数据库备份 |
| 10 | 升级工具 | 使用工具升级 |
游乐宝系统必须做实结账之后在升级
游乐宝系统需升级到V8.1.6886版本及以上
1）本地服务器可在FXP自行下载升级包升级系统）
2）云服务器可推送升级后，在后台点自动升级
重启所有机台，等待卡头升级完成
注意事项：魔方/钻石V9娱乐版卡头升级版本后，有可能出现刷卡不上币的情况，如果出现该情况，需要调整白盒子中的拨码，如下图所示：
数据库备份教程：《数据库备份教程》
1）小程序解绑：切换之前需要提前在游乐宝系统后台--线上--开通盈客宝--解绑微信小程序
注意：游乐宝和娱乐管家使用同一个加密狗，微信小程序不需要解绑，需要将小程序分组和商品，手机报表绑定账号，游乐掌柜绑定账号删除
2）抖音解绑：切换之前需要提前在游乐宝系统后台--线上--抖音配置--解绑抖音账号
3）美团解绑：需要登录美团开店宝后台取消第三方应用授权
4）售货机解绑：切换之前需要联系硬件同事解绑售货机（没有售货机可以忽略）
游乐宝系统菜籽余额截图发给运营助理（没有菜籽余额则不需要），同狗升级菜籽余额会同步到娱乐管家系统
1）同一个加密狗升级，游乐宝系统在本地服务器也需禁用游乐宝系统。不同狗升级则不需要
2）游乐宝系统在云服务器上，找到门店游乐宝系统所在的云服务器地址
说明：运维平台上面可以查询到门店部署的通讯IP和业务端口，跟云服务器电脑的IP地址一致
可在云服务管理界面进行搜索查询具体云服务地址
2）找到对应的游乐宝系统，停止服务，并禁用
游乐宝和娱乐管家数据库都需要备份，注意不要备份错门店数据，一定要是对应门店的数据库
详情请查看：【数据库备份操作】
情况一：游乐宝是本地服务器情况下，可点击云服务器右边设置按钮
点击文件管理
点击上传文件，将游乐宝备份文件上传到云服务器。（数据量大的情况下上传网盘，通过云服务器展厅服务器下载）
情况二：游乐宝系统是云服务器，在云服务器找到备份好的游乐宝数据库文件，将数据库复制到Guacamole RDP 上的 JumpServer
2）在部署娱乐管家单店版系统的云服务器上面打开Guacamole RDP 上的 JumpServer，可以看到刚上传的游乐宝数据库备份文件
将游乐宝备份的数据库还原到娱乐管家的服务器中，具体步骤如下：
①将拷贝的游乐宝数据库放在服务器电脑D盘文件夹
②打开安装了娱乐管家系统服务器电脑的sql server，并连接到娱乐管家单店版数据库
③鼠标右击系统数据库，点击还原数据库
④在目标数据库输入YCH+游乐宝系统加密狗编号（目标数据库不能选择娱乐管家数据库），点击源设备
⑤点击添加
⑥选择拷贝的游乐宝数据库，点击确认还原，进行游乐宝数据库还原
注意事项：还原游乐宝数据库不要选择其他的数据库，新建一个数据库还原
游乐宝系统和娱乐管家系统转换前都需备份好数据库文件，避免操作失误可还原数据库重新操作。
详情请查看：【数据库备份操作】
1.鼠标右击点击以管理员身份运行（注意，如果将工具放到桌面，或者D盘的根目录情况下有可能出现异常）
2. （数据转换之前请再次确认游乐宝和娱乐管家系统都停止服务），在数据库地址输入服务器IP地址，账号密码输入数据库账户密码，点击连接数据库
3.连接数据库之后，选择对应的游乐宝和娱乐管家数据库（注意不要选择错数据库）
4.核对目标门店是否正确
5.选择记录保留的时间（一般保留12个月，数据量多的情况下可和客户沟通保留时间），选择门店，点击获取资料
6.核对之前数据构造的会员级别，机台分类，商品分类，游乐宝系统和娱乐管家系统是否一致。不一致可以点击娱乐管家商品分类下拉框进行修改，确保构造的数据一一对应。
8.转换成功之后，重新启动娱乐管家系统（本地服务器改了Setting文件的情况下，设备会自动连接），有需要也可以重新启动游乐宝系统方便核对数据（同一个加密狗升级尽量减少游乐宝系统启动）。
1）删除游乐宝收银台和后台软件
2）收银电脑需安装娱乐管家单店版收银台软件
3）商品收银台分组需要重新设置，转换之后收银台分组默认都是未分组
1）微信小程序需要重新绑定到娱乐管家系统，菜籽余额需要转到娱乐管家系统，需联系运营助理处理
详情请查看：【小程序开通流程说明】
2）微信小程序套餐需要重新发布
3）微信小程序装修需要重新设置
抖音美团账号和套餐需重新绑定到娱乐管家系统，才可以正常核销
特别注意：抖音团购一定需要重新绑定门店ID，否则会出现抖音对账问题
1）部分连接不上娱乐管家系统的硬件设备，需重置重新绑定到娱乐管家系统
2）部分特殊机台有在游乐宝系统修改机台参数的机台，需要重新设置机台参数重新调试
1）扫码游戏方案需要重新设置
2）扫码游戏方案设置完必须测试是否正常
1）检查会员数据是否一致（包括会员储值余额，会员个人信息）；
a) 登录游乐宝后台--会员--会员资料查询/会员储值余额查询数据，和娱乐管家系统后台--会员--会员查询/会员管理数据是否一致
b）登录娱乐管家收银台，读取游乐宝会员实体会员卡，查询会员数据是否和游乐宝系统数据一致
2）检查商品资料数据是否一致（游戏币套餐，游乐套票，组合商品，入会套餐等）
a) 登录娱乐管家后台--商品--游乐宝套餐等商品，和游乐宝系统后台--商品--商品管理，核对商品资料数据是否一致
b) 登录娱乐管家收银台核对收银台上架的商品是否一致
3）检查零售商品资料和库存数据是否一致
a）登录娱乐管家后台--仓库--库存查询，和游乐宝系统后台--商品--库存查询，核对商品库存是否一致
4）检查财务数据报表是否一致（主要账期做实，商品订单报表）
5) 检查员工账号是否能正常登录娱乐管家系统
1）检查游乐项目和端口是否一致
a) 登录娱乐管家后台--终端--游乐项目，和游乐宝--设备--游乐项目是否一致
2）检查测试卡头设备是否正常连接
a) 登录娱乐管家后台--终端--项目监控--查看卡头连接情况，用实体会员卡刷卡头测试能否正常扣费启动机台，娱乐管家系统后台是否有对应测试数据
3）测试自助设备是否正常连接
a) 用实体会员卡测试自助设备，看能否正常使用，且娱乐管家系统后台是否有对应数据记录
1）测试微信支付和支付宝支付是否正常收款
a) 在收银台软件测试微信支付和支付宝支付能否正常收款
b) 在自助兑币机上测试微信和支付宝能否正常收款
c) 查看客户的收款账号是否到帐，使用汇付则查询汇付平台
2）需要将游乐宝系统的支付方式禁用，避免收银员登录游乐宝收银台收银
系统升级成功后，需在游乐宝所在的云服务器安装备案上找到升级门店的备案，添加备注。如下图所示
系统升级成功后，在娱乐关管家单店系统所在的服务器将升级工具和还原的游乐宝数据库删除
注意：不要删除其他的文件和数据库，如担心删除错误联系陈彦峰，高晓钦，梁建宁删除
