UAPV63-安装盘配置与升级技术红皮书(整理后).doc

UAP 红皮书系列 安装盘配置与升级技术红皮书 NC UAP 6 1 UAP 中心 编著 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 1 14 页 目录 第一章 安装盘结构及配置文件说明 2 1 1 安装盘结构 2 1 2 产品结构 2 1 3 模块结构 3 1 4 配置文件说明 4 第二章 安装升级方案相关说明 9 2 1 安装流程 9 2 2 创建升级业务中心 9 2 3 代码调整 12 附录 13 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 2 14 页 第一章 安装盘结构及配置文件说明 本章内容概要 安装盘结构 产品结构 模块结构 配置文件说明 NC 安装盘分为新安装盘和 NC 安装盘分为新安装盘和补丁盘两种 新 装盘会在 nchome 下生成 ncscript 文件夹 而补丁盘则会在 nchome 下生 成 update 文件夹 新盘和补丁盘结构大同小异 下面就介绍下安装盘的 结构 1 1 安装盘结构 安装盘包含一个到多个产品 安装盘的目录结构如下图所示 图 1 1 安装盘下面可以放一个到多个产品 表现形式上为一个目录 目录的名 称必须为产品的模块标识名称 如客户化为 uap 1 2 产品结构 一个产品包含一个到多个模块 产品的目录结构为下图所示 安装界面 的图片目录 产品 1 产品 2 安装程序包 安装程序依赖 的包 安装程序依赖的包 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 3 14 页 图 1 2 对于一个产品来说 其配置文件 setup ini 中的内容为 code 10 产品编码 name 客户化 产品名称 version 5 0 产品版本号 disk type new 是否是全新安装 new 为全新安装 patch 为补丁安装 previous generation code 10 自身依赖的前一个版本号 required related module 依赖的其他产品 1 3 模块结构 模块下面包含着该模块相关的多个 jar 包 运行安装程序 将解压模块下的所有 jar 包到指定的 nchome 目录下 形成 ncv5 的目录结构 如下图所 示 所以在压缩 jar 包时需要安装该目录结构进行压缩 模块一 模块二 产品配置文件 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 4 14 页 图 1 3 1 4配置文件说明 上文中 每个产品和每个模块的目录下都必须存在一个对于该产品或者模块的描述文件 即 setup ini 文 件 当进入 nc 的安装界面后 会看见产品安装树 此树中信息就是从 setup ini 中读取的 树的结构是 根据产品文档结构构成的 同一节点下的子结点按照 setup ini 中的编码属性进行排序 模块代码目录 模块数据库脚本目录 产品目录层 次 模块目录层 次 数据库脚本目录结 构 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 5 14 页 图 1 4 在产品下的 setup ini 中只需要配置编码 名称 版本等属性 不需要配置脚本存放目录等信息 而模块 下的 setup ini 需要配置相关信息 配置文件 setup ini 中配置着该模块的属性请参见下表 配置项含义必选使用范围备注 code 模块编码是安装盘和补丁 盘 name 模块名称是安装盘和补丁 盘 desc 描述否安装盘和补丁 盘 一般对于补丁盘 应该使用该 项来描述其功能 module stamp 模块标签否安装盘和补丁 盘 该项是描述模块名称的 例如 uap arap 安装程序通过该名称来 加载升级类 如果没有配置 安装 盘取其父目录名称 补丁盘取其父 父目录名称 version 版本号是安装盘和补丁 盘 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 6 14 页 disk type 盘类型是安装盘和补丁 盘 安装盘取值为 new 补丁盘 取值为 patch need update d b 是否需要升级 数据库 否安装盘和补丁 盘 默认值为 false 该标志仅仅是 在安装结束时提示用户哪些盘或补 丁需要对数据进行升级 特别对那 些需要升级数据库的补丁 比较有 用 need deploy ejb 是否需要重新 部署 ejb 否安装盘和补丁 盘 表示是否需要重新部署 ejb delete loginjar 是否删除 NC Login v5 0 jar 否客户化的安装 盘和补丁盘 该配置仅对客户化的安装盘有 效 previous gener ation code 表明该模块以 前的编码值 否安装盘该值的配置可以影响安装盘安 装时模块是否是新安装还是升级安 装 must selected 模块是否必须 安装 否安装盘当安装对应产品是 该模块为 必选 preversion 模块自身依赖 的以前的版本 号 否安装盘表示该模块依赖自己的前一个 版本号 required relate d module 依赖的其他的 安装盘 否安装盘和补丁 盘 该项的配置内容必须是其他的 安装盘 表明需要先安装了这些盘 才能在安装本盘 格式为 code name version1 version2 code name version1 vers ion2 注意该项配置不能和其他的盘 的配置成环 required relate d patch 依赖的其他补 丁盘 否安装盘和补丁 盘 该项的配置内容必须是其他的 补丁盘 格式为 code name version1 version2 code name version1 vers ion2 required samet ime install 表示同时安装 的补丁 否补丁盘该项表示必须同时安装的补丁 每个补丁都需要将其他的补丁在此 进行描述 product packa ge 模块的代码包 名称 否安装盘和补丁 盘 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 7 14 页 help package 帮助文件的目 录名 否安装盘和补丁 盘 db create scrip t 数据库建库脚 本包 否安装盘和补丁 盘 bill templet sc ript 单据模板脚本 的目录名 否安装盘和补丁 盘 query templet script 查询模板脚本 的目录名 否安装盘和补丁 盘 report templet script 报表模板脚本 的目录名 否安装盘和补丁 盘 print templet s cript 打印模板脚本 的目录名 否安装盘和补丁 盘 sys templet scr ipt 默认模板脚本 的目录名 否安装盘和补丁 盘 bill type script 单据类型脚本 的目录名 否安装盘和补丁 盘 busi type scrip t 业务类型脚本 的目录名 否安装盘和补丁 盘 system type sc ript 系统类型脚本 的目录名 否安装盘和补丁 盘 subj class scri pt 科目分类脚本 的目录名 否安装盘和补丁 盘 voucher templ et script 凭证模板脚本 的目录名 否安装盘和补丁 盘 project temple t script 项目模板脚本 的目录名 否安装盘和补丁 盘 business script 产品组内脚本 的目录名 否安装盘和补丁 盘 menu script 菜单脚本的目 录名 否安装盘和补丁 盘 ml script 多语言脚本的 目录名 否安装盘和补丁 盘 ddc initdata 数据字典初始 化数据目录名 否安装盘和补丁 盘 hasdynamicte mpletdata 是否有动态模 版数据 否安装盘和补丁 盘 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 8 14 页 containproduc tcode 包含的产品编 码 否安装盘和补丁 盘 dataupdateclas s 数据升级程序 的类名 否安装盘和补丁 盘 在升级安装时执行 需实现接口 nc bs sm accountmanage IUpdateAccount adjust class 新安装时执行 的调整类 否安装盘 nc bs sm accountmanage INewInstallA djust 接口 在安装盘新安装时执行 resourceupdat eclass 安装盘解压代 码时执行的升 级类 安装盘和补丁 盘 nc newinstall update IUpdateResource 接口 在解压安装盘时执行 dbml script 数据多语脚本 目录名 是安装盘和补丁 盘 表 1 1 另 详细也可参考 ConfigKey 接口里的说明 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 9 14 页 第二章 安装升级方案相关说明 本章内容概要 安装流程 创建升级业务中心 代码调整 2 1 安装流程 NC 产品安装分为以下几个步骤 运行客户化安装盘的安装程序 把代码及数 据库脚本安装到指定目录作为系统运行环境 以超级管理员的身份进入系统管理界面 创 建业务中心 5 系帐套的概念 运行数据库安 装脚本及初始化数据 保存客户化版本信息和账套信息 第一步安装代码实质就是代码解压过程 此过程无特殊之处 下文将对创建 和升级业务中心 即数据库安装升级进行详细描述 2 2 创建升级业务中心 在 NC6 系列 用户需要以超级管理员 root 的身份登陆系统 在系统管理 节点可以增加业务中心 安装时会根据所选的语种顺序来更新数据多语 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 10 14 页 图 2 1 新增 升级 业务中心时 会读取 NCScript update 中脚本 构造产品树 如下所示 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 11 14 页 图 2 2 蓝色圆点的是新安装盘 而半圆为补丁盘 安装程序会比较 setup ini 中 version 的属性值和数据库中 sm product version 中记录的版本新旧 如果 setup ini 中版本较新则该模块可以升级 升级时会按照树结构以及 setup ini 中的依赖关系来决定脚本的执行顺序 会先执行在树上靠前的模块脚本 如果该模块对其他模块有依赖 先执行被依赖的模块 在安装盘里 初始化脚本都是 insert 语句 这样在执行升级操作的时候就会产生唯一键冲突的情况 NC 对此种情况有如下几种策略 将 insert 语句转化为 update 语句 对数据进行更新 将 insert 语句装化为 update 语句 只对部分字段更新 忽略该语句 该表的预置数据将不会被执行 抛出违反唯一性约束异常 语句使用何种策略由业务人员根据业务需要制定 如果没有指定 默认按照抛异常的策略执行 策略注册 到 NCHOME ierp install sqlTransConf 目录下 该目录下直接放 xml 文件 不要再放文件夹 格式参考 示 例文件 sqlTransConf xml 文件中 table 标签表示对一个表策略的描述 name 属性为表名称 pk 为主键字段 operate 表示策略 值如下 若无值使用策略 1 若无值且存在 ignorefield 标签 则使用策略 2 ignorefield 中 name 属性表示不会被更新的字 段名 值为 ignore 表示使用策略 3 值为 notranslate 表示使用策略 4 sqlTransConf xml 示例文件如下所示 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 12 14 页 2 3 安装检查及代码调整 在很多时候 需要在安装升级过程中 只是执行脚本并不能完全解决问题 需要进行一些安装检 查和代码调整 在 NC 中对以下几种情况做了相应处理 新盘升级时检查 当系统升级时 需要检查某些单据的状态等需要符合要求 否则可能会造成错误数据 升级程序 提供了这个时机 请实现 nc bs sm accountmanage IUAPUpdateCheck 接口 升级程序会在升级 UAP 前调用该接口 来校验是否可以进行升级 该接口实现类注册到 NCHome ierp acccheck 下 文件示例 3607 cmp nc bs cmp updatedata CmpUpdateCheck 新装时代码调整 请实现 nc bs sm accountmanage INewInstallAdjust 接口 将实现类注册到 setup ini 的 adjust class 属 性值 setup ini 文件说明 该接口提供 void adjust String newVersion 方法 会在本模块安装过程 都结束后调用该方法 安装盘配置与升级技术红皮书 UAP 6 1 UAP 技术红皮书系列 第 13 14 页 升级时代码调整 请实现 nc bs sm accountmanage IUpdateAccount 接口 该接口提供了 3 个方法 可以在不同时机 进行代码调整 doBeforeUpdateDB String oldVersion String newVersion 在数据库表结构升级之前调用 doBeforeUpdateData String oldVersion String newVersion 在数据库表结构升级之后 数据 初始化之前调用 doAfterUpdateData Str