EAS环境迁移指南

内容简介

本文主要介绍EAS系统在不同的操作系统之间进行迁移的基本方法与操作步骤。实现快速搭建备用的测试环境。避免因操作不当或相关配置没有更正，造成迁移后的环境无法使用启动或使用。

读者对象

EAS实施顾问、EAS系统维护人员。

一、需求背景

1. 客户有多台EAS应用服务器，需要进行环境复制；

2. 客户的测试环境与正式环境需要同步EAS。

二、可行性分析

1. 迁移基本思路：

a) 将当前环境还原为初始未部署状态

b) 对新环境进行重新部署

2. EAS环境是基于JVM的，同时需要有Perl脚本运行环境的支持，这两个环境对于不同的操作系统，需要安装不同的版本。

a) JDK更换

b) Perl更换

3. 环境迁移后，由于环境的变化，对应的配置文件也需要进行更新，可以通过直接修改或重新部署的方式实现，需要分下面几种情况进行处理：

a) 操作系统类型变更；

b) 操作系统用户&权限变更

c) 目录结构变更；

d) 中间件类型变更；

e) 部署类型变更（集群->单实例）；

f) 数据库帐套备份与恢复。

4. 迁移流程图

三、实现步骤

(一) EAS打包

1) 打包格式要求：

a) 同为Windows环境：可以使用zip或rar；

b) Windows环境迁移到Linux/Unix：zip；

c) Linux/Unix迁移到Windows环境：tar或tar.gz；

d) 同为Linux/Unix：tar或tar.gz

2) 打包内容：

a) 排除eas\admin\patch目录(patch目录单独进行打包)；

b) 排除eas\server\profiles\server*\logs

c) 排除文件eas\server\profiles\server*\bin\headdump*、core*；

(二) 解压

1) 将压缩包释放到指定的路径即可（注意：在windows环境下，目录层级过深会导致实例无法正常启动，EAS6.0及之后的版本建议直接放到类似k:\kd的目录下），解压后将$EAS_HOME\eas\server\profiles目录下除server1之外的目录删除（只保留server1，其它实例重新进行创建与部署）；

2) 将patch包的内容放到eas\admin目录下(这一步可以放到迁移完成后再执行)；

(三) JDK、Perl替换，

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

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

2) 替换Perl：将对应版本的Perl目录复制到eas\server目录下即可，建议复制前将原来的perl目录删除或重命名为其它名称。

(四) 配置文件修改

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

1) Windows平台之间的环境迁移

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

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

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

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

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

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

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

然后重新导入新的EAS License即可。

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

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

2) Linux/Unix->Windows平台迁移

Linux/Unix->Windows平台迁移的基本步骤与上面的Windows平台之间的迁移基本类似。由于配置文件类型不同，第三步IP绑定的检查和修改通常不需要进行。

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

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

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

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

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

e) 由于环境迁移后，由于路径的改变，License文件的指向可能不再有效，需要对License配置文件进行重新初始化后再导入。具体操作方法如下：

1) 打开EAS License配置文件eas\server\profiles\server1\config\ licensefile.xml，只保留下面的内容后保存：

2) 重新导入License；

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

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

 注意：

Windows迁移到Linux/Unix环境时，由于文件编码格式的不同，可能导致读取不到对应的配置信息，对于linux，可以使用dos2unix命令将对应的文件格式转换即可，对于Unix环境，可以使用ultraedit之类的工具将对应的配置文件另存为Unix格式。

(五) 用户权限调整

a) Windows环境，当前用户必须有EAS顶级目录及子目录与文件的读写权限。选择EAS顶级安装目录，点右键【属性】【安全】进行设置（如下图所示）：

b) Linux/unix环境，启动EAS的用户必须有EAS顶级目录及子目录与文件的读写权限，可以直接下面的命令进行授权：

(六) 帐套备份

这里不对具体的备份过程进行详细的描述，Oracle备份建议使用expdb进行操作。

(七) 帐套恢复

这里不对具体的恢复过程进行详细的描述，Oracle备份建议使用impdb进行操作。

(八) EAS部署

1) 单实例：

e) 启动管理控制台；

f) 点击菜单【工具】【部署应用】，按照提示进行完成部署即可。

2) 群集：

a) 启动管理控制台；

b) 点击菜单【工具】【群集部署】，按照提示进行完成部署即可。