一、文档说明

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

二、升级准备

1.营业结束时间确认

需确认清楚门店具体的结束营业时间，为后续升级做准备
通常情况下，门店营业时间（可操作的升级时间）为：晚上21:00 -凌晨12:00；
若客户不按约定时间升级，超时1小时仍旧无法对接，可跟客户沟通确认，是否延期升级。

2.升级可转换数据的说明

可转换数据

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

暂不支持转换数据

• 升降级策略
• 扫码游戏方案
• 盈客宝小程序
• 线上核销平台：抖音美团快手等
• 卡丁车设置（无卡丁车可忽略）
• 岗位权限设置

需注意：

1）转换前需要当天营业结束后，并对当日的账期进行做实才能开始转换；

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

3）娱乐管家系统需要是新安装的系统，不能有营业数据，不支持在已经在营业的娱乐管家系统中进行转换。

3.升级信息收集

1）本地服务器向日葵远程

2）原游乐宝数据库大小&业务系统后台登录账号密码

3）主机电脑剩余可用内存

检查本地服务器电脑磁盘空间，需要保证磁盘空间足够（至少需要游乐宝数据库大小*2的磁盘空间，如游乐宝数据库低于50G建议预留50G磁盘空间），否则会导致升级失败。

4）业务系统版本确认

新娱系统：10.3.9001及以上

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

5）备份路径确认

6）游乐宝系统对接的第三方平台类型：抖音、美团、快手、OTA、天时同城

7）账期做实

三、升级操作

1.升级工具下载：

https://pulic.oss.youcaihua.net/%E9%AB%98%E6%99%93%E9%92%A6/YLBToVipTool(13).exe

升级程序还在持续更新中，注意下载最新版本的升级程序

2 安装娱乐管家系统（本地服务器）

注意：安装娱乐管家系统之前需备份游乐宝数据

情况一：游乐宝系统和娱乐管家单店版都是本地服务器

需要在安装游乐宝系统的服务器电脑上面，安装娱乐管家单店版系统，娱乐管家单店版系统需升级到V10.3.6305 版本及以上

详情请查看：【同一个服务器下安装多个门店安装流程】

（重要）注意：娱乐管家安装的路径一定要更改！！一定要更改！！一定要更改！！避免和游乐宝相同路径，导致将游乐宝文件覆盖从而导致游乐宝系统异常。

情况二：游乐宝是云服务器，娱乐管家是本地服务器

本地服务器电脑上面安装娱乐管家系统，娱乐管家单店版系统需升级到V10.3.6305 版本及以上

详情请查看：【娱乐管家单店版服务器安装】

3 卡头版本升级（无卡头可跳过）

卡头需要在游乐宝系统上升级到最新版本（卡头版本联系硬件同事获取或推送），避免连接不上娱乐管家系统；在营业期间可提前将卡头版本进行推送，等待晚上营业结束后可一次性断电等待自动升级完成

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

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

    卡头升级包存放路径：

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

4.数据库备份 

备份游乐宝系统及娱乐管家系统数据库以及对应系统YCHMALL文件夹（非常重要）

数据库备份教程：《数据库备份教程》

5.游乐宝系统部分功能解绑，以及剩余菜籽确认

需要解绑的内容为：小程序、第三方平台、自助售货机/兑换柜

1）小程序解绑：

切换之前需要提前在游乐宝系统后台--线上--开通盈客宝--解绑微信小程序

 注意：游乐宝和娱乐管家使用同一个加密狗，微信小程序不需要解绑，需要将小程序分组和商品，手机报表绑定账号，游乐掌柜绑定账号删除

2）抖音解绑

切换之前需要提前在游乐宝系统后台--线上--抖音配置--解绑抖音账号

3）美团解绑：

需要登录美团开店宝后台取消第三方应用授权

4）快手解绑：

解绑之前，需记录快手门店id信息

5）售货机解绑：

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

6)  剩余菜籽数量确认

游乐宝系统菜籽余额截图发给运营助理（没有菜籽余额则不需要）

6.数据迁移

将数据迁移到同一个服务器上（仅适用于游乐宝和娱乐管家系统不在同一个服务器上适用，如果本身是同一个服务器则这个步骤可以跳过）

