HAND-HLS-AutoInstall程序发布指南

《HAND-HLS-AutoInstall程序发布指南》由会员分享，可在线阅读，更多相关《HAND-HLS-AutoInstall程序发布指南（17页珍藏版）》请在装配图网上搜索。

1、HAND AutoInstall程序发布指南 文档作者：zhengang.zhu创建日期：2011-11-01更新日期：文档编号： 当前版本：1.0文档控制变更记录17日期作者版本变更说明2011-11-01朱振刚1.0审阅姓名职位目录文档控制2概述4HLS代表什么4文档目的4本文档的阅读对象4本文档内容和结构安排思考4AutoInstall的简介及基本原理5基本原理5客户化程序文档结构简介6文档结构简介6FNDLOAD简介7安装文件的上传11上传安装文件11客户化程序安装12客户化程序安装12未决与已结问题16未决问题16已结问题16概述HLS代表什么生命科学事业部：Healthcare a

2、nd Life Science 因此,HLS代表的就是生命科学事业部文档目的本文档的主要目的是为了指导操作人员按照标准规范发布新程序及变更程序。本文档的阅读对象1、 项目现场技术负责人2、 全体技术顾问3、 客户方系统管理员4、 客户方内部顾问本文档内容和结构安排思考本文档的内容主要包括如下几方面的内容：1、 AutoInstall的简介及基本原理2、 客户化程序文档结构简介3、 FndLoad工具简介及使用方法4、 AutoInstall工具简介及使用方法AutoInstall的简介及基本原理基本原理什么是AutoInstallAutoInstall是由上海汉得(Hand)公司开发针对于Or

3、acle EBS的客户化开发安装的一套解决方法。为什么使用AutoInstall传统方法安装：Oracle EBS客户化开发安装时涉及到的安装内容比较多而繁杂。1. 传统方法安装需要开发人员或系统管理人员切换不同的工具进行客户化开发对象的编译，安装及定义，容易出现漏装的情况；2. 传统方法安装不宜将系统的管理和开发权限分离，仍需要开发人员登录EBS系统进行客户化程序的定义及设置。AutoInstall安装1. AutoInstall是为了解决以上问题而开发的，通过开发人员将不同类型的源码对象整理成相应的规范，AutoInstall工具就可以根据不同类型的对象自动编译，安装及定义，即只需简单的几

4、部操作，就可以将一个内容繁多的客户化开发迁移到系统中；2. AutoInstall可以实现应用管理和开发的分离。AutoInstall包含哪些对象AutoInstall 工具主要包含以下对象：1. 按照规范的文档结构整理的安装对象文件夹及对象；2. 用于下载FNDLOAD的 download_zhs.sh 脚本文件；3. AutoInstall所使用的 配置文件Install.cfg及Install.pl文件AutoInstall的安装步骤 使用AutoInstall 工具安装步骤如下：1. 按照规范整理安装对象文档结构(包含FNDLOAD生成的.ldt文件)；2. 上传文件夹至应用服务器相应

5、目录下，一般为$CUX_TOP/install/相应文件夹下；3. 执行perl install.pl命令进行客户化程序安装；4. 检查生成的install.log文件是否安装成功；AutoInstall的原理AutoInstall是使用操作系统脚本语言，定义的一套安装步骤，模拟用户手工安装。根据配置文件Install.cfg中定义的安装步骤，不同的步骤调用不同的工具进行安装(如DBObjects使用SQLPLUS进行安装，.ldt文件使用FNDLOAD安装等等) ，根据安装步骤运行完后就可以将所有的Objects安装到目标应用中。客户化程序文档结构简介文档结构简介客户化开发对象的整理为了能够

6、正常安装所有的源代码，我们需要将程序整理成相应的目录结构，具体如下图所示：第一层是以 开发编号+开发名称 命名的文件夹 如图是：(GMF_004批次单位成本汇总表)该文件夹下放置MD120安装文档MD070技术文档以并发请求简称命名的文件夹（如图中是：CUXGMFLC）第二层是以 并发请求简称命名的文件夹 如图是：CUXGMFLC该文件夹下放置Code 文件夹Install.pl文件Install.cfg文件第三层是以 code 命名的文件夹 该文件夹下放置Fndload文件夹Forms文件夹Package文件夹Reports文件夹Sql文件夹Table文件夹View 文件夹Xdo 文件夹第四

