EAS配置部署实施入门指导

EAS配置部署实施入门指导
EAS支持环境说明
EAS是基于java的大型企业j2ee应用。目前已经支持以下主流软件环境
环境 应用类别 支持类型 说明
服务端 操作系统 AIX 5.2.0.10以上，推荐5.3.0.30以上
  HpUnix 11iV2
  Soalris V9;  V10
  RedHatLinux Enterprise V4
  SuseLinux Enterprise V10
  Windows 2000 sp4以上，推荐2003 sp1
  AS400(i5/OS) V5R4M0 安装最新修正补丁
应用服务器 Apusic 随EAS一同分发
  WebSphere 5.1.0.13或6.0.2.9以上（6.1版本后续支持）
  Weblogic 8.1.4以上（9.0版本后续支持）
数据库 Oracle  9.2.0.8 以及10.2以上版本
  DB2  8.1.11(即8.2.4)以上; 以及DB2 V9
  SQLServer 2000 SP3以上； 以及sqlserver2005
  DB2/400 V5R4以上版本（需安装最新修正补丁）
JAVA虚拟机 SUN 1.4.2_11 ;  1.5_08
  IBM 1.4.2 SR5以上
  HP 1.4.2_10(注:1.4.2_11存在bug), 1.5.0.05以上
  BEA 与weblogic版本相同
客户端 　操作系统 Windows Windows98 SE以后的所有windows平台, 推荐windows2000 sp4以上，xp sp2以上
　浏览器 IE 6.0 sp1
　虚拟机 JRE V1.4.2_11及其以上版本

EAS服务端目录结构介绍
EAS服务端文件和目录在所有EAS支持的环境下都是一样的。

请关注以下文件：
1、 bin下的 set-server-env.bat(sh)文件
该文件主要用来配置EAS安装路径,应用服务器类型、是否启用gc、服务器内存设置等。下面为主要参数说明：

2、 server/tools/admin下的admin.vmoptions文件
用于设定EAS管理控制台的行为，包含ksql trace开关(KsqlTracec参数)， 是否加密数据源url的开关(encodeurl参数)。

3、 服务器日志输出文件
服务器日志文件是跟踪EAS服务器运行状态以及查找跟踪EAS问题的关键问题。
apusic服务器：日志存放在 apusic的logs目录下，apusic.log.0为当前最新的日志文件。

   Websphere服务器： websphere5.1的日志在 WebSphere/AppServer/logs/<server名> 下，SystemOut.log记录EAS当前日志， SystemErr.log记录系统错误，native_stderr.log用于记录websphere gc日志；  WebSphere6.0之后的日志在 WebSphere/AppServer/profiles/<profile名>/logs/<server名>下。

  Weblogic服务器: 日志存放在用户配置的 domain目录和server目录下，如: mydomain.log, myserver.log， 以及eas/server目录下的 server.log等。

4、 EAS管理控制台日志文件
该文件为eas/server/tools/admin/admin.vmlog；用于分析跟踪EAS的安装部署、建库、升级等问题。

5、 虚拟机GC日志文件
在开启gc开关，重启应用服务器后，gc日志将输出在eas/server/jvmlogs目录下（集群输出为 eas/server/instances/<eas实例名>/jvmlogs）; 注意 EAS5.2.1之前的版本gc输出为 server/bin下的jvm_gc.log

EAS客户端目录结构介绍
EAS GUI客户端目录与easportal登陆下载生成的目录结构一致。
 
请关注以下文件：
1、 bin下的 set-client-env.bat文件
该文件主要用来配置EAS客户端安装路径,以及客户端内存设置等。下面为主要参数说明：

2、 客户端日志文件
GUI客户端日志存放在 eas/client/bin/client.vmlog, 而portal客户端登陆的日志通过IE浏览器的【工具】菜单中选择【Sun Java 控制台】，可以查看，或者在windows系统盘的Documents and Settings\<当前操作系统用户>\Application Data\Sun\Java\Deployment\log目录下最新的plugin_***.trace 可以查看。

