文档目录：

相关文档：

注意：

如果是大版本升级，并且项目中有使用到定制开发及集成功能，升级前需要先明确以下问题，问题确认后，可按正常步骤升级。

如果上述列表问题较多，建议由具体的实施人员配合客户做升级。

Smartbi 系统升级过程的完整步骤如下。

1、系统备份

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

1.1 备份知识库

首先对知识库进行备份，访问"管理 -> 工具"页面，点击备份知识库，将知识库保存到指定位置。

为求万全，最好在数据库中利用其备份工具再做一次备份。具体可以参考：知识库备份与恢复。

Smartbi V6 帮助中心 > Smartbi版本更新 > 1.png

如果是更新 Smartbi Spreadsheet 电子表格版本，下文中所有涉及到 smartbi、smartbi.war 名称的地方需要全部替换为 spreadsheet、spreadsheet.war。千万注意！

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

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

Smartbi V6 帮助中心 > Smartbi版本更新 > 2.png

部署新的 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 V6 帮助中心 > Smartbi版本更新 > 4.png

4、访问新系统

升级完成后，需要先清除浏览器缓存，再重新访问 Smartbi。

Smartbi V6 帮助中心 > Smartbi版本更新 > 5.png

注意：在IE删除浏览历史记录对话框上，第一项"保留收藏夹网站数据"不要勾上；下面的"Internet 临时文件"、"Cookie"两项，最好全部勾选。然后点击"删除"按钮。

请按如下操作进行：

前提：有旧版本的备份知识库和war包

1、新建一个空库的数据库作为知识库；

2、删除smartbi-config.xml文件（一般是在服务器的bin目录下）；

3、启动服务器，这时候会进入config界面，重新配置知识库（对应知识库配置是第一步创建的空库）；

4、重启服务器，恢复知识库（也可以拿每天自动备份的知识库，一般路径是在服务器的\bin\repoBackup\）。

注：更新为新版本后直接换回旧war包的方式是不允许的。