1、手动安装流程
本文档将向您讲述为 Smartbi 手工创建知识库,以及手动部署到各种应用服务器的详细操作步骤。使用服务器应用包 smartbi.war 手工安装配置 Smartbi 的完整流程如下:
- 申请License。
- 手工创建知识库。
- 手工部署Smartbi应用。
- 启动服务器。
- 进行系统配置。
- 登录使用。
面板 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
文档目录:
相关文档: |
2、申请License文件
请参考 系统配置和应用 中申请License部分内容。
3、手工创建知识库
Smartbi 目前支持MySQL、HSQL、SQL Server、Oracle、DB2、Sybase 和 Kingbase 作为知识库。新建知识库步骤如下:
- 登录数据库服务器;
- 新建一个空库,如:SmartbiRepository,并将空库授权给相应的用户;
- 记录服务器地址、端口号、用户名、密码等,在部署完 Smartbi 后进行系统配置。
- 目前产品的知识库只支持UTF-8和GBK字符集,并且在配置项中要与数据库的字符集一致。
锚 | ||||
---|---|---|---|---|
|
锚 | ||||
---|---|---|---|---|
|
锚 | ||||
---|---|---|---|---|
|
锚 | ||||
---|---|---|---|---|
|
锚 | ||||
---|---|---|---|---|
|
锚 | ||||
---|---|---|---|---|
|
锚 | ||||
---|---|---|---|---|
|
为了保证 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 |