1REALMINIT(1)          User Contributed Perl Documentation         REALMINIT(1)
2
3
4

NAME

6       realminit - Create new realm records for a DNSSEC-Tools realms file.
7

SYNOPSIS

9         realminit [options] <realm1> ... <realmN>
10

DESCRIPTION

12       realminit creates new realm entries for a realms file.  dtrealms
13       manages multiple distinct DNSSEC-Tools rollover environments running
14       simultaneously.  Each rollover environment, called a realm, is defined
15       in a realms file.  dtrealms uses this file to determine how to run the
16       rollover environment.  This is useful for such things as managing very
17       large collections of zones, segregating customer zones, and software
18       tests.
19
20       The newly generated realm entries are written to standard output,
21       unless the -out option is specified.
22
23       A realms file contains a number of entries, one for each managed realm.
24       A realm entry has this format:
25
26           realm "example"
27               state          "active"
28               configdir      "/usr/realms/configs/example"
29               statedir       "/usr/realms/states/example"
30               realmsdir      "/usr/realms/realms-files/example"
31               rollrec        "example.rrf"
32               administrator  "bob@cat.example.com"
33               display        "1"
34               manager        "rollerd"
35               args           "-display -loglevel phase"
36
37       Multiple realm entries may be created with a single execution of
38       realminit.  Except for the entry's name field, the entries will be
39       exactly the same unless the '=' metacharacter is used in the command-
40       line options.  If the values of the configdir, statedir, realmdir,
41       rollrec, administrator, args, or user options contain an '=', then it
42       will be replaced with the realm's name when building the entry.  See
43       the EXAMPLES section for examples of how options are used by realminit.
44

OPTIONS

46       realminit may be given the following options:
47
48       -active
49           This indicates that dtrealms should start the realm when dtrealms
50           starts.  realms are active by default.
51
52       -administrator
53           This is the email address for the realm's administrator.
54
55       -args
56           This is a set of command-line arguments passed to the realm's
57           rollover manager when the realm is started.
58
59       -configdir
60           This is the realm's configuration directory.  This will contain
61           such files as the DNSSEC-Tools configuration file for that realm.
62
63       -display
64           This indicates if the realm should be included in grandvizier
65           output.
66
67       -inactive
68           This indicates that dtrealms should not start the realm when
69           dtrealms starts.
70
71       -manager
72           This is the rollover manager for the realm.  rollerd is the default
73           rollover manager, but other managers may be used.
74
75       -out output-file
76           The new realm entries will be appended to output-file.  The file
77           will be created if it does not exist.
78
79           If this option is not given, the new rollrec entries will be
80           written to standard output.
81
82       -realmdir
83           This is the realm's data directory.  This directory is expected to
84           contain the rollrec file, zone files, keyrec files, and key files
85           for the zones in that realm.
86
87       -rollrec
88           This is the path to the realm's rollrec file.  This is used to
89           control rollover actions for the realm.  If it is not an absolute
90           path, it will be assumed to be relative to the realmdir field.
91
92       -statedir
93           This is the realm's state directory.  This will contain such files
94           as that realm's rollrec lock file and the rollerd communications
95           socket.  If the statedir is not defined for a realm, then the
96           realm's configdir is used for that value.
97
98       -user
99           This is the user that the realm is executed as.  (This is not yet
100           implemented in dtrealms.)
101
102       -help
103           Display a usage message.
104
105       -Version
106           Display version information for realminit and DNSSEC-Tools.
107

EXAMPLES

109       The following options should make clear how realminit deals with
110       options and the new realms.  Example 1 will show the complete new realm
111       record.  For the sake of brevity, the remaining examples will only show
112       the fields relevant to that example.  Further examples will also use
113       short-hand forms of the option names.
114
115   Example 1.  One realm, with -statedir
116       This example shows the realm generated by giving realminit a single
117       realm.
118
119           $ realminit -active -configdir /realms/confs/example -statedir /realms/states/example -realmdir /realms/realms/example -rollrec example.rrf -admin bob@cat.example.com -args "-loglevel phase -logfile logger" example
120
121           realm       "example"
122               state           "active"
123               configdir       "/realms/confs/example"
124               statedir        "/realms/states/example"
125               realmdir        "/realms/realms/example"
126               rollrec         "example.rrf"
127               administrator   "bob@cat.example.com"
128               display         "1"
129               manager         "rollerd"
130               args            "-loglevel phase -logfile logger"
131
132   Example 2.  One realm, without -statedir
133       This example shows the realm generated by giving realminit a single
134       realm.
135
136           $ realminit -active -configdir /realms/confs/example -realmdir /realms/realms/example -rollrec example.rrf -admin bob@cat.example.com -args "-loglevel phase -logfile logger" example
137
138           realm       "example"
139               state           "active"
140               configdir       "/realms/confs/example"
141               statedir        "/realms/confs/example"
142               ...
143
144   Example 3.  Two realms, without metacharacters
145       This example shows the realms generated by giving realminit two realms,
146       without using the special "=" metacharacter.
147
148           $ realminit -configdir /realms/confs/example -statedir /realms/states/example -realmdir /realms/realms/example -rollrec example.rrf -admin bob@cat.example.com example test
149
150           realm       "example"
151               configdir       "/realms/confs/example"
152               statedir        "/realms/states/example"
153               realmdir        "/realms/realms/example"
154               rollrec         "example.rrf"
155               administrator   "bob@cat.example.com"
156               ...
157
158           realm       "test"
159               configdir       "/realms/confs/example"
160               statedir        "/realms/states/example"
161               realmdir        "/realms/realms/example"
162               rollrec         "example.rrf"
163               administrator   "bob@cat.example.com"
164               ...
165
166   Example 4.  Two realms, with metacharacters
167       This example shows the realms generated by giving realminit two realms,
168       and that uses the special "=" metacharacter.
169
170           $ realminit -configdir /realms/confs/= -statedir /realms/states/= -realmdir /realms/realms/= -rollrec =.rrf -admin bob@cat.=.com example test
171
172           realm       "example"
173               configdir       "/realms/confs/example"
174               statedir        "/realms/states/example"
175               realmdir        "/realms/realms/example"
176               rollrec         "example.rrf"
177               administrator   "bob@cat.example.com"
178               ...
179
180           realm       "test"
181               configdir       "/realms/confs/test"
182               statedir        "/realms/states/test"
183               realmdir        "/realms/realms/test"
184               rollrec         "test.rrf"
185               administrator   "bob@cat.test.com"
186               ...
187
189       Copyright 2012-2014 SPARTA, Inc.  All rights reserved.  See the COPYING
190       file included with the DNSSEC-Tools package for details.
191

AUTHOR

193       Wayne Morrison, tewok@tislabs.com
194

SEE ALSO

196       lsrealm(1), dtrealms(8), realmchk(8)
197
198       Net::DNS::SEC::Tools::realm.pm(3),
199
200       file-realmrec.pm(5)
201
202
203
204perl v5.34.0                      2022-01-20                      REALMINIT(1)
Impressum