AIX命令参考大全，卷 2，d - h

frcactrl 命令

用途

控制和配置 FRCA。

语法

frcactrl { load | unload }
frcactrl open Ip_Address Port [ Virtual_Host ] Server_Name Virtual_Root Log_File
frcactrl close Ip_Address Port [ Virtual_Host ]
frcactrl loadfile Ip_Address Port [ Virtual_Host ] Document_Root File ...
frcactrl stats [ reset ] [ Interval ]
frcactrl logging Ip_Address Port [Virtual_Host ] { on | off } [ Format ] [ CPU_Id ]
frcactrl { start | stop } Ip_Address Port [ Virtual_Host ]
frcactrl revaltimeout Ip_Address Port [ Virtual_Host ] [ Seconds ]
frcactrl pctonintr [ Percentage ]
frcactrl set { option=value }
frcactrl get
frcactrl default [ option ]

描述

frcactrl 命令控制和配置 FRCA 的内核扩充。在启动一个想使用 FRCA 的 Web 服务器之前，必须装入内核扩充。

子命令

load: 载入没有载入的 FRCA 内核扩充。
unload: 卸载已经载入了的 FRCA 内核扩充。
打开 Ip_Address Port [ Virtual_Host ] Server_Name Virtual_Root Log_File: 在名为 Server_Name、IP 地址为 Ip_Address、端口为 Port的情况打开和配置一个 FRCA 实例。Virtual_Root 参数指定 Web 数据启动的目录。请求将被记录在 Log_File 指定的文件中。这个文件名称必须是全限定的。
注:

FRCA 只支持一个记录文件。在一个带有 FRCA 的系统中运行超过一个的 Web 服务器时，所有的请求都会被记录到同一个文件中。
close Ip_Address Port [ Virtual_Host ]: 关闭与指定 IP 地址和端口相关联的 FRCA 实例。
loadfile Ip_Address Port [ Virtual_Host ] Document_Root File ...: 把指定的文件装入到 FRCA 或者网络的高速缓存器中。在这里必须指定 FRCA 实例较早打开所在的 IP 和端口号与根文档和要装载的文件。
stats [ reset ] [ Interval ]: 显示 FRCA 的统计信息。可选的 reset 子命令清除（置零）这些统计信息。您可以通过使用 Interval 参数来按秒指定间隔的持续时间，从而在规则的时间间隔中显示统计信息。
logging Ip_Address Port [ Virtual_Host ] { on | off } [ Format ] [ CPU_Id ]: 将一个 FRCA 实例范围服务的请求记录日志转到指定的 Ip_Address 和 Port 上。格式可以是 CLF、V-CLF，或者 ECLF 中的一种（通常的记录格式，虚拟主机的 CLF & 扩展的 CLF）。在多处理器机器上，FRCA 记录线程也能通过指定可选的 CPU_Id 参数绑定到一个特定的 CPU 上。
start Ip_Address Port [ Virtual_Host ]: 把内核获取引擎启用到发送往指定 IP 和端口的服务请求。
stop Ip_Address Port [ Virtual_Host ]: 对指定的 IP 和端口禁用内核获取引擎。
revaltimeout Ip_Address Port [ Virtual_Host ] [ Seconds ]: 对于在指定地址和端口的一个 FRCA 实例，改变重新生效的超时值。超时值必须以秒指定。
pctonintr [ Percentage ]: 控制能被在中断上下文花费的 CPU 时间百分比。如果这个值太低，那么 FRCA 将更多的把请求送到 Web 服务器上，因为它总是在中断上下文执行。任何 >= 100 的值都会导致 FRCA 对 FRCA 高速缓存的每个请求服务。
set {option=value}: 将指定的 FRCA 选项指定为该值。当前可用的唯一选项是 frca_hashsz，它将 FRCA 散列表中的插槽数设置为指定值。frca_hashsz 的缺省值是 12841。如果更改，使用的值必须为质数，因为这将使散列表项更平衡地分布。
get: 显示所有可用的 FRCA 选项及它们的当前值。当前仅存在名为 frca_hashsz 的选项。
default [option]: 当使用时不指定选项名称时，将所有选项的值设置为它们的缺省值。如果指定了选项名称，则它仅将指定选项的值设置为缺省值。

示例

下面的示例是关于使用 open 子命令的：
```
frcactrl open 9.1.1.1 80 ici imgcache01 /htdocs /logs/frca.log bin
```
```
frcactrl open 9.1.1.2 80 ici imgcache02 /htdocs /logs/frca.log bin
```
在上面的例子中，“ici”是虚拟主机的名字，它被用来访问镜像 imgcache01 或 imgcache02中的一个。如果 Web 服务器没有被绑定到一个指定的 IP 地址上的话，IP 地址可能就是 0.0.0.0。
为了关闭与 IP 地址 9.1.1.1 和端口 80 相关联的 FRCA 实例，请输入：
```
frcactrl close 9.1.1.1 80
```
为了用 URLs /d 和 /e 装入文件 /a/b/c/d 和 /a/b/c/e 的上下文，请输入：
```
frcactrl loadfile /a/b/c /a/b/c/d e
```

为了显示 FRCA 的统计信息，请输入：

frcactrl stats

这将导致 FRCA 统计信息被显示。它们看上去与下面的情况类似：

       总计     延迟        高速缓存       高速缓存    资源
    请求        请求            命中      未命中      错误
 -----------------------------------------------------------
  1024065396         227  1024065168           1           0

这个例子表明在虚拟主机“ici”上如何使用 start 子命令：
```
frcactrl start 9.1.1.1 80 ici
```
注:

虚拟主机参数是可选的。
为了能在虚拟主机“ici”上对端口 80 和 IP 地址 9.1.1.1 上禁用内核获取引擎，请输入：
```
frcactrl stop 9.1.1.1 80 ici
```
下面的例子把在端口 80 和 IP 地址 9.1.1.1 上的 FRCA 示例的重新生效超时值设置为 100 秒。
```
frcactrl revaltimeout 9.1.1.1 80 100
```
为了允许 CPU 把它 98％的时间用在中断上下文，请输入：
```
frcactrl pctonintr 98
```
要将 frca_hashsz 选项的值设置为 24499，请输入：
```
frcactrl set frca_hashsz=24499
```
要将 frca_hashsz 的值设置为缺省值，请输入：
```
frcactrl default frca_hashsz
```

文件

/usr/bin/frcactrl

[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]