1nisserver(1M) System Administration Commands nisserver(1M)
2
3
4
6 nisserver - set up NIS+ servers
7
9 /usr/lib/nis/nisserver -r [-x] [-f] [-v] [-Y]
10 [-d NIS+_domain] [-g NIS+_groupname]
11 [-l network_passwd]
12
13
14 /usr/lib/nis/nisserver -M [-x] [-f] [-v] [-Y] -d NIS+_domain
15 [-g NIS+_groupname]
16 [-h NIS+_server_host]
17
18
19 /usr/lib/nis/nisserver -R [-x] [-f] [-v] [-Y]
20 [-d NIS+_domain] [-h NIS+_server_host]
21
22
24 The nisserver shell script can be used to set up a root master, non-
25 root master, and replica NIS+ server with level 2 security (DES). If
26 other authentication mechanisms are configured with nisauthconf(1M),
27 nisserver will set up a NIS+ server using those mechanisms. nisauth‐
28 conf(1M) should be used before nisserver.
29
30
31 When setting up a new domain, this script creates the NIS+ directories
32 (including groups_dir and org_dir) and system table objects for the
33 domain specified. It does not populate the tables. nispopulate(1M) must
34 be used to populate the tables.
35
37 -d NIS+_domain Specifies the name for the NIS+ domain. The
38 default is your local domain.
39
40
41 -f Forces the NIS+ server setup without prompting
42 for confirmation.
43
44
45 -g NIS+_groupname Specifies the NIS+ group name for the new
46 domain. This option is not valid with -R option.
47 The default group is admin.<domain>.
48
49
50 -h NIS+_server_host Specifies the hostname for the NIS+ server. It
51 must be a valid host in the local domain. Use a
52 fully qualified hostname (for example,
53 hostx.xyz.sun.com.) to specify a host outside of
54 your local domain. This option is only used for
55 setting up non-root master or replica servers.
56 The default for non-root master server setup is
57 to use the same list of servers as the parent
58 domain. The default for replica server setup is
59 the local hostname.
60
61
62 -l network_password Specifies the network password with which to
63 create the credentials for the root master
64 server. This option is only used for master root
65 server setup (-r option). If this option is not
66 specified, the script prompts you for the login
67 password.
68
69
70 -M Sets up the specified host as a master server.
71 Make sure that rpc.nisd(1M) is running on the
72 new master server before this command is exe‐
73 cuted.
74
75
76 -R Sets up the specified host as a replica server.
77 Make sure that rpc.nisd is running on the new
78 replica server.
79
80
81 -r Sets up the server as a root master server. Use
82 the -R option to set up a root replica server.
83
84
85 -v Runs the script in verbose mode.
86
87
88 -x Turns the echo mode on. The script just prints
89 the commands that it would have executed. Note
90 that the commands are not actually executed. The
91 default is off.
92
93
94 -Y Sets up a NIS+ server with NIS-compatibility
95 mode. The default is to set up the server with‐
96 out NIS-compatibility mode.
97
98
100 Use the first synopsis of the command (-r) to set up a root master
101 server. To run the command, you must be logged in as super-user on the
102 server machine.
103
104
105 Use the second synopsis of the command (-M) to set up a non-root master
106 server for the specified domain. To run the command, you must be logged
107 in as a NIS+ principal on a NIS+ machine and have write permission to
108 the parent directory of the domain that you are setting up. The new
109 non-root master server machine must already be an NIS+ client (see
110 nisclient(1M)) and have the rpc.nisd(1M) daemon running.
111
112
113 Use the third synopsis of the command (-R) to set up a replica server
114 for both root and non-root domains. To run the command, you must be
115 logged in as a NIS+ principal on a NIS+ machine and have write permis‐
116 sion to the parent directory of the domain that you are replicating.
117 The new non-root replica server machine must already be an NIS+ client
118 and have the rpc.nisd daemon running.
119
121 Example 1 Setting up Servers
122
123
124 To set up a root master server for domain sun.com.:
125
126
127 root_server# /usr/lib/nis/nisserver -r -d sun.com.
128
129
130
131
132 For the following examples make sure that the new servers are NIS+
133 clients and that rpc.nisd is running on these hosts before executing
134 nisserver. To set up a replica server for the sun.com. domain on host
135 sunreplica:
136
137
138 root_server# /usr/lib/nis/nisserver -R -d sun.com. -h sunrep
139
140
141
142
143 To set up a non-root master server for domain xyz.sun.com. on host
144 sunxyz with the NIS+ groupname as admin-mgr.xyz.sun.com.:
145
146
147 root_server# /usr/lib/nis/nisserver -M -d xyz.sun.com. -h sunxyz \
148 -g admin-mgr.xyz.sun.com.
149
150
151
152
153 To set up a non-root replica server for domain xyz.sun.com. on host
154 sunabc:
155
156
157 sunxyz# /usr/lib/nis/nisserver -R -d xyz.sun.com. -h sunabc
158
159
160
162 See attributes(5) for descriptions of the following attributes:
163
164
165
166
167 ┌─────────────────────────────┬─────────────────────────────┐
168 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
169 ├─────────────────────────────┼─────────────────────────────┤
170 │Availability │SUNWcsu │
171 └─────────────────────────────┴─────────────────────────────┘
172
174 NIS+[22m(1), nisgrpadm(1), nismkdir(1), nisaddcred(1M), nisauthconf(1M),
175 nisclient(1M), nisinit(1M), nispopulate(1M), nisprefadm(1M), nis‐
176 setup(1M), rpc.nisd(1M), attributes(5)
177
179 NIS+ might not be supported in future releases of the Solaris Operating
180 system. Tools to aid the migration from NIS+ to LDAP are available in
181 the current Solaris release. For more information, visit
182 http://www.sun.com/directory/nisplus/transition.html.
183
184
185
186SunOS 5.11 13 Dec 2001 nisserver(1M)