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
|
<!-- $Id: install.xml,v 1.11 2004/01/23 10:26:57 sdalu Exp $ -->
<section>
<title>Requirement</title>
<itemizedlist>
<listitem>
<para>For the ZoneCheck core components:
<itemizedlist>
<listitem>
<para>Ruby (v. 1.8): <ulink url="http://www.ruby-lang.org/">http://www.ruby-lang.org/</ulink></para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para>For UTF-8 unaware terminal:
<itemizedlist>
<listitem>
<para>Ruby Iconv: <ulink url="http://raa.ruby-lang.org/list.rhtml?name=iconv">http://raa.ruby-lang.org/list.rhtml?name=iconv</ulink></para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para>For the GTK interface:
<itemizedlist>
<listitem>
<para>GTK2 libraries: <ulink url="http://www.gtk.org/">http://www.gtk.org/</ulink></para>
</listitem>
<listitem>
<para>Gnome2 ruby binding: <ulink url="http://ruby-gnome2.sourceforge.net/">http://ruby-gnome2.sourceforge.net/</ulink></para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para>For the CGI interface (other servers or clients can be used):
<itemizedlist>
<listitem>
<para>Apache2: <ulink url="http://httpd.apache.org/">http://httpd.apache.org/</ulink></para>
</listitem>
<listitem>
<para>Mozilla: <ulink url="http://www.mozilla.org/">http://www.mozilla.org/</ulink></para>
</listitem>
</itemizedlist>
</para>
</listitem>
</itemizedlist>
</section>
<section>
<title>Directory layout</title>
<screen>PREFIX
|-- bin
| `-- zonecheck # Command line
|-- etc
| `-- zonecheck # Configuration directory
| |-- zc.conf # Main configuration file
| |-- rootservers # List of the root servers (YAML file)
| |-- reverse.profile # Profile for checking reverse delegation
| |-- ... # ...
| `-- default.profile # Default set of rules to be used
|-- libexec
| `--zonecheck
| |-- cgi-bin
| | `-- zc.cgi # CGI
| |-- html # HTML directory (javascript, css, pics, ...)
| | |-- en # English version
| | |-- ... # ...
| | `-- fr # French version
| |-- locale # Localisation files
| |-- test # test set
| |-- lib # Extra libraries (NResolv, Address, ...)
| `-- zc # core component
`-- share
`-- doc
`-- zonecheck # Documentation</screen>
</section>
<section>
<title>CGI</title>
<para>Here is an exemple of
<ulink url="http://httpd.apache.org">Apache2</ulink> configuration file,
assuming ZoneCheck has been installed in
<filename class="directory">/usr/local</filename> (PREFIX=/usr/local)
and for html pages generated in the
<filename class="directory">/zc/</filename> namespace (HTML_PATH=/zc).
<screen>
AliasMatch ^/zonecheck/?$ /usr/local/libexec/zonecheck/www/html/form.html
AliasMatch ^/zonecheck/(en|fr)/?$ /usr/local/libexec/zonecheck/www/html/form.html.$1
AliasMatch ^/zonecheck/(en|fr)/(.*)$ /usr/local/libexec/zonecheck/www/html/$2.$1
ScriptAlias /zonecheck/cgi-bin/ /usr/local/libexec/zonecheck/cgi-bin/
Alias /zonecheck/js/ /usr/local/libexec/zonecheck/www/js/
Alias /zonecheck/style/ /usr/local/libexec/zonecheck/www/style/
Alias /zonecheck/img/ /usr/local/libexec/zonecheck/www/img/
Alias /zonecheck/ /usr/local/libexec/zonecheck/www/html/
<Directory /usr/local/libexec/zonecheck/cgi-bin/>
Options ExecCGI
</Directory>
<Directory /usr/local/libexec/zonecheck/www/>
Options Includes FollowSymLinks MultiViews
</Directory>
</screen>
</para>
</section>
<section>
<title>inetd</title>
<para>First you need to edit the file <filename>/etc/services</filename>,
which contains information regarding the known services
available in the Internet to add the following line:
<screen>
zonecheck 1904/tcp # ZoneCheck service
</screen>
You also need to configure <application>inetd</application>, so that
it is listening for the new zonecheck service, this is done by adding
the line:
<screen>
zonecheck stream tcp nowait root /usr/local/bin/zonecheck zonecheck --INPUT=inetd
</screen>
If you have an IPv6 stack installed but don't have the connectivity
with the outside world add the option <option>-4</option> to the
<command>zonecheck</command> command.
</para>
</section>
<!--
Local Variables:
mode: xml
sgml-declaration: "../chapter.decl"
sgml-indent-data: t
sgml-omittag: nil
sgml-always-quote-attributes: t
sgml-parent-document: ("../zc.xml" "part" "chapter")
End:
-->
|