1EAS环境迁移指南一、需求背景1.客户有多台EAS应用服务器，需要进行环境复制；2.客户的测试环境与正式环境需要同步EAS。二、可行性分析1.迁移基本思路：a)将当前环境还原为初始未部署状态b)对新环境进行重新部署2.EAS环境是基于JVM的，同时需要有Perl脚本运行环境的支持，这两个环境对于不同的操作系统，需要安装不同的版本。a)JDK更换b)Perl更换3.环境迁移后，由于环境的变化，对应的配置文件也需要进行更新，可以通过直接修改或重新部署的方式实现，需要分下面几种情况进行处理：a)操作系统类型变更；b)操作系统用户&权限变更c)目录结构变更；d)中间件类型变更；e)部署类型变更（集群->单实例）；f)数据库帐套备份与恢复。4.迁移流程图2三、实现步骤(一)EAS打包1)打包格式要求：a)同为Windows环境：可以使用zip或rar；b)Windows环境迁移到Linux/Unix：zip；c)Linux/Unix迁移到Windows环境：tar或tar.gz；d)同为Linux/Unix：tar或tar.gz2)打包内容：a)排除eas\admin\patch目录(patch目录单独进行打包)；b)排除eas\server\profiles\server*\logsc)排除文件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替换，只有跨平台才需要进行替换，在Windows平台或Linux/AIX/Solaris之间进行迁移不需要替换，迁移到HP-UX需要将JDK指向HPJDK；1)替换JDK：将对应版本的JDK目录复制到eas目录下即可，建议复制前将原来的JDK目录删除或重命名为其它名称；(四)配置文件修改配置文件文件是整个迁移过程中最为关键的一步，一个细节的修改错误，都有可能导致EAS无法正常启动与运行，尤其是对于跨平台的迁移，需要修改的文件及参数比较多，下面将按照不同的迁移类型进行分别介绍。1)Windows平台之间的环境迁移a)修改eas\server\bin\set-server-env.bat文件中的红色部分（如果是非apusic中间件，请增加对应的中间件服务器路径）SETEAS_HOME=d:\kd\easSETJAVA_HOME=d:\kd\eas\jdkSETCMD_PERL=%EAS_HOME%\server\perl\bin\perl.exeSETPERL5LIB=%EAS_HOME%\server\perl\lib@REMapplicationserverconfigSETAPP_SERVER_TYPE=apusicSETAPP_SERVER_HOME=W:\ApusicSETAPP_SERVER_VERSION=SETAPUSIC_SERVER_HOME=d:\kd\apusicSETWAS_SERVER_HOME=SETWLS_SERVER_HOME=SETEAS_NODEID=EAS883560930703793544922SETADMINSERVER_PORT=10061如果是WAS中间件，请增加该参数的设置如果是Weblogic中间件，请增加该参数的设置设置EAS根目录及JDK目录3SETHTTPSERVER_PORT=10060如果JDK与Perl环境没有问题，修改这一步之后，管更控制台应该可以正常启动。b)修改eas\server\profiles\server1\bin\set-server-env.bat文件中的红色部分（如果是非apusic中间件，请增加对应的中间件服务器路径）@call"%~dp0\..\..\..\bin\set-server-env.bat"SETJVM_INITIAL_HEAP_SIZE=512mSETJVM_MAX_HEAP_SIZE=850mSETJVM_PERM_SIZE=128mSETJVM_MAX_PERM_SIZE=450mSETJVM_VERBOSE_GC=trueSETJVM_CUSTOM_PARAMS=-XX:+HeapDumpOnOutOfMemoryErrorSETUSE_HTTPSERVER_FOR_DOWNLOAD=falseSETHTTPSERVER_TYPE=ApacheSETHTTPSERVER_HOME=SETHTTPSERVER_PORT=@REMapplicationserverconfigSETAPP_SERVER_TYPE=apusicSETAPP_SERVER_HOME=d:/eas703/apusicSETAPP_SERVER_VERSION=4.0.3SETAPP_SERVER_JMX_PORT=6888SETAPP_SERVER_HTTP_PORT=6888SETAPP_SERVER_JNDI_PORT=6888SETAPP_SERVER_SECURITY=trueSETAPP_SERVER_USER=adminSETAPP_SERVER_PASSWORD=ksqle:F3XnSwIclHwy4InMghK2IGxEPV18EDzRSETSERVER_NAME=SETPROFILES_NAME=server1SETPROFILE_PATH=d:/eas703/apusic/domains/server1/SETDEPLOY_EASAPP=trueSETDEPLOY_EASWEB=trueSETSERVERRUNNINGEASWEB=SETDEPLOY_AUTOUPDATEAPP=truec)检查eas\admin\adminserver.cmd文件中是否绑定IP，如果有，需要修改为新的IP或者取消掉绑定IP的设置。@call"..\server\bin\set-server-env.bat"@REMPleasesetLOCAL_IPineas_HOME\server\bin\set-server-env.bat.setLOCAL_IP=192.168.1.2d)如果是群集环境，请检查eas\admin\config\domain.xml文件，建议直接还原到初始状态(如下所示)。
e)如果是从群集环境迁移过来的，还需要检查eas\server\profiles\server1\config\portalConfig\portalConfig.xml文件，将其中的easAppServer标签中的内容清空(如下所示，红色删除线部分内容需要删除)。true不同的JDK，这里设置的参数名称一般不同，建议先清空部分windows环境下，这个值不能超过1024m，否则会导致EAS实例启动失败这里的中间件类型、版本号、端口、以及安全属性需要根据实际情况进行修改，apusic和weblogic都默认启用安全性，WAS默认不启用（APP_SERVER_SECURITY=false）根据中间件进行设置在前面加“@REM”注释掉该行或修改为新的机器的IP4tcp://192.168.33.129:11064?lbIndictor=tcp://192.168.76.184f)EASLicense配置文件初始化成License导入，打开EASLicense配置文件eas\server\profiles\server1\config\licensefile.xml，只保留下面的内容后保存：然后重新导入新的EASLicense即可。g)正确完成上面的配置文件修改后，正常控制控制台可以正常启动，并且会提示需要部署，按要求完成EAS实例的部署即可正常使用了。如果是群集环境，建议把Server1配置好之后再建立群集环境。h)在某些环境中，还可能在apusic的配置文件中绑定了IP，如果有，则需要一并进行修改，检查方法：检查对应补丁的apusic配置文件:apusic\domain\server*\config\apusic.conf，检查标签为的配置项是否存在IPAddress配置项，如果，将该配置项删除或修改为新的IP即可。i)IP映射信息清理，如果在部署了设置了ipmap信息，在迁移后必须清理掉，否则可能会导致更新下载出现异常(仍然从原来的服务器下载组件)，清理方法：用记事本打开eas\server\profiles\server1\config\portalConfig\ipMap.properties,检查是否有设置映射行，如果有，直接删除或使用#注释掉。2)Linux/Unix->Windows平台迁移Linux/Unix->Windows平台迁移的基本步骤与上面的Windows平台之间的迁移基本类似。由于配置文件类型不同，第三步IP绑定的检查和修改通常不需要进行。3)Windows->Linux/Unix平台迁移a)修改eas\server\bin\set-server-env.sh文件中的红色部分（如果是非apusic中间件，请增加对应的中间件服务器路径）EAS_HOME=/kingdee/easJAVA_HOME=/kingdee/eas/jdkexportEAS_HOMEexportJAVA_HOME#。。。中间内容不需要修改，省略#applicationserverconfigAPP_SERVER_TYPE=apusicAPP_SERVER_HOME=/kingdee/apusicAPP_SERVER_VERSION=4.0.3exportAPP_SERVER_TYPEexportAPP_SERVER_HOMEexportAPP_SERVER_VERSIONAPUSIC_SERVER_HOME=/kingdee/apusicWAS_SERVER_HOME=WLS_SERVER_HOME=exportAPUSIC_SERVER_HOMEexportWAS_SERVER_HOMEexportWLS_SERVER_HOMEb)修改eas\server\profiles\server1\bin\set-server-env.sh文件中的红色部分（如果是非apusic中间件，请增加对应的中间件服务器路径）如果是WAS中间件，请增加该参数的设置如果是Weblogic中间件，请增加该参数的设置设置EAS根目录及JDK目录修改为server1使用的中间件类型、路径及版本号5."./../../../bin/set-server-env.sh"JVM_INITIAL_HEAP_SIZE=256mJVM_MAX_HEAP_SIZE=1024mJVM_PERM_SIZE=128mJVM_MAX_PERM_SIZE=368mJVM_VERBOSE_GC=trueJVM_CUSTOM_PARAMS=exportJVM_INITIAL_HEAP_SIZEexportJVM_MAX_HEAP_SIZEexportJVM_PERM_SIZEexportJVM_MAX_PERM_SIZEexportJVM_VERBOSE_GCexportJVM_CUSTOM_PARAMSUSE_HTTPSERVER_FOR_DOWNLOAD=falseHTTPSERVER_TYPE=ApacheHTTPSERVER_HOME=HTTPSERVER_PORT=exportUSE_HTTPSERVER_FOR_DOWNLOADexportHTTPSERVER_TYPEexportHTTPSERVER_HOMEexportHTTPSERVER_PORT#applicationserverconfigAPP_SERVER_TYPE=apusicAPP_SERVER_VERSION=4.0.3APP_SERVER_JMX_PORT=6888APP_SERVER_HTTP_PORT=6888APP_SERVER_JNDI_PORT=6888APP_SERVER_SECURITY=trueAPP_SERVER_USER=adminAPP_SERVER_PASSWORD=adminexportAPP_SERVER_HOMEexportAPP_SERVER_VERSIONexportAPP_SERVER_JMX_PORTexportAPP_SERVER_HTTP_PORTexportAPP_SERVER_JNDI_PORTexportAPP_SERVER_SECURITYexportAPP_SERVER_USERexportAPP_SERVER_PASSWORDSERVER_NAME=server1PROFILES_NAME=PROFILE_PATH=/kindee/apusic/domains/server1exportSERVER_NAMEexportPROFILE_PATHexportPROFILES_NAMEc)如果是群集环境，请检查eas\admin\config\domain.xml文件，建议直接还原到初始状态(如下所示)。64位环境，最大内存堆可设置为2048m，最小可以设置为1024m根据不同的JDK类型进行设置，否则可能会导致EAS无法正常启动这里的中间件类型、版本号、端口、以及安全属性需要根据实际情况进行修改，apusic和weblogic都默认启用安全性，WAS默认不启用（APP_SERVER_SECURITY=false）根据中间件进行设置6d)如果是从群集环境迁移过来的，还需要检查eas\server\profiles\server1\config\portalConfig\portalConfig.xml文件，将其中的easAppServer标签中的内容清空(如下所示，红色删除线部分内容需要删除)。truetcp://192.168.33.129:11064?lbIndictor=tcp://192.168.76.184e)由于环境迁移后，由于路径的改变，License文件的指向可能不再有效，需要对License配置文件进行重新初始化后再导入。具体操作方法如下：1)打开EASLicense配置文件eas\server\profiles\server1\config\licensefile.xml，只保留下面的内容后保存：2)重新导入License；f)正确完成上面的配置文件修改后，正常控制控制台可以正常启动，并且会提示需要部署，按要求完成EAS实例的部署即可正常使用了。如果是群集环境，建议把Server1配置好之后再建立群集环境。g)在某些环境中，还可能在apusic的配置文件中绑定了IP，如果有，则需要一并进行修改，检查方法：检查对应补丁的apusic配置文件:apusic\domain\server*\config\apusic.conf，检查标签为的配置项是否存在IPAddress配置项，如果，将该配置项删除或修改为新的IP即可。h)IP映射信息清理，如果在部署了设置了ipmap信息，在迁移后必须清理掉，否则可能会导致更新下载出现异常(仍然从原来的服务器下载组件)，清理方法：用记事本打开eas\server\profiles\server1\config\portalConfig\ipMap.properties,检查是否有设置映射行，如果有，直接删除或使用#注释掉。Windows迁移到Linux/Unix环境时，由于文件编码格式的不同，可能导致读取不到对应的配置信息，对于linux，可以使用dos2unix命令将对应的文件格式转换即可，对于Unix环境，可以使用ultraedit之类的工具将对应的配置文件另存为Unix格式。(五)用户权限调整a)Windows环境，当前用户必须有EAS顶级目录及子目录与文件的读写权限。选择EAS顶级安装目录，点右键【属性】【安全】进行设置（如下图所示）：7b)Linux/unix环境，启动EAS的用户必须有EAS顶级目录及子目录与文件的读写权限，可以直接下面的命令进行授权：#/kingdee为EAS所在的根目录，请根据EAS实际存放位置进行修改chmod–R777/kindgee(六)帐套备份这里不对具体的备份过程进行详细的描述，Oracle备份建议使用expdb进行操作。(七)帐套恢复这里不对具体的恢复过程进行详细的描述，Oracle备份建议使用impdb进行操作。(八)EAS部署1)单实例：e)启动管理控制台；f)点击菜单【工具】【部署应用】，按照提示进行完成部署即可。2)群集：a)启动管理控制台；b)点击菜单【工具】【群集部署】，按照提示进行完成部署即可。1.点“添加”按钮选择需要授权的用户2.设置权限，勾选“安全控制”3.点“应用”按钮，完成授权的设置，然后点“确定”退出即可
