NC6.5 产品部署及配置指南

YONYOU NC 6.5 产品部署及配置指南产品部署及配置指南 2015 年 12 月 版权所有 (c) 2015 用友网络科技股份有限公司 2 目录目录 YONYOU NC 6.5 产品部署及配置指南产品部署及配置指南 . 1 目录目录 . 2 1 NC V6.5 适配适配UAP中间件安装部署中间件安装部署 . 5 1.1 NC应用服务器JDK安装 . 5 1.2 NC V6.5 安装盘目录结构 . 5 1.3 NC V6.5 全新安装 . 6 1.4 创建ORACLE用户 . 9 1.5 NC V6.5 配置SYSCONFIG . 9 1.6 NC V6.5 客户端JRE安装 . 13 1.7 建立系统并升级 . 14 2 NC V6.5 升级安装升级安装 .15 2.1 NC V6.3 直接升级到NC V6.5 . 15 2.2 NC V6.3.1 直接升级到NC V6.5 . 15 2.3 NC V6.3.3 直接升级到NC V6.5 . 15 2.4 升级注意事项 . 15 3 NC V6.5 适配适配UAP水平集群中间件安装部署水平集群中间件安装部署 .17 3.1 APACHE安装 . 17 3.2 UAP集群下代码部署 . 21 3.2.1 NC代码安装 . 21 3.2.2 UAP集群添加配置server . 21 4 WEBSPHERE安装安装 .25 WEBSPHERE 应用程序安装 . 25 4.1 安装前准备 . 25 4.2 应用程序安装 . 25 4.3 配置WAS8 创建PROFILE时默认使用的SDK为JAVA1.7 . 41 4.4 创建与删除PROFILE文件 . 43 4.4.1 创建profile文件 . 43 4.4.2 删除profile文件 . 45 5 NC V6.5 适配适配WEBSPHERE单机中间件安装部署单机中间件安装部署 .46 5.1 IBM WEBSPHERE中间件启动 . 46 5.2 NC代码安装 . 46 5.3 新建ORACLE用户，配置NC，生成部署EJB . 46 5.4 NC客户端JRE安装 . 47 5.5 建立账套升级 . 48 6 NC V6.5 适配适配WEBSPHERE集群中间件安装部署集群中间件安装部署 .49 6.1 WEBSPHERE集群拓扑结构规划 . 49 6.2 WEBSPHERE集群拓扑结构配置 . 50 3 6.2.1 配置前环境准备 . 50 6.2.2 主从机节点联合 . 50 6.2.3 进控制台配置集群结构 . 52 6.3 WEBSPHERE集群下NC V6.5 代码部署 . 56 6.3.1 NC代码安装 . 56 6.3.2 NC配置工具配置并生成EJB . 57 6.3.3 同步代码 . 61 6.3.4 部署EJB . 62 6.3.5 启动WebSphere各server . 62 6.4 HTTPSERVER PLUGIN配置 . 64 6.5 建系统，同步BUSICENTERCONFIG.XML . 64 7 NC V6.5 适配适配WEBLOGIC单机中间件安装部署单机中间件安装部署 .66 7.1 产品安装 . 66 7.2 基于WEBLOGIC中间件部署 . 67 8 NC V6.5 适配适配WEBLOGIC集群中间件安装部署集群中间件安装部署 .71 9 NC V6.5 集成配置工具使用集成配置工具使用 .75 9.1 服务器信息 . 75 9.2 数据源 . 76 9.3 文件服务器信息 . 76 9.4 安全日志数据源 . 76 9.5 部署 . 76 9.6 服务分配 . 77 9.7 服务转发 . 77 9.8 资源适配器 . 77 9.9 日志文件 . 77 9.10 IMMP配置 . 77 9.11 调度引擎 . 78 9.12 分布式缓存 . 78 9.13 集群消息 . 78 9.14 数据缓存 . 78 9.15 代码版本 . 79 9.16 并发控制 . 79 9.17 搜索引擎 . 79 9.18 LICENSE . 79 9.19 系统配置 . 79 9.20 WS SECURITY . 80 9.21 单点登录外部信任地址 . 80 4 概述概述 本文档适用于 NCV6.5 产品环境部署配置，本文档主要包含以下几部分内容： WebSphere 安装 NC V6.5 适配 UAP 中间件安装部署说明 NC V6.5 适配 UAP 集群中间件安装部署说明 NC V6.5 适配 WebSphere 单机中间件安装部署说明 NC V6.5 适配 WebSphere 集群中间件安装部署说明 NC V6.5 适配 Weblogic 单机中间件安装部署说明 NC V6.5 适配 Weblogic 集群中间件安装部署说明 NC V6.5 集成配置工具使用说明 注意事项： NC V6.5 中任何配置及使用过程中，IP 地址禁止使用 和 localhost 等本地回环地址，否则会出 现不可预知的异常错误。 NCV6.5 不能单独登录 master 节点做任何操作，否则会出现不可预知的异常错误。 WebSphere 版本为 ，安装后需要将默认 jdk 切换为 1.7_64，否则会出现不可预知的错误。 WAS 创建集群后需要修改 nodeagent、deploymentmanager 及各 server 的内存参数。 Weblogic Server 版本为 11g(10.3.6)，内存参数可在 sysconfig 中或者 weblogicconsole 中修改。 WAS 的 profile 文件最好不要多次使用。 Weblogic 的 domain 最好不要多次使用。 NC 代码解压路径不要有空格，汉字，非法字符。 中间件数据源改变时，需要更新文件服务器的元数据仓库。 在 Linux/Unix 上设置 JAVA_HOME 时一定不要使用 NC_HOME/ufjdk，因为 ufjdk 是 win 下 32 位。需要 自行下载符合版本的 64 位的 JDK。 中间件配置端口后，火狐和 chrome 浏览器访问提示“此地址访问受限，此地址使用了一个通常应该用 于其他网页浏览的端口。由于安全原因，Firefox 取消了该请求”，那此端口可能对于该浏览器是特殊端 口，需要重新更换。已知 6000 端口不能作为访问端口。 5 1 NC V6.5 适配适配UAP中间件安装部署中间件安装部署 （本文档以 windows2008R2+UAP 中间件+Oracle 11g+NC V6.5 安装部署过程为例） 1.1 NC应用服务器应用服务器JDK安装安装 在 Windows2008R2 上安装 NCV6.5 产品时， 系统将会自动安装 JDK， 版本是 32 位 SUN jdk1.7update51， JDK 目录在 nc_homeufjdk。强烈建议用户下载安装 64 位 SUN jdk1.7update51，并设置为 JAVA_HOME 环境 变量。 1.2 NC V6.5 安装盘目录结构安装盘目录结构 NC V6.5 的目录结构 安装盘下面可以放一个到多个产品， 表现形式上为一个目录。 目录的名称必须为产品的模块标识名称， 如企业绩效管理为 sem。 6 1.3 NC V6.5 全新全新安装安装 NCV6.5 安装前应准备好操作系统，需要保证目标路径下至少有 10GB 剩余空间，用于保存应用程序和 相关日志。 安装请执行NC安装盘根目录下setup.bat文件 （要求安装盘同级目下有ufjdk文件或者设置JAVA_HOME 环境变量） ，安装时，出现如下图界面： 7 选择安装的语言,点击”确定” 选择同意，点击下一步 8 此处会提示用户指定产品安装目录，如果指定的安装路径不存在，会提示创建相关路径。安装路径力 求简单易于维护，不要使用汉字，空格和操作系统限制的特殊符号，如果产品安装路径不正确或磁盘空间 不足，会导致安装失败。 选择要安装的模块后点击开始安装即可，如下图： 安装完成后点击“完成”按钮，弹出如下界面： 点击“下一步”，将进入 sysConfig 系统配置界面。 9 至此 NC 已安装完成。若需要安装新的产品，同理即可。 1.4 创建创建oracle用户用户 进入 sqlplus 使用命令创建 oracle 用户，以 sys 用户进入 sqlplus，使用以下命令创建两个用户并授权 NCV6.5 作为数据源 SQL create user NCV6.5 identified by 1 default tablespace nnc_data01 temporary tablespace temp; SQL grant dba,connect to NCV6.5; 1.5 NC V6.5 配置配置sysConfig 安装完成后进入 nc_homebin 目录下运行 sysConfig.bat 进入系统配置界面， 服务器类型选择 UAP SERVER。点击服务器信息读取，如下图： 10 此处用于配置应用服务器名称，端口，地址和 JVM 等参数使用，要求所有端口在服务器上必须唯一， JVM 设置符合服务器配置，否则中间件无法启动。配置完成后点击保存。 进入“数据源页签”“读取”“添加”,将 NC V6.5 作为账套数据源， 安全日志数据源是记录关于系统安全 及操作等的记录。 数据库类型选择 ORACLE11G，添加数据源名称，不能包含中文，配置数据库地址，用户名密码，数据 源 OID 标示（当前环境唯一） ，失效链接检查周期，prepareStatement 缓存数等信息，完成后点击测试，如 果提示测试通过则表示 NC 能够与数据库连通，保存即可。 11 进入安全日志数据源页签读取初始化数据源 初始化完成后点击“确定”。 然后进入“部署”“全选”“部署 EJB”， 如下图所示： 此处用于生成、部署 EJB，UAP 中间件下不需要二阶段部署。 点击进入“文件服务器”“读取” 12 此处添加服务器 ip 地址，端口，存储路径，及选择元数据仓库,保存即可。 系统配置初始化完成后即可启动中间件，在 nc_home 下执行 startup.bat， 13 看到 Server startup in 113805 ms 即表示启动成功。 1.6 NC V6.5 客户端客户端jre安装安装 用友 NC 推出了新一代互联网化企业应用客户端 UClient，登录 nc 时会提示用户选择 UClient 客户端下 载或继续浏览器登录。 UClient 客户端安装请参考NC6.5 UClient 使用配置指南 浏览器登陆时会自动检测用户当前客户端是否安装了 JRE 插件，如果当前客户端没有 JRE 或 JRE 低于 推荐版本，系统会自动下载并安装推荐版本的 JRE，安装 JRE 要求具有系统 administrator 权限，否则无法 正常安装。 IE 设置相关要求：将 NC 应用服务器地址加入受信任站点，将浏览器受信任级别设为“自定义级别”， 启用 ActiveX 控件和插件（JRE 安装后可关闭） 。下面以 IE8 为例： 运行“IE8.0”选择“工具internet 选项”菜单选择“安全”页签选择“可信任站点”按钮选择“站点”按 钮将 NC 应用服务器地址添加进去选择“自定义级别”按钮将 ActiveX 控件和插件设置为“Enable”。 用户也可以选择手动安装 NC 客户端插件，在 nc_homewebappsnc_webClient 下有 jre-7u51-windows-i586.exe 和 jre-7u51-windows-x64.exe 独立安装程序。 14 1.7 建立系统并升级建立系统并升级 建账套过程就是根据安装的产品，执行预置的脚本。登陆 http:/IP:port/admin.jsp 登陆 NC 系统，用户 名 root 密码为空。点击系统管理增加，输入帐套编码，帐套名称，选择生效/失效日期，选择数据源， 选择语种，添加系统管理员。点击保存按钮开始升级。升级完成后需要重启中间件。 运行 nc_home 下的 stop.bat/startup.bat 至此，windows2008+UAP 中间件+Oracle 11g+NC V6.5 系统搭建完成。 15 2 NC V6.5 升级安装升级安装 此版本支持从此版本支持从 NCV6.3/NC V6.3.1/NCV6.3.3 直接直接升级升级安装安装到到 NC V6.5 2.1 NC V6.3 直接直接升级到升级到NC V6.5 具体步骤如下： 1) NC 代码安装方法请参考 1.3 章节 2) 通过 sysCofig 配置工具配置数据源，服务器信息、安全数据源、文件服务器等 3) 部署并启动，升级系统 2.2 NC V6.3.1 直接直接升级到升级到NC V6.5 具体步骤如下： 1) NC 代码安装方法请参考 1.3 章节 2) 通过 sysCofig 配置工具配置数据源，服务器信息、安全数据源、文件服务器等 3) 部署并启动，升级系统 2.3 NC V6.3.3 直接直接升级到升级到NC V6.5 具体步骤如下： 1) NC 代码安装方法请参考 1.3 章节 2) 通过 sysCofig 配置工具配置数据源，服务器信息、安全数据源、文件服务器等 3) 部署并启动，升级系统 2.4 升级注意事项升级注意事项 1) 升级前请先备份 NC_HOME、数据库。 2) 升级前请先备份文件服务器文件。 3) 安全日志数据源可以使用账套数据源，或新建数据源，并且必须初始化。 4) 整个升级过程时间长短因服务器性能、需要升级模块数量、具体业务数据量长短不同。 建议在升级前做好计划安排。 5) 整个升级工作结束后，用户需要重新启动中间件。 6) 对于数据量大的用户，在升级前建议作数据库优化分析，升级结束后再作一次数据库优 化分析。 7) 日志文件所在目录nchomenclogs， 可根据实际需要在 sysConfig 工具中配置日志级别及 滚动策略，写日志会占用磁盘 IO，不建议开启所有日志 16 8) 若用到文件服务器/文档中心，则在覆盖完代码后准备升级系统之前一定要配置好文件服 务器。详情请查看文档NC V6.5 文件服务器配置指南 17 3 NC V6.5 适配适配UAP水平水平集群中间件安装部署集群中间件安装部署 对于用户服务器硬件资源充足的情况，NC 系统可以搭建集群启用多个 Server 来做负载均衡和充分利 用服务器资源。 搭建 UAP 集群首先要根据用户的实际情况规划所需集群的拓扑结构，再根据规划来配置 UAP 集群。 本文档演示以 78 和 32 为应用服务器， master、 ncMem01 两个 server 在 78， ncMem02 在 32 上。 78 是主机，32 是从机 Apache 安装在 78，端口默认 80。 3.1 Apache安装安装 以系统管理员登陆以系统管理员登陆：在安装程序前，必须以系统管理员登陆系统，拥有操作系统的所有权限，如 administrator，运行“apache_2.2.2-win32-x86-no_ssl.msi”开始安装。 进入安装界面，点击“Next”继续，如下图所示： 18 选择接受条款，点击“Next”继续，如下图所示： 填写相关配置信息（以上信息必须填写，否则可能导致安装后不可用） ，端口使用默认 80，下一步继 续，如下图所示： 19 选择安装类型，点击“Next”继续，如下图所示： 选择安装路径，点击“OK”继续。 注意：产品安装路径不要包含特殊字符、中文、空格等，否则可能会导致 apache 安装失败或无法使 用。 20 然后点击“Finish”按钮，至此 Apache 安装完成。 21 3.2 UAP集群下代码部署集群下代码部署 3.2.1 NC代码安装代码安装 此安装在 78 上。 UAP 集群下 NC 代码安装与普通安装无任何区别，安装方法请参考 1.3 章节。 3.2.2 UAP集群添加配置集群添加配置server 此配置是在 78 上 代码安装完成后进入 nc_home/bin 目录， 运行 sysConfig.bat 启动配置向导开始配置， 选择服务器信息， 读取设置，应用服务器选择“集群服务器”，如下图。 节点配置中选择增加，在服务器名称中添加 master 服务，并勾选“主服务器标识”，管理端口任意，协 议定义中协议类型选择 HTTP，IP 地址为当前主机 IP（78） ，端口任意，设置完成后点击确定，如 下图。 再次选择增加按钮，服务名称为 ncMem01，不勾选“主服务器标识”，管理端口任意，协议定义选择 HTTP 和 AJP，IP 地址为当前主机 IP（78） ，端口任意，设置完成后点击确定，如下图。 22 同理添加更多 server。 （所有端口在当前系统上必须唯一，非 master 服务必须选择 AJP 协议） 此操作是在 78 上。 再次选择增加按钮，服务名称为 ncMem02，不勾选“主服务器标识”，管理端口任意，协议定义选择 HTTP 和 AJP，IP 地址为从机 IP（32） ，端口任意，设置完成后点击确定，如下图。 选择数据源，读取设置，添加数据源，如下图。 23 选择服务转发，读取设置，Apache Home 选择 Apache 安装路径，例如本环境为“C:Apache2.2”，单击 Start Config 生成配置文件，如下图。 检查 apache_homeconf 下 perties 和 ncmodjk.conf 文件配置是否正确，将产品安装盘中 携带的 Apache 插件 mod_jk.so 文件拷贝到 apache_homemodules 目录下， 完成以上操作后进入部署页签， 开始部署。 24 78 上部署完成后打上 license，将 nc_home 拷贝到 32 上，与 78 完全相 同路径的目录下。 在 78 上进入 nc_home 下执行 startup.bat 启动 NC，进入 apache_homebin 下执行 httpd.exe 启动 Apache。 在 32 上，当 78 上的节点都起来后执行 startup.bat 启动 NC 浏览器中输入 78 即可登陆 NC， 在 78 后添加端口以及在 32 后添 加端口即可测试各端口配置是否正确。 25 4 WebSphere安装安装 WebSphere 应用程序安装应用程序安装 4.1 安装前准备安装前准备 非 windows 平台远程安装需要图形化界面支持，可能需要 Xmanager、vnc 等 应用程序安装需要安装用户有系统管理员权限 Win2008/win2012 需要安装 vcredist_x86 或者 vcredist_x64 4.2 应用程序安装应用程序安装 在安装程序前， 必须以系统管理员登陆系统， 拥有操作系统的所有权限， 如administrator， 运行install.exe， 启动安装向导开始安装。 非 windows 平台以 root 登陆，运行 install #./install 26 根据提示安装 IBM Install Manager 接受协议 27 选择安装路径（注意路径一定不能有空格，否则后续会报错） 点击安装 28 安装过程 安装完成后重新启动 Install Manager 29 在重新启动的 Install Manager 首页，依次点击文件首选项 在弹出框中点击存储库添加存储库 30 选择 WAS8501_allplatform 和 WAS8_SDk1.7 的 repository.config 31 添加存储库后如下所示 点击确定回到 IBM Install Manager 首页。接着进行选