应用系统部署操作手册.docx

1、应用系统部署操作手册应用部署操作手册(eos6.0、eos6.2)前 言本文档介绍了如何通过governor对一个新应用进行部署以及对已有的应用进行更新。本文档主要内容包括创建应用、部署应用、部署构件包部署包、部署构件包补丁、切换构件包版本、Governor配置功能等六大快。本操作手册适用于eos6.0和eos6.2版本。详细操作步骤1Governor系统登录a)登录Governor系统，首先要启动管理器服务b)打开IE浏览器，在地址栏输入http:/localhost:8080/eos-governor，或在Windows下选择EOS菜单“EOS Governor”，进入登陆界面，如下图所示

2、：c)输入用户名和密码，用户名为“sysadmin”，密码默认为“000000”，点击按钮，登录系统。说明：修改密码可以在登录系统后，点击右上角”修改密码”。2创建应用2.1功能概述创建应用是指为某个独立服务器或服务器组创建新应用。应用创建后只是创建了一个空的应用，不包含任何用户自己开发的程序，用户可以向空应用部署构件包。2.2操作步骤a)在菜单导航栏选择“管理”，点击“应用管理”，进入功能区应用管理界面，默认显示管理服务器的应用列表，如下图所示：b)选择要管理的独立服务器或服务器组。c)点击“创建应用”按钮 ，进入创建应用界面，如下图所示。说明：此时应用管理后的括号中会显示当前创建应用的服务

3、器的名称，如下图红圈中所示。d)在创建应用页面填写相关信息，参数说明如下。参数名称参数意义应用名称应用的唯一标识。在同一个服务器或同一个服务器组中，应用名称不允许重复（忽略大小写）。可选平台模块创建BPS空应用时可选择部署的平台级系统模块。（一般不需要选）必选平台模块创建BPS空应用时必须部署的平台级系统模块。数据源可选择无数据源、自定义C3P0数据源或自定义JNDI数据源。无数据源：表示应用不使用数据源；自定义C3P0数据源：对于Tomcat，需要建立C3P0数据源； 自定义JNDI数据源：对于JBoss、WebLogic、WebSphere，需要创建自定义JNDI数据源。 注：当选择自定义

4、C3P0数据源或自定义JNDI数据源时，需要填写数据源的信息，数据源的详细配置请参考数据源配置。e)点击按钮，完成创建应用操作3部署应用3.1功能概述 部署应用是指将仓库中的应用部署到被管服务器上（及其J2EE应用服务器上），使其能够在被管服务器上运行。EOS应用部署到被管服务器上后，由两部分组成：一部分是应用服务器的部署目录下的EAR文件（Tomcat部署目录下的war文件），这部分包括所有页面、Java程序文件； 另一部分是EOS主目录中的应用的工作目录，这部分内容包括了应用的配置信息和构件包程序资源，如页面流、逻辑流、工作流、数据模型、组合构件等程序文件，以及国际化资源文件等。 3.2操

5、作步骤a)进入“应用管理界面”；b)选择要管理的独立服务器或服务器组，显示其下的所有应用列表；c)在要部署的应用 对应的操作栏点“部署”超链接，系统弹出确认对话框；点击按钮，退出操作点击按钮，执行部署操作。4部署构件包部署包4.1功能概述构件包部署包是EOS studio导出的多个构件包，以及一个可选web模块的压缩包。一般来说对一个项目导出一个部署包，扩展名为 .ecd。部署构件包部署包功能向目标应用部署ecd文件中的一个或多个构件包，并且会默认部署ecd文件中的web模块。可以将构件包部署为系统构件包或用户构件包，通常情况下部署为用户构件包。注意：使用部署构件包部署包功能，需要注意以下的约

6、束和规则：系统构件包和用户构件包的名称不能冲突如果已经部署过某个系统构件包，再部署名称相同（忽略大小写）的用户构件包，就会产生名称冲突，系统不允许部署新的构件包。例如已经部署过com.primeton.workflow.core系统构件包，用户再开发一个com.Primeton.Workflow.CORE用户构件包，是不允许部署的。反之亦然，部署了用户构件包，同名系统构件包也是不允许部署的；相同大版本构件包部署时会先清理再部署部署包中每一个构件包都有版本号（称为大版本号）。部署时，如果已经部署过同名构件包，且大版本号相同，则会先卸载该版本原先已部署的构件包及该版本的所有补丁版本，然后重新部署该

7、版本的构件包； 部署高于当前版本的构件包时，仓库会保留历史版本当部署的版本大于当前版本时，不会清理仓库中的旧的版本的jar和补丁jar，只会重新覆盖工作目录中的构件包文件； 依赖的构件包没有部署，则不允许部署构件包如构件包A依赖构件包B，但B没有部署，如果用户想直接部署A，则是不允许的，但用户可以同时部署A和B。4.2操作步骤a)在菜单导航栏选择“管理”，点击“构件包”，在功能区选择一个目标应用，进入构件包管理页面；选择用户构件包列表页签，将构件包部署为用户构件包；选择系统构件包列表页签，将构件包部署为系统构件包。b)在页面下方点击“部署”，进入构件包向导页面；c)点击“浏览”选择要部署的部署