7、层是以 对象分类命名的文件夹每个文件夹下放置相应类型的程序源代码Fndload文件夹ZHS和US子文件夹及.ldt结尾的文件Forms 文件夹ZHS和US子文件夹及.fmb结尾的文件Package文件夹.pck结尾的文件Reports 文件夹ZHS和US子文件夹及.rdf结尾的文件Sql 文件夹.sql结尾的文件Table 文件夹.sql结尾的创建表的脚本文件View 文件夹.sql结尾的创建视图的脚本文件Xdo 文件夹ZHS和US子文件夹及.rtf结尾的文件请注意fndload,forms,reports,xdo这几个文件夹是分多语言的，需要建立ZHS和US文件夹，否则无法正常安装FNDLO

8、AD简介什么是FNDLOADFNDLOAD是Oracle提供的一个数据同步工具，并且得到官方的支持。FNDLOAD通过下载相关定义到一个文本文件做中转，再上在到另一个实例中。通过该文件，可以方便地进行版本控制，同时也方便进行安装、移植和克隆。例如，快速编码和职责可以在开发环境中建立并下载到一个文件后，上传到测试或生产环境中。这样可以避免很多手工的操作。以下这些对象可以使用FNDLOAD来迁移 Attachment Definition Concurrent Programs Printers and Printer Styles Value-Sets Request Groups Reques

9、t Sets Form Personalization Lookups Responsibilities Applications Profile Options Users Form, Functions and Menus Document Sequences Descriptive and Key Flex Fieldsl 并发请求，可执行程序。l 请求组，请求集。l 配置文件选项。l 键弹性域和描述性弹性域。l 菜单。l Form个性化。l 附件。l 消息。l 值集和值。l Lookup。l 职责。l 用户。l 打印机定义。l WebADI。l FNDLOAD怎样工作FNDLOAD是基

10、于命令行方式运行的并发请求。这个脚本既可以根据传入的参数来决定下载或上传数据。下载数据时需要指定一种对象，这是由定义文件决定的(后缀为.lct的文件)，这个定义文件是标准文件(对于所有标准的对象)在同一个目录下$FND_TOP/patch/115/import/。例如，如果要下载并发程序，就要使用afcpprog.lct这个定义文件。脚本运行后输出的文件是以扩展名为.ldt结尾的文件，这个文件可以使用FNDLOAD工具直接上传到另一环境中。例如，我们在开发环境中定义了一个并发请求，希望安装到测试环境，我们可以通过以下两部达到目标：a. 在开发环境在DOWNLOAD模式下运行 FNDLOAD 命

11、令使用afcpprod.lct 生成一个 .ldt 文件b. 在测试环境在UPLOAD模式下运行FNDLOAD，使用上面生成的.ldt文件FNDLOAD的语法语法：FNDLOAD logon 0 Y mode configfile datafile entity param . logon:EBS用户名/密码TNS连接别名mode: UPLOAD 或 DOWNLOADconfigfile: 配置文件路径，根据同步对象的不同需要选择不同的配置文件。datafile: 数据文件entity: 条目名称, 或者上载时的所有相关值param: 参数格式为 NAME=VALUE标准配置文件Oracle提

12、供了一系列的配置文件(.lct 文件)用来迁移标准对象，这些配置文件都在 $FND_TOP/patch/115/ 目录下。主要的配置文件如下：EntityConfiguration FileAttachment Definitionafattach.lctConcurrent Programsafcpprog.lctPrinters and Printer Stylesafcppstl.lct, afcpprnt.lctValue Setsafffload.lctRequest Groupsafcpreqg.lctRequest Setsafcprset.lctForm Personaliza

13、tionaffrmcus.lctLookupsaflvmlu.lctResponsibilitiesafrole.lctApplicationsafscapp.lctProfile Optionsafscprof.lctUsersafscursp.lctForm, Functions, Menusafsload.lctDocument Sequencesafsncat.lctDescriptive and Key Flex Fieldsafffload.lctMessagesafmdmsg.lctFNDLOAD示例下载及上传一个并发请求定义：开发环境下DOWNLOAD：FNDLOAD apps

