用友BQ V8.2安装指南.docx

企业互联网开放平台iUAP BQ V8.2iUAP丛书-安装指南版权2015用友集团版权所有。未经用友集团的书面许可，本发版说明任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本发版说明的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本发版说明的内容并不代表用友软件所做的承诺。目录版权21概述52简介53产品与安装盘对应清单53.1产品盘文件列表53.2产品模块说明64系统要求74.1服务器端要求74.1.1服务器端操作系统要求74.1.2服务器端数据库要求84.1.3服务器端中间件要求84.1.4服务器端JDK要求94.1.5服务器端应用规模硬件配置推荐94.2客户端配置要求94.2.1客户端硬件配置要求94.2.2客户端软件配置要求94.2.3客户端jre内存使用设置104.2.4客户端的缓存管理114.2.5UAP客户端应用程序包的生成与安装114.3网络相关要求124.4UAP多语言安装124.5数据缓存135数据库设置及优化136BQ8.2安装与卸载136.1BQ8.2全新安装136.1.1全新安装BQ8.2136.2BQ8.1升级至BQ8.2176.2.1适用范围176.2.2准备工作176.2.3标准数据库结构要求186.2.4中间件环境准备186.2.5升级186.3产品卸载186.3.1代码卸载186.3.2数据库卸载196.3.3jre的卸载197申请授权198安装升级过程常见问题和注意事项198.1打开UAP，浏览器自动退出198.2客户端使用JRE1.7，修改用户可用最大内存208.3客户端安装防火墙及杀毒软件时注意208.4使用was集群时注意208.5无法显示验证码208.6非windows平台下的注意事项208.7保护系统超级管理员权限208.8root密码错误3次会被锁定，如何解锁209附录211 概述本安装指南主要包含以下几部分内容： 安装 BQ8.2 时，对系统软件、硬件配置、数据库的支持与调整的要求。 如何升级BQ8.1到BQ8.2 安装 BQ8.2 时，中间件如何安装部署。 有关数据库字符集请阅读本文档第4.4节。 如何卸载BQ8.2。 强烈建议BQ8.2环境与其他业务系统分开部署。2 简介BQ8.2是以现有BAP产品为基础，覆盖原BQ的相关功能（从满足最终用户需求的角度而非完全的产品详细功能）完成一个企业级的全功能的商业分析平台产品。BQ8产品定位是为伙伴和客户提供商务决策分析应用的开发、管理和运行服务。BQ8.2分为分析设计器、Swing端展现和Portal端展现，其中设计器包含：自由报表、透视表、仪表板、智能报告、数据采集、统计图，Swing端展现包括自由报表、透视表、仪表板、智能报告、数据采集、统计图，其中统计图没有独立的展现，需要附加在自由报表、透视表、仪表板中，Portal端展现包括自由报表、透视表、仪表板、统计图。返回页首3 产品与安装盘对应清单3.1 产品盘文件列表根目录二级目录三级目录UAP6.3UAP.zipyonyou UAP6.3安装指南.pdfdocUAP6.3补丁管理系统使用说明.pdfUAP6.3部署安全性配置指导.pdfUAP6.3多语言安装指南.pdfUAP6.3分布式共享设置.pdfUAP6.3分布式配置指南.pdfUAP6.3数据缓存及配置使用说明.pdfUAP6.3数据库参考脚本及临时表要求.pdfUAP6.3数据库服务器参数配置说明.pdfUAP6.3双引擎配置指南.pdfUAP6.3应用服务器JAVA参数调整明.pdfUAP6.3应用服务器安装部署指导.pdfUAP6.3文件服务器安装配置说明.pdfUAP6.3系统安全建议.pdf时间服务器配置.pdftoolsmod_jk,sohttpd-2.2.22-win32-x86-no-ssl.msiunzip_aix.ZNCPERF.zipncsmtp.zipNC DB Objects Compare Tool.zipyonyou_uap63_patchBQ.zip用友BQ V8.2安装指南.pdf用友BQ V8.2发版说明.pdf 注意： Tools目录中提供了AIX下的unzip工具以及相关工具的使用说明。返回页首3.2 产品模块说明安装盘名称产品名称包含模块模块名称yonyou_UAP客户化UAP客户化UAPBD基础数据UFOFR报表平台UAPWSWeb服务UAPBDSEARCHUAP基本档案全文检索UAPPBUAP公共基础BAPUB商业分析公共UAPEAI外部交换平台UAPADP分布式管理NMCNMCNCAAM应用资产管理PUBAPPpubapp商业分析BAP商业分析平台BAPORTAL商业分析门户应用集成平台UAPPORTAL企业门户开发WEB应用平台WEBRTWEB应用运行引擎WEBBDWEB基础数据管理WEBIMPWEB客户化配置WEBSMWEB系统管理WEBADWEB应用适配器WEBDBLWEB自由表单安装盘名称产品名称包含模块模块名称yonyou_bq数据处理平台aert数据处理平台运行时aefs文件存储aemm元数据管理aesm语义建模aeam分析建模商业分析平台bqufofr自由报表bqanrpt多维分析bqofrpt智能报告bqdboard仪表板bqmcp管理控制台4 系统要求4.1 服务器端要求4.1.1 服务器端操作系统要求操作系统是否支持redhat6.3支持Suslinux支持中标麒麟支持Windows2008支持Solaris支持注意：没有明确指定的安装平台不建议使用。使用虚拟机作为应用服务器时，VMWARE ESXI 平台最低版本为5.0 U1；redhat linux平台的kvm最低版本为2.6.32。各种推荐平台下的安装，请参考附件UAP6.3 应用服务器安装部署指导进行设置：返回页首4.1.2 服务器端数据库要求系统数据库分析数据库（DI目标库）业务数据库（DI源库）Oracle11g、Oracle10gOracle11g、Oracle10gOracle11g、Oracle10gSQL Server 2012SQL Server 2012、SQL Server 2008SQL Server 2012、SQL Server 2008DB2 10DB2 10DB2 10GBaseGBase注意：建议使用ORACLE最新的补丁。ORACLE数据库如果需要RAC技术，请联系UAP技术支持部。具体数据库参数配置，请参考附件调整。返回页首4.1.3 服务器端中间件要求中间件支持类型Was8集群、单机环境Was7集群、单机环境weblogic11集群、单机环境uap集群、单机环境注意：使用Websphere 7中间件时，IHS和plugin补丁版本是3，WAS和WASSDK补丁版本是1。同时也支持WASSDK，HIS，Plugin都为7版本。使用Websphere 8中间件的版本号是8.501。请联系UAP技术支持部获取Websphere对应版本的补丁。返回页首4.1.4 服务器端JDK要求JDK版本是否支持Jdk3支持返回页首4.1.5 服务器端应用规模硬件配置推荐简明硬件建议表，本表所写关键硬件要求以Intel Xeon 3.0G为标准计算：用户数量50100100200200400400-10001000 配置应用服务器数据服务器应用服务器数据服务器应用服务器数据服务器应用服务器数据服务器应用服务器数据服务器CPU数量(物理核)8881682162内存配置(G)816163216x2322磁盘数量(块)1磁盘阵列1磁盘阵列1磁盘阵列 注意： 应用服务建议使用PC Server，数据库服务器建议使用小型机，硬盘使用SCSI接口10000转以上磁盘或磁盘阵列。 表中的CPU数量指的是物理核心数，8核对应为2Cx4core。 ：规模大于400人在线时，请与UAP技术支持部协商评估硬件及网络方案。返回页首4.2 客户端配置要求4.2.1 客户端硬件配置要求配置建议配置CPU 双核(或更高) 内存 2GB(或更高) 硬盘(剩余空间) 10GB(或更高) 打印机 操作系统所能适配的打印机显示适配器 支持1024X768分辨率（或更高）返回页首4.2.2 客户端软件配置要求客户端操作系统客户端浏览器客户端jreWINXP 32位IE8.0 32位Jre1.7 32位（默认） Jre1.6 32位（兼容） Windows7 32位 IE8.0、IE9.0、IE10、FIREFOX、CHROME。都是32位Jre1.7 32位（默认） Jre1.6 32位（兼容）Windows7 64位 IE8.0、IE9.0、IE10、FIREFOX、CHROME。都是32位Jre1.7 32位（默认） Jre1.6 32位（兼容）Windows7 64位 IE8.0 64位、IE9.0 64位Jre1.7 64位（默认） Jre1.6 64位（兼容）Windows8 64位 IE8.0、IE9.0、IE10、FIREFOX、CHROME。都是32位Jre1.7 32位（默认） Jre1.6 32位（兼容）若客户端需要大内存操作时，请使用UAP客户端登陆，详情请参见本文档4.2.5节。注意： 若客户端未安装jre1.6或者jre1.7,则第一次登陆服务器时系统会自动下载jre1.7，本版插件内嵌的JRE的版本是 SUN Jre1.7 update 25。如果有jre1.6或者jre1.7任何一种,直接使用jre1.6或者jre1.7。 IE的相关设置要求：将UAP应用服务器地址加入浏览器“受信任站点”，并将浏览器受信任站点的安全设置为自定义级别，启用下载和运行ActiveX。安装完jre后，用户可以将下载ActiveX安全设置为禁用。 Windows 2008 R2 Server、Windows Vista、Windows 7、Windows8操作系统上运行UAP时，需要确保安装正确的网卡驱动，并在cmd下运行以下命令： netsh interface tcp set global autotuninglevel=disable 不推荐使用Internet Explorer的网络自动检测设置，取消设置方法为运行“Internet Explorer”，选择工具-intenet选项-选择“连接”页签-局域网设置，将“自动检测设置”的勾去掉即可。 IE的具体设置过程可以参考调整如下方法调整。以IE8.0为例。运行IE8.0选择工具internet选项菜单选择安全页签选择可信任站点按钮选择”站点”按钮将UAP应用服务器地址添加进去选择”自定义级别”按钮将ActiveX 控件和插件 设置为 Enable 出于安全的目的，请求方式我们只保留了常用的post和get方式，其余的比如option、put、delete等已被禁用了。如果做二次开发需要用到这些方式，需要实施做专门的处理 返回页首4.2.3 客户端jre内存使用设置对于jre1.7版本的客户端，客户端默认可以使用的最大内存基本满足UAP正常使用，不需要在客户端额外设置jre内存。如果需要手工设置JRE的内存参数，请将“java控制面板”“高级”“java插件”“启用下一代java插件”前面的选项不要勾选。然后按照如下方法设置内存参数：选择Java页签-选择Java小应用程序Runtime设置区域-选择查看按钮在Java Runtime参数中，输入-Xms128m Xmx256m选择确定按钮-选择应用按钮并退出，重新打开IE浏览器登陆即生效了不建议用户将java内存设置过大，对于作大数据查询、展现的用户，建议使用UAP客户端应用程序包。使用方法详见3.5返回页首4.2.4 客户端的缓存管理UAP 6.3 系统运用异步缓存技术缓存部分代码和数据，这些缓存信息以密文形式保存客户端，减少网络流量，提高运行效率。缓存代码和数据需要的空间因用户使用模块、节点和用户数据量定。在系统默认设置情况下，要保证缓存所在的硬盘有2GB的可用空间。在系统登陆或操作过程中会缓存到特定位置。系统默认缓存路径是%USERPROFILE%。例如Windows 7的Administrator用户系统默认是USERPROFILE=C:usersAdministrator。具体察看当前用户的缓存位置。运行如下：在开始- 运行(R)- 输入cmd在DOS窗口中输入set,可以看到有关%USERPROFILE%UAP缓存目录是NCCACHE，一般不需要清除缓存。如果需要用户手动清除，建议只清空代码缓存，即CODE文件夹。清除缓存时要保证浏览器不在运行。JRE的缓存部分，保存在%USERPROFILE%Application DataSun下。手动清除缓存时，需要将这一部分也清除掉。具体打开Java 控制面板常规页签设置按钮查看小应用程序按钮，可以看到有关缓存文件，同时也可以使用删除功能。返回页首4.2.5 UAP客户端应用程序包的生成与安装UAP 6.3 同时提供基于java技术的客户端应用程序包。运行sysConfig.bat，并在“部署”页签中选择“生成客户端”，指定UAP应用服务器的IP地址、UAP服务的端口和用于存放生成的客户端安装文件的路径。生成完成后即可将安装文件复制到客户机上进行安装。用户得到的安装文件，应包括jre.jar，setup.jar和setup.exe三个文件。用户选择本地安装时，安装过程中需要指定需要正确指定服务器地址和端口，安装后会在本地系统菜单上创建对应应用快捷方式。客户端设置功能可以更改调整设置服务器端口和地址，同时可以设置Jre运行时参数。运行客户端后系统自动连接服务器，运行效率更高。如果使用UAP客户端应用程序包访问UAP服务器需要代理服务器时，需要在客户端设置工具的“添加JVM参数”栏输入以下内容：-DxyHost=代理服务器地址 -DxyPort=代理服务器端口 -DxyUser= -DxyPassword=为了减少对代理服务器的解析，需要在客户端的操作系统中加入代理服务器的IP地址，所在文件为：c:windowssystem32driversetchosts加入以下字符：08 proxy以上举例是假设代理服务器地址为08，不管代理服务器机器名是什么，都输入“proxy”即可。返回页首4.3 网络相关要求用户通过防火墙访问UAP服务器时，需要注意在防火墙上开放相应端口。用户可以使用单机应用或集群模式灵活配置环境，需要保证相关端口不被其他应用占用，在设置防火墙端口策略时需要注意开放上述端口。在数据库服务器和应用服务器上不要安装或启用DHCP、DNS、PROXY、WINS和防火墙等服务。以Windows系统作应用服务器的用户请将防火墙功能停止，保证数据库服务器和应用服务器，应用服务器和应用服务器间高速网络通信，强烈推荐应用服务器、数据库服务器、web服务器间使用千兆网络进行连接，不建议安装或设置跨网关或跨防火墙通信。应用服务器的网卡正确设置很重要。通常情况下，无论用户使用的是UAP中间件还是IBM WebSphere中间件，都要保证网卡驱动、物理连线、地址、网关、路由等被正确配置，IBM WebSphere中间件profile文件安装后不要修改服务器机器名，否则可能会导致中间件无法正常启动。如果环境中有网卡被启用而未连接物理网线，可能会影响UAP系统网络操作性能，在此建议禁用不使用的网卡。返回页首4.4 UAP多语言安装 Yonyou UAP 6.3 支持多种语言应用，内容多语最多支持五种语言。默认只有简体中文，用户若要使用其他的语言请购买对应的语言包并安装。多语安装详细过程参见UAP6.3 多语言安装指南。客户端应用服务器数据库服务器操作系统语言支持简体中文、繁体中文、英文系统，其中英文系统需要安装亚洲字符集，否则不能处理英文之外的语言Windows系统时必须安装亚洲字符集，保证能够处理简体中文；非Windows系统时，启动中间件时需要指定系统变量中LANG为zh_CN.gb18030（实际字符集因操作系统不同而有差异）对操作系统语言无要求其他要求要求与应用服务器同时区；只有简体中文、繁体中文和英语应用时， MS SQLServer排序规则要选择“Chinese_PRC_CI_AS”方式；Oracle实例要选择ZHS16GBK；DB2要选择GBK字符集；非中文、英文、繁体文字应用时Oracle要选择unicode（ALT32UTF8）；DB2数据库要选择UTF8字符集；本版暂不支持简体中文、英文、繁体中文之外的其他语言在MS SQLServer数据库上的应用。系统语言设置在系统管理建立系统时指定已安装的语种顺序，预制数据会按照对应的顺序存储。返回页首4.5 数据缓存Yonyou UAP6.3数据缓存的介绍及相关配置详见UAP6.3 数据缓存及配置使用说明。5 数据库设置及优化YONYOU UAP6.3数据库的设置及优化详见 yonyou UAP6.3 安装指南.pdf 第7节6 BQ8.2安装与卸载6.1 BQ8.2全新安装本安装说明仅适用于yonyou用友软件UAP管理软件BQ8.2版本。6.1.1 全新安装BQ8.2 基本步骤：安装UAP63金盘并升级系统，安装UAP63金盘补丁，安装BQ8.2，升级系统。详细的中间件配置可参考文档UAP6.3产品部署及配置指南以win+UAP单机中间件为例:a) 安装UAP63(包含商业分析模块)，安装步骤可参考文档 UAP6.3产品部署及配置指南b) 在UAP63金盘基础上启动sysConfig配置中间件并升级系统，停止系统。1：配置服务器信息2：配置系统数据源 注意：数据源共分为以下几类：1）系统数据源，用于新建系统和升级系统；2）BAP资源库（安装AE后，改为AE资源库），用来存放AE和BQ的一些定义，如语义建模、元数据仓库元数据、分析建模、多维分析、仪表板等等，资源库需要安装UAP+AE+BQ，通常与系统数据源一致；3）Portal数据源，主要用于门户访问，一般来说，也与系统数据源一致；4）查询数据源，又叫执行数据源，用于存放AE和BQ的分析数据，该数据源可以为空库，只是存几个表，不需要安装UAP+AE+BQ，如果是was/weblogic环境，这个数据源需要配置成双数据源；5）业务数据源，存放原始业务数据，通常，数据集成会把该数据源的数据，处理并转移到查询数据源。3：部署EJB4：配置日志策略（选配）：5：启动中间件6：升级系统7：停止中间件c) 安装UAP63金盘补丁d) 安装BQ8.2e) 在UAP63金盘补丁， BQ8.2基础上启动sysConfig配置中间件并升级系统，重启系统1：配置文件服务器2：部署EJB3：升级系统4：重启系统6.2 BQ8.1升级至BQ 适用范围本升级说明仅适用于BQ8.1到BQ8.2版本。支持BQ8.2代码覆盖BQ8.1代码的升级，此类情形下必须停掉中间件再覆盖原来旧代码。BQ8.1升级必须先停掉相应中间件，安装UAP63金盘补丁，再安装BQ8.2，最后部署并升级系统，否则会导致不可逆转的损失。6.2.2 准备工作停止相应UAP中间件，备份应用服务器代码，同时备份相应系统对应的数据库。6.2.3 标准数据库结构要求Yonyou UAP 6.3 的数据库结构要求，具体参考UAP6.3 数据库参考脚本及临时表要求.pdf6.2.4 中间件环境准备Yonyou UAP 6.3 分别支持Yonyou middleware”和IBM Websphere 以及”Oracle Weblogic”，具体用户根据项目需要确定使用何种中间件。6.2.5 升级BQ8.2 产品升级可以安装到新的路径下，也支持覆盖到原产品UAP63(BAP)/BQ8.0.1/BQ8.0.2代码路径下升级安装。系统备份文件过程没有备份数据源和账套信息，需要用户同新安装产品一样，可以将需要升级的产品全部安装到目标目录中。到$UAP_HOME/bin下，运行sysConfig.bat，注册数据源；配置服务器地址、端口；生成ejb，部署ejb。需要注意一点，此处注册的数据源是UAP63 使用的数据源，并且确保数据库版本是UAP63 支持的版本，用户在此前做过数据备份。整个升级过程时间长短因服务器性能、需要升级模块数量、具体业务数据量长短不同。建议在升级前做好计划安排。整个升级工作结束后，用户需要重新启动中间件。 注意： 对于数据量大的用户，在升级前建议作数据库优化分析，升级结束后再作一次数据库优化分析。 UAP的产品可独立安装。有部分产品的安装需依赖于一些相关的产品；在安装这部分产品时，需先安装其所依赖的产品和版本。 日志文件所在目录uaphomenclogs；日志信息量因日志级别而异。 在覆盖代码升级过程之前，务必停掉原来的was，weblogic，uap中间件以及相关的java进程，否则新代码不能完全覆盖替换原来的旧代码。6.3 产品卸载BQ8.2产品卸载相对简单，卸载包括代码卸载、数据库卸载和jre卸载三部分。6.3.1 代码卸载 对于使用UAP 6.3中间件用户，停止中间件的所有服务，删除安装目录下的所有文件即可。对于使用IBM Websphere 7.0中间件用户，在企业应用中卸载UAP6.3应用，删除jdbc数据源，和环境变量中对应的设置。停止服务，删除安装目录下的所有文件即可。6.3.2 数据库卸载对于SQL Server用户，在SQL Server的Enterprise Manager中删除UAP63应用的数据库即可。对于Oracle用户，删除安装时所指定的用户的所有表和视图即可。对于DB2用户，删除安装时所指定的用户的所有表和视图即可。6.3.3 jre的卸载 客户机：在控制面版的添加/删除程序中选择JRE_1或者JRE_5并删除。返回页首7 申请授权在$UAP_HOME/bin下运行sysConfig.bat文件，在license项中选择生成硬件锁，按照提示要求输入产品号：，系统会在当前目录($UAP_HOME/bin)下自动生成hardkey.req文件。用户将此文件提交给用友公司，用友公司会根据用户购买的产品和许可数生成对应的license.resp文件。拿到license.resp文件后在sysConfig工具的license选项中选择导入，然后重新启动中间件，授权文件生效即可正常使用。 注意： UAP 6.3 继续采用软加密方式； UAP6.3 采用强制授权策略，任何uaphome都必须打license才可用，申请演示license请联系UAP区域业务部； 授权文件license与服务器的硬件信息相关，应用服务器硬件变动、机器名变动或uaphome移动均需要重新申请license； 如果在同一台服务器上重新安装产品，保持以前安装路径、机器名不变，即可利用以前的license文件的备份； 使用集群中间件时，只需要在master所在的服务器上申请授权； 版本升级后需要重新申请license，否在会造成产品无法正常使用。返回页首 8 安装升级过程常见问题和注意事项8.1 打开UAP，浏览器自动退出经测试发现，在部分机器上安装的浏览器插件与jre插件有冲突，导致浏览器加载applet时自动退出。遇到这种问题请检查浏览器加载项，逐个排除，或不勾选“java控制面板”中高级选项java插件启用下一代java插件。8.2 客户端使用JRE1.7，修改用户可用最大内存打开uaphome/webapps/nc_web/WEB-INF/jsp下的ncapplet.jsp，查找“-Xmx25