nisserver(1M) nisserver(1M)
NAME [Toc] [Back]
nisserver - set up NIS+ servers.
SYNOPSIS [Toc] [Back]
/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 [Toc] [Back]
The nisserver shell script can be used to set up a root master, nonroot
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 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 create 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 create permission to the parent directory of
the domain that you are replicating. The new replica server machine
must already be an NIS+ client (see nisclient(1M)) and have the
rpc.nisd daemon running (see rpc.nisd(1M)).
Options [Toc] [Back]
-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.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
nisserver(1M) nisserver(1M)
-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.hp.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 (-roption). If this option is
not specified, the script will prompt you for
the login password.
-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.
-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(1M) is running on the
new replica server.
-Y sets up an NIS+ server with NIS-compatibility
mode. The default is to set up the server
without NIS-compatibility mode.
EXAMPLES [Toc] [Back]
To set up a root master server for domain hp.com. :
root_server# /usr/lib/nis/nisserver -r -d hp.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.
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
nisserver(1M) nisserver(1M)
To set up a replica server for domain hp.com. on host hpreplica :
root_server# /usr/lib/nis/nisserver -R -d hp.com. -h hpreplica
To set up a non-root master server for domain xyz.hp.com. on host
hpxyz with the NIS+ groupname as admin-mgr.xyz.hp.com. :
root_server# /usr/lib/nis/nisserver -M -d xyz.hp.com. \
-h hpxyz -g admin-mgr.xyz.hp.com.
To set up a non-root replica server for domain xyz.hp.com. on host
hpabc:
hpxyz# /usr/lib/nis/nisserver -R -d xyz.hp.com. -h hpabc
WARNINGS [Toc] [Back]
HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is
supported.
LDAP is the recommended replacement for NIS+. HP fully supports the
industry standard naming services based on LDAP.
AUTHOR [Toc] [Back]
nisserver was developed by Sun Microsystems, Inc.
SEE ALSO [Toc] [Back]
nis+(1), nisgrpadm(1), nismkdir(1), nisaddcred(1M), nisclient(1M),
nisinit(1M), nismkdir(1), nispopulate(1M), nissetup(1M), rpc.nisd(1M).
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003 [ Back ] |