14、/apps_pwd O Y DOWNLOAD $FND_TOP/patch/115/import/afcpprog.lct report.ldt PROGRAM APPLICATION_SHORT_NAME=CUX CONCURRENT_PROGRAM_NAME= CUXGMFLC测试及生产环境下UPLOAD：FNDLOAD apps/apps_pwd O Y UPLOAD $FND_TOP/patch/115/import/afcpprog.lct report.ldt批量生成.ldt文件以上我们理解了FNDLOAD是什么，但是在实际的开发过程中比如一个并发请求可能包含很多实体，如repor

15、t,Lookup,profile,Message等等，如果使用FNDLOAD一个一个DownLoad必然会比较耗时，所以我们编写了download_zhs.sh文件，进行.ldt文件的批量下载。.sh文件中是顺序下载排列好的FNDLOAD脚本，我们只需要修改相应的参数就好，.sh 文件支持安装所有的FNDLOAD脚本。具体步骤如下：1. 修改相应的FNDLOAD参数，如report，则修改APPLICATION_SHORT_NAME 和 CONCURRENT_PROGRAM_NAME 两个参数，如以上的例子则需要修改为APPLICATION_SHORT_NAME=CUX CONCURRENT_

16、PROGRAM_NAME= CUXGMFLC 即可2. 将.sh文件上传至源实例应用服务器下，位置可自定义，一般可以上传至相应的开发文件夹下，如$CUX_TOPinstall CUXGMFLC下3. Telnet至源应用服务器相应目录下，如$CUX_TOPinstall CUXGMFLC找到download_zhs.sh文件，执行脚本，命令为 download_zhs.sh 数据库APPS用户名数据库APPS密码 如download_zhs.sh appsapps 回车，则开始执行批量下载4. 将生成的.ldt 文件全部下载到以上整理的code 文件夹下的fndload文件夹下，按照语言分开放

17、置即可安装文件的上传上传安装文件上传文件路径按照上诉方法整理好文档结构并做好FNDLOAD文件下一步就是要上传文件夹到目标实例的应用服务器上。一般要上传到客户化开发所在应用对应的TOP下，如果客户化开发应用简称是CUX，则要上传文件夹到$CUX_TOP下的install目录下，即$CUX/install目录下，若没有install 目录可手工建立。上传时从第二层文件夹开始上传，即将以程序简称命名的文件夹上传到服务器上。上述例子中为CUXGMFLC文件夹。客户化程序安装客户化程序安装简介当完成已上步骤完成了文档结构的建立，制作了FNDLOAD对应的.ldt文件后，并将整理好的文件夹上传到要迁移的

18、应用服务器后，就要开始进行安装操作。客户化程序的安装主要是运行.pl脚本根据在.cfg文件中定义的安装步骤，调用不同的工具将不同类型的程序安装到目标环境中。.cfg配置文件.cfg配置文件是用来指定pl脚本文件安装的执行步骤其中包含以下配置：1、要安装对象的schema和应用2、安装哪些步骤/对象3、每种安装步骤的参数.格式说明配置文件中以#开头的行为备注行属性设置的行格式： 中间必须以空格分隔，属性值必须在一行内完成属性说明第一区：安装的数据schema和应用dbschema必须安装对象的数据库用户，如：HSS, HAND, CUXappshortname必须安装应用简称，如：HSS, HA

19、ND, CUXbasepath必须安装应用的顶层目录，如HSS_TOP, HAND_TOP, CUX_TOPnls_lang_charset必须安装脚本文件所使用的默认字符集，如UTF8该设置影响$NLS_LANG,对于使用sqlplus,fndload有影响如果某一类型不一致，可以在安装步骤参数中设置第二区：需要从context获取的变量context s_dbSid必须数据库实例context s_dbhost必须数据库主机名context s_dbdomain必须数据库主机域名context s_dbport必须数据库端口 说明：如果需要获取额外的变量，可以从context文件中获取相应

