Linux下，Nginx的安装、升级及动态添加模块

ubuntu server 14.04.4 amd64

安装

第一步 下载并解压Nginx压缩包

wget http://nginx.org/download/nginx-1.10.1.tar.gz[/code]命令直接下载 
解压
nginx-1.10.1.tar.gz
文件：

tar zxvf nginx-1.10.1.tar.gz


第二步 配置
cd nginx-1.10.1
./configure --prefix=/usr/local/nginx


注意：

① 如果之前没有安装C compiler（C 编译器），这一步将报如下错误信息：

xueliang@dev:~/download/nginx-1.10.1$ ./configure –prefix=/usr/local/nginx

checking for OS

+ Linux 4.2.0-27-generic x86_64

checking for C compiler … not found

./configure: error: C compiler cc is not found

xueliang@dev:~/download/nginx-1.10.1$

可以参考这篇文章安装C compiler，然后继续下面的操作

② 如果之前没有安装PCRE，这一步将报如下错误信息：

checking for PCRE library … not found

checking for PCRE library in /usr/local/ … not found

checking for PCRE library in /usr/include/pcre/ … not found

checking for PCRE library in /usr/pkg/ … not found

checking for PCRE library in /opt/local/ … not found

./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= option.

xueliang@dev:~/download/nginx-1.10.1$

可以参考这篇文章安装PCRE，然后继续下面的操作

③ 如果之前没有安装zlib，这一步将报如下错误信息：

checking for md5 in system md library … not found

checking for md5 in system md5 library … not found

checking for md5 in system OpenSSL crypto library … not found

checking for sha1 in system md library … not found

checking for sha1 in system OpenSSL crypto library … not found

checking for zlib library … not found

./configure: error: the HTTP gzip module requires the zlib library.

You can either disable the module by using –without-http_gzip_module

option, or install the zlib library into the system, or build the zlib library

statically from the source with nginx by using –with-zlib= option.

xueliang@dev:~/download/nginx-1.10.1$

可以参考这篇文章安装zlib，然后继续下面的操作

也可以跳过此步，执行默认安装，
--prefix
的默认值为
/usr/local/nginx
，Nginx官网对此有说明：Building nginx from Sources

第三步 编译
make


第四步 完成安装
sudo make install


平滑升级
当需要对正在运行的Nginx进行升级时，可以在不停止Nginx的情况下，使用新版本或者重编译的可执行程序替换旧版本的可执行程序，这里我们从
nginx-1.10.1
升级到
nginx-1.11.1
。

第一步 备份旧版本
因为Nginx的升级，实质只是用新版本的可执行文件，替换旧版本的可执行程序，所以，对于备份，既可以只备份旧版本可执行文件，也可以打包备份整个旧版本安装目录，参考命令分别如下：

只备份旧版本可执行文件

sudo cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak


打包备份整个旧版本安装目录

sudo tar -cvf /usr/local/nginx.bak /usr/local/nginx


第二步 下载新版本并解压Nginx压缩包
对于新版本Nginx压缩包的下载和解压，可以参考本文关于Nginx的安装部分的第一、二步。

第三步 使用旧版本配置参数，配置并编译新版本Nginx
因为只是对Nginx进行升级，并不涉及配置参数的修改，所以，我们一般使用和旧版本相同的配置(当然你也可以使用全新的配置信息)，来编译新版本的Nginx，使用如下命令查看旧版本配置信息：

/usr/local/nginx/sbin/nginx -V


可以得到结果如下：

xueliang@dev:~/download/nginx-1.11.1$ /usr/local/nginx/sbin/nginx -V

nginx version: nginx/1.10.1

built by gcc 4.8.4 (Ubuntu 4.8.4-2ubuntu1~14.04.3)

configure arguments: –prefix=/usr/local/nginx

xueliang@dev:~/download/nginx-1.11.1$

其中 [configure arguments: –prefix=/usr/local/nginx] 这一行即为旧版本Nginx配置信息，这里可以看出，旧版本只是指定了安装路径，使用[configure arguments:]后面的参数信息，对新版本Nginx作相同配置，然后进行编译：

./configure --prefix=/usr/local/nginx


第四步 编译新版本Nginx可执行程序
make


第五步 用新版本Nginx可执行程序覆盖旧版本可执行程序
在上一步的基础上，执行一下命令即可：

sudo cp objs/nginx /usr/local/nginx/sbin/nginx


执行这条命令，可能会报以下异常，提示文件被占用：

xueliang@dev:~/download/nginx-1.11.1$ sudo cp objs/nginx /usr/local/nginx/sbin/nginx

cp: cannot create regular file ‘/usr/local/nginx/sbin/nginx’: Text file busy

xueliang@dev:~/download/nginx-1.11.1$

可以使用以下命令进行强制覆盖：

sudo cp -rfp objs/nginx /usr/local/nginx/sbin/nginx


第六步 启动新版本Nginx主进程
发送 USR2信号给旧版本主进程号：

kill -USR2 旧版本的Nginx主进程号


旧版本Nginx主进程接收到
-USR2
信号，将重命名它的
.pid
文件为
.oldpid
，然后执行新版本的Nginx可执行程序，依次启动新版本的主进程和工作进程：