如何启动EAS管理控制台？
EAS管理控制台是EAS服务器的配置部署管理工具，能够完成EAS服务器的启动与停止、发布EAS程序、创建配置部署EAS数据中心等操作。该工具屏蔽了各种操作系统与应用服务器差异，所以，只要熟悉了windows+apusic下的配置部署，在其他任何环境中都可以采用类似的向导完成所有工作。
Windows环境可以通过【开始】菜单中的选择【金蝶EAS管理控制台】启动管理控制台，或者在服务端安装目录的eas/server/tools/admin目录下，双击admin.bat启动。
非windows环境需要在 cd 到 eas/server/tools/admin目录下， 运行 sh  admin.sh 启动管理控制台。
   
如何启动停止EAS服务器？
在EAS服务端的server/bin目录下的startserver.bat(sh)  stopserver.bat(sh)用于启动与停止EAS的应用服务器， 注意：apusic与weblogic的启动与停止必须使用这两个脚本。该脚本也能完成websphere的启动和停止。
在windows环境也可以通过【开始】菜单中的【金蝶EAS服务器】启动。
推荐： 任何环境下都通过eas自带的脚本启动与停止服务器。或者通过EAS管理控制台的【应用服务器管理】中启动与停止服务器。
集群环境下必须在eas/server/bin下通过startLoadBalance.bat(sh) 与 stopLoadBalance.bat(sh)启动与停止EAS集群控制器，或通过EAS管理控制台的【EAS集群】中启动与停止EAS集群控制器。

EAS服务端安装流程
1、 服务端环境要求
A) EAS服务端不要与数据库服务器安装在同一台物理主机
B) EAS服务端安装至少需要6G左右空间，为了今后的升级备份等操作，推荐10G以上。（空间检查方法参考《EAS实施环境指南》）
C) EAS服务器所在主机至少2G以上内存。

2、 启动EAS服务端安装向导
EAS服务端安装程序在windows下可以通过双击 EASSetup_Windows.exe启动安装向导，非windows下通过执行 sh EASSetup_[操作系统名].sh 启动。

3、 设置应用服务器类型
EAS服务端支持Apusic, websphere和weblogic三种主流中间件，当选择“apusic”时，安装程序会自动把apusic安装在 与EAS同级的目录下；其他中间件必须在安装EAS服务端前已经安装完毕。

4、 设置应用服务器安装目录
Websphere目录必须配置为 WebSphere下的AppServer目录， 而WebLogic8.1必须配置为 WebLogic81/server下，WebLogic9.0必须配置为 WebLogic90/server下；
5、 启动EAS管理控制台应用部署向导
服务端安装完毕后将自动启动EAS管理控制台的应用部署向导，用户可以选择取消，然后通过 eas/server/tools/admin下的wizard.sh(bat)启动。应用部署向导可以帮助您完成EAS标准部署流程的所有工作。

EAS标准部署流程
安装完毕后，需要通过应用部署向导发布才能正常使用。下面将针对EAS5.2.1的部署向导进行说明，其他版本类似。
1、 设置EAS部署模式

EAS部署模型分为标准和集群模式，非EAS集群环境请选择【独立服务】

2、 配置应用服务器信息
A) Apusic服务器配置说明：

【管理方式】：分为offline和online。 当选择offline时，EAS管理控制台直接操作本地apusic配置，这种管理方式配置部署速度快，但修改配置后需要重启apusic才能正常使用； 而online方式则通过远程调用与apusic通讯，修改配置不用重启apusic， 但是配置部署速度慢，而且在IBMJDK环境（如AIX）不支持online方式。
  【HTTP】端口：apusic默认端口为6888，但有些网络运营商屏蔽了该端口，如果客户需要在广域网上运行，建议点击【设置】修改这个端口
   【内存设置】： 初始内存一般不需要修改，使用默认的256m；最大内存推荐为1536m； 不要设置太高，32位虚拟机内存使用限制不能超出2G，否则会导致服务器启动失败。
   【 用户名】和【密码】设置： apusic默认的用户名和密码都是admin

