nisserver(1M) System Administration Commands nisserver(1M)NAMEnisserver - set up NIS+ servers
SYNOPSIS
/usr/lib/nis/nisserver -r [-x] [-f] [-v] [-Y]
[-d NIS+_domain] [-g NIS+_groupname]
[-l network_passwd]
/usr/lib/nis/nisserver -M [-x] [-f] [-v] [-Y] -d NIS+_domain
[-g NIS+_groupname]
[-h NIS+_server_host]
/usr/lib/nis/nisserver -R [-x] [-f] [-v] [-Y]
[-d NIS+_domain] [-h NIS+_server_host]
DESCRIPTION
The nisserver shell script can be used to set up a root master, non-
root master, and replica NIS+ server with level 2 security (DES). If
other authentication mechanisms are configured with nisauthconf(1M),
nisserver will set up a NIS+ server using those mechanisms. nisauth‐
conf(1M) should be used before nisserver.
When setting up a new domain, this script creates the NIS+ directories
(including groups_dir and org_dir) and system table objects for the
domain specified. It does not populate the tables. nispopulate(1M) must
be used to populate the tables.
OPTIONS-d NIS+_domain Specifies the name for the NIS+ domain. The
default is your local domain.
-f Forces the NIS+ server setup without prompting
for confirmation.
-g NIS+_groupname Specifies the NIS+ group name for the new
domain. This option is not valid with -R option.
The default group is admin.<domain>.
-h NIS+_server_host Specifies the hostname for the NIS+ server. It
must be a valid host in the local domain. Use a
fully qualified hostname (for example,
hostx.xyz.sun.com.) to specify a host outside of
your local domain. This option is only used for
setting up non-root master or replica servers.
The default for non-root master server setup is
to use the same list of servers as the parent
domain. The default for replica server setup is
the local hostname.
-l network_password Specifies the network password with which to
create the credentials for the root master
server. This option is only used for master root
server setup (-r option). If this option is not
specified, the script prompts you for the login
password.
-M Sets up the specified host as a master server.
Make sure that rpc.nisd(1M) is running on the
new master server before this command is exe‐
cuted.
-R Sets up the specified host as a replica server.
Make sure that rpc.nisd is running on the new
replica server.
-r Sets up the server as a root master server. Use
the -R option to set up a root replica server.
-v Runs the script in verbose mode.
-x Turns the echo mode on. The script just prints
the commands that it would have executed. Note
that the commands are not actually executed. The
default is off.
-Y Sets up a NIS+ server with NIS-compatibility
mode. The default is to set up the server with‐
out NIS-compatibility mode.
USAGE
Use the first synopsis of the command (-r) to set up a root master
server. To run the command, you must be logged in as super-user on the
server machine.
Use the second synopsis of the command (-M) to set up a non-root master
server for the specified domain. To run the command, you must be logged
in as a NIS+ principal on a NIS+ machine and have write permission to
the parent directory of the domain that you are setting up. The new
non-root master server machine must already be an NIS+ client (see
nisclient(1M)) and have the rpc.nisd(1M) daemon running.
Use the third synopsis of the command (-R) to set up a replica server
for both root and non-root domains. To run the command, you must be
logged in as a NIS+ principal on a NIS+ machine and have write permis‐
sion to the parent directory of the domain that you are replicating.
The new non-root replica server machine must already be an NIS+ client
and have the rpc.nisd daemon running.
EXAMPLES
Example 1 Setting up Servers
To set up a root master server for domain sun.com.:
root_server# /usr/lib/nis/nisserver -r -d sun.com.
For the following examples make sure that the new servers are NIS+
clients and that rpc.nisd is running on these hosts before executing
nisserver. To set up a replica server for the sun.com. domain on host
sunreplica:
root_server# /usr/lib/nis/nisserver -R -d sun.com. -h sunrep
To set up a non-root master server for domain xyz.sun.com. on host
sunxyz with the NIS+ groupname as admin-mgr.xyz.sun.com.:
root_server# /usr/lib/nis/nisserver -M -d xyz.sun.com. -h sunxyz \
-g admin-mgr.xyz.sun.com.
To set up a non-root replica server for domain xyz.sun.com. on host
sunabc:
sunxyz# /usr/lib/nis/nisserver -R -d xyz.sun.com. -h sunabc
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWcsu │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSONIS+(1), nisgrpadm(1), nismkdir(1), nisaddcred(1M), nisauthconf(1M),
nisclient(1M), nisinit(1M), nispopulate(1M), nisprefadm(1M), nis‐
setup(1M), rpc.nisd(1M), attributes(5)NOTES
NIS+ might not be supported in future releases of the Solaris Operating
system. Tools to aid the migration from NIS+ to LDAP are available in
the current Solaris release. For more information, visit
http://www.sun.com/directory/nisplus/transition.html.
SunOS 5.10 13 Dec 2001 nisserver(1M)