Nginx通过hmux协议访问resin说明文档

pittpakk 2011-04-17

这里讲述一下在nginx-0.8.53版本下使用本模块的具体安装方法(linux)
一、安装准备

1、下载nginx-0.8.53;

2、下载ngx_caucho_vx.x.tar包,解开后包含两个文件:config和ngx_caucho.c;

    这里供下载的版本是初步版本,以后会随着需求不断增强其功能。

    ngx_caucho.c文件的实现参考了姚伟斌写的nginx_ajp_module模块,具体功能就是实现hmux协议,并把处理过程异步化。

    hmux协议可以参考文档 http://www.caucho.com/resin-4.0-javadoc/com/caucho/server/hmux/HmuxRequest.html

3、(可选)

    如果nginx与resin之间需要保持keepalive,请下载keepalive模块( http://mdounin.ru/hg/ngx_http_upstream_keepalive );

    如果需要session sticky,请下载nginx_upstream_jvm_route里的ngx_http_upstream_jvm_route_module.c文件。

ngx_caucho_v1.0.tar与ngx_http_upstream_jvm_route_module.c下载在在安科网论坛的1号FTP服务器里,下载地址:

密码:www.muu.cc

下载方法见 http://www.linuxidc.net/thread-1187-1-1.html

4、为了实现过程异步,需要修改src/event/ngx_event_pipe.c文件

    原来代码如下:

while (cl && n > 0) {

    ngx_event_pipe_remove_shadow_links(cl->buf);

    size = cl->buf->end - cl->buf->last;

    if (n >= size) {

    cl->buf->last = cl->buf->end;

    /* STUB * / cl->buf->num = p->num++;

    if (p->input_filter(p, cl->buf) == NGX_ERROR){

        return NGX_ABORT;

    }

    n -= size;

    ln = cl;

    cl = cl->next;

    ngx_free_chain(p->pool, ln);

    } else {

    cl->buf->last += n;

    n = 0;

    }

    }

    修改如下:

while (cl && n > 0) {

    ngx_event_pipe_remove_shadow_links(cl->buf);

    size = cl->buf->end - cl->buf->last;

    if (n >= size) {

    cl->buf->last = cl->buf->end;

    n -= size;

    } else {

    cl->buf->last += n;

    n = 0;

    }

    /* STUB */cl->buf->num = p->num++;

    if (p->input_filter(p, cl->buf) == NGX_ERROR) {

    return NGX_ABORT;

    }

    ln = cl;

    cl = cl->next;

    ngx_free_chain(p->pool, ln);

    }

这样修改的目的就是为了让nginx及时返回信息给客户端,否则很长时间才能返回给客户端。

上述修改参考了Maxim Dounin和姚伟斌的做法。

上述也可以采用补丁的方式修改,但鉴于nginx版本众多,往往会导致无法打上补丁,对于这一点请见谅。
二、安装步骤

以下是加上keepalive功能的安装步骤:

1、./configure --add-module=caucho/ --add-module=keepalive/ --with-debug

2、修改objs/Makefile,去掉优化参数(调试目的)

3、make

4、make install

5、修改nginx.conf配置文件如下:

user xxx;

worker_processes 2;

debug_points abort;

error_log logs/error.log debug;

pid logs/nginx.pid;

worker_rlimit_nofile 65536;

events {

    use epoll;

    epoll_events 4096;

    worker_connections 8192;

    accept_mutex off;

}

http {

    include mime.types;

    default_type application/octet-stream;

    access_log logs/access.log;

    sendfile on;

    tcp_nopush on;

    client_header_timeout 5;

    send_timeout 5;

    keepalive_timeout 10;

    server_name_in_redirect off;

    server_tokens off;

    charset GB2312;

    upstream resins{

    server xxx.xxx.xxx.xxx:6800;

    keepalive 1024;

    }

    server {

    listen xxxx;

    server_name xxx.xxx.com;

    location / {

    hmux_pass resins;

    }

    }

}
三、注意

这里需要注意的几点就是:

1、在单进程模式下,keepalive模块是没有问题的,但是在多进程模式下,按照keepaive模块内说明是有问题的。根据我近一年使用 keepalive的经验和源代码分析,在多进程模式下要保持与后端resin的keepalive,必须设置accept_mutex off(这个会在我以后的文档中具体讲述为什么)。

2、这里书写的文档由于是从项目中提炼出来的,如果有什么不明白的或者错误的地方,请提出来,我们团队会尽快解决这些问题的。

相关推荐

lwplvx / 0评论 2020-11-22
岁月如歌 / 0评论 2020-07-21