将游乐宝备份的数据库还原到娱乐管家的服务器中，具体步骤如下：

①将拷贝的游乐宝数据库放在服务器电脑D盘文件夹

②打开安装了娱乐管家系统服务器电脑的sql server，并连接到娱乐管家单店版数据库

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

④在目标数据库输入YCH+游乐宝系统加密狗编号（目标数据库不能选择娱乐管家数据库），点击源设备

⑤点击添加

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

注意事项：游乐宝系统是云服务器，娱乐管家是本地服务器。需要联系油菜花技术人员在云服务器上面拷贝游乐宝数据库文件，在娱乐管家本地服务器上面还原。反之，如果是游乐宝是本地服务器，娱乐管家是云服务器，则需要将游乐宝的数据给到油菜花技术人员上传到云服务器进行还原。

7 setting配置修改

（仅在游乐宝与娱乐管家在同一个服务器的情况下才需要执行）

第一步：游乐宝系统Setting配置修改

1）系统都是本地服务器，打开游乐宝门店部署目录，停止游乐宝系统服务

2）打开游乐宝Setting文件，修改MacSvrPort的端口为1095、server IP 的端口和HOST端口修改为9995，不是则需修改成1095。不能和娱乐管家端口重复冲突。（如果没有MacSvrPort参数，则手动增加参数）

3）HOST里面的localhost改成*号

4）端口修改成功之后需重启一下游乐宝服务，检查系统是否正常运行。

 第二步：娱乐管家setting配置修改

1）打开娱乐管家门店部署目录，停止娱乐管家系统服务.

2）打开娱乐管家Setting文件，检查端口是否修改成功，MacSvrPort的端口（原游乐宝默认为1016）、server IP 的端口（原游乐宝默认为9999）和HOST端口（原游乐宝默认为9999）是否改成原本记录的游乐宝端口，确保一致，方可保证终端设备可以自动连接。

3）HOST里面的localhost改成*号

4）端口修改成功之后需重启一下娱乐管家服务，检查系统是否正常运行。

8 停止所有服务器的服务

9 数据备份

娱乐管家数据进行备份（非常重要）

游乐宝系统和娱乐管家系统转换前都需备份好数据库文件，避免操作失误可还原数据库重新操作。

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

10 使用工具对数据转换

本地服务器运行升级工具之前可以重启一下服务器电脑，清除一下后台其他进程，升级会快一些

1.鼠标右击点击以管理员身份运行（注意，如果将工具放到桌面，或者D盘的根目录情况下有可能出现异常）

2. （数据转换之前请再次确认游乐宝和娱乐管家系统都停止服务），在数据库地址输入服务器IP地址，账号密码输入数据库账户密码，点击连接数据库

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

4.核对目标门店是否正确

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

8.转换成功之后，重新启动娱乐管家系统（本地服务器改了Setting文件的情况下，设备会自动连接），有需要也可以重新启动游乐宝系统方便核对数据（同一个加密狗升级尽量减少游乐宝系统启动）。

四、升级还原旧有配置

1.收银台设置

1）删除游乐宝收银台和后台软件

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

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

2.微信小程序绑定

1）微信小程序需要重新绑定到娱乐管家系统，菜籽余额需要转到娱乐管家系统，需联系运营助理处理

详情请查看：【小程序开通流程说明】

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

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

3.抖音美团快手绑定

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

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

特别注意：抖音团购一定需要重新绑定门店ID，否则会出现抖音对账问题

4 设备重新绑定

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

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

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

5 扫码游戏方案设置

1）扫码游戏方案需要重新设置

2）扫码游戏方案设置完必须测试是否正常

6 卡丁车设置（没有卡丁车可忽略）

7 自助售货机/兑换柜重新绑定

五、升级检查

1.数据检查

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

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

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

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

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

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

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

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

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

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

2 设备检查

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

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

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

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

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

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

3 支付测试

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

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

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

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

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

4.VPN检查

除非场地有外广场区域是需要连接域名的， 否则vpn统一要求更换新vpn

5.数据库检查

分离多余的数据库，一般会带有ylb字眼

六、常见问题

【游乐宝升级娱乐管家常见问题合集】