20、的名称（可能用于用户定义程序中）。第三区：安装步骤/安装对象格式：installstep 使用安装对象名称，多个单词使用_连接，不要有空格或则. 如安装table，则安装步骤可以是：installstep table第四区：安装步骤的参数格式：. 参数名有以下几个：SourceDir必须安装文件存放目录( 相对目录：相对于安装目录 )Filter必须文件过滤器，无过滤器使用*，如*.sql, *.fmb等MultiLanguage可选有效值：Y/N，指定是否为多语言安装， 如form安装SourceDir指定到forms目,MultiLanguage=Y,则安装程序自动安装forms下的所有语

21、言nls_lang_charset可选指定该来源文件所使用的字符集CopyToStage可选有效值：Y/N，是否拷贝文件到代码存储区StageDir可选代码存储区目录（可以引用install.pl中的全局变量/环境变量）CopyToDestination可选有效值：Y/N，是否拷贝文件到目的地DestinationDir可选文件目的地的目录（可以引用install.pl中的全局变量/环境变量），如$basepath/program/code/tableExecuteProgram可选使用的安装程序，可以选择有sqlplus / FndXdfCmp / frmcmp_batch / f60gen

22、 fndload / xdoload / XMLImporter / userdefineUserDefineExecute可选用户自定义执行脚本，当ExecuteProgram=userdefine时必须设置（可以引用install.pl中的全局变量/环境变量）SqlInBatch可选有效值：Y/N，sqlplus的参数，当ExecuteProgram=sqlplus时可以设置是否使用批方式来执行，使用批处理可以避免频繁登录数据库.XDOLobType可选xdo文件参数，用于确定xdo文件的对象类型，有效值：TEMPLATE / DATA_TEMPLATE / XML_SAMPLE 当Exe

23、cuteProgram=XMLImporter时必须指定实例：# table#table.SourceDir code/tabletable.Filter *.xdftable.CopyToStage Ytable.StageDir $basepath/program/code/tabletable.ExecuteProgram FndXdfCmp# forms#forms.SourceDir code/formsforms.Filter *.fmbforms.MultiLanguage Yforms.CopyToStage Yforms.StageDir $basepath/program/

24、code/formsforms.ExecuteProgram frmcmp_batch.pl脚本文件.pl脚本文件作用是根据.cfg文件的设置执行安装工作，.pl脚本文件不需要做任何修改，直接使用。语法： perl install.pl installpath= cfgfile= appsusr= appspwd= dbschemapwd= contextfile= logfile= where * installpath= install path * cfgfile= install config file * appsusr= apps user name * appspwd= apps

25、 password * dbschemapwd= password of dbschema in config file * contextfile= context file * logfile= installer log file name. default: ./install.log如果任何参数不输入，则安装程序会一步一步提示用户输入建议将install.pl和install.cfg放在代码根目录即按照规范整理文档目录。如-xxx |-code | |-forms | |-table | |-view |-install.pl |-install.cfg安装时执行: perl ins

26、tall.pl 这时用户可以按缺省进行安装。怎样安装使用Telnet工具，cd至以上步骤上传文件夹的路径下，如$CUX_TOPinstall CUXGMFLC目录下,执行.pl文件，方法为 perl install.pl后回车会提示以下问题：1. Please enter codes path /u02/crp/apps/apps_st/appl/cux/12.0.0/install/CUXGMFLC: 提问code路径，如果是当前路径，则直接回车2. Please enter install config file/u02/crp/apps/apps_st/appl/cux/12.0.0/i

27、nstall/CUXGMFLC/install.cfg: 提问使用的配置文件名称，如果是当前文件夹下的install.cfg文件则直接回车3. Please enter the APPS User apps:输入APPS Schema的名称，如果是apps则直接回车4. Please enter the APPS password apps:输入APPS Schema的密码，如果是apps则直接回车5. Please enter the CUX password CUX:输入CUX Schema的密码，如果是CUX则直接回车回车后则进入安装，安装完毕后会提示install success!Please check log file at /u02/crp/apps/apps_st/appl/cux/12.0.0/install/ CUXGMFLC /install.log这是表示安装结束，这时我们可以根据提示回到以上目录，查看install.log文件，install.log文件会显示所有安装的过程及最后安装是否成功，如果出错错误是什么。所以一定要检查install.log文件，确保安装正常，至此所有的安装过程结束。可以去目标实体中检查是否安装成功未决与已结问题未决问题序号问题解决方案负责人目标日期实际日期12已结问题序号问题解决方案负责人目标日期实际日期