艺赛旗 Tomcat 8 通用升级方案

艺赛旗 Tomcat 8 通用升级方案

1. 准备工作

  • tomcat 常见的安装目录:
  • /app/isearch/
  • /isearch/
  • /test/isearch/


在下面升级文档中以 /isearch 安装目录 和 apache-tomcat-8.5.57.tar.gz 为示例

1.2 升级思路说明

升级文档思路:

  1. 上传新包 & 解压
  2. tomcat 升级准备:
  3. 删除新包中的 webapps 目录下所有文件
  4. 修改 conf/server.xml 文件
    1. 服务端口(必选,我们服务的端口基本是 9080,或者 10080)
    2. ssl 证书配置(可选 )
  5. 复制 confi/Catalina 到新 tomcat 的 conf 目录下
  6. 修改 tomcat 软连接(记住之修改前的对应的目录,方便恢复到之前的版本)
  7. 重启服务


2. 升级

2.1 上传需要升级的文件并解压

PS: tomcat 升级包存在 tar.gz 和 zip 两种文件类型,
- tar.gz linux 操作系统基本都支持,推荐使用这种文件类型的升级包;在本文档中使用的是 tar.gz 文件类型升级;
- zip 文件类型解压需要安装 unzip 文件,不推荐使用使用

## 1.上传tomcat升级包到安装目录,在这里是上传到/isearch目录
## 2.跳转到安装目录(省略)
# cd /isearch/
## 3.解压升级文件
tar -zxvf apache-tomcat-8.5.57.tar.gz

查看安装目录 ll |grep tomcat 如下:

drwxrwxr-x.  9 isearch isearch     4096 3月   3 2017 apache-tomcat-8.5.11
drwxrwxr-x.  9 isearch isearch     4096 7月  10 10:06 apache-tomcat-8.5.57
-rw-r--r--.  1 isearch isearch 10379806 7月  10 09:53 apache-tomcat-8.5.57.tar.gz
lrwxrwxrwx.  1 isearch isearch       20 7月  10 10:49 tomcat -> apache-tomcat-8.5.11

下面是对目录的说明:
apache-tomcat-8.5.11                  – tomcat 老版本的目录
apache-tomcat-8.5.57                 – tomcat 新版本的目录
apache-tomcat-8.5.57.tar.gz        – 新版本的压缩包
tomcat                                         – 当前版本的软连接(升级的时候更改指向 tomcat 新版本的路径即可,具体参考下面的文档)

2.1 tomcat 升级准备

为满足升级需求,需要做如下修改:

  • 删除新包中的 webapps 目录下所有文件
  • 修改 conf/server.xml 文件
  • 服务端口(必选,我们服务的端口基本是 9080,或者 10080)
  • ssl 证书配置(可选 )
  • 复制 confi/Catalina 到新 tomcat 的 conf 目录下

进入 新版 tomcat 目录 ,以 tomcat-8.5.57 为示例 : cd ``/isearch/apache-tomcat-8.5.57

2.1.1. 删除 webapps 目录下多余的文件

rm -rf webapps/*

2.1.2. 删除 webapps 目录下多余的文件

根据老版本的配置 /isearch/tomcat/conf/server.xml  修改到新版本的 server.xml 文件
vim conf/server.xml

2.1.3. 修改 conf/server.xml 文件 (该配置操作需要有 tomcat 配置经验,如无经验请谨慎操作)

下面是常用服务的端口说明,请根据老版本的 tomcat 配置端口修改新版本 tomcat 的端口:

  • 用来关闭 tomcat 服务的端口:默认 8005,如果该服务有前提多个 tomcat 会有一个 tomcat 修改该端口号
  • 连接器监听端口:默认 8009,负责和其他的 HTTP 服务器建立连接,从 apache-tomcat-8.5.51 开始 默认关闭 AJP 服务。
  • HTTP 连接端口:默认 8080,可能会修改成其他端口,例如修改成 80/9080/10080 端口,在通过浏览器访问 Tomcat 服务器的 Web 应用时,使用的就是这个连接器。(该配置需要修改)
  • https 端口:443/8443 ,配置了 SSL 证书后可以使用 (这个可能使用,具体要参考本服务老版本的配置)


a. 服务端口(必选,我们服务的端口基本是 9080,或者 10080)

复制老版本的 ,替换到新版本中的 8080 端口

b. SSL 证书配置(可选 )

复制老版本的 SSL ,替换到新版本中

2.1.3. 复制 confi/Catalina 到新 tomcat 的 conf 目录下

在新版本的 tomcat 目录中执行下面命令:
 cp -r ../tomcat/conf/Catalina/ conf/
查看复制结果:

[isearch@localhost apache-tomcat-8.5.57]$ ll conf/Catalina/localhost/
总用量 8
-rw-r--r--. 1 isearch isearch 312 7月  10 10:37 cda.xml
-rw-r--r--. 1 isearch isearch 301 7月  10 10:37 ROOT.xml

3. tomcat 升级操作

 cd /isearch/ ## 进入 tomcat 安装目录
修改 tomcat 软连接(记住之修改前的对应的目录,方便恢复到之前的版本)

drwxrwxr-x.  9 isearch isearch     4096 3月   3 2017 apache-tomcat-8.5.11
drwxrwxr-x.  9 isearch isearch     4096 7月  10 10:06 apache-tomcat-8.5.57
-rw-r--r--.  1 isearch isearch 10379806 7月  10 09:53 apache-tomcat-8.5.57.tar.gz
lrwxrwxrwx.  1 isearch isearch       20 7月  10 10:49 tomcat -> apache-tomcat-8.5.11

先停止服务 ./bin/tomcat.sh stop

## 进入tomcat安装目录
cd /isearch/ 

## 先停止服务 
./bin/tomcat.sh stop

## 修改软连接到新版本的地址,新地址根据实际情况来(先记住修改前的地址)
ln -snf apache-tomcat-8.5.57 tomcat

## 启动tomcat
./bin/tomcat.sh start


4 tomcat 恢复之前的系统

## 进入tomcat安装目录
cd /isearch/ 

## 先停止服务 
./bin/tomcat.sh stop

## 修改到之前的版本地址,根据实际情况来,例如之前是apache-tomcat-8.5.11
ln -snf apache-tomcat-8.5.11 tomcat

## 启动tomcat
./bin/tomcat.sh start

参考:

ln 常用命令

  • 新建:
ln -s 源路径 新建链接
  • 修改:
ln -snf 源路径 待修改链接
  • 删除