注意：V85版本，由于跨库查询功能需要用到jdk1.8,所以如果需要使用该功能的话，必须将JDK版本更新为1.8；中间件支持1.8的最低版本情况：Tomcat 7 ， WebLogic 12.1.3，Websphere 8.5.5.9
1 设置java虚拟机参数
在部署到 Weblogic 应用服务器之前，需要先设置 Weblogic 环境变量。在<smartbi_domain>\bin\setDomainEnv.cmd/setDomainEnv.sh 中增加 Java 虚拟机配置，建议安装64位WebLogic，最大Java内存设置8G以上。
- Windows环境
| 代码块 |
|---|
set JAVA_OPTIONS="%JAVA_OPTIONS% -Dfile.encoding=GBK -Duser.region=CN -Duser.language=zh -Djava.awt.headless=true -Xms8192m -Xmx8192m |
-XX:MetaspaceSize=512m -XX:MaxMetaspaceSize=512m -XX:+HeapDumpOnOutOfMemoryError" |
- Linux环境
| 代码块 |
|---|
JAVA_OPTIONS="$JAVA_OPTIONS -Dfile.encoding=GBK -Duser.region=CN -Duser.language=zh -Djava.awt.headless=true -Xms8192m -Xmx8192m -XX:MetaspaceSize=512m -XX:MaxMetaspaceSize=512m -XX:+HeapDumpOnOutOfMemoryError" |
Linux具体配置操作如下：
修改setDomainEnv.sh 的内存大小：
| 注意 |
|---|
Weblogic 12.2.1.3.0版本由于安全问题，默认禁用了rmi协议，可以通过在启动脚本中增加 -Dweblogic.oif.serialFilterScope=weblogic 参数来配置smartbi集群。 Weblogic 12.2.1.4.0版本由于安全问题，默认禁用了rmi协议，可以通过在启动脚本中增加 -Dweblogic.oif.serialFilter=java.rmi.server.* 参数来配置smartbi集群。 |
设置其他jvm参数：
JAVA_OPTIONS="$JAVA_OPTIONS -Dfile.encoding=GBK -Duser.region=CN -Duser.language=zh -Djava.awt.headless=true"
export JAVA_OPTIONS
...
在weblogic上部署的时候把smartbi.war/ WEB-INF/lib目录中的 xml-apis-1.3.04.jar、xmlbeans-2.3.0.jar 、geronimo-stax-api_1.0_spec-1.0.1.jar、wstx-asl-3.2.4.jar、cglib-nodep-2.1_3.jar包删掉。
Tips:删除jar包的方法可以参考：如何向war或ext包中添加或删除文
3 操作步骤
1） 启动控制台：
cd /domains/base_domain/servers/proxy_Server_1
...
3） 点击左侧的部署按钮，进入部署界面，点击安装按钮。
4） 选择smartbi.war包，下一步。
...
7） 点击完成按钮，等待部署完成。
8） 回到部署页面，启动smartbi应用。
...
10） 配置完知识库信息，重新启动smartbi，进入登陆页面：http://localhost:7001/smartbi/vision/index.jsp
4 部署的过程中出现的问题及解决办法
Tips:删除jar包的方法可以参考 如何向war或ext包中添加或删除文件
| 信息 |
|---|
| Smartbi 在部署到Weblogic应用服务器上时，如果出现部署不上，或者部署之后启动应用时出现WstxIOException或XMLInputFactory之类的错误提示，请删除smartbi.war/ WEB-INF/lib目录中的geronimo-stax-api_1.0_spec-1.0.1.jar和wstx-asl-3.2.4.jar两个jar包，然后再重新部署。 |
| 信息 |
|---|
如果部署后可以正常使用，但是在“恢复知识库”过程中报错，日志中出现 Caused by: java.lang.ClassCastException: com.ctc.wstx.stax.WstxEventFactory cannot be cast to javax.xml.stream.XMLEventFactory 这样的错误，也请删除smartbi.war/ WEB-INF/lib目录中的geronimo-stax-api_1.0_spec-1.0.1.jar和wstx-asl-3.2.4.jar两个 jar包，然后再重新部署。 |
| 信息 |
|---|
| Smartbi 部署后启动过程中如果出现Caused By: java.lang.ClassCastException: net.sf.cglib.proxy.Enhancer$EnhancerKey$$KeyFactoryByCGLIB$$71c0a23 cannot be cast to net.sf.cglib.core.KeyFactory这样的错误，请尝试删除smartbi.war/ WEB-INF/lib目录中的cglib-nodep-2.1_3.jar包，然后再重新部署。 |
...
| 信息 |
|---|
| Smartbi 部署后启动过程中如果出现User defined lis tener smartbi.extension.spring.SmartbiContextLoaderListener failed: XML错误. XML这样的错误，请按下面的步骤操： 1、停止weblogic服务器； 2、删除<smarti_domain>\smartbi-config.xml，（<smarti_domain>指的是smartbi部署的域）； 3、启动weblogic，重新登录http://localhost:7001/smartbi/config进行配置。 4、类冲突后，重新部署步骤 |
| 信息 |
|---|
Smartbi 部署后excel导入如果出现org.apache.commons.fileupload.disk.DiskFileItem cannot be cast to org.apache.commons.fileupload.FileItem这样的错误，请尝试删除smartbi.war/ WEB-INF/lib目录中的common-fileupload.1.3.3.jar包，然后再重新部署。 |
| 信息 |
|---|
| 如出现上面的类冲突的情况，请按下面步骤操作： 1、在控制台中卸载已经部署好的smartbi应用； 2、停止weblogic服务； 3、在smartbiwar包中删除冲突的jar； 4、删除<smartbi_domain>\servers\Adminserver\tmp中的所有文件； 5、启动weblogic服务； 6、重新发布smartbi。 |
...
5、weblogic 部署smartbi后，在使用过程出现jar包冲突常见问题可查看文档：https://history.wiki.smartbi.com.cn/pages/viewpage.action?pageId=47483318
备注：
1、部署过程中，如果出现以下截图错误信息：
...
解决方案：由于第一步骤设置java虚拟机参数时，直接将wiki中的编码复制到Linux环境中，导致编码不对，无法识别。通过手工输入后，重新启动服务器正常启动。
