1nca(1) User Commands nca(1)
2
3
4
6 nca, snca - the Solaris Network Cache and Accelerator (NCA)
7
9 The Solaris Network Cache and Accelerator ("NCA") is a kernel module
10 designed to provide improved web server performance. The kernel module,
11 ncakmod, services HTTP requests. To improve the performance of servic‐
12 ing HTTP requests, the NCA kernel module maintains an in-kernel cache
13 of web pages. If the NCA kernel module cannot service the request
14 itself, it passes the request to the http daemon (httpd). It uses
15 either a sockets interface, with family type designated PF_NCA, or a
16 private Solaris doors interface that is based on the Solaris doors RPC
17 mechanism, to pass the request.
18
19
20 To use the sockets interface, the web server must open a socket of fam‐
21 ily type PF_NCA. The PF_NCA family supports only SOCK_STREAM and proto‐
22 col 0, otherwise an error occurs.
23
24
25 The following features are not presently supported:
26
27 o You cannot initiate a connection from a PF_NCA type socket.
28 The connect(3SOCKET) interface on PF_NCA fails.
29
30 o System calls that are associated with type SO_DGRAM, such as
31 send(), sendto(), sendmsg(), recv(), recvfrom(), and
32 recvmsg(), fails.
33
34 o You cannot set TCP or IP options on a PF_NCA type socket
35 through setsockopt(3SOCKET).
36
37
38 The NCA cache consistency is maintained by honoring HTTP headers that
39 deal with a given content type and expiration date, much the same way
40 as a proxy cache.
41
42
43 For configuration information, see System Administration Guide: IP Ser‐
44 vices
45
46
47 When native PF_NCA socket support does not exist in the web server, the
48 ncad_addr(4) interface must be used to provide NCA support in that web
49 server.
50
51
52 NCA is intended to be run on a dedicated web server. Running other
53 large processes while running NCA might cause undesirable behavior.
54
55
56 NCA supports the logging of in-kernel cache hits. See ncalogd.conf(4).
57 NCA stores logs in a binary format. Use the ncab2clf(1) utility to con‐
58 vert the log from a binary format to the Common Log File format.
59
61 /etc/nca/ncakmod.conf Lists configuration parameters for NCA.
62
63
64 /etc/nca/ncalogd.conf Lists configuration parameters for NCA log‐
65 ging.
66
67
68 /etc/nca/nca.if Lists the physical interfaces on which NCA
69 runs.
70
71
72 /etc/nca/ncaport.conf ncaport configuration file
73
74
75 /etc/hostname.{}{0-9} Lists all physical interfaces configured on
76 the server.
77
78
79 /etc/hosts Lists all host names associated with the
80 server. Entries in this file must match with
81 entries in /etc/hostname.{}{0-9} for NCA to
82 function.
83
84
86 See attributes(5) for descriptions of the following attributes:
87
88
89
90
91 ┌─────────────────────────────┬─────────────────────────────┐
92 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
93 ├─────────────────────────────┼─────────────────────────────┤
94 │Availability │SUNWncar (32-bit) │
95 ├─────────────────────────────┼─────────────────────────────┤
96 │ │SUNWncarx (64-bit) │
97 ├─────────────────────────────┼─────────────────────────────┤
98 │Interface Stability │Committed │
99 └─────────────────────────────┴─────────────────────────────┘
100
102 ncab2clf(1), ncakmod(1), close(2), read(2), write(2), sendfilev(3EXT),
103 accept(3SOCKET), bind(3SOCKET), connect(3SOCKET), door_bind(3C),
104 door_call(3C), door_create(3C), getsockopt(3SOCKET), listen(3SOCKET),
105 setsockopt(3SOCKET), shutdown(3SOCKET), socket.h(3HEAD),
106 socket(3SOCKET), ncad_addr(4), nca.if(4), ncakmod.conf(4), nca‐
107 port.conf(4), ncalogd.conf(4), attributes(5)
108
109
110 System Administration Guide: IP Services
111
112
113
114SunOS 5.11 22 Feb 2005 nca(1)