B) WebSphere服务器配置说明：

  【服务器版本】： 目前EAS支持websphere5.1； 6.0和 6.1三个大版本，请根据实际情况选择。
   【概要表】： websphere6.0开始提出的概念，如果列表显示为空，则需要在websphere中创建概要表；（参考本文的《WebSphere概要表》部分）；
   【应用服务器名称】：选择概要表下发布eas应用的websphere server名
   当客户的websphere配置了全局安全性后，请选中【应用服务器启用了安全登录】，然后输出websphere的管理员用户名和密码（websphere默认情况下是没有启用全局安全性的）。

C)WebLogic应用服务器配置说明:

  【应用服务器版本】：目前EAS支持weblogic8.1.4以上版本
  【Domain目录】：指向weblogic中给EAS使用的domain，所在的目录。（参考本文的《weblogic domain配置》部分）
  【应用服务器名称】：选择发布EAS的weblogic server名称。
  【用户名】和【密码】设置： weblogic服务器启动时的用户名和密码。（新建weblogic domain时指定）

3、 配置EAS

【全下载】： EAS512开始支持客户端按需下载，也就是当使用客户端组件前，系统检测发现服务端存在新版本，就会在后台在自动下载最新组件，因为，当服务器端发生更新了，客户端使用到了更新的些功能是，会有延迟；  全下载模式：在出现登陆界面前，下载服务器上所有最新版本，登陆后不会再去下载组件。
【使用Apache下载服务器】： 因为EAS更新组件时都是静态的文件，如果客户端比较多，同时下载对应用服务器的冲击比较大，因此建议使用apache最为EAS文件更新的服务器。  Windows环境可以从 http://httpd.apache.org/download.cgi 下载最新的apache 安装程序。 非windows环境需要使用IBM HTTP Server，可以从 http://www-306.ibm.com/software/webservers/httpservers/ 下载。 注意：WebSphere 安装盘中自带了IBM HTTP Server安装程序。（参考本文的“如何集成Apache下载服务器”）
【Apache安装目录】： 配置为apache或IHS的安装目录
【配置文件名称】： 指定apache或IHS使用的配置文件名称，默认为httpd.conf
【RPC服务器端口】：设定EAS RPC协议绑定的端口，默认为11034。 注意不要与本机其他端口冲突。
【portal虚拟路径】： 指定EAS Portal访问的地址。
【下载服务器映射】： 配置EAS自动更新的映射规则，主要用于不同网络中的客户端自动下载更新的访问, 一般不用配置。 规则说明如下：
  192.168.18.*  ――> 192.168.18.9:6888  表示当客户端在192.168.18网络中时，则从192.168.18.9:6888 这个地址去下载EAS最新组件
  202.168.18.163.124 --> 202.168.186.125:6888 表示当客户端来自202.168.163.124时，去202.168.186.125:6888去下载最新EAS组件。
  *.*.*.*  --> 192.168.18.9:6888  表示任意客户端可以去 192.168.18.9:6888下载最新EAS组件。
规则的中*越少，优先级越高。 

4、 配置EAS数据中心

EAS配置部署必须包含至少一个可用的EAS数据中心，如果之前已经建立或者还原过EAS数据中心，则可以在这个页面点击【注册】添加进来； 如果没有，则通过【创建】按钮启动EAS数据中心创建向导，创建完毕后自动注册过来。（参考《数据中心向导》部分）
选择需要部署的数据中心，点击【下一步】就开始自动化部署配置过程。
5、 配置部署

6、 部署完毕后，重启应用服务器后，EAS客户端就可以登陆使用了。
数据中心向导
在EAS管理控制台的【数据中心管理】页签点击【创建】按钮，或在部署向导中都可以启动数据中心向导。
1、 设置数据库服务器信息
A) Oracle服务器

