nisserver(1M) Maintenance Commands nisserver(1M)
NAME
nisserver - set up NIS+ servers.
SYNOPSIS
/usr/lib/nis/nisserver -r [-x] [-f] [ -v][-Y]
[-d ] [-g < NIS+_groupname>]
[-l ]
/usr/lib/nis/nisserver -M [-x] [-f] [ -v] [-Y]
-d  [-g ]
[-h ]
/usr/lib/nis/nisserver -R [-x] [-f] [ -v] [-Y]
[-d ] [-h ]
DESCRIPTION
The nisserver shell script can be used to set up a root mas-
ter, non-root master, and replica NIS+ servers with level 2
security (DES).
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 popu-
late the tables. You will need to use nispopulate(1M) to
populate the tables.
Use the first synopsis (-r) to set up a root master server.
You must be logged in as super-user on the server machine.
Use the second synopsis (-M) to set up a non-root master
server for the specified domain. You must be logged in as an
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
daemon running (see rpc.nisd(1M)).
Use the third synopsis (-R) to set up a replica server for
both root and non-root domains. You must be logged in as an
NIS+ principal on an NIS+ machine and have write permission
to the parent directory of the domain that you are replicat-
ing. The new non-root replica server machine must already be
an NIS+ client (see nisclient(1M)) and have the rpc.nisd
daemon running (see rpc.nisd(1M)).
OPTIONS
- d  specifies the name for the NIS+
domain. The default is your local
domain.
-f forces the NIS+ server setup without
prompting for confirmation.
-g  specifies the NIS+ group name for the
new domain. This option is not valid
with -R option. The default group is
admin..
-h  specifies the hostname for the NIS+
server. It must be a valid host in
the local domain. Use a fully quali-
fied 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  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 will prompt
you for the login password.
-M sets up the specified host as a mas-
ter 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(1M) 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 an NIS+ server with NIS-
compatibility mode. The default is to
set up the server without NIS-
compatibility mode.
EXAMPLES
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 rpc.nisd is running on these hosts
before executing nisserver.
To set up a replica server for domain sun.com. on host sun-
replica :
root_server# /usr/lib/nis/nisserver -R -d sun.com. \
-h sunreplica
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.
SunOS 5.4 Last change: 01 Jun 1993