plone.recipe.pound 0.5.5

trunk (2009-06-02)

• xxx [Ingeniweb]

0.5.5 (2009-06-02)

• cmmi change extra_options configuration [youenn]

0.5.4 (2008-12-12)

• 添加新选项以配置粘性会话 [youenn]

0.5.3 (2008-10-23)

• 修复获取当前组时的回归 [youenn]

• poundctl重启需要使用正确的配置文件 [jensens]

• 关于可移植性，bash脚本现在使用env来获取它们的shell。

• poundctl脚本覆盖了$prefix/sbin中存在的控制二进制文件。因此，引入了选项来解决该问题：（kiorky）

  • 添加了poundcontrol脚本来包装实际的poundctl二进制文件。

  • 自定义生成脚本的名称。要使用它们，只需将poundctl-binary、poundrun-binary、poundcontrol-binary添加到您的选项中。

0.5.1 (2008-07-08)

• 修复获取当前组时的bug [youenn]

0.5.0 (2008-07-07)

• 将iw.recipe.pound重命名为plone.recipe.pound [youenn]

• 修复doctests [youenn]

• 添加socket选项 [mathieu pasquet]

• 配置配方现在还创建了一个名为“poundrun”的脚本，该脚本仅运行配置好的pound可执行文件，并使用正确的配置 [rockyburt]

• 获取当前运行用户的方式现在更加健壮 [rockyburt]

0.4.1 (2008-07-02)

• 修复Cheetah需求 [youenn]

0.4.0 (2008-06-26)

• 添加一个ctl脚本（类似于plone.recipe.squid） [youenn]

0.3.0

• 将配方分为两部分：构建和配置部分 [youenn]

• 添加构建选项（额外选项）[youenn]

• 添加配置文件选项（超时，优先级等）[youenn]

0.2.0

• 添加了一个启动Pound的脚本，使用正确的配置文件 [tarek]

0.1.0

• 初始发布 [tarek]

支持的选项

该配方支持以下选项

url

包含Pound源代码的存档的URL。必须指定 url 或 svn。

svn

包含Pound源代码的子版本控制库的URL。必须指定 url 或 svn。

ssl_dir

OpenSSL主目录（默认：系统定义）。

t_rsa

RSA临时密钥重新生成的超时时间（默认：300秒）。

owner

已安装二进制文件所有者的名称（默认是启动buildout的用户）。

group

已安装二进制文件所属组的名称（默认是系统依赖的）。

extra-options

编译的额外选项

示例用法

我们将首先创建一个使用此配方的buildout

>>> write('buildout.cfg',
... """
... [buildout]
... parts = poundbuild
... index = http://pypi.python.org/pypi
...
... [poundbuild]
... recipe = plone.recipe.pound:build
... url = http://www.apsis.ch/pound/Pound-2.3.2.tgz
... """ )

运行buildout将给出

>>> print system(buildout)
Installing poundbuild.
poundbuild: compilation option : --with-owner=... --with-group=...
poundbuild: Downloading http://www.apsis.ch/pound/Pound-2.3.2.tgz
poundbuild: Unpacking and configuring
...

支持的选项

该配方支持以下选项

daemon - 守护进程 0|1

让Pound在前台运行（如果为0）或作为守护进程（如果为1）。默认情况下，Pound作为守护进程运行（从控制台断开并进入后台）。通过指定此选项，可以强制Pound像普通进程一样工作。这对于调试或希望使用类似daemontools的工具非常有用。

log_facility - 日志设施值

指定要使用的日志设施。值（默认：daemon）必须是syslog.h中定义的符号设施名称之一。此设施应用于日志记录。使用“-”作为设施名称将导致Pound将日志记录到stdout/stderr。

log_level - 日志级别值

指定日志记录级别：0表示无日志记录，1（默认）表示常规日志记录，2表示扩展日志记录（显示选定的后端服务器），3表示Apache-like格式（结合虚拟主机的日志格式），4（与3相同，但无虚拟主机信息）和5（与4相同，但包含关于服务和后端的信息）。此值可以针对特定监听器覆盖。

dynscale - 动态缩放值 0|1

启用或禁用动态缩放代码（默认：0）。如果启用，Pound将定期尝试修改后端优先级，以平衡来自各个后端的服务响应时间。此值可以针对特定服务覆盖。

alive - 存活值

指定Pound多久检查一次复活的后端主机（默认：30秒）。通常，将其设置为尽可能低是一个好主意——这将更快地找到复活的主机。但是，如果设置得太低，它将消耗资源——所以要注意。

client - 客户端值

指定Pound将等待客户端请求多长时间（默认：10秒）。如果在这么长时间内客户端没有发送任何数据，Pound将关闭连接。如果您的客户端在缓慢的网络或过载的服务器上超时，请将其设置得更高；如果开始遭受DOS攻击或遇到IE客户端的问题，请将其设置得更低。此值可以针对特定监听器覆盖。

timeout - 超时值

Pound应等待多久从后端获取响应（以秒为单位）。默认：15秒。

grace - 慈悲值

Pound在收到INT或HUP信号后继续回答现有连接多久（默认：30秒）。配置的监听器将立即关闭。您可以通过用TERM或QUIT信号停止Pound来绕过此行为，在这种情况下，程序将无延迟地退出。

balancers - 带后端的监听器列表

设置后端列表，默认列表为：名称地址:端口地址-backend-1:端口-backend-1(,优先级,超时) 地址-backend-2:端口-backend-2(,优先级,超时) … 地址-backend-n:端口-backend-n(,优先级,超时)

executable - 磅的路径，如果构建配方未提供磅可执行文件，则为必需

socket - 设置控制套接字路径。

sticky - 如果开启，则添加粘性会话配置（默认开启，可能值为on/off）

sessiontype - 粘性会话类型（默认COOKIE）

sessioncookie - 粘性会话cookie的名称（默认__ac）

sessiontimeout - 粘性会话超时时间（默认300）

poundctl-binary - 设置初始化脚本名称 poundrun-binary - 设置守护进程二进制名称 poundcontrol-binary - 设置磅控制器名称（它包装了磅的poundctl二进制文件）

示例用法

我们将首先创建一个使用此配方的buildout

>>> write('buildout.cfg',
... """
... [buildout]
... parts = configpound
...
... [configpound]
... recipe = plone.recipe.pound:config
... executable = /usr/sbin/pound
... balancers =
...    one  127.0.0.1:80 127.0.0.1:8080 127.0.0.1:8081,1
...    two  0.0.0.0:81 127.0.0.1:8082,1,120 127.0.0.1:8083 169.1.1.2:80
...
... """ )

运行buildout将给出

>>> print system(buildout)
Installing configpound.
<BLANKLINE>