说明： EAS要求Oracle数据库必须是9.2.0.8以上，强烈推荐使用10.2以上。而且数据库实例的字符集必须是UTF8， 其他字符集：如AL32UTF8都是不能使用的（主要是EAS工作流引擎必须使用UTF8编码）。
  同时请注意： 如果oracle监听服务配置为 “使用oracle8发行版本8.0兼容标识”，择在此必须选择【数据库版本】为 “SID Edition”.  可以通过oracle的net manager查看修改实例监听配置.
    
B) DB2服务器

说明： EAS工具不能直接创建DB2数据库，请通过DB2工具创建一个UTF8编码的数据库，或者使用以下脚本在db2上命令行上执行
    CREATE DATABASE EASDBNAME ON '/db2' USING CODESET UTF-8 TERRITORY CN COLLATE USING SYSTEM;
注意上面的 EASDBNAME替换为希望创建的数据库名， /db2 替换为数据所在操作系统上的实际路径。
  第一次新建EAS帐套前需要拷贝 eas/server/lib/uuid/Uuid.class文件到db2的sqllib/function目录下。

C) Sqlserver服务器


2、 配置EAS数据中心信息
A) Oracle类型数据中心配置

【创建用户】： oracle通过用户名区分不用的应用，每个EAS数据中心对应一个oracle用户名，所以新建EAS数据中心需要执行用户名，新建成功后，使用该用户名注册EAS配置，EAS运行时也将使用这个用户名来连接数据库。
【使用同一表空间】： 选中该选项后，EAS的临时表和业务表都将存放在这个表空间下。 推荐生产环境使用多表空间设置。
单一表空间配置时： 表空间路径是oracle数据库服务器上的物理路径。
多表空间设置如下：

B) DB2类型数据中心配置


C) SQLServer类型数据中心配置


D) 高级参数选项设定
高级参数设定可以选择相关任务，默认执行所有任务，建议不要修改。
    点击下一步就可以开始创建EAS数据中心了。

EAS补丁的安装
1、 补丁目录结构说明：
EAS每个补丁都符合一个标准的目录结构， 如下图所示：

  补丁目录下包含一个Client目录和Server目录，以及相关的sql文件和补丁说明文件xxx.xls ，EAS52之前还可能包含元数据定义文件（需要根据文档手工合并）。
  Client目录是EAS客户端使用的，Server目录表示EAS 服务端目录。
 
2、如何安装补丁：
A) 首先停止EAS服务器，备份补丁即将覆盖的文件；
B) 然后把Server目录下的所有目录(fileserver.ear   server等)拷贝覆盖 EAS服务端安装目录下的对应目录（不要使用说明文档中的方式一个个文件拷贝，避免发生错误）
C) 如果补丁中包含sql脚本文件，请参考说明文件中的方式执行SQL脚本： 注 EAS的补丁脚本一般为ksql，必须在EAS管理控制台中选择【工具】-->【执行脚本】方式执行。
D) EAS5.2之前的版本补丁如果包含元数据，请参考说明文件替换元数据。 EAS5.2之后不需要执行这个步骤
E) 如果应用服务器为websphere，而且EAS补丁的Server/server/deploy/目录下包含eas.ear 或者apusic目录，则需要在EAS管理控制台中重新部署EAS应用，方法：选择管理控制台的【工具】-->【部署应用】重新部署EAS。

如何切换应用服务器
如果安装后需要使用另外的应用服务器发布EAS，只需要登陆EAS管理控制台，选择【环境设置】页签，修改应用服务器设置，保存后重启管理控制台，然后选择【工具】-->【部署应用】重新发布一次EAS就可以了。
 

