File: INSTALL

package info (click to toggle)
dnssec-tools 1.13-1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 16,064 kB
  • sloc: perl: 44,399; ansic: 31,547; cpp: 21,306; sh: 15,813; xml: 2,113; makefile: 1,390; pascal: 836; python: 290; csh: 11
file content (153 lines) | stat: -rw-r--r-- 5,723 bytes parent folder | download
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

			     DNSSEC-Tools
			Is your domain secure?


TABLE OF CONTENTS
=================

  Table Of Contents
  Instructions
  Patching Other Applications (mozilla, sendmail, libspf, ...)
  Gnu CONFIGURE Instructions

INSTRUCTIONS
==================

  1) Get and install the following required perl modules:

      Net::DNS
      Net::DNS::SEC

     These can be easily done via the perl CPAN shell.  For example:

     # perl -MCPAN -e shell
       [...]

     cpan>  install Net::DNS
       [ CPAN will start the install process and hopefully install it ]

     cpan>  install Net::DNS::SEC
       [...]
       [... optionally continue with other perl modules in step 2 below ...]

  2) Install the optional software and perl modules

      Software needed if you want to sign zones using zonesigner:
         bind 9.3.1 or later.  ( http://www.isc.org/sw/bind/ )
	 openssl and its development libraries ( http://www.openssl.org )

      Extra perl modules needed for various tools:
         Text::Wrap
         Date::Parse
         ExtUtils::MakeMaker
         MailTools
         Test::Builder
         String::Diff

      Software for displaying zone maps, tcpdump traces, validator traces:
         graphviz                  [ http://www.graphviz.org/ ]

      Perl modules needed for displaying zone maps:
         GraphViz

      Perl modules (optional) that provides a GUI interface to some tools:
         Gtk2
         QWizard
         Getopt::GUI::Long
         Perl Tk

      Perl module needed for running tests:
         Text::Diff


  3) Run ./configure
     (type "./configure --help" for a quick usage summary.)
     (--prefix=PATH will change the default /usr/local installation path.)
     (--without-validator will turn off the C-code library and
      applications if they're not needed or don't compile and you
      still want to install the rest of the useful scripts)

  4) make

p  5) make install                 [as root]

  6) install the logwatch extensions for parsing DNSSEC related
     reports from syslog messages (note: these patches are included in
     recent versions of logwatch, so you only need to enable them)
 
        See tools/logwatch/README

  7) If you want to use automatic dynamic DNS securely on linux
     systems, see the tools/linux/ifup-dyn-dns/README file.

  8) Before using zonesigner and other DNSSEC-Tools commands, the dtinitconf
     script should be run.  This will create a new configuration file that
     will be used by the DNSSEC-Tools programs.  It is also a good idea to
     read the README and INFO files in the dnssec-tools/tools/scripts
     directory, as well as the man pages for the commands you wish to use.

PATCHING OTHER APPLICATIONS
=============================================

Patches for the other applications can be found in the apps
directory.  See the apps/README file for details on those applications
and patches.


GNU CONFIGURE INSTRUCTIONS
=============================================

The `configure' shell script attempts to guess correct values for
various system-dependent variables used during compilation.  It uses
those values to create a `Makefile' in each directory of the package.
It may also create one or more `.h' files containing system-dependent
definitions.  Finally, it creates a shell script `config.status' that
you can run in the future to recreate the current configuration, a file
`config.cache' that saves the results of its tests to speed up
reconfiguring, a file `config.log' containing compiler output
(useful mainly for debugging `configure') and a file `configure-summary'
containing the summary displayed at the end of the `configure' run.

As the `configure' invocation often gets lengthy and difficult to
type or if you have several different ways you want to configure a
system, you may want to create a shell script containing your invocation.

If you need to do unusual things to compile the package, please try
to figure out how `configure' could check whether to do them, and mail
diffs or instructions to the address given in the `README' so they can
be considered for the next release.  If at some point `config.cache'
contains results you don't want to keep, you may remove or edit it.

The file `configure.in' is used to create `configure' by a program
called `autoconf'.  You only need `configure.in' if you want to change
it or regenerate `configure' using a newer version of `autoconf'.

The simplest way to compile this package is:

  1. `cd' to the directory containing the package's source code and type
     `./configure' to configure the package for your system.  If you're
     using `csh' on an old version of System V, you might need to type
     `sh ./configure' instead to prevent `csh' from trying to execute
     `configure' itself.

     Running `configure' takes awhile.  While running, it prints some
     messages telling which features it is checking for.  When it
     completes it prints a short message (also available in configure-summary)
     indicating what functionality will be available when compiled.

  2. Type `make' to compile the package.

  3. Type `make install' to install the programs and any data files and
     documentation.

  4. You can remove the program binaries and object files from the
     source code directory by typing `make clean'.  To also remove the
     files that `configure' created (so you can compile the package for
     a different kind of computer), type `make distclean'.

There may be additional installation issues discussed in the 
README's for various platforms such as README.solaris.

# Copyright 2004-2012 SPARTA, Inc.  All rights reserved.
# See the COPYING file included with the DNSSEC-Tools package for details.