本文以apache-tomcat-6.0.18升级为apache-tomcat-7.0.85为例。

目录

一、准备Tomcat包

二、升级步骤

2.1、停服务

2.2、打包现有Tomcat目录下logs和webapps目录

2.3、备份现有Tomcat目录

2.4、上传Tomcat安装包至 $HOME 下并解压

2.5、修改环境变量及启动脚本参数

2.6、Tomcat启动验证

2.7、迁移原项目及日志

2.8、启动验证

三、有问题回退步骤

3.1、Tomcat包回退

3.2、环境变量回退

3.3启动验证

四、升级问题统计

4.1、url特殊字符问题

4.1.1日志信息：

4.1.2问题分析

4.1.3解决方案

---

一、准备Tomcat包

可通过【uname -a】命令查看服务器系统信息。

下载的Tomcat包为Linux下的，apache-tomcat-7.0.85.tar.gz，若需部署的环境可解压“*.tar.gz”包，可直接看第二步。

笔者需要部署的环境没法解压“*.tar.gz”包，故先在可解压的环境下将安装包解压，然后打成tar包，然后拿到要部署的环境。但在用sftp拿到Windows下后（两个机器访问不通需先拿到Windows下，然后上传），发现拿到的tar包里多了“PaxHeaders.*”文件，经查是sftp传输的问题，需在打成tar包时增加一个参数：【--format=gnu】，打完包再传就可以了。

#1.解压
tar xvf apache-tomcat-7.0.85.tar.gz#2.重新打包
tar --format=gnu cvf apache-tomcat-7.0.85.tar apache-tomcat-7.0.85

二、升级步骤

【打包旧的包注意空间剩余量！！！（df -k $HOME）】

2.1、停服务

cd./apache-tomcat-6.0.18/bin/shutdown.sh

2.2、打包现有Tomcat目录下logs和webapps目录

cd
cd apache-tomcat-6.0.18
tar cvf logs.tar logs
tar cvf webapps.tar webapps

2.3、备份现有Tomcat目录

cd
mv apache-tomcat-6.0.18 apache-tomcat-6.0.18_bak

2.4、上传Tomcat安装包至 $HOME 下并解压

cd
tar xvf apache-tomcat-7.0.85.tar

2.5、修改环境变量及启动脚本参数

#note：笔者环境下Tomcat的启动脚本是在myshell.sh中添加的自定义命令
【start is aliased ~/apache-tomcat-6.0.18/bin/startup.sh,
down is aliased ~/apache-tomcat-6.0.18/bin/shutdown.sh】，
同时myshell.sh在.profile里有引用，故需修改myshell.sh
cd
cd mysbin
cp myshell.sh myshell.sh.bakvi myshell.sh
#全量替换【在该脚本中有Tomcat启动脚本的自定义命令】
:%s/6.0.18/7.0.85/g
#保存退出
diff myshell.sh myshell.sh.bak#使修改生效
cd
. .profile #unix
source .profile #Linux#修改端口号，具体参数参考旧的Tomcat配置
cd ~/apache-tomcat-7.0.85/conf
cp server.xml server.xml.bakvi server.xml
#第一处需要修改的
<Server port="8005" shutdown="SHUTDOWN">
#第二处需要修改的
<Connector port="8080" protocol="HTTP/1.1"connectionTimeout="20000"redirectPort="8443" />
#第三处需要修改的
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />#保存退出
diff server.xml server.xml.bak#以下修改可参考旧的Tomcat的startup.sh，若有则配置，没有则无需配置
cd ~/apache-tomcat-7.0.85/bin
cp startup.sh startup.sh.bak
vi startup.sh#保存退出
diff startup.sh startup.sh.bak

2.6、Tomcat启动验证

cd
down
start#浏览器访问
http://[IP]:[port]/

2.7、迁移原项目及日志

cd
down
cd apache-tomcat-7.0.85
mv webapps webapps_bak
cp ~/apache-tomcat-6.0.18_bak/webapps.tar ./
cp ~/apache-tomcat-6.0.18_bak/logs.tar ./
tar xvf webapps.tar
tar xvf logs.tar

2.8、启动验证

cd
start#浏览器访问验证
http://[ip]:[port]/[项目名]/

三、有异常时回退的步骤

3.1、Tomcat包回退

cd
down
mv apache-tomcat-7.0.85 apache-tomcat-7.0.85_err
mv apache-tomcat-6.0.18_bak apache-tomcat-6.0.18

3.2、环境变量回退

cd
cp myshell.sh myshell.sh.err
cp myshell.sh.bak myshell.sh
. .profile #unix
source .profile #linux

3.3启动验证

cd
start#浏览器访问验证
http://[ip]:[port]/[项目名]/

四、升级问题统计

4.1、url特殊字符问题

4.1.1日志信息：

4.1.2问题分析

RFC3986文档规定，Url中只允许包含英文字母（a-zA-Z）、数字（0-9）、-_.~4个特殊字符以及所有保留字符。RFC3986文档对Url的编解码问题做出了详细的建议，指出了哪些字符需要被编码才不会引起Url语义的转变，以及对为什么这些字符需要编码做出了相应的解释。

