1、手动安装流程
本文档将向您讲述为 Smartbi 手工创建知识库，以及手动部署到各种应用服务器的详细操作步骤。使用服务器应用包 smartbi.war 手工安装配置 Smartbi 的完整流程如下：
- 申请License。
- 手工创建知识库。
- 手工部署Smartbi应用。
- 启动服务器。
- 进行系统配置。
- 登录使用。
| 面板 | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
文档目录：
相关文档： |
2、申请License文件
请参考 系统配置和应用 中申请License部分内容。
3、手工创建知识库
Smartbi 目前支持MySQL、HSQL、SQL Server、Oracle、DB2、Sybase 和 Kingbase 作为知识库。新建知识库步骤如下：
- 登录数据库服务器；
- 新建一个空库，如：SmartbiRepository，并将空库授权给相应的用户；
- 记录服务器地址、端口号、用户名、密码等，在部署完 Smartbi 后进行系统配置。
| 锚 | ||||
|---|---|---|---|---|
|
| 锚 | ||||
|---|---|---|---|---|
|
| 锚 | ||||
|---|---|---|---|---|
|
| 锚 | ||||
|---|---|---|---|---|
|
| 锚 | ||||
|---|---|---|---|---|
|
| 锚 | ||||
|---|---|---|---|---|
|
| 锚 | ||||
|---|---|---|---|---|
|
为了保证 Smartbi 能够正确的连接知识库和各种关系数据源，必须将各个项目上实际用到的数据库驱动程序文件，手工添加到 smartbi.war 包中。默认安装和手动部署，两种方式下操作过程是不同的。
1、smartbi.exe 安装包默认安装
1）清除<Smartbi>\Tomcat\webapps\smartbi\WEB-INF\lib 目录中已经存在的该数据库其它版本的驱动程序（如果存在）。
2）将当前项目上使用的数据库驱动程序文件（.jar），添加到<Smartbi>\Tomcat\webapps\smartbi\WEB-INF\lib 目录下。
2、smartbi.war 手工部署方式
1）使用 WinRAR 或其他压缩工具，双击打开 smartbi.war 文件。
2）清除 smartbi.war 包中 smartbi.war\WEB-INF\lib 目录下已经存在的该数据库其它版本的驱动程序（如果存在）。
3）将当前项目上使用的数据库驱动程序文件（.jar），拖放到 WinRAR 窗口中 smartbi.war\WEB-INF\lib 目录中。
4）直接关闭 WinRAR 窗口，保存 smartbi.war 文件。
为了便于检查数据源连接方面的问题，下面列出各种关系数据库对应的驱动程序 .jar 文件名。如果缺少相应的 JDBC 驱动，可以从 这里 下载。
数据库名称 | Jar包名称 | 备注 |
|---|---|---|
SQL Server | sqljdbc.jar | SQL Server 2005 |
msbase.jar | SQL Server 2000 | |
mssqlserver.jar | ||
msutil.jar | ||
MySQL | mysql.jar |
|
Oracle | classes12.zip | Oracle9i |
classes12.jar | Oracle10g | |
| ojdbc6.jar | ||
| ojdbc7.jar | ||
| ojdbc7_g.jar | ||
DB2 | db2java.zip |
|
db2jcc.jar |
| |
db2jcc_license_cu.jar |
| |
Sybase | jconn2d.jar |
|
Kingbase | kingbasejdbc4.jar |
|
Informix | ifxjdbc.jar |
|
NCR Teradata | teradata.jar | Ncr 2.5 |
terajdbc4.jar | Ncr 2.5/2.6 | |
tdgssjava.jar | Ncr 2.6 | |
PostgreSQL | postgresql.jar |
|
Greenplum | postgresql.jar |
|
本节主要讲述将应用包 smartbi.war 手工安装配置到各类型应用服务器上。
安装完成 Tomcat 应用服务器后，将 Smartbi 应用部署到 Tomcat 上，请执行下列操作：
- 检测环境变量中是否存在 JAVA_HOME 变量，如果不存在，则请增加环境变量或手工修改 <Tomcat>\bin\startup.bat 文件指定 Java 虚拟机路径。
- 在catalina.bat/catalina.sh 中增加 Java 虚拟机配置，建议安装64位JDK，最大 Java 内存设置 8G 以上。注：由于拷贝粘贴时空格可能变成中文空格等，导致报错，请勿直接复制粘贴以下内容，请手工输入。
- Windows环境
代码块 language text set JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=GBK -Duser.region=CN -Duser.language=zh -Djava.awt.headless=true -Xms1024m -Xmx9000m- Linux环境
代码块 language text JAVA_OPTS=$JAVA_OPTS -Dfile.encoding=GBK -Duser.region=CN -Duser.language=zh -Djava.awt.headless=true -Xms1024m -Xmx9000m - 将smartbi.war包复制到<Tomcat>\webapps目录下。
- 运行<Tomcat>\bin\startup.bat启动Tomcat服务器。
- 登录Smartbi配置页面，设置知识库信息，上传License文件，请参考系统配置与应用。
- 如需要在系统中加载Smartbi帮助文件，请将Smartbi帮助文档扩展包SmartbiHelp.ext复制到服务器任意目录，并在Smartbi配置页面中指定扩展包存放目录。
- 重启应用。
- 安装完成 JBoss 后检测环境变量中是否存在 JAVA_HOME 变量，如果不存在，则请增加环境变量或手工修改 <Jboss>\bin\run.bat 文件指定 Java 虚拟机路径。
- run.bat/run.sh 中增加 Java 虚拟机配置，建议安装64位JDK，最大 Java 内存设置 8G 以上。
- Windows环境
代码块 language text set JAVA_OPTS=%JAVA_OPTS% -Dorg.apache.catalina.STRICT_SERVLET_COMPLIANCE=false -Dfile.encoding=GBK -Duser.region=CN -Duser.language=zh -Djava.awt.headless=true -Xms1024m -Xmx9000m- Linux环境
代码块 language text JAVA_OPTS=$JAVA_OPTS -Dorg.apache.catalina.STRICT_SERVLET_COMPLIANCE=false -Dfile.encoding=GBK -Duser.region=CN -Duser.language=zh -Djava.awt.headless=true -Xms1024m -Xmx9000m - 将smartbi.war包复制到< Jboss >\ server\default\deploy目录下。
- 运行<Jboss>\bin\run.bat启动Tomcat服务器。
- 登录Smartbi配置页面，设置知识库信息，上传License文件，请参考系统配置与应用。
- 如需要在系统中加载Smartbi帮助文件，请将Smartbi帮助文档扩展包SmartbiHelp.ext复制到服务器任意目录，并在Smartbi配置页面中指定扩展包存放目录。
- 重启应用。
| 注意 |
|---|
注意：设置 WebSphere 安装路径时，路径中最好不要存在“空格”。 如果需要在 WebSphere中创建新的服务器节点，请参考 Linux环境下WebSphere概要文件管理 。 |
安装完成 WebSphere 7 应用服务器后，将 Smartbi 应用部署到 WebSphere 上。请执行下列操作：
在部署到 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 -Xms1024m -Xmx9000m |
- Linux环境
| 代码块 | ||
|---|---|---|
| ||
JAVA_OPTIONS="$JAVA_OPTIONS -Dfile.encoding=GBK -Duser.region=CN -Duser.language=zh -Djava.awt.headless=true -Xms1024m -Xmx9000m" |
部署 smartbi 到WebLogic 10.0 应用服务器。
- 利用WebLogic的"Configuration Wizard"新建一个域服务器，可以命名为smartbi_domain。
- 启动smartbi_domain域服务器，在IE浏览器中输入http://<WebLogicServer>:7001/console，进入WebLogic Server Console。
- 输入有管理员权限的用户名和密码后，单击 登录 按钮。
- 在控制台左侧选择Smartbi对应域服务器smartbi_domain下的 Deployments。如下图所示：
- 在控制台右侧的 Deployments 一栏中点击 Install 按钮；
- 选择发布的 smartbi.war 文件，点击 Next 按钮；
- 后续的步骤按照默认选择进行发布直至完成；
- 单击 Finish 按钮，再在控制台左侧的导航栏"Change Center"中点击"Activate Changes"保存并激活上面的设置。
- 最后点击 start 按钮，启动应用。
- 登录Smartbi配置页面，设置知识库信息，上传License文件，请参考系统配置与应用。
- 如果需要在系统中加载 Smartbi 帮助文件，请将 Smartbi 帮助文档扩展包 SmartbiHelp.ext 复制到服务器任意目录，并在 Smartbi 配置页面中指定扩展包存放目录即可。
- 重启应用。
| 信息 |
|---|
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包，然后再重新部署。 |
| 信息 |
|---|
Smartbi 部署后启动过程中如果出现Caused by: org.hibernate.DuplicateMappingException: Duplicate query mapping ResourceTreeNode.getAllRoots这样的错误，请尝试删除smartbi.war/ WEB-INF/lib目录中的xercesImpl.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 部署后启动过程中如果出现Caused by: java.lang.ClassCastException: weblogic.xml.jaxp. RegistrySAXTransformerFactory cannot be cast to javax.xml.transform.TransformerFactory、或者Caused by: java.lang.ClassCastException: weblogic.xml.jaxp.RegistryDocumentBuilderFactory cannot be cast to javax.xml.parsers.DocumentBuilderFactory这样的错误，请尝试删除smartbi.war/ WEB-INF/lib目录中的xml-api(小版本号)s.jar, xmlbeans-2.3.0.jar包，然后再重新部署。 |
| 信息 |
|---|
Smartbi 部署后启动过程中如果出现User defined lis 1、停止weblogic服务器； 2、删除<smarti_domain>\smartbi-config.xml，（<smarti_domain>指的是smartbi部署的域）； 3、启动weblogic，重新登录http://localhost:7001/smartbi/config进行配置。 |
| 信息 | ||
|---|---|---|
| ||
如出现上面的类冲突的情况，请按下面步骤操作： 1、在控制台中卸载已经部署好的smartbi应用； 2、停止weblogic服务； 3、在smartbiwar包中删除冲突的jar； 4、删除<smartbi_domain>\servers\Adminserver\tmp中的所有文件； 5、启动weblogic服务； 6、重新发布smartbi。 |
4.6 部署Smartbi到金蝶Apusic-AS-6.0
4.7 部署Smartbi到中创InforSuite-AS-8.3.0
- Windows环境
| 代码块 | ||
|---|---|---|
| ||
set JAVA_OPTS=%JAVA_OPTS% -Dorg.apache.catalina.STRICT_SERVLET_COMPLIANCE=false -Dfile.encoding=GBK -Duser.region=CN -Duser.language=zh -Djava.awt.headless=true -Xms1024m -Xmx9000m |
- Linux环境
| 代码块 | ||
|---|---|---|
| ||
JAVA_OPTS=$JAVA_OPTS -Dorg.apache.catalina.STRICT_SERVLET_COMPLIANCE=false -Dfile.encoding=GBK -Duser.region=CN -Duser.language=zh -Djava.awt.headless=true -Xms1024m -Xmx9000m |
