1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
<HTML><HEAD>
<TITLE>Configuration -- Configuration File Structure</TITLE>
<LINK rel=Previous href="con-ch1.htm">
<LINK rel=ToC href="toc.htm">
<LINK rel=Index href="master.htm">
<LINK rel=Next href="con-ch3.htm">
</HEAD><BODY BGCOLOR="#ffffff"><A NAME="topofpage"></A>
<TABLE WIDTH=100%>
<TR>
<TD ALIGN=LEFT>
<A NAME="topofpage"></A> <IMG SRC="as-c-sm.gif">
</TD>
<TD ALIGN=RIGHT>
<A href="con-ch1.htm"><IMG BORDER="0" src=navbprev.gif alt="[ Previous ]"></A>
<A href=toc.htm> <IMG BORDER="0" src=navbhome.gif alt="[ Contents ]"></A>
<A href=master.htm> <IMG BORDER="0" src=navbhelp.gif alt="[ Index ]"></A>
<A href="con-ch3.htm"> <IMG BORDER="0" src=navbnext.gif alt="[ Next ]"></A>
<A name="7983"> </A>
</TD>
</TR>
</TABLE>
<a name="120063">
</a><h3>Configuration File Structure</h3>
<p><a name="5888">
</a>This section describes the format of the configuration file and provides detailed information on individual AOLserver parameters.</p>
<p><a name="34940">
</a>The configuration file is normally the <code>nsd.tcl</code> file in the AOLserver home directory (the directory where AOLserver was installed). You must specify the configuration file when you start up AOLserver with the -c command line flag (see <a href="tech-ch1.htm#20993">page 5</a>).</p>
<p><a name="2309">
</a>The configuration file is a Tcl file that can be modified with a text editor such as <i>vi</i> or <i>emacs</i> on Unix. The file is made up of named sections with one or more parameters. Each section heading is of the form "ns/...". Each parameter is composed of a parameter name and a parameter value. The parameters of a section continue until a new section is defined or until the end of the file.</p>
<p><a name="120214">
</a>The <b>ns_section</b> and <b>ns_param</b> Tcl functions are used to define each section and the parameters for each section in the configuration file. The general format of the configuration file is as follows:</p>
<pre> <a name="120237"></a>ns_section "ns/..."
<a name="120240"></a>ns_param <i>param-name param-value
</i> <a name="120241"></a>...
</pre><p><p><a name="120242">
</a>Configuration file examples begin on <a href="con-ch4.htm#115417">page 79</a>. The default configuration file is shown on <a href="con-ch4.htm#115423">page 79</a>.</p>
<a name="69792">
</a><h4>Configuration File Hierarchy</h4>
<p><a name="69796">
</a>Although there are a large number of configurable parameters for AOLserver, most of them are not required. Also, the parameters are organized into a hierarchy branching off of the following main sections, letting you configure AOLserver at a global level, configure each server, and configure each database you will be accessing. This hierarchy of sections allows you maximum flexibility to provide exactly the capabilities you need on each server, including where pages will be stored and which databases will be accessible.</p>
<ul><li><b>Parameters:</b> This part of the configuration file contains parameters that apply to the AOLserver process:<a name="14416">
</a>
<p><ul>
<li><a href="con-ch3.htm#14541">ns/parameters</a> specifies parameters such as the AOLserver home directory.<a name="23774">
</a>
<p></ul>
<li><b>MIME Types:</b> This part of the configuration file lists global MIME types.<a name="87211">
</a>
<p><ul>
<li><a href="con-ch3.htm#87245">ns/mimetypes</a> maps file name extensions to content-type headers.<a name="87219">
</a>
<p></ul>
<li><b>Servers:</b> This part of the configuration file configures one or more servers, one of which that can be run within each AOLserver process. It is the top level in a hierarchy of sections for each server.<a name="14593">
</a>
<p><ul>
<li><b><a href="con-ch3.htm#7980"></b>ns/servers<b></a></b> lists and names all of the servers.<a name="23539">
</a>
<p><li><b><a href="con-ch3.htm#7987"></b>ns/server/server-name<b></a></b> configures an individual server.<a name="23570">
</a>
<p><li><b><a href="con-ch3.htm#75330"></b>ns/server/server-name/adp<b></a></b> configures AOLserver Dynamic Pages (ADPs) for the server.<a name="75054">
</a>
<p><li><a href="con-ch3.htm#157087">ns/server/server-name/adp/parsers</a> configures ADP parsers.<a name="157548">
</a>
<p><li><b><a href="con-ch3.htm#67160"></b>ns/server/server-name/db<b></a></b> configures database connections used by the server.<a name="68176">
</a>
<p><li><a href="con-ch3.htm#125264">ns/server/server-name/fastpath</a> configures fastpath serving of static files.<a name="127214">
</a>
<p><li><a href="con-ch3.htm#146964">ns/server/server-name/realms</a> configures logging realms for individual modules.<a name="146903">
</a>
<p><li><a href="con-ch3.htm#125010">ns/server/server-name/redirects</a> configures redirects.<a name="127219">
</a>
<p><li><b><a href="con-ch3.htm#67828"></b>ns/server/server-name/tcl<b></a></b> configures Tcl for the server.<a name="62582">
</a>
<p><li><b><a href="con-ch3.htm#10185"></b>ns/server/server-name/modules<b></a></b> lists the modules available to each server. <a name="23725">
</a>
<p><ul>
<li><b><a href="con-ch3.htm#120876"></b>ns/server/server-name/module/nscgi<b></a></b> configures CGI (Common Gateway Interface) for the server. See also the CGI interpreters and CGI environment configuration sections on <a href="con-ch2.htm#54159">page 48</a> for additional CGI configuration.<a name="74378">
</a>
<p><li><b><a href="con-ch3.htm#122605"></b>ns/server/server-name/module/nscp<b></a></b> configures the control port administration interface.<a name="127209">
</a>
<p><li><b><a href="con-ch3.htm#122701"></b>ns/server/server-name/module/nscp/users<b></a></b> configures the users allowed to access the control port administration interface.<a name="127659">
</a>
<p><li><b><a href="con-ch3.htm#74437"></b>ns/server/server-name/module/nslog<b></a></b> configures the access log module loaded into a server.<a name="120739">
</a>
<p><li><b><a href="con-ch3.htm#8758"></b>ns/server/server-name/module/nsperm<b></a></b> configures the permissions module loaded into a server.<a name="67095">
</a>
<p><li><b><a href="con-ch3.htm#85895"></b>ns/server/server-name/module/nssock<b></a></b> configures the sockets module loaded into a server.<a name="67075">
</a>
<p><li><b><a href="con-ch3.htm#126389"></b>ns/server/server-name/module/nsvhr<b></a></b> configures the virtual host redirection module loaded into a server.<a name="127224">
</a>
<p><li><b><a href="con-ch3.htm#126815"></b>ns/server/server-name/module/nsvhr/maps<b></a></b> configures virtual host redirection mappings.<a name="127229">
</a>
<p><li><a href="con-ch3.htm#156749">ns/server/server-name/module/nsunix</a> configures a UNIX domain socket driver.<a name="156742">
</a>
<p></ul>
</ul>
<li><b>Database Drivers and Pools:</b> This part of the configuration file configures the database drivers (the type of database you will be using) and the database pools (connections to the database).<a name="14635">
</a>
<p><ul>
<li><b><a href="con-ch3.htm#12449"></b>ns/db/drivers<b></a></b> lists the database drivers available to AOLserver. Currently internal database drivers are available for SOLID and Postgres. An external database driver is available for Sybase.<a name="62673">
</a>
<p><ul>
<li><b><a href="con-ch3.htm#66659"></b>ns/db/driver/extname<b></a></b> configures an external database driver.<a name="62706">
</a>
<p></ul>
<li><b><a href="con-ch3.htm#26401"></b>ns/db/pools<b></a></b> lists the database pools available to AOLserver.<a name="62678">
</a>
<p><ul>
<li><b><a href="con-ch3.htm#26424"></b>ns/db/pool/pool-name<b></a></b> configures a database pool, which determines the database to access and how many connections there will be to it.<a name="62679">
</a>
<p></ul>
</ul>
<li><b>CGI Interpreters</b>: This section allows you to configure the interpreters to execute for CGI scripts that end with certain file extensions. For example, you can configure the perl.exe interpreter to be invoked for all CGI's that end in .pl.<a name="54159">
</a>
<p><ul>
<li><b><a href="con-ch3.htm#68166"></b>ns/interps/interps-name<b></a></b> defines an interps section for CGI modules.<a name="54160">
</a>
<p></ul>
<li><b>CGI Environment</b>: This section allows you to configure environment variables in addition to the standard CGI environment variables for all CGI's or specific CGI interpreters.<a name="42115">
</a>
<p><ul>
<li><b><a href="con-ch3.htm#52785"></b>ns/environment/environment-name<b></a></b> defines an environment section for CGI modules.<a name="42116">
</a>
<p></ul>
<li><b>SGI IRIX Sproc-based Threads:</b> This section configures sproc-based threads on either IRIX 5.3 or 6.2 (not the pthread-based approach available on IRIX 6.2).<a name="71443">
</a>
<p><ul>
<li><b><a href="con-ch3.htm#71366"></b>ns/threads<b></a></b> configures sproc-based threads.<a name="155133">
</a>
<p></ul>
</ul><p><a name="155135">
</a>The parameters for each of the configuration file sections are described below. </p>
<TABLE BORDER="2" CELLPADDING="1" width="100%">
<TR><TD COLSPAN=3><P ALIGN=Center>
<IMG SRC="bluebult.gif">
<A HREF="#topofpage">
<FONT SIZE=-1>Top of Page</FONT></A>
<IMG SRC="bluebult.gif">
</TD></TR>
<TR><TD COLSPAN=3><P ALIGN=Center>
<A href="con-ch1.htm">
<IMG BORDER="0" src=navbprev.gif alt="[ Previous ]"></A>
<A href=toc.htm>
<IMG BORDER="0" src=navbhome.gif alt="[ Contents ]"></A>
<A href=master.htm>
<IMG BORDER="0" src=navbhelp.gif alt="[ Index ]"></A>
<A href="con-ch3.htm">
<IMG BORDER="0" src=navbnext.gif alt="[ Next ]"></A>
<BR align=center>
<FONT size=-1>Copyright © 1998-99 America Online,
Inc.</FONT>
</TD></TR></TABLE></BODY></HTML>
|
