问题
最近在迁移即将到期的虚拟机，虚拟机上面跑着Nginx对外提供服务。在切换到新的虚拟机后，有业务方反映上传图片失败，Nginx返回响应码411.
第一次遇到这种问题，在网上搜索一番后发现是低版本Nginx存在的问题。新的虚拟机上面的Nginx是通过yum源安装的，版本为1.0.15. 该版本的Nginx在处理 POST 方式上传文件的时候会触发该问题，给客户端返回响应码411.
解决方案
OK，知道是Nginx版本太低导致的，那解决方案就是升级Nginx了。如何不影响线上服务平滑升级Nginx呢？
平滑升级Nginx
源码编译
到Nginx官网下载最新稳定版：
wget http://nginx.org/download/nginx-1.8.0.tar.gz
解压缩并进入源码目录：
tar zxf nginx-1.8.0.tar.gz
cd nginx-1.8.0
查看老版本Nginx的编译配置：
nginx -V
复制上述命令输出的配置参数，加到 ./configure 后面，修改prefix参数为其它目录：
./configure --prefix=/home/ubuntu/nginx <其它复制过来的配置参数>
执行完上面的命令，你可能看到如下错误信息，提示rewrite模块需要PCRE库：
./configure: error: the HTTP rewrite module requires the PCRE library.
You can either disable the module by using --without-http_rewrite_module
option, or install the PCRE library into the system, or build the PCRE library
statically from the source with nginx by using --with-pcre=<path> option.
到PCRE官方FTP服务器下载PCRE并解压缩：
wget ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-8.36.tar.gz
tar zxf pcre-8.36.tar.gz
在Nginx的源码目录再次执行配置命令，这次加上--with-pcre选项：
./configure --prefix=/home/ubuntu/nginx <其它复制过来的配置参数> --with-pcre=/home/ubuntu/pcre-8.36
如果仍然提示缺少一些依赖库，安装这些库：
# on ubuntu/debian system
sudo apt-get install libssl-dev libxml2-dev libxslt-dev libgd-dev libgeoip-dev
配置无误后，然后执行make命令。至此，编译好的nginx可执行文件在当前目录的子目录objs里面。
平滑升级
-
备份旧版本的nginx可执行文件：
<pre class=”brush: bash; gutter: false;”>
sudo mv /usr/sbin/nginx /usr/sbin/nginx.old
</pre> -
把编译好的nginx可执行文件复制过去：
<pre class=”brush: bash; gutter: false;”>
sudo cp objs/nginx /usr/sbin/nginx
</pre> -
测试Nginx配置是否正确：
<pre class=”brush: bash; gutter: false;”>
sudo /usr/sbin/nginx -t
</pre>如果测试正确，可以进入下一步操作。
-
给旧版本的nginx主进程发送USR2信号：
<pre class=”brush: bash; gutter: false;”>
ubuntu@me:~/nginx-1.8.0$ ps -ef | grep nginx
root 9962 1 0 2014 ? 00:00:00 nginx: master process /usr/sbin/nginx
ubuntu 31321 9962 0 Apr23 ? 00:04:58 nginx: worker process
ubuntu 31322 9962 0 Apr23 ? 00:05:20 nginx: worker process
ubuntu 31323 9962 0 Apr23 ? 00:05:46 nginx: worker process
ubuntu 31324 9962 0 Apr23 ? 00:00:18 nginx: worker process
ubuntu@me:~/nginx-1.8.0$ sudo kill -USR2 9962
ubuntu@me:~/nginx-1.8.0$ ps -ef | grep nginx
root 9962 1 0 2014 ? 00:00:00 nginx: master process /usr/sbin/nginx
root 29149 9962 0 04:47 ? 00:00:00 nginx: master process /usr/sbin/nginx
ubuntu 29150 29149 0 04:47 ? 00:00:00 nginx: worker process
ubuntu 29151 29149 0 04:47 ? 00:00:00 nginx: worker process
ubuntu 29152 29149 0 04:47 ? 00:00:00 nginx: worker process
ubuntu 29153 29149 0 04:47 ? 00:00:00 nginx: worker process
ubuntu 31321 9962 0 Apr23 ? 00:04:58 nginx: worker process
ubuntu 31322 9962 0 Apr23 ? 00:05:20 nginx: worker process
ubuntu 31323 9962 0 Apr23 ? 00:05:46 nginx: worker process
ubuntu 31324 9962 0 Apr23 ? 00:00:18 nginx: worker process
</pre>可以看到，在发送USR2信号后，新的nginx master进程和worker进程开始运行。此时，新nginx和旧nginx同时在工作。
-
接下来，给旧版本nginx主进程发送WINCH信号：
<pre class=”brush: bash; gutter: false;”>
ubuntu@me:~/nginx-1.8.0$ sudo kill -WINCH 9962
ubuntu@me:~/nginx-1.8.0$ ps -ef | grep nginx
root 9962 1 0 2014 ? 00:00:00 nginx: master process /usr/sbin/nginx
root 29149 9962 0 04:47 ? 00:00:00 nginx: master process /usr/sbin/nginx
ubuntu 29150 29149 0 04:47 ? 00:00:00 nginx: worker process
ubuntu 29151 29149 0 04:47 ? 00:00:00 nginx: worker process
ubuntu 29152 29149 0 04:47 ? 00:00:00 nginx: worker process
ubuntu 29153 29149 0 04:47 ? 00:00:00 nginx: worker process
</pre>这时，可以看到旧nginx的worker进程退出了，不再处理新的请求，新的请求都由新nginx处理。
-
接下来是平滑升级的最后一步，也就是给旧版本nginx主进程发送QUIT信号：
<pre class=”brush: bash; gutter: false;”>
ubuntu@me:~/nginx-1.8.0$ sudo kill -QUIT 9962
ubuntu@me:~/nginx-1.8.0$ ps -ef | grep nginx
root 29149 1 0 04:47 ? 00:00:00 nginx: master process /usr/sbin/nginx
ubuntu 29150 29149 0 04:47 ? 00:00:00 nginx: worker process
ubuntu 29151 29149 0 04:47 ? 00:00:00 nginx: worker process
ubuntu 29152 29149 0 04:47 ? 00:00:00 nginx: worker process
ubuntu 29153 29149 0 04:47 ? 00:00:00 nginx: worker process
</pre>好了，至此旧nginx的主进程也退出了。我们已成功平滑升级到新版nginx.
版本回退
如果在执行上面的平滑升级过程中反悔了想回退，该怎么办？
- 给旧版本nginx主进程发送HUP信号
- 给新版本nginx主进程发送QUIT信号
- 从备份中还原nginx可执行文件
升级过程中出问题
按照上面的升级步骤，笔者在ubuntu系统上成功将Nginx升级到1.8版本。但是在公司虚拟机CentOS 6.4上执行升级操作却没有成功。问题在执行第3步的时候，检查Nginx配置失败，提示nginx.pm文件版本号不匹配。
