页面历史

Smartbi 经常会定期发布新的版本，增加新的功能模块，或者对现有功能进行增强，提升运行效率。如果已经安装部署过 Smartbi，现在又需要使用新版本的某些功能，就需要对系统进行升级，将其更新到最新版本。

Smartbi 的架构设计比较合理，基本可以做到系统的无缝平滑升级，可以从任一历史版本，顺利地升级到当前最新版，并且不会影响已经开发的任何报表资源。

Smartbi 支持"自升级"，即所有的升级过程，皆由程序自身去完成，不需要外部的人为干预。只要将旧程序替换为新版本，再次运行时，系统自动完成所有的升级工作。

1. 升级流程

Smartbi的升级流程如下：

• 更换smartbi.war包：在应用服务器中新的部署包替换旧包。详情参见：更换新的smartbi.war包。
• 数据挖掘引擎更新：若使用了数据挖掘模块，则需要进行数据挖掘引擎的更新升级。详情请参见：数据挖掘引擎更新。
• Smartbi OLAP Server升级：若发包中附带该组件升级的文件，则需进行OLAP更新升级。详情请见：OLAP升级
• 知识库升级：在config界面中进行知识库升级。详情参见：知识库升级。

2.更新方法

2.1 系统备份

系统升级的过程通常都是极为顺利的，但为了确保万无一失，还是需要对系统进行备份，以备升级出错时，可以迅速回退到旧版本。

2.1.1 备份知识库

首先对知识库进行备份，访问“系统运维”界面，选择 备份知识库，将知识库备份到指定位置。

为求万全，最好在数据库中利用其备份工具再做一次备份。

2.1.2 备份smartbi.war

到服务器上，对旧版本的smartbi.war 包进行备份，保存到指定位置。举例，如果是部署到Tomcat 应用服务器，直接到 <Smartbi-install-dir>\Tomcat\webapps\ 目录下将smartbi.war 文件拷贝下来即可。

2.1.3 备份扩展包

访问系统配置界面，地址：http://localhost:8080/smartbi/vision/config。查看"扩展包存放路径"，然后去到服务器上，对该路径下的所有文件进行备份，保存到指定位置。

2.2 更换新的smartbi.war

部署新的 smartbi.war包，针对不同的应用服务器，部署过程会有不同。下面以Tomcat为例，介绍部署过程。

• 停止Tomcat应用服务器。
• 删除<Smartbi-install-dir>\Tomcat\webapps\ 目录下的smartbi文件夹。如果还有smartbi.war文件，也一并删除。
• 清除<Smartbi-install-dir>\Tomcat\temp\ 目录下 ( 注意不是把temp删除，是删除temp里边的内容 ) 的所有文件和文件夹。
• 清除<Smartbi-install-dir>\Tomcat\work\ 目录下 ( 注意不是把work删除，是删除work里边的内容 ) 的所有文件和文件夹。
• 如果有必要的话，修改新的smartbi.war包。比如向其中添加数据库驱动。
• 将新的smartbi.war包拷贝到<Smartbi-install-dir>\Tomcat\webapps\ 目录下。
• 启动smartbi，按以下操作进行知识库升级。

2.3 知识库升级

部署新的war包后，服务器在启动过程中，如果遇到升级知识库，需要用户使用浏览器访问Config界面进行升级。

注意：当系统出现了异常或由于功能出现问题需要对知识库进行回退，操作详情请参见知识库回退。

用户使用浏览器访问Config界面，提示“-请联系管理员登录系统，完成系统升级-”，如图：

升级知识库的具体流程如下：

2.3.1 确认连接信息

登录后，确认知识库连接信息：

• 正确：勾选“已确认连接信息正确”，点击 下一步 。
• 错误：点击 更改参数 ，进入“Config配置界面”进行配置。更改参数并保存后，需重启服务器，并再次访问Config界面。

2.3.2 选择备份文件

在升级前备份知识库、war、扩展包，这一步骤非常重要，备份后一旦升级失败时可以回退。

1）可以选择对 当前时刻 的“知识库、war包、扩展包”进行备份，默认全部勾选，即全部备份：

其中备份的路径：

• 知识库：与“监控管理”的路径【Tomcat\bin\smartbi_repoBackup】一致。
• war：新增路径【Tomcat\bin\smartbi_warBackup】，备份日期以war中的packageInfo.txt中声明为准，如果存在多个war，读取最新的。

• 扩展包：新增路径【Tomcat\bin\smartbi_extBackup】，备份日期以ext中的version声明为准。

2）跳过备份，进入下一步“升级知识库”。

不跳过备份，点击 下一步 ，进行备份，以进度条的方式显示当前备份进度，如图：

2.3.3 备份升级

在成功备份后点击 下一步 ，进入升级界面，点击 开始升级 按钮，进行知识库升级。

浏览器会显示整个升级的日志信息，如果升级过程没有异常则最终时显示按钮【完成】，点击 完成 按钮进入系统访问界面。

如果提示升级失败，则需要跟进具体的日志进行分析。

2.4 数据挖掘引擎更新

如果使用了数据挖掘/SmartbiETL组件，在更新war包时要同步更新数据挖掘/SmartbiETL组件。

具体操作流程如下：

1、联系Smartbi官方支持获取最新版本的数据挖掘引擎安装包，并解压。

2、用putty工具连接到服务器进入安装目录 <smartbiEngine>/engine/sbin/下停止服务，分别运行命令：

sh experiment-daemon.sh stop 

sh service-daemon.sh stop

3、删除<smartbiEngine>/engine 目录

4、将更新包中的engine文件夹拖入到 <smartbiEngine>目录下

5、启动数据挖掘执行引擎和服务引擎。

具体操作方式，可以参考数据挖掘引擎更新数据挖掘引擎更新操作文档

2.5 升级Smartbi OLAP Server

Smartbi OLAP Server服务升级只需替换文件“SmartbiOLAPServer.jar”，然后重新启动即可。

① 停止Smartbi OLAP Server服务；

② 备份“SmartbiOLAPServer.jar”文件，上传新的SmartbiOLAPServer.jar文件到Smartbi OLAP Server目录下；

③ 启动Smartbi OLAP Server服务；

具体启动方法请参考：Window部署、linux部署Window环境部署更新操作文档、linux环境部署更新操作文档

2.6 升级导出引擎SmartbiExport

导出引擎SmartbiExport服务升级，大部分情况下只需替换文件“server.js”，然后重新启动即可。

① 停止SmartbiExport服务；

② 备份“server.js”文件，上传新的server.js文件到<SmartbiExport>\plugins\ScreenshotApp目录下；

③ 启动SmartbiExport服务；

具体更新重启等方法请参考：Window环境部署更新操作文档、linux环境部署更新操作文档