WebSphere概要表
Websphere概要表是IBM在WebSphere 6.0开始使用的一种配置管理概念， 一个websphere概要表下可以就是一套完整的websphere配置,包含服务器定义，资源定义等等。一般情况下推荐EAS独立使用一个websphere概要表。
1、如何创建概要表
Websphere6.0可以通过WebSphere/AppServer/bin/ProfileCreator目录下的pct[操作系统].bin(exe)启动概要表新建向导, 而websphere6.1则通过WebSphere/AppServer/bin/ ProfileManagement/pmt.bat(sh)启动概要表新建向导。
首先选择“创建应用程序服务器”概要文件。

接下来的部署基本上按照websphere的默认值就可以了。



  2、如何删除概要表
   Websphere6.0在WebSphere/AppServer/bin下运行
（Windows环境） wasprofile -delete –profileName 概要表名  
（非windows） sh wasprofile.sh –delete –profileName 概要表名
就可以删除概要表了。
  Websphere6.1在WebSphere/AppServer/bin下运行
（Windows环境） manageprofiles -delete –profileName 概要表名  
（非windows） sh manageprofiles.sh –delete –profileName 概要表名
weblogic domain配置
weblogic domain是weblogic服务器实例的基本管理单元，这个单元是所有相关资源的集合。推荐eas使用的domain与其他应用的domain分开。
1、 如何创建weblogic domain
在weblogic安装目录的 weblogic81/common/bin（weblogic9.0在 weblogic90/common/bin）下运行 sh config.sh (windows环境运行 config.cmd)启动weblogic domain的配置向导

选择 “Create a new WebLogic domain”

选择“Basic WebLogic Server Domain”,然后点击【Next】

选择【Custom】然后点击【Next】

注意配置weblogic Listen port, 默认为7001， 不要如其他服务器冲突。

选择【No】不创建weblogic集群，然后点击【Next】

选择【No】不配置weblogic jdbc等等，然后点击【Next】

选择【No】不定义weblogic jms， 然后选择【Next】

在此配置weblogic服务器的用户名和密码，注意记住该密码，EAS管理控制台必须通过这个用户名和密码才能管理weblogic。 Weblogic服务器也必须通过这个用户名和密码启动。

选择不创建windows开始菜单，不配置windows服务。

选择”Product Mode”，然后点击Next

在此配置weblogic的domain路径和domain名称，选择 create 即可开始创建weblogic domain。

EAS集群的配置部署
EAS集群是依靠金蝶自身的技术力量打造的、独立于应用服务器的、可以跨操作系统、应用服务器的集群技术。一个EAS集群由一个集群控制器和只包含一个主节点的多个EAS实例组成。具体部署模型以及说明请参考EAS相关技术文档。
由于一个EAS实例对应一个应用服务器实例，所以在部署EAS集群前，请新建多个应用服务器配置实例（即： websphere新建多个profile， weblogic新建多个domain）， apusic除外，因为在EAS管理控制台中新建EAS实例时，同时新建apusic实例。
1、 新建多个EAS实例
A) 配置实例信息
启动EAS管理控制台，选择【工具】-->【新建实例】后，弹出新建实例向导。

【实例名称】：EAS每个实例必须有一个名字，安装EAS后有一个叫default的实例。一个EAS实例就是一套EAS运行时配置文件，存放在EAS安装目录的server/instances/<实例名>目录下，所以安装EAS补丁时，不需要针对每个实例安装，只需要针对EAS_HOME安装一次。
【RPC服务器端口】： 每个EAS实例都有一个RPC服务器，在同一物理主机上，该端口不能与其他RPC端口和其他应用的端口冲突。建议每个物理主机上的多个实例给连续的端口号,便于记忆。
【服务类型】： 指定这个EAS实例的类型，一个EAS集群下只有一个EAS主服务。 当你选择从服务时，必须指定这个主服务器的ip和主服务的RPC端口号。

