Smartbi Insight V11帮助中心
页面树结构
转至元数据结尾
转至元数据起始

1、升级前准备以及注意事项

升级前准备和注意事项：

1、了解项目情况、项目环境，升级tomcat版本的原因。
2、了解项目上tomcat的版本信息，部署方式、部署路径，tomcat是否只部署了Smartbi服务。
3、了解项目是否定制了扩展包。
3、获取新版的tomcat安装包，获取项目环境接服务器的连接方式。
4、tomcat只建议小版本之间升级，比如 tomcat 8.1升级到tomcat 8.x。
5、服务器可能存在多个tomcat服务，需要检查Smartbi使用的是哪个tomcat服务,检查步骤：
     ①登陆服务器查看Smartbi端口对应的tomcat进程，确认tomcat的信息。

此文档仅供参考，相关信息请根据实际环境调整，请勿将文档中的命令配置直接复制到环境中运行。

2、环境信息

IP地址

软件

原版本

新版本

OS

192.168.137.115

Tomcat

8.5.51

8.5.65

Censtos7.5

注意事项

1、根据实际环境的tomcat版本下载对应的升级版本安装包
2、tomcat版本升级前最重要的一件事：备份

3、安装介质

安装介质已上传到节点的对应位置：
192.168.137.115
Tomcat: /data/apache-tomcat-8.5.65.tar.gz


Tomcat官网下载地址：https://tomcat.apache.org/
根据实际环境下载对应的版本：

4、版本升级

4.1.1、升级Tomcat版本

1、停止正在运行的tomcat进程

ps -ef | grep tomcat
kill -9 tomcat进程ID


2、备份旧版本tomcat目录

cd /data/
mv Tomcat/ Tomcat_bk20210421/


3、解压并重命名新版本的tomcat安装包

cd /data/
tar -zxvf apache-tomcat-8.5.65.tar.gz
mv apache-tomcat-8.5.65/ Tomcat/

注意事项

将新安装包命名为旧安装包名称的原因：
tomcat和Smartbi的相关配置文件中包含了原有的旧tomcat路径名称，所以此处将新安装包名称修改成旧安装包名称，可以减少修改配置文件中tomcat路径的步骤，避免出现配置文件路径未修改导致服务启动或者访问异常。


注意事项

基于tomcat的安全漏洞问题，建议删除Tomcat/webapps目录自带的文件。
rm -rf Tomcat/webapps/*


4、复制旧tomcat中bin目录相关文件到新的tomcat

cd /data/Tomcat/bin/
cp -ra /data/Tomcat_bk20210421/bin/{dynamicLibraryPath,exts,exts-smartbi,Font-smartbi,Index-smartbi,mlogs-smartbi,setenv.sh,smartbi*,Smartbi-License.xml,tmp_ehcache.xml,Tmp-smartbi,upgrade-smartbi}  ./

注意事项

迁移的主要是smartbi自己生成的文件内容，主要包括以下内容：

        动态链接库目录：dynamicLibraryPath

        扩展包目录：exts

        license文件：Smartbi-License.xml

        smartbi配置文件：smartbi.properties、smartbi-config.xml

        知识库备份目录：smartbi_repoBackup

        还有其他smartbi开头或结尾的相关文件目录等。

注意事项

注意：

1、dynamicLibraryPath为默认驱动存放文件夹；exts为默认扩展包存放文件夹 可更改http://IP:端口/smartbi/vision/config.xml配置的进行移动

2、可以根据实际环境，将旧版本中的tomcat/bin目录下所有新版本tomcat/bin目录不存在的文件和文件夹，全部复制到新版本的tomcat/bin目录下。

3、此命令复制的文件和文件夹仅适合当下文档的环境。

4、迁移的主要是smartbi自己生成的文件内容（包括动态链接库目录dynamicLibraryPath，扩展包目录exts，license文件smartbi-license.xml，）。

 
5、复制旧tomcat部署的服务war包到新的tomcat

cd /data/Tomcat/webapps/
cp /data/Tomcat_bk20210421/webapps/smartbi.war ./

注意事项

如果tomcat还部署了其他应用，请将其他应用也复制到新tomcat/webapps目录


6、修改新版本tomcat的server.xml

旧版本tomcat 配置文件中如果修改了server.xml的配置，如修改了tomcat端口、连接数或者设置了https，新版本tomcat也需要修改对应的配置。如果配置了https，需要把证书复制到新的tomcat安装路径中


7、启动新版本的tomcat

cd /data/Tomcat/bin
./startup.sh


8、查看tomcat版本信息
可以通过tomcat启动日志查看tomcat的版本信息：

more /data/Tomcat/logs/catalina.out



也可以通过执行命令查看版本信息:

sh /data/Tomcat/bin/version.sh



等待Smartbi启动完成。

5、验证Smartbi

Smartbi启动完成后，可以通过浏览器访问Smartbi，验证是否正常。
浏览器打开  http://IP:端口/smartbi

登陆Smartbi后测试相关功能是否正常。
版本升级完成。

6、其他说明

1、logs目录
日志文件可以根据项目审计要求，自行评估是否复制到新的tomcat中。

  • 无标签