nisserver - set up NIS+ servers
/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]
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. nisauthconf(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
Specifies the name for the NIS+ domain. The default
is your local domain.
-f Forces the NIS+ server setup without prompting for
Specifies the NIS+ group name for the new domain.
This option is not valid with -R option. The default
group is admin.<domain>.
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.
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 executed.
-R Sets up the specified host as a replica server. Make
sure that rpc.nisd is running on the new replica
-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
-Y Sets up a NIS+ server with NIS-compatibility mode.
The default is to set up the server without NIS-
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 permission to the parent direc-
tory 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.
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-
root_server# /usr/lib/nis/nisserver -M -d xyz.sun.com. -h sunxyz \
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
See attributes(5) for descriptions of the following attri-
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWcsu |
nis+(1), nisgrpadm(1), nismkdir(1), nisaddcred(1M),
nisauthconf(1M), nisclient (1M), nisinit(1M),
nispopulate(1M), nisprefadm(1M), nissetup(1M), rpc.nisd(1M),
NIS+ might not be supported in future releases of the
SolarisTM Operating Environment. Tools to aid the migration
from NIS+ to LDAP are available in the Solaris 9 operating
environment. For more information, visit
Man(1) output converted with