作者：Shiva Vishnubatla 现就职于SAP
BI
升级系列
这个Wiki是用于记录BusinessObjects商务智能平台4.0 SP04或者更高的版本的完整安装包和补丁包的安装过程中，存在的已知问题和解决办法。一开始这篇文章关注在SP04的更新，但是现在这些信息可用于所有SP04或者以上的版本。
最佳实践
以下是所有SP和Patch安装包的最佳实践：
- 当从BI平台SP02升级到SP04版本时，使用Update Installer。
- 阅读Support and Feature Pack Release Notes.
- 关闭除以下最基本服务器之外的所有服务器：
- Central Management Server (CMS)
- File Repository Servers (FRS)
- Tomcat and the CMS 数据库
- 使用Process Explorer或者Windows任务管理器关掉所有不必要的进程，并且确认它们被终止了。在Business Objects目录下的java.exe进程应该被终止。（进程的路径可以通过Windows任务管理器里面进程窗口中的命令行那一列看到）
注意：如果和BI平台相关的Java进程没有被终止，它们可能会锁住文件，造成它们更新或者删除。这些文件的更改可能会造成丢失库的问题。这种问题是Java虚拟机（JVM）的问题，计划会在BI平台SP05版本进行修复。
管理员需要终止在图片里面选择的进程，如果它在停止了不必要的服务之后仍在内存中运行。
上面最佳实践的信息同样请见SAP KBA 1757132 - BI4 Support Pack Upgrade and Patch Install Best Practice Guide
对于集群环境或者分散式环境的额外的最佳实践
以下是集群环境或者分散式环境的最佳实践：
- 首先，在移动到其它层之前把CMS服务器进行更新。
- 在一个服务器上运行一次Update Installer。如果你在多个服务器上同时运行Update Installer，你可能会造成一个紊乱情况，最终会导致元数据的丢失。
注意：失败的同时安装的症状包括：
- 你会在.../setup/packagestemp文件夹下面看到几个文件。
- 你会在安装日志里面（setupengine.log）发现CMS尝试登陆但是一直都失败。
上面最佳实践的信息同样请见SAP KBA 1757132– BI4 Support Pack Upgrade and Patch Install Best Practice Guide.
问题1：因为找不到.jar文件，服务不能启动
这个问题的发现始于Windows下一个失败的补丁升级，从BI 4.0 SP02 Patch12到BI 4.0 SP04。这是一个典型的问题，由于Report Application Server (RAS)在更新进行时正在运行中，造成了它没有在需要的时候关闭掉它其中的一个java子进程。RAS运行中的结果就是在补丁被执行时产生了一些被锁的文件，进而造成了在打补丁完成之前丢失了文件。这个问题可以参照上面的最佳实践部分进行避免。
症状：
- 下面的进程在打补丁之后失败了：
Adaptive Processing Server (APS)
Crystal Cache
Xcelsius Cache
- 尽管重建了进程和Server Intelligence Agent (SIA)，而且修复/安装了SP04，动作还是和以前一样。
- 只卸载SP04产生了一个SP04 patch12的服务器。
- 丢失文件/库。
解决办法：
- 确保所有不必要的服务都停止了。
- 在BI平台 4.0安装的基础上运行修复，点击控制面版>程序>程序和功能> SAP Business objects BI Platform 4.0>卸载/更改>修复
- （可选的）为了检测丢失的文件或者库：
a. 检查.../InstallData/logs/<install_timestamp>文件夹
b. 确保只有三个文件在文件夹里面（InstallManifest.sqlite, setupexe.log and setupengine.log.）
c. 如果你见到了其他日志文件例如InstallDU-*.log (e.g., InstallDU-cvom.java-4.0-core-nu, 14.0.4.738, etc)，那么一些文件或者库已经没有合适地安装。
问题2: 32位路径取代64位路径
这个问题发生于进行了一个SP04的补丁升级或者安装之后。有一种情况这个问题也会出现在SP04 Patch17上，但是大部分情况都发生在SP04。
症状：
- AdaptiveProcessingServer不启动。
- 症状会在CMC服务器页面被发现。
- AdaptiveJobServer没有产生任何子进程。
- 在CMC服务器页面，AJS已经启动，但是没有按照预想的产生任何子进程。
- 没有计划示例运行因为服务器不可以启动新的进程。
- 安装日志可以展示出升级这些服务器的问题。
解决办法：
在BI4.0升级之前，停掉所有除了CMS, 和Input and Output FRS之外所有的服务。这样就阻止了一个服务一直不停止而影响安装。
注意：如果不必要的服务没有在安装SP04之前手动地停止，某些java的服务会升级失败。
上面的信息可见SAP KBA 1742498 – Scheduling workflow(s) affected after installing SP4 for BusinessObjects Enterprise 4.0.
问题3：CMS在安装之后不能重新启动
这个问题发生在SP04安装和之前的补丁版本。CMS启动不了最可能的原因是由于问题1里面提到的RAS造成了文件被锁。这问题经常会在SP04发生，但是也有其他可能的因素造成。
症状：
安装失败并报错。
一些进程不能启动或者保持未启用状态。
例如BI启动版和CMC这样的应用可能会意外失败，尽管它们已经重新部署过了。
安装日志(setupengine.log)显示安装程序不能连接到CMS因为它不能及时重启。日志条目如下或者类似的可以被找到：
Server <servername> not found or server may be down or
com.crystaldecisions.sdk.occa.security.in ternal.LogonService||Is the CMS alive? Ensure the CMS supports SDK version 1400
[InstallEntDfoWrapper.Connect] Exception:
[com.crystaldecisions.sdk.exception.SDKException$OCAFramework:
[InstallEntDfoWrapper.Connect] Connection Failed. Please retry...
10:46:30.572 [InstallEntDfoWrapper.main] Connection Failed. Could not connect to CMS [SERVERNAME:6400]
注意：CMS不能重新启动的原因可能和环境相关的（资源、病毒等等）、网络相关的区分开来，因为这并不是一个常见的问题。
解决办法：
在升级或者修复之前，遵循上面的最佳实践部分。
- 保证所有的不必要的服务都像最佳实践里面提到的那样被停掉了。
- 在安装BI 4.0的基础上运行修复。控制面板>程序>程序和功能> SAP Business Objects BI Platform 4.0>卸载/改变>修复。
- （可选的）卸载，再安装一个新的完整版SP04 。
- 安装之后，重新运行脚本来导入丢失的模块。
以上的信息可见SAP KBA 1603067 - java.lang.NullPointerException or usagesProperty error after login to CMC or BI Launchpad.
问题4：SP04补丁安装没有安装正确的文件
存在不正确版本的DFO文件导致了他们在安装过程中上传失败。如果文件夹里面有比上面列出的更多的文件，那么这有可能和问题1、问题3是一样的，CMS已经不能够启动了。
症状：
当使用Installer升级一个已经存在的BI4系统，Installer可能不会安装所有文件。
当安装日志显示安装成功，文件保留在.../setup/packagestemp 文件夹下，比如 "C:\Program Files(x86)\SAP BusinessObjects\setup\packagestemp" 基于默认的Windows平台的安装。
一些文件在文件夹.../setup/packagestemp folder可能会像如下文件：
BusinessObjects_ClientAction_Publication_DocumentLink_dfo.xml
BusinessObjects_ClientAction_Publication_ViewLatestInstance_df o.xml
BusinessObjects_DSL_Universe_pin.xml
BusinessObjects_InformationDesigner_dfo.xml
BusinessObjects_InformationDesigner_pin. xml
BusinessObjects_MLStrings_MetricDescriptions_DSLBridgeSessionService_dfo_frag.xml
BusinessObjects_PlatformSearchUniverseCont entExtractor_dfo.xml
BusinessObjects_Relation_WEBI_UNIVERSE_dfo.xml
解决办法：
这个问题已经在ADAPT01628046进行了跟踪，而且在SP04 Patch1修复了，补丁包可以到SMP下载。
这个或者其他修复或者改进可以到版本注释文档里面进行验证：http://service.sap.com/~sapidb/011000358700000813222012E.
BI4.0 SP04的补丁版本注释可以在这里面查看：1729424.
问题5：安装之后CMC和BI启动版上发生HTTP 500报错
HTTP 500的报错可以发生在网络层的部署之中。这并不经常发生。另外一个补丁或者附加组件就可能把Tomcat关掉，而同时Tomcat正在编辑已经被部署到它的网络应用，造成了编辑后的文件夹处于不一致的状态。
症状：
在更新或者修补到SP04之后你会发现当访问BI启动版或者CMC时会有如下的报错：
Error: 500
Error: “Java.lang.NullPointer Exception”
解决办法：
这是一个应用服务器的问题，不是一个安装问题。
解决办法和上面的信息可见SAP KBA 1671068 - CMC in SAP BusinessObjects BI 4.0 returns a 500 error.
问题6：重命名SIA节点造成了SP2升级到FP3或者SP4失败
安装包使用的节点名字是来自于原始安装，造成了不能上传新的名字节点。
症状：
在更新到SP4时（FP3不会发生），安装包会在最后页面提出警告给你，提示安装遇到错误。
如果你为了添加RESTful网络服务，在原始安装之后执行了改进的安装，你就会发现RESTful网络服务不会在服务中出现。
Dashboard Analytics Server 和 Dashboard Server会在CMC服务器管理页面中显示“启动失败”。这些服务本身已经被移除了。
解决办法：
如果你已经重命名了原始节点，你可以运行修复安装，然后命名新的节点以得到一个修复的系统。
1.为了解决这个问题，你需要从命令行运行修复安装，使用存在于你安装文件夹的setup.exe。
- 对于BI platform (on UNIX platforms, substitute setup.sh for setup.exe):
<INSTALLDIR>\setup.exe -i product.businessobjects64-4.0-core-32 SIAName=<NEW SIA NAME> - 对于Information Platform Services:
<INSTALLDIR>\setup.exe -i product.minibip-4.0-core-32 SIAName=<NEW SIA NAME> - 对于Crystal Server:
<INSTALLDIR>\setup.exe -i product. crystalserver2011-4.0-core-32 SIAName=<NEW SIA NAME>
注意：如果在你的机器上有额外的节点，你需要直接在每个没被原始安装覆盖的额外的节点上运行addnode脚本。
2.根据下面的说明，MasterCmsName 和 MasterCmsPort是你CMS的名字和端口，CMSPassword 是你管理员的密码， SIAName是你额外节点的名字。
a.关闭点正在更新的节点。运行MasterCms的节点必须在运行，除非MasterCms所在的节点正在进行更新。
b.运行下面的命令行（在UNIX平台下，用addnote.sh替代addnode.bat）：
"<INSTALLDIR>\SAP BusinessObjects Enterprise XI 4.0\win64_x64\scripts\addnode.bat" -update -cms "[MasterCmsName]:[MasterCmsPort]" -username Administrator -password "[CMSPassword]" -authentication secEnterprise -name [SIAName] -cmsport [MasterCmsPort] -usetempcms
以上的信息请见SAP Note 1731612 - SIA node renaming may affect SP2 updates to FP3 or SP4.
问题7：在BI 4.0上安装Patch 3破坏了SAP的功能
当安装运行在一个和SAP授权系统相对立的系统上，SAP登陆，查看SAP用户，角色，使用SAP别名的用户和SAP插件可能会停止其功能。
症状：
你会发现报错："Account information not recognized: All servers with CMS "CMSname:port", cluster @"clustername:port", kind cms which host service null, are down or disabled".
解决办法：
转换到一个应用服务器。
反转到patch 2或者之前的版本。
更多的细节请参考SAP KBA 1765690. 在里面这个问题有着很详细的描述，而且有个和补丁5相对应的修复.dll 文件在附件中，或者查看 SP04 Patch Release notes.
问题8：从SP4更新到SP6的#SYNTAX
症状：
在BO 4.0 SP4升级到4.0 SP6之后，某些报表里面出现#SYNTAX。
解决办法：
在SP4和SP6中间，对于计算引擎的更新会造成对之前缓存文件的不兼容。由于这种情况，SP6的文件不能够合理的处理SP4 文档生成的缓存文件。为了解决这个问题，请像如下Note里面一样清理文档缓存。
1926596 - How to clear Web Intelligence. document cache on BI 4.0.
相关内容
相关文档：
帮助页面：http://help.sap.com/bobip40/
SP04补丁注释文档：http://service.sap.com/~sapidb/011000358700000813222012E
相关注释：
SAP Note 1729424 Business Intelligence platform 4.0 SP04 Patch Release Notes
SAP KBA 1603067 java.lang.NullPointerException or usagesProperty error after login to CMC or BI Launchpad
SAP KBA 1742498 Scheduling workflow(s) affected after installing SP4 for BusinessObjects Enterprise 4.0
SAP KBA 1743755 After installation of BI 4.0 Sp04, the crystal report cache server runs with errors and is disabled
SAP KBA 1671068 CMC in SAP BusinessObjects BI 4.0 returns a 500 error
SAP Note 1731612 SIA node renaming may affect SP2 updates to FP3 or SP4
SAP Note 1757132 BI4 Support Pack Upgrade and Patch Install Best Practice Guide
SAP Note 1765690 Installing patch 3 on BI 4.0 SP4 breaks SAP logon, viewing SAP users, roles, and accounts with SAP aliases as well as SAP plug-in
SAP Note 1926596 How to clear Web Intelligence. document cache on BI 4.0.
- SAP Managed Tags:
