nisserver(1M)

NAME

nisserver — 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+ 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

-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.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 (-r option). 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

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.

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

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

nisserver was developed by Sun Microsystems, Inc.

nisserver(1M)

Technical documentation

» Table of Contents

» Index