8、包ecd文件，点击“下一步”；d)在可部署构件包列表中选择要部署的构件包文件，并且选择“是否覆盖配置文件”；e)点击发布，完成部署操作，将看到部署构件包操作结果提示页面。说明：如果操作结果页面提示重启应用，需要重启应用才能使本次部署操作在运行时生效。5部署构件包补丁5.1功能概述构件包的补丁包是EOS Studio对若干个构件包增量文件或若干个增量的web模块文件导出扩展名为.epd的压缩包。该功能向目标应用部署epd文件中的一个或多个构件包补丁，并且会默认部署epd文件中的web模块。注意：使用部署构件包补丁功能，需要注意以下的约束和规则：没有部署过的构件包，不能打补丁如ponent1构件包

9、还没有部署，此时部署ponent1的补丁是不允许的； 部署构件包的补丁只能针对当前大版本如ponent1已经部署，当前版本为2.0.1，如果一个补丁包中该构件包的版本为2.1.0，与运行的当前版本不一致，则不允许部署，只能部署2.0.1版本打出的补丁； 补丁版本号由部署程序自动生成如构件包com.a.b当前版本为2.0.1，部署该版本的补丁后，生成0001的小版本号，当前版本变为2.0.1_0001。如果再次部署一个补丁，则会生成0002的另一个小版本号，当前版本变为2.0.1_0002。这样，构件包仓库中就会保留了com.a.b_2.0.1.jar、com.a.b_2.0.1_0001.ja

10、r、com.a.b_2.0.1_0002.jar三个jar文件，以此类推； 切换构件包后再次部署补丁将删除当前补丁版本后的所有补丁文件，然后部署补丁文件。如构件包com.a.b当前版本为2.0.1_0002，切换为2.0.1版本后再部署补丁，将先删除原有com.a.b_2.0.1_0001和com.a.b_2.0.1_0002版本补丁文件，然后部署新的补丁文件，并生成0001的小版本号。 5.2操作步骤a)在菜单导航栏选择“管理”，点击“构件包”，在功能区选择一个目标应用，进入构件包管理页面；选择用户构件包列表页签，为用户构件包打补丁；选择系统构件包列表页签，为系统构件包打补丁。b)在构件包管

11、理页面下方点击“部署补丁”，进入补丁包部署向导页面；c)点击“浏览”选择要部署的补丁包epd文件，点击“下一步”；d)在可部署补丁包列表中选择要部署的补丁包文件，并且选择“是否覆盖配置文件”；e)点击发布补丁，完成部署操作，将看到部署补丁包操作结果提示页面。说明：如果操作结果页面提示重启应用，需要重启应用才能使本次部署操作在运行时生效。6切换构件包版本6.1功能概述EOS提供了构件包的版本切换功能，通过Governor可以在已经部署过的多个版本中切换，以便升级到一个新的版本，或部署过一个新的补丁后发生了问题时，可以切换到原先的版本继续运行。注意：使用部署构件包补丁功能，需要注意以下的约束和规则

12、：切换构件包版本时，建议保留当前版本的配置信息。因为当前版本的配置信息代表了当前运行期的设置，而要切换到的版本的的配置是以前的运行配置，甚至是开发期的配置，和当前运行期的配置是不同的。在切换版本时默认保留当前配置的选项。6.2操作步骤a)在菜单导航栏选择“管理”，点击“构件包”，在功能区选择一个目标应用，进入构件包管理页面；选择用户构件包列表页签，为用户构件包切换版本；选择系统构件包列表页签，为系统构件包切换版本。b)选择要切换版本的构件包，点击下方的“切换历史版本”，进入构件包版本切换页面；c)在可切换含本列表中选中要切换的版本，选择“是否保留当前配置”；d)点击“切换”，完成切换操作，将看

13、到切换版本操作结果提示页面。说明：如果操作结果页面提示重启应用，需要重启应用才能使本次部署操作在运行时生效。7Governor配置功能7.1数据源配置7.1.1功能概述应用数据源配置包括增加、修改和删除应用数据源功能对于Tomcat服务器，可以建立C3P0数据源；对于JBoss、Weblogic、Websphere，只能配置JNDI数据源。7.1.2操作步骤a)在菜单导航栏选择“配置/数据源”，在功能区选择一个目标应用，进入数据源配置页面。b)选择“应用数据源”页签，进入应用数据源配置页面。页面显示已有的应用数据源、数据源名称和类型（JNDI或C3P0）。c)增加应用数据源点击按钮，进入应用数

14、据源配置页面。JNDI数据源配置页面如下图所示。用户填写数据源相关参数后，点击按钮，可以增加新的应用数据源；点击按钮，返回上一页面，不做任何操作。相关参数说明如下：参数名称参数意义数据源名称用于唯一标识数据源的名称。数据源类型JNDI或C3P0。JNDI名称系统数据源的JNDI名称。隔离级别数据源的事务隔离级别。事务隔离级别用来控制一个数据库会话中、一个事务中对数据如何加锁。分为以下几种：ISOLATION_DEFAULT：使用每种数据库自己缺省的隔离级别，每种数据的缺省隔离级别可能有所不同，但大部分是ISOLATION_READ_COMMITED；（一般选择此级别）ISOLATION_REA

