Purpose
Controls and configures FRCA.
Syntax
frcactrl { load | unload }frcactrl open Ip_Address Port [ Virtual_Host ] Server_Name Virtual_Root Log_Filefrcactrl 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 getfrcactrl default [ option ]
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.
- set {option=value}
- Sets the specified FRCA option to the value. The only option currently
available is frca_hashsz which sets the number of slots in
the FRCA hash table to the specified value. The default value of frca_hashsz is 12841. If changed, the value used must be prime
as this results in a more even distribution of hash table entries.
- get
- Displays all FRCA options available along with their current values.
Only one option called frca_hashsz currently exists.
- default [option]
- Sets the value of all options to their default values when used
without specifying an option name. If an option name is specified
it sets only the value of the specified option to its default.
Security
Attention RBAC users and Trusted AIX users: This
command can perform privileged operations. Only privileged users can
run privileged operations. For more information about authorizations
and privileges, see Privileged Command Database in AIX® Version 7.1 Security. For a list
of privileges and the authorizations associated with this command,
see the lssecattr command or the getcmdattr subcommand.
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
- To set the value of the frca_hashsz option to 24499, type:
frcactrl set frca_hashsz=24499
- To set the value of frca_hashsz to its default, type:
frcactrl default frca_hashsz