Linux -- 消息队列 httpsqs 安装

安装 libevent

[root@localhost httpsqs]# wget http://httpsqs.googlecode.com/files/libevent-2.0.12-stable.tar.gz

[root@localhost httpsqs]# tar -zxf libevent-2.0.12-stable.tar.gz

[root@localhost httpsqs]# cd libevent-2.0.12-stable

[root@localhost libevent-2.0.12-stable]# ./configure --prefix=/usr/local/libevent-2.0.12-stable/

[root@localhost libevent-2.0.12-stable]# make

[root@localhost libevent-2.0.12-stable]# make install

[root@localhost libevent-2.0.12-stable]# cd ..

安装 tokyocabinet

[root@localhost httpsqs]# wget http://httpsqs.googlecode.com/files/tokyocabinet-1.4.47.tar.gz

[root@localhost httpsqs]# tar -zxf tokyocabinet-1.4.47.tar.gz 

[root@localhost httpsqs]# cd tokyocabinet-1.4.47

#注：在32位Linux操作系统上编译Tokyo cabinet，请使用./configure --enable-off64代替./configure，可以使数据库文件突破2GB的限制。

#./configure --enable-off64 --prefix=/usr/local/tokyocabinet-1.4.47/

[root@localhost tokyocabinet-1.4.47]# ./configure --prefix=/usr/local/tokyocabinet-1.4.47/

[root@localhost tokyocabinet-1.4.47]# make

[root@localhost tokyocabinet-1.4.47]# make install

[root@localhost libevent-2.0.12-stable]# cd ..

安装 httpsqs

[root@localhost httpsqs]# wget http://httpsqs.googlecode.com/files/httpsqs-1.7.tar.gz

[root@localhost httpsqs]# tar -zxf httpsqs-1.7.tar.gz 

[root@localhost httpsqs]# cd httpsqs-1.7

[root@localhost httpsqs-1.7]# make

[root@localhost httpsqs-1.7]# make install

[root@localhost httpsqs-1.7]#  httpsqs -h

--------------------------------------------------------------------------------------------------

HTTP Simple Queue Service - httpsqs v1.7 (April 14, 2011)

-l    监听的IP地址，默认值为 0.0.0.0 

-p         监听的TCP端口（默认值：1218）

-x       数据库目录，目录不存在会自动创建（例如：/opt/httpsqs/data）

-t    HTTP请求的超时时间（默认值：3）

-s    同步内存缓冲区内容到磁盘的间隔秒数（默认值：5）

-c         内存中缓存的最大非叶子节点数（默认值：1024）

-m       数据库内存缓存大小，单位：MB（默认值：100）

-i       保存进程PID到文件中（默认值：/tmp/httpsqs.pid）

-a         访问HTTPSQS的验证密码（例如：mypass123）

-d                  以守护进程运行

-h                  显示这个帮助

使用  killall httpsqs 批量杀掉 httpsqs 进程.关闭 httpsqs.

不要使用 pkill -9 httpsqs 或 kill -9 PID of httpsqs.否则，内存中尚未保存到磁盘的数据将会丢失

更多介绍查看: http://code.google.com/p/httpsqs

--------------------------------------------------------------------------------------------------

启动:

[root@localhost httpsqs-1.7]# ulimit -SHn 65535

[root@localhost httpsqs-1.7]# httpsqs -d -p 1218 -x /usr/local/httpsqs/

[root@localhost httpsqs-1.7]# netstat -atln | grep 1218

tcp            0         0 0.0.0.0:1218                        0.0.0.0:*                           LISTEN 

测试:

入队测试

-----------------------------

在浏览器中访问:

http://yourid:1218/?name=sunyu&opt=put&data=testcontent&auth=mypass123

如果入队列成功，返回：

HTTPSQS_PUT_OK

如果入队列失败，返回：

HTTPSQS_PUT_ERROR

如果队列已满，返回：

HTTPSQS_PUT_END

从HTTPSQS 1.2版本开始，在返回给客户端的HTTP Header头中增加了一行“Pos: xxx”，输出当前队列的读取位置点.

可在 firebug 或 chorm 返回的 response 中查看到:

Cache-Control:no-cache

Connection:keep-alive

Content-Length:14

Content-Type:text/plain

Date:Sat, 14 Dec 2013 14:00:27 GMT

Pos:5

出队测试

-----------------------------

上面的实例是往队列中 put 值.就是把消息传入队列.

下面是出队的测试:

http://yourid:1218/?name=sunyu&opt=get&auth=mypass123

返回的结果就是之前 put 进去的.

队列状态

-----------------------------

http://yourid:1218/?name=sunyu&opt=status&auth=mypass123

HTTP Simple Queue Service v1.7

------------------------------

Queue Name: sunyu

Maximum number of queues: 1000000

Put position of queue (1st lap): 1

Get position of queue (1st lap): 1

Number of unread queue: 0

以 json 格式查看状态:

http://yourid:1218/?name=sunyu&opt=status_json&auth=mypass123

查看指定队列位置点的内容

-----------------------------

http://yourid:1218/?charset=utf-8&sunyu&opt=view&pos=1&auth=mypass123

pos >=1 并且 <= 1000000000

返回指定队列位置点的内容。

重置指定队列

-----------------------------

http://yourid:1218/?name=sunyu&opt=reset&auth=mypass123

如果重置成功，返回：

HTTPSQS_RESET_OK

如果重置失败，返回：

HTTPSQS_RESET_ERROR

更改指定队列的最大队列数量：

-----------------------------

默认的最大队列长度（100万条）：1000000

http://yourid:1218/?name=sunyu&opt=maxqueue&num=1000000000&auth=mypass123"

num >=10 并且 <= 1000000000

如果更改最大队列数量成功，则返回：

HTTPSQS_MAXQUEUE_OK

更改的最大队列数量必须大于当前的“队列写入点”。另外，当“队列写入点”小于“队列读取点”时（即PUT位于圆环的第二圈，而GET位于圆环的第一圈时），本操作将被取消，然后返回给客户端以下信息：

HTTPSQS_MAXQUEUE_CANCEL

不停止服务的情况下，修改定时刷新内存缓冲区内容到磁盘的间隔时间：

-----------------------------

从HTTPSQS 1.3版本开始支持此功能。

默认间隔时间：5秒 或 httpsqs -s 参数设置的值。

http://yourid:1218/?name=sunyu&opt=synctime&num=10&auth=mypass123"

num >=1 and <= 1000000000

如果修改间隔时间成功，则返回：

HTTPSQS_SYNCTIME_OK

如果 num 不在 1 ～ 1000000000 之间，本操作将被取消，然后返回给客户端以下信息：

HTTPSQS_SYNCTIME_CANCEL

密码校验失败：

-----------------------------

从HTTPSQS 1.5版本开始支持此功能。

如果密码校验失败（/?auth=xxx），将返回以下信息：

HTTPSQS_AUTH_FAILED

全局错误：

-----------------------------

如果发生全局错误（即指令、参数错误等），将返回以下信息：

HTTPSQS_ERROR