|
技术迭代日新月异，作为你日常工作的得力助手，Smartbi 也在持续进化 —— 功能不断升级、体验持续优化，只为更贴合你的业务需求！但使用时，你是否也有过这些困惑：什么时候该更新？担心盲目更新反而影响工作；为啥一定要更新？不确定新功能是否真的有用；更新会带来什么影响？想知道具体优化了哪些内容、修复了哪些问题；又该怎么更新？希望既能快速完成，又能避免操作失误……
别担心！现在，这份专为你准备的Smartbi 更新/升级攻略秘籍已就位，上述所有疑问，都能在这里找到清晰答案。赶紧收好，让 Smartbi 的每一次更新升级，都能成为你提升效率的 “加速器”！
一、为什么要更新/升级？
就像手机 App 会不断推出新版本一样，Smartbi 也会定期发布更新，目的就是为了让系统更好用、功能更强大、运行更顺畅。如果你已经安装过 Smartbi，但想体验新功能或解决现有问题，就可以考虑升级到最新版。更新/升级一般分为两种情况：
（1）小版本更新（比如从V11版本 2025年1月版 更新到 2025年8月版）：
- 当你看到新版本中 【更新动态】有你感兴趣的功能或优化；
- 或者当前使用的版本出现了一些小问题，需要修复。
（2）大版本升级（比如从 V9 升级到 V10、V11）：
- 新旧版本之间功能变化比较大，例如 V10 之后新增了“数据模型”等实用功能，如果你希望使用这些新模块，就可以考虑升级。
温馨提示：大版本升级就像给房子做一次“大装修”，需要提前做好规划。请您先联系我们的商务团队，我们会像“设计师”一样，上门了解您的“户型”（项目现状），然后为您量身设计一套安全可靠的“装修方案”（升级规划）。
二、多久更新一次？更新有影响吗？
（1）更新频率：没有固定时间，一切由您做主
Smartbi的更新不强制、不统一。您可以根据自己项目的节奏和需求，灵活安排升级时间，就像手机APP更新一样，主动权在您手里。
给您的建议：建议您时常关注Smartbi官方发布的 【更新动态】 或 【跨版本升级变更】。当您看到新版本提供了您急需的功能、显著提升了性能或修复了某个困扰您的问题时，就是考虑升级的好时机。
简单来说：看菜吃饭，量体裁衣。按需升级，丰俭由人。
（2）更新影响：正常情况下，您的数据和报表都很安全
您可以放心，升级过程通常平稳无感，主要基于以下两点：
- 您的业务数据很安全：Smartbi本身就像一个“数据展示工具”，并不存储实际的业务数据。即使涉及数据抽取，您的原始数据文件也原封不动，不会受到任何改动。
- 您的报表配置很稳固：您辛苦制作的所有报表、设置都安全地存储在“知识库”里。版本升级不会去触碰和修改这些核心资产。
（3）小版本更新完成后该做什么？
非常简单！只需像平时一样，打开几个常用的报表检查一下，确认一切显示正常，就可以继续投入使用了。
注：大版本更新要对进行全面的测试验证，需要按照制定专属的升级规划方案执行。
三、更新涉及什么内容？
主要是更新Smartbi主程序服务，而考虑到数挖引擎、OLAP引擎、仪表盘导出引擎需与war包版本匹配才可正常使用，如有使用相应功能，请同时更新对应组件的版本，和war包版本保持一致：
服务类型
|
涉及更新文件
|
功能说明
|
是否需要更新
|
Smartbi主服务
|
smartbi.war
|
登录smartbi系统使用的主服务
|
需要
|
Smartbi OLAP Server
|
SmartbiOLAPServer.jar
|
数据模型功能处理依赖的多维引擎服务
|
需要
|
导出引擎SmartbiExport
|
server.js
|
仪表盘报表导出功能
|
需要
|
数据挖掘引擎/SmartbiETL组件
|
engine（整个文件夹）
|
数据挖掘或者数据准备——ETL功能
|
若有部署使用，则需要同步更新
|
注：高速缓存库若是使用MPPMD或MPP服务的，一般无需同步更新，特殊问题涉及更新的再具体问题具体分析，更换对应的Smartbimpp 安装介质即可，有需要可再看SmartbiMPP服务升级；
四、怎么更新/升级？
4.1 小版本更新指南
小版本更新是指同个大版本，例如都是V11版本，随着时间版本迭代，2025年以来产品优化新增了不少功能，我们希望使用到新功能，就可以从旧日期2024年版本升级到最新2025的版本，此时属于小版本更新。更新需要结合项目涉及使用的组件服务更新，流程和详情操作如下:
4.1.1 更新Smartbi主服务
更新Smartbi主程序服务时，需要在应用服务器中使用新版本部署包替换旧版本，并通过浏览访问完成知识库的升级操作。由于不同应用服务器的部署方式和操作入口存在差异，请在实际操作前确认以下事项：
操作前提：
- 若项目已有既定的运维文档或升级手册，请严格以项目运维文档为准；
- 如无专门文档，可参考以下通用更新步骤执行。
（1）Tomcat应用更新服务指南：
（2）Weblogic应用更新服务指南：
（3）Websphere应用更新服务指南
（4）东方通应用更新服务指南
（5）宝兰德应用更新服务指南
（6）中创应用更新服务指南
（7） 金蝶Apusic中间件更新服务指南
4.1.2 更新数据挖掘引擎/SmartbiETL组件
如果使用到数据挖掘/SmartbiETL组件，在更新war包时要同步更新数据挖掘/SmartbiETL组件，具体方法可以参考：数据挖掘引擎服务更新
操作步骤如下：
4.1.3 更新数据模型/Smartbi OLAP Server
V10以上版本使用到数据模型功能，一般都涉及这个Smartbi OLAP Server组件服务使用，升级只需替换文件“SmartbiOLAPServer.jar”，然后重新启动即可，具体方法请参考：OLAP服务更新
操作步骤如下：
4.1.4 更新导出引擎SmartbiExport
使用到仪表盘导出功能都会使用到导出引擎SmartbiExport服务，一般情况下升级只需替换文件“server.js”【若是从2022年9月9号之前的版本更新的，需要更新一次node_modules文件】，然后重新启动即可，具体方法请参考：导出引擎服务更新
操作步骤如下：
4.1.5 知识库升级
更新版本或更新扩展包可能触发升级类，所以部署新的war包后，我们使用浏览器访问系统，若从index.jsp自动跳转到config.jsp界面要求我们升级的话，例如下图提示“-请联系管理员登录系统，完成系统升级-”，我们继续参考下述步骤进行升级即可。
4.1.5.1 确认连接信息
登录后，确认知识库连接信息，没问题的话继续勾选“已确认连接信息正确”，点击 下一步即可。
注意：之前没有改过的话一般不需要更改的，若确实检查不对，也可以点击更改参数 ，进入“Config配置界面”进行配置。更改参数并保存后，需重启服务器，并再次访问Config.jsp界面。
4.1.5.2 选择备份文件
在升级前备份知识库、war、扩展包，这一步骤非常重要，备份后一旦升级失败时可以回退。
1）可以选择对 当前时刻 的“知识库、war包、扩展包”进行备份，默认全部勾选，即全部备份，继续点击下一步开始备份，以进度条的方式显示当前备份进度，如图：
其中备份的路径：
- 知识库：部署启动文件路径bin下，若没有修改一般tomcat路径为：/Tomcat/bin/smartbi_repoBackup；
- war：部署启动文件路径bin下，若没有修改一般tomcat路径为：/Tomcat/bin/smartbi_warBackup，备份日期以war中的packageInfo.txt中声明为准，如果存在多个war，读取最新的。
- 扩展包：部署启动文件路径bin下，若没有修改一般tomcat路径为：/Tomcat/bin/smartbi_extBackup，备份日期以ext中的version声明为准。
4.1.5.3 开始升级
在成功备份后点击 下一步 ，进入升级界面，点击 开始升级 按钮，进行知识库升级。
开始升级后，浏览器会显示整个升级的日志信息，如果升级过程没有异常则最终时显示按钮【完成】，点击 完成 按钮进入系统访问界面。
- 如果提示升级失败，则需要根据具体的日志进行分析，可获取完整日志找Smartbi技术支持继续分析。
（1）获取应用服务日志，获取方式可参考：⬝ 在各种服务器下的日志获取.
（2） 获取smartbi服务日志，获取方式可参考：各类组件日志获取方式参考
4.1.6 Smartbi更新后验证
访问http://实际IP：端口 /smartbi/vision/index.jsp，使用管理员账号登录，进入smartbi主界面后，右侧三个点->关于看更新/升级后的版本日期，然后进入分析展现菜单去打开具体报表检查无报错即可：
 
