一. 文档说明

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

二. 系统版本要求

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

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

需注意：游乐宝系统没有开通漫游功能或者漫游全部召回成功才可以使用迁移工具进行升级，漫游召回失败的情况下不能使用迁移工具升级

三. 提前准备事项

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卡头联系硬件同事推送

注意事项：魔方/钻石V9娱乐版卡头升级版本后，有可能出现刷卡不上币的情况，如果出现该情况，需要调整白盒子中的拨码，如下图所示：

四. 具体转换流程

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

1.1 游乐宝系统解绑

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

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

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

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

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

1.2 坐实结账

游乐宝系统必须做实结账之后在升级（未坐实结账会导致账期重复的情况）

第二部分系统安装和升级

第一步：部署娱乐管家连锁门店系统

情况一：游乐宝系统和娱乐管家连锁门店都是本地服务器（如果其中一个是云服务器则跳过此步骤）

①在本地服务器安装好娱乐管家连锁门店

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

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

情况二：游乐宝和娱乐管家连锁门店有一个系统是本地服务器，一个云服务器或者都是云服务器

1）需要先在云服务器电脑或者本地服务器电脑上面安装娱乐管家系统，娱乐管家连锁系统需升级到V10.3.6305 版本及以上

详情请查看：【娱乐管家连锁门店服务器安装】

2）游乐宝系统是云服务器，娱乐管家是本地服务器。需要联系油菜花技术人员拷贝游乐宝数据库文件，在娱乐管家服务器上面还原，还原步骤如下：

将拷贝的游乐宝数据库放在服务器电脑D盘文件夹，打开安装了娱乐管家系统服务器电脑的sql server，并连接到娱乐管家连锁门店数据库

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

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

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

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

需要将游乐宝本地数据库文件上传云服务器（联系油菜花技术人员）。按照上面数据库还原步骤在云服务器上还原游乐宝数据库。

第二步 数据构造

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

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

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

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

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

第三部分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）端口修改成功之后需重启一下娱乐管家服务，检查系统是否正常运行。

第三步：娱乐管家门店URL修改

娱乐管家门店系统端口修改完之后，需要在总部门店管理里面修改门店URL端口

修改完，需要重启总部服务器使其生效。

情况二：游乐宝系统和娱乐管家系统其中有一个是云服务器

游乐宝和娱乐管家有一个系统是云服务器的情况下，不需要修改Setting文件，设备需要重新配置

第四部分：停止所有服务器的服务，并将数据进行备份（非常重要）

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

①检查总部设置的内容是否已经同步到门店，包括【会员级别】【商品分类】【员工角色】【机台分类】（特别留意碎票机是否已经建好分类）

如果没有同步，请先解决同步问题

②停止所有服务，包括娱乐管家连锁总部、娱乐管家连锁门店以及游乐宝

③备份所有数据库

备份范围：游乐宝数据库、娱乐管家总部数据库、娱乐管家门店数据库。

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

第五部分：数据转换/数据导入

步骤一：安装数据转换工具

1）检查服务器电脑磁盘空间，需要保证磁盘空间足（客户数据量不同所需磁盘空间不同，数据量越大需要的磁盘空间越大），否则会导致升级失败

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

步骤二：门店数据转换

游乐宝系统升级娱乐管家连锁门店，需要先转换门店数据再转换总部数据。数据转换之前需要再次确认游乐宝和娱乐管家门店系统都停止服务，在数据库地址输入服务器IP地址，账号密码输入数据库账户密码，点击连接数据库

连接数据库之后，选择对应的游乐宝和娱乐管家门店数据库

选择记录保留的时间（游乐宝数据太大的情况下，建议和客户沟通缩短记录保留时间），选择门店，点击获取资料

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

门店数据转换成功之后，在转换工具的文件夹里面会自动生成数据库文件，需要将数据库文件给到油菜花技术人员在云服务器总部二次转换数据

门店数据转换成功之后，不能启动门店服务，需总部转换成功之后在启动门店服务

4.3 总部数据转换

1）检查服务器电脑磁盘空间，需要保证磁盘空间足够（总部服务器至少需要100G的磁盘空间，数据越多需要的磁盘空间越多），否则会导致升级失败

2）将门店转换之后生成的数据库文件上传到总部服务器上面，附加到数据库中

将拷贝的数据库文件放在总部服务器电脑D盘文件夹，打开安装了娱乐管家总部系统服务器电脑的sql server，点击附加

点击添加，找到上传的数据库位置，添加数据库，点击确认，进行数据库附加

3）备份总部数据库，需要备份总部数据库避免升级失败总部数据异常

4）按照之前的门店转换流程进行二次数据转换，需注意需要选择总部

当总部转换成功之后，先启动总部服务器，等总部服务启动成功之后，在启动门店服务器

第六部分

6.1 收银台设置

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

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

6.2 微信小程序绑定

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

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

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

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

6.3 抖音美团绑定

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

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

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

6.4 设备重新绑定

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

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

第七部分数据和设备检查

7.1 数据检查

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

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

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

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

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

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

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

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

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

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

7.2 设备检查

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

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

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

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

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

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

7.3 支付测试

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

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

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

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

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

五、常见问题

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