EAS Cloud环境迁移操作指导

EAS环境迁移是指将整个EAS服务端进行迁移，并支持跨操作系统迁移，如在Linux操作系统安装后，并打包迁移至windows操作系统。

迁移工具路径：eas/admin/migrate

以Linux迁移至windows为例进行操作说明。

一、打包迁移

1、Linux环境执行命令：sh admin/migrate/tar_env_linux.sh，打包成功后界面提示所在路径，压缩包默认为.tar

2、Linux环境执行命令：sh admin/migrate/setup_env_linux.sh执行迁移操作，如下图：

二、解压

将路径下打包文件手动拷贝至windows目录下，并解压到指定路径。（注意：在windows环境下，目录层级过深灰导致实例无法正常启动）

解压成功后EAS包显示如下：

三、JDK替换

只有跨平台才需要进行替换，在Windows平台或Linux/AIX/Solaris之间进行迁移不需要替换，迁移到HP-UX需要将JDK指向HP JDK；

替换JDK：将对应版本的JDK目录复制到eas目录下即可，建议复制前将原来的JDK目录删除或重命名为其它名称；

四、配置文件修改

配置文件文件是整个迁移过程中最为关键的一步，一个细节的修改错误，都有可能导致EAS无法正常启动与运行，尤其是对于跨平台的迁移，需要修改的文件及参数比较多。

1、以Linux/Unix->Windows平台迁移

1)修改eas\server\bin\set-server-env.bat文件中的红色部分（如果是非apusic中间件，请增加对应的中间件服务器路径）

如果JDK与Perl环境没有问题，修改这一步之后，管理控制台应该可以正常启动。

2)修改eas\server\profiles\server1\bin\set-server-env.bat文件中的红色部分（如果是非apusic中间件，请增加对应的中间件服务器路径）

3）如果是群集环境，请检查eas\admin\config\domain.xml文件，建议直接还原到初始状态(如下所示)。

<?xml version="1.0" encoding="UTF-8"?>
<domain deployed="false">
  <password />
  <clustermanager>
    <easstatus />
  </clustermanager>
</domain>

4）如果是从群集环境迁移过来的，还需要检查eas\server\profiles\server1\config\portalConfig\portalConfig.xml文件，将其中的easAppServer 标签中的内容清空(如下所示，红色部分内容需要删除)。

<customizedFullUpdate>true</customizedFullUpdate>

    <easAppServer>tcp://192.168.33.129:11064?lbIndictor=tcp://192.168.76.184</easAppServer>

5）EAS License配置文件初始化成License导入，打开EAS License配置文件eas\server\profiles\server1\config\licensefile.xml，只保留下面的内容后保存：

<licensefiles>
</licensefiles>

重新导入新的EAS License即可。

6)正确完成上面的配置文件修改后，正常控制控制台可以正常启动，并且会提示需要部署，按要求完成EAS实例的部署即可正常使用了。如果是群集环境，建议把Server1配置好之后再建立群集环境。

7)在某些环境中，还可能在apusic的配置文件中绑定了IP，如果有，则需要一并进行修改，检查方法：检查对应补丁的apusic配置文件:apusic\domain\server*\config\apusic.conf，检查标签为<SERVICE CLASS="com.apusic.net.Muxer">的配置项是否存在IPAddress配置项，如果，将该配置项删除或修改为新的IP即可。

8)IP映射信息清理，如果在部署了设置了ipmap信息，在迁移后必须清理掉，否则可能会导致更新下载出现异常(仍然从原来的服务器下载组件)，清理方法：用记事本打开eas\server\profiles\server1\config\portalConfig\ipMap.properties,检查是否有设置映射行，如果有，直接删除或使用#注释掉。

2、Windows平台之间的环境迁移

需要在以上第 2）步骤后增加以下步骤

1)检查eas\admin\adminserver.cmd文件中是否绑定IP，如果有，需要修改为新的IP或者取消掉绑定IP的设置。

@call "..\server\bin\set-server-env.bat"
@REM Please set LOCAL_IP in eas_HOME\server\bin\set-server-env.bat.
set LOCAL_IP=192.168.1.5

3、Windows->Linux/Unix平台迁移

1)修改eas\server\bin\set-server-env.sh文件中的红色