[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 2
frcactrl Command
Purpose
Controls and configures FRCA
Syntax
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 ]
Description
The frcactrl command controls and configures the
FRCA kernel extension. The kernel extension must be loaded before starting
any Web servers that want to use FRCA.
Subcommands
- load
- Loads the FRCA kernel extension if not loaded.
- unload
- Unloads the FRCA kernel extension if loaded.
- open Ip_Address Port [ Virtual_Host ] Server_Name Virtual_Root
Log_File
- Opens and configures an FRCA instance under the name Server_Name for IP address Ip_Address on port Port. The Virtual_Root parameter
specifies the directory where the Web data starts. The requests will be logged
in the file specified by Log_File. This filename must
be fully qualified.
Note
FRCA only supports one log file. When running
more than one Web server on a system with FRCA, all requests will be logged
to the same file.
- close Ip_Address Port
[ Virtual_Host ]
- Closes the FRCA instance associated with the specified IP address and
port.
- loadfile Ip_Address Port [ Virtual_Host ] Document_Root
File ...
- Loads the specified file(s) into the FRCA / Network Buffer Cache. The
IP and Port number at which the FRCA instance has been opened earlier must
be specified here along with the document root and the file(s) to be loaded.
- stats [ reset ] [ Interval ]
- Displays FRCA statistics. The optional reset subcommand
clears (zeros) the statistics. You can display the statistics at a regular
interval by specifying the duration of the interval in seconds with the Interval parameter.
- logging Ip_Address Port
[ Virtual_Host ] { on | off } [ Format ] [ CPU_Id ]
- Turns logging of request served by an FRCA instance bound to the specified Ip_Address and Port on or off.
The format can be one of CLF, V-CLF, or ECLF (Common Log Format, Virtual Host &
CLF, Extended CLF). The FRCA logging thread can also be bound to a particular
CPU by specifying the optional CPU_Id parameter on
multiprocessor machines.
- start Ip_Address Port
[ Virtual_Host ]
- Enables the kernel get engine to serve requests sent to the specified
IP and port.
- stop Ip_Address Port [ Virtual_Host ]
- Disables the kernel get engine for the specified IP and port.
- revaltimeout Ip_Address
Port [ Virtual_Host ] [ Seconds ]
- Changes the revalidation timeout value for an FRCA instance at the specified
address and port. The timeout value must be specified in seconds.
- pctonintr [ Percentage ]
- Controls the percentage of CPU time that can be spent in interrupt context.
If this value is too low then FRCA will send requests up to Web server more
often since it always executes in interrupt context. Any value >= 100 will
result in FRCA serving every request that is cached in the FRCA cache.
Examples
- The following are examples of using the open subcommand:
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
In
the above examples "ici" is the virtual host name which could be used to access
one of the mirrors imgcache01 or imgcache02. The IP address may be 0.0.0.0
if the Web server is not bound to a specific IP address.
- To close the FRCA instance associated with IP address 9.1.1.1 and port
80, type:
frcactrl close 9.1.1.1 80
- To load the content of files /a/b/c/d and /a/b/c/e with URLs /d and /e,
type:
frcactrl loadfile /a/b/c /a/b/c/d e
- To display the FRCA statistics, type:
frcactrl stats
This will cause the FRCA statistics to be displayed. They will look
similar to this:
Total Deferred Cache Cache Resource
Requests Requests Hits Misses Errors
-----------------------------------------------------------
1024065396 227 1024065168 1 0
- This examples shows how to use the start subcommand
for virtual host "ici":
frcactrl start 9.1.1.1 80 ici
Note
The virtual host parameter is optional.
- To disable the kernel get engine for port 80 on IP address 9.1.1.1 on
virtual host "ici", type:
frcactrl stop 9.1.1.1 80 ici
- The following example sets the revalidation timeout value for the FRCA
instance at port 80 of IP address 9.1.1.1 to 100 seconds:
frcactrl revaltimeout 9.1.1.1 80 100
- To allow the CPU to spend 98 percent of its time in interrupt context,
type:
frcactrl pctonintr 98
Files
/usr/bin/frcactrl
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]