Manual page for nisserver(1M)
nisserver - set up NIS+ servers.
/usr/lib/nis/nisserver -r [-x] [-f] [
/usr/lib/nis/nisserver -M [-x] [-f] [
/usr/lib/nis/nisserver -R [-x] [-f] [
shell script can be used to set up
a root master, 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 populate the tables. You will need to use
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
and have the
daemon running (see
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 replicating. The new non-root
replica server machine must already be an NIS+ client (see
and have the
daemon running (see
- -d <NIS+_domain>
specifies the name for the NIS+ domain. The default is your
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
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
- -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 will prompt you for the login password.
sets up the specified host as a master server.
Make sure that
is running on the new master server
before this command is executed.
sets up the specified host as a replica server. Make sure that
is running on the new replica server.
sets up the server as a root master server. Use the -R option
to set up a root replica server.
runs the script in verbose mode.
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.
sets up an NIS+ server with NIS-compatibility mode. The default
is to set up the server without NIS-compatibility mode.
To set up a root master server for domain
root_server# /usr/lib/nis/nisserver -r -d sun.com.
For the following examples make sure that
the new servers
are NIS+ clients and
is running on these hosts
To set up a replica server for domain
root_server# /usr/lib/nis/nisserver -R -d sun.com. -h sunrep
To set up a non-root master server for domain
with the NIS+ groupname as
root_server# /usr/lib/nis/nisserver -M -d xyz.sun.com. -h sunxyz \
To set up a non-root replica server for domain
sunxyz# /usr/lib/nis/nisserver -R -d xyz.sun.com. -h sunabc
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97