15、D_UNCOMMITED：允许脏读，可读出其他事务修改的，尚未提交的脏数据； ISOLATION_READ_COMMITED：不允许脏读，只能读取提交后的数据； ISOLATION_REPEATABLE_READ：可重复读，在一个事务中查询数据时，不能读到其他事务修改过的数据，但可以读到其他事务中增加的数据；ISOLATION_SERIALIZABLE：最严格的隔离级别，在一个事务中查询数据的时候，不允许其他事务对所读的表数据进行修改或添加新记录。 连接重试次数设置测试数据库连接时，如果连接不上，重新连接数据库的次数。超过这个数目连接不上，则认为数据库无法连接。-1表示不重新连接。测试SQL语

16、句测试数据库连接所使用的SQL语句。C3P0数据源配置页面如下图所示：用户填写数据源相关参数后，点击按钮，可以增加新的应用数据源点击按钮，返回上一页面，不做任何操作。相关参数说明如下：参数名称参数意义数据库类型数据库的类型，如Oracle、DB2等。驱动类型数据库驱动的类型，一种数据库会提供至少一种或多种驱动类型，每种驱动类型有不同的驱动类和JDBC URL的写法。随着EOS支持的数据库驱动增加，一个数据库可能会有多种支持的驱动。驱动类数据库驱动的类全名。JDBC连接URL连接数据库的URL。用户名、密码登录数据库的用户和密码连接池初始连接数应用启动后初始化建立的数据库连接数，应该介于最大连接

17、数和最小连接数之间。连接池最大连接数连接池可以容纳的最大的连接数。连接池最小连接数连接池最少可以维持的连接数目。连接重试次数设置测试数据库连接时，如果连接不上，重新连接数据库的次数。超过这个数目连接不上，则认为数据库无法连接。-1表示不重新连接。测试SQL语句测试数据库连接所使用的SQL语句。d)修改应用数据源选择一个要修改的应用数据源，点击按钮，进入修改数据源页面；该页面与增加数据源页面类似，不同的是，不能修改数据源的名称。e)删除应用数据源选择一个要删除的应用数据源，点击按钮，系统提示是否确定删除指定记录；点击按钮，删除数据源； 点击按钮，取消操作。f)测试数据源连接用户如果需要测试数据库

18、参数填写是否正确，请点击按钮，测试数据库是否可以连上。7.2HTTP接入配置7.2.1功能概述HTTP接入配置包括文件上传参数设置、HTTP请求的字符集配置、门户或非门户访问模式和登录验证过滤配置等功能，涉及HTTP访问相关配置。7.2.2操作步骤a)在菜单导航栏选择配置/HTTP接入，在功能区选择一个目标应用，进入HTTP接入配置页面，如下图所示。b)用户可以修改文件上传的参数、HTTP请求的字符集编码、访问模式配置、登录过滤配置等参数，点击按钮保存配置。相关参数说明如下参数名称参数意义文件上传配置配置有关文件上传的配置项。最大可上传文件的字节数定义通过HTTP上传文件的最大字节数，缺省为1

19、00M。说明Governor应用也是EOS应用，也有这个限制，但缺省没有提供修改这个参数的功能。如果Governor要删除超过100M大小的文件，可以手工修改$eosHome/working/eos-governor/config/user-config.xml文件中的Access-Http/FileUpload/MaxSize选项，将其改大即可。上传文件临时缓冲大小定义server在接收上传文件时，在server中使用的缓冲的大小，缺省为10K。如果上传文件大于缓冲大小，则会使用临时文件来保存数据。增大缓冲可以提高性能，但增加内存开销。不可上传文件类型用来控制不能上传的文件类型，一般用于安全

20、目的，如jsp文件不能上传，否则用户可以在server上执行任意的代码，危害系统安全。文件上传临时存放目录文件上传后临时存放的目录，是一个相对路径。登录拦截配置用来对HTTP请求进行拦截过滤，验证是否已经登录，如果没有登录，则重定向到登录页面。未登录时跳转页面用来设置拦截到HTTP请求后，在登录验证判断为未登录的情况下，重定向到的页面，一般可以设置成登录页面。拦截Url设置对哪些请求路径进行拦截（即进行登录验证）。不拦截Url设置对哪些请求路径不进行拦截（即不进行登录验证）。其他配置引擎字符编码用来配置HTTP请求的字符编码，该字符编码只对通过POST方式提交的数据生效，对GET方式请求不生效。HTTP请求使用的字符集，这个字符集要和JSP页面的字符集保持一致。EOS缺省的JSP编码是UTF-8，因此字符编码缺省也设置为UTF-8。门户(Portal)模式设置是门户模式还是非门户模式。门户模式不需要登录验证。