B)配置实例对应的应用服务器信息
在此输入这个EAS实例对应的应用服务器实例的信息，也可以在新建实例完毕后，重启eas管理控制台时选择这个新建的实例登录，然后选择【环境设置】页签中的【应用服务器配置】进行设置。
   a)apusic设置

 
  b)websphere配置

  注意： 每个EAS实例对应websphere的概要表或应用服务器名称必须不相同。

   c)weblogic配置

  注意：每个EAS实例对应的weblogic domain必须保证不能相同

2、 部署每个EAS实例

在登陆界面选择EAS实例名称，然后选择登陆。 注意： EAS5.2.1之前，每次切换实例前，必须重启管理控制台。 EAS5.2.1可以在管理控制台的【系统】菜单中选择【重新登录】切换实例。
  登陆EAS管理控制台后，选择【工具】菜单中的【部署应用】开始EAS应用的部署。 每个EAS实例都必须部署后才能使用。 部署过程参考“EAS标注部署流程”；
新增注册一个EAS数据中心后，必须切换到每个EAS实例的【数据中心管理】页签，选择工具栏中的【部署】，将EAS数据中心发布到对应的应用服务器实例上。

3、 配置EAS集群控制器
一个EAS集群中的每个实例都必须在EAS集群控制器中进行注册。在EAS管理控制台的登录界面选择集群中主服务对应的EAS实例名，登录后在【应用管理】页签的【EAS集群】中可以看到EAS集群成员信息。

在参数设置中修改 tcpConnectionPort 对应的参数值，可以修改EAS集群控制器的端口号。
修改参数后，选择【保存】，然后选择【启动前置机】就可以启动EAS集群控制器。


EAS集群的启动与停止
EAS主服务必须先于其他成员启动，后于其他成员停止。EAS的default实例在EAS_HOME/server/bin下通过 startserver.sh(bat)和stoptserver.sh(bat)启动与停止。 而其他实例在 EAS_HOME/server/instances/<实例名>/bin下通过 startserver.sh(bat)和stopserver.sh(bat)启动与停止。
EAS集群控制器必须在EAS主服务器所在的EAS_HOME/server/bin下通过startLoadBalance.sh(bat)和stopLoadBalance.sh(bat)启动与停止。


如何集成Apache下载服务器
1、 下载Apache服务器
Windows环境可以从 http://httpd.apache.org/download.cgi 下载最新的apache 安装程序。 非windows环境需要使用IBM HTTP Server（基于Apache），可以从 http://www-306.ibm.com/software/webservers/httpservers/ 下载。 注意：WebSphere 安装盘中自带了IBM HTTP Server安装程序。
2、 安装Apache服务器
A)Windows下Apache的安装
  下载apache或者使用EAS服务端 fileserver.ear/easWebClient/download/ 下的apache_2.0.54-win32-x86-no_ssl.msi， 运行后显示安装向导。
  按照默认设置安装完毕即可。 注意，apache默认安装在 C:\Program Files\Apache Group\下。
  安装完毕后，apache会自动启动，在windows右下角的图标区域可以看到apache的控制图标，双击可以打开apache控制台。

在这个界面上可以启动与停止apache。或者在apache安装目录的 apache2/bin下运行apache.exe启动

B)IBM HttpServer的安装
  从IBM网站下载IHS后（或者在WebSphere安装盘的IHS目录），进入IHS目录，运行 ./install  即可启动程序安装向导。 按照向导默认设置完成IHS的安装

3、 集成Apche服务器
EAS管理控制台已经集成了对Apache（IHS）的管理功能，在EAS应用部署向导页面，只需要选定 【使用Apache(IBM Http Server)作为默认的下载服务器】，同时设定 apache(IHS)安装目录就可以了。 EAS管理控制台会自动完成Apache配置文件(httpd.conf)的配置修改。


4、 启动与停止Apache(IHS)
Windows下可以直接通过apache控制台启动与停止apache。 非windows环境都可以通过apache(IHS)安装目录的bin目录下运行 ./apachectl –k start|stop|restart  完成apache的启动、停止和重启。
  注意：一般情况下，重启EAS应用服务器不需要重启apache。