Smartbi 经常会定期发布新的版本，增加新的功能模块，或者对现有功能进行增强，提升运行效率。如果已经安装部署过 Smartbi 旧版本，现在又需要使用新版本的某些功能，就需要对系统进行升级，将其更新到最新版本。Smartbi 的架构设计比较合理，基本可以做到系统的无缝平滑升级，可以从任一历史版本，顺利地升级到当前最新版，并且不会影响已经开发的任何报表资源。Smartbi 支持"自升级"，即所有的升级过程，皆由程序自身去完成，不需要外部的人为干预。只要将旧程序替换为新版本，再次运行时，系统自动完成所有的升级工作。
系统升级
注意：
如果是大版本升级，并且项目中有使用到定制开发及集成功能，升级前需要先明确以下问题，问题确认后，可按正常步骤升级。
- 1、整理用户的定制开发内容，该部分需要从新做兼容升级。
- 2、看用户是否有较多的手动写的宏代码，该部分需要根据具体情况做兼容升级。
- 3、用户环境是否有做集成，如果有集成，需要先明确用户的集成方式再具体判断（V6同V3的前端框架有修改）。
- 4、看用户都做了哪些报表，这些具体的报表功能会涉及到 升级注意事项 里面的内容。
Smartbi 系统升级过程的完整步骤如下。
1、系统备份
系统升级的过程通常都是极为顺利的，但为了确保万无一失，还是需要对系统进行备份，以备升级出错时，可以迅速回退到旧版本。
1.1 备份知识库
首先对知识库进行备份，访问"定制管理 -> 管理员工具集"页面，点击管理知识库--》备份知识库，将知识库保存到指定位置。
为求万全，最好在数据库中利用其备份工具再做一次备份。具体可以参考：知识库备份与恢复。
1.2 备份smartbi.war
到服务器上，对旧版本的smartbi.war 包进行备份，保存到指定位置。举例，如果是部署到Tomcat 应用服务器，直接到 <Smartbi-install-dir>\Tomcat\webapps\ 目录下将smartbi.war 文件拷贝下来即可。
1.3 备份扩展包
访问系统配置界面，地址：http://localhost:8080/smartbi/vision/config。查看"扩展包存放路径"，然后去到服务器上，对该路径下的所有文件进行备份，保存到指定位置。
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，更新smartbi.war，方式参考以下：
1、使用winscp工具登录Linux系统，找到<高性能版本部署路径>/smartbi_data/smartbi-tomcat/webapps
进入对应的目录，找到smartbi和smartbi.war并删除（注意删除前请先备份war包）
2、使用winscp将新的war包上传文件到Linux的<高性能版本部署路径>/smartbi_data/smartbi-tomcat/webapps目录下
3、在浏览器打开控制台页面 http://服务器ip:8088
如下图所示，点击smartbi-tomcat服务,进入容器编排页面。
左键点击容器名右边的图标，选择删除，然后系统会删掉当前的容器，并且立即启动一个新的容器。
5、等待新容器启动成功，就可以正常访问smartbi。
访问smartbi地址：http://服务器ip:31080/smartbi/vision/index.jsp
3、重启应用服务器
重启应用服务器，此时系统会自动进行升级工作。此过程可能会比较耗时，根据所升级版本的跨度大小，以及系统中开发的报表资源多少，升级过程可能会从几分钟到几十分钟不等。
4、访问新系统
升级完成后，需要先清除浏览器缓存，再重新访问 Smartbi。
注意：在IE删除浏览历史记录对话框上，第一项"保留收藏夹网站数据"不要勾上；下面的"Internet 临时文件"、"Cookie"两项，最好全部勾选。然后点击"删除"按钮。
版本回退
在产品升级过程中，有可能会升级失败，虽然这种机率微乎其微，但是为了保证出现这种情况时不影响环境的正常使用，我们可以采取版本回退的应急机制。
产品版本回退的前提条件：备份了旧版本的知识库。因此，对知识库的定期备份是良好的产品使用习惯。
系统不允许执行了产品升级后，直接替换回旧war包，只能通过重新部署旧版本的war包，在空库上恢复旧版本的知识库来实现版本回退。
实现版本回退的详细步骤如下：
1、在数据库中新建一个空库，将此库作为回退到旧版本的知识库。
2、在Smartbi服务器中删除文件“smartbi-config.xml”，该文件通常在服务器的bin目录下，如：Smartbi_Insight\Tomcat\bin。
3、启动Smartbi服务，进入config界面，重新配置知识库，这里配置步骤1创建的空库。
4、保存知识库配置后，重启Smartbi服务，登录到Smartbi，通过 恢复知识库 功能将已经备份的旧版本知识库进行恢复。恢复成功后，可以正常访问旧版本。