US-ASCII字符集中没有对应的可打印字符：Url中只允许使用可打印字符。US-ASCII码中的10-7F字节全都表示控制字符，这些字符都不能直接出现在Url中。同时，对于80-FF字节（ISO-8859-1），由于已经超出了US-ACII定义的字节范围，因此也不可以放在Url中。

保留字符：Url可以划分成若干个组件，协议、主机、路径等。有一些字符（:/?#[]@）是用作分隔不同组件的。例如:冒号用于分隔协议和主机，/用于分隔主机和路径，?用于分隔路径和查询参数，等等。还有一些字符（!$&’()*+,;=）用于在每个组件中起到分隔作用的，如=用于表示查询参数中的键值对，&符号用于分隔查询多个键值对。当组件中的普通数据包含这些特殊字符时，需要对其进行编码。

RFC3986中指定了以下字符为保留字符：! * ’ ( ) ; : @ & = + $ , / ? # [ ] 
不安全字符：还有一些字符，当他们直接放在Url中的时候，可能会引起解析程序的歧义。这些字符被视为不安全字符，原因有很多。 
空格：Url在传输的过程，或者用户在排版的过程，或者文本处理程序在处理Url的过程，都有可能引入无关紧要的空格，或者将那些有意义的空格给去掉。 
引号以及<>：引号和尖括号通常用于在普通文本中起到分隔Url的作用 
井号（#） 通常用于表示书签或者锚点 
%：百分号本身用作对不安全字符进行编码时使用的特殊字符，因此本身需要编码 
{}|\^[]`~：某一些网关或者传输代理会篡改这些字符

同时RFC 3986规范在tomcat7.0.73版本中就已经提出了，RFC 7230也是对前者的一些补充或者说是完善，所以在tomcat7.0.73及以上版本都会有这种问题。

从日志信息可以看出Error parsing HTTP request header，负责解析http请求的org.apache.tomcat.util.http.parser.HttpParser，对请求URL中的字符做了限制，具体代码如下：IS_NOT_REQUEST_TARGET[]中定义了一堆not request target

if(IS_CONTROL[i] || i > 127 || i == 32 || i == 34 || i == 35 || i == 60 || i == 62 || i == 92 || i == 94 || i == 96 || i == 123 || i == 124 || i == 125) {IS_NOT_REQUEST_TARGET[i] = true;
}/*
转换过来就是以下字符(对应10进制ASCII看):键盘上那些控制键:(<32或者=127)非英文字符(>127)空格(32)双引号(34)#(35)<(60)>(62)反斜杠(92)^(94)TAB上面那个键,我也不晓得嫩个读(96){(123)}(124)|(125)
*/

由于页面中某个跳转url中带有特殊字符“||”，故报此错

4.1.3解决方案

4.1.3.1在~/apache/tomcat-7.0.85/conf/catalina.properties中添加：

tomcat.util.http.parser.HttpParser.requestTargetAllow=|

4.1.3.2换用低版本的tomcat，既然你是tomcat7.0.73版本，及以上版本有这种问题，我们可以暂时的逃避这个问题，选择低版本的tomcat。
4.1.3.3用post代替get请求，上面也说过了是get请求才会有这种情况，如果方便的话，我们完全可以采用post请求来实现这个功能。在前端对前端URL进行编码

前端对URL进行编码的实现方法。 
javascript可以使用的内置函数有

encodeURI()
encodeURIComponent() 
他们都是用utf-8的编码方式,对于get请求，他的编码格式默认是按照浏览器的编码格式进行编码的，我们可以设置浏览器的编码格式，但是每个用户的浏览器的编码格式不可能都是一致的，这样我们的get请求的参数有时候就会出现乱码问题，但是如果我们自己在前端对get请求利用encodeURI()或者encodeURIComponent ()来统一设置成utf-8编码，这样我们在后台在用utf-8来解码，就不会出现乱码问题。 
这里需要注意的一点，对于get请求的中文乱码问题，如果你没有在tomcat配置文件中设置编码格式，天真的想用request.setCharacterEncoding(“UTF-8”)来在后端设置后端的解码格式，这种方式对于get请求是无效的。同时有的小伙伴可能会想我们可以在项目的web.xml中设置编码过滤器。抱歉这种方式对于get请求也是无效的。 
对于这种情况我们可以采用new String(request.getParameter(“name”).getBytes(“iso-8859-1”),”UTF-8”) 来进行二次编码解码过程，这种方式就能解决get请求中文乱码问题，当然我们也可以在tomcat的配置文件中设置统一编码格式。

encodeURI()，用来encode整个URL，不会对下列字符进行编码：+ : / ; ?&。它只会对汉语等特殊字符进行编码 
encodeURIComponent ()，用来enode URL中想要传输的字符串，它会对所有url敏感字符进行encode 
在对url做encode操作时，要根据情况选择不同的方法。 当参数中有汉字时可以用encodeURI(url) ，当你的参数中包含+ : / ; ?&请使用 encodeURIComponent 方法对这些参数单独进行编码。