PID
PPID
USER
%CPU
VSZ
WCHAN
COMMAND
33126
1
root
0.0
1164
pause
nginx: master process /usr/local/nginx/sbin/nginx
33134
33126
nobody
0.0
1368
kqread
nginx: worker process (nginx)
33135
33126
nobody
0.0
1380
kqread
nginx: worker process (nginx)
33136
33126
nobody
0.0
1368
kqread
nginx: worker process (nginx)
36264
33126
root
0.0
1148
pause
nginx: master process /usr/local/nginx/sbin/nginx
36265
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)
36266
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)
36267
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)
第七步 从容关闭旧版本的工作进程
此时，新、旧版本的Nginx实例会同时运行，共同处理请求，如果此时给旧版本主进程发送
WINCH
 信号，旧版本主进程将会给它的工作进程发送消息，请求它们从容关闭，此后，旧版本的工作进程开始逐步退出：

PID
PPID
USER
%CPU
VSZ
WCHAN
COMMAND
33126
1
root
0.0
1164
pause
nginx: master process /usr/local/nginx/sbin/nginx
33135
33126
nobody
0.0
1380
kqread
nginx: worker process is shutting down (nginx)
36264
33126
root
0.0
1148
pause
nginx: master process /usr/local/nginx/sbin/nginx
36265
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)
36266
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)
36267
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)
从容关闭旧版本的工作进程命令：

kill -WINCH 旧版本的Nginx主进程号


第八步 从容关闭旧版本的主进程，完成Nginx的升级
经过一段时间后，旧的工作进程（work process）处理完了所有已连接的请求后退出，仅由新版本的工作进程来处理新的请求了：

PID
PPID
USER
%CPU
VSZ
WCHAN
COMMAND
33126
1
root
0.0
1164
pause
nginx: master process /usr/local/nginx/sbin/nginx
36264
33126
root
0.0
1148
pause
nginx: master process /usr/local/nginx/sbin/nginx
36265
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)
36266
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)
36267
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)
应该注意的是，此时，旧版本的主进程还尚未关闭它监听的套接字，如果有需要，你仍可以恢复旧版本工作进程。如果由于某些原因，新版本的可执行文件运行情况不理想，下面有几种方案可供参考：

给旧版本主进程发送 
HUP
 信号。旧版本主进程将在不重新读取配置信息的情况下，重新开启工作进程。然后，通过给新版本主进程发送 
QUIT
 信号，所有新版本的进程将会从容关闭。

给新版本主进程发送 
TERM
 信号。然后，他将会给它的工作进程发送消息，要求它们立即退出，紧接着，这些工作进程就会立即退出。（如果因为某些原因，新版本进程没有退出，应该给新版本主进程发送 
KILL
 信号，强制新版本主进程退出。）新版本主进程退出的同时，旧版本主进程将会自动启动它的工作进程。

新版本主进程退出后，旧版本主进程将会移除名字以
.oldpid
 结尾的文件，恢复为它的 
.pid
 文件。

如果升级成功，应该给旧版本主进程发送 
QUIT
 信号，使其退出，只保留新版本进程：

PID
PPID
USER
%CPU
VSZ
WCHAN
COMMAND
36264
33126
root
0.0
1148
pause
nginx: master process /usr/local/nginx/sbin/nginx
36265
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)
36266
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)
36267
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)
添加模块
刚接触Nginx时，只知道Nginx的功能是分模块的，并不清楚有些模块默认是不参与到构建中去的，比如
ngx_http_ssl_module
模块，是用来支持
https
协议的，默认情况下是没有构建到Nginx中的。

随着业务不断扩展，如果需要Nginx支持某些模块，而这些模块默认不在Nginx的构建计划中，构建Nginx时，又没有指定加入这些模块，该怎么办呢？是否能够给已经运行的Nginx动态添加这些模块呢？答案是肯定的！

给运行中的Nginx动态添加模块的方案，与上面提到的平滑升级Nginx的方案很类似。下面我们来看一下如何给运行中的Nginx添加 
ngx_http_ssl_module
 模块。

第一步 查看运行中的Nginx版本，并下载、解压对应版本的压缩包
查看Nginx版本：

/usr/local/nginx/sbin/nginx -v


结果：

xueliang@dev:~$ /usr/local/nginx/sbin/nginx -v

nginx version: nginx/1.11.1

xueliang@dev:~$

或者：

/usr/local/nginx/sbin/nginx -V


结果：

xueliang@dev:~$ /usr/local/nginx/sbin/nginx -V

nginx version: nginx/1.11.1

built by gcc 4.8.4 (Ubuntu 4.8.4-2ubuntu1~14.04.3)

configure arguments: –prefix=/usr/local/nginx

xueliang@dev:~$

这里可以看出，正在运行的Nginx版本为
1.11.1
，参照安装Nginx部分，下载并解压对应版本的Nginx

第二步 编译Nginx，同时加入需要模块配置
参考平滑升级的第三步，查看运行中的Nginx的配置参数，并在最后追加
-with-http_ssl_module
。

如：原配置信息为 
--prefix=/usr/local/nginx
，则新配置信息为 
--prefix=/usr/local/nginx --with_http_ssl_module
，配置Nginx执行的命令如下：

./configure --prefix=/usr/local/nginx --with_http_ssl_module


第三步 平滑重启Nginx，完成动态模块添加
这一步可以参考平滑升级的第四至八步