4.2 大版本升级流程
（1）为何需要特殊流程？ 因为大版本更新涉及重大功能变更，为确保您现有系统的平稳过渡，我们需要进行专业评估。
（2）具体怎么做？
第一步：联系商务 - 请您首先联系我们的商务同事。
第二步：共同评估 - 我们将与您一起分析您项目的具体情况。
第三步：制定方案 - 最后，为您量身定制一份稳妥的升级规划。
五、知识库回退
若更新过程中出现异常，短时间内无法处理，可以通过回退知识库操作，将Smartbi还原为原来的版本，此时可以通过访问Config.jsp界面进行回退。
例如，有需要的话，我们可以换回去之前备份好的smartbi.war文件，然后使用浏览器访问Config界面，点击 恢复知识库 按钮，进入“知识库恢复”界面进行恢复。
注意：换回去备份好的旧版本smartbi.war以后重启会提示启动失败，如下图所示，我们可以先忽略此提示，继续登录进去config点击“恢复知识库”，下拉列表内选择之前备份好的知识库压缩包文件进行恢复即可。
 
回退的具体流程如下：
（1）确认知识库连接信息
登录后，确认知识库连接信息，没问题的话继续勾选“已确认连接信息正确”，点击 下一步即可。
注意：之前没有改过的话一般不需要更改的，若确实检查不对，也可以点击更改参数 ，进入“Config配置界面”进行配置。更改参数并保存后，需重启服务器，并再次访问Config.jsp界面。
（2）选择备份文件
1）选择备份文件 ，如图：
2）点击 下一步 ，弹出提示，如图，继续在“提示信息”窗口点击 “确定”进行下一步 ：
注意：此处是先删除的当前配置知识库的数据，然后恢复再备份，跟实际项目业务数据源的数据无关！
（3）备份恢复
窗口会继续输出恢复知识库日志，等待恢复完成：
恢复过程结束后，弹窗提示界面继续点击“完成”：
至此，此次恢复知识库的过程就结束了，我们继续点击当前界面的“完成”：
（4）重新去访问index.jsp界面登录系统，进入smartbi主界面，查看关于界面查看是否已恢复到原有版本日期即可：
到这里，关于 Smartbi 更新的核心疑问 —— 从 “何时更新”、“为何更新”，到 “更新什么”、“怎么更新”—— 相信这份方案已经为您提供了清晰的解答与可落地的参考，帮您扫清 Smartbi 更新路上的困惑。
若后续您在实际操作中遇到新的问题，或是对更新方案有更细致的想法、补充建议，都欢迎在评论区随时沟通交流。我们一起探讨，让 Smartbi 的每一次更新都能更贴合你的需求，真正成为提升工作效率的得力帮手！
恭喜你已阅读完全文，来做做题巩固下学习内容，答题可赢取麦豆哦——>点击领取任务 | 
