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+ 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
tables.
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.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 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
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
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 a NIS+ server with NIS-compatibility mode.
The default is to set up the server without NIS-
compatibility mode.
USAGE
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.
EXAMPLES
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-
mgr.xyz.sun.com.:
root_server# /usr/lib/nis/nisserver -M -d xyz.sun.com. -h sunxyz \
-g admin-mgr.xyz.sun.com.
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
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
SEE ALSO
nis+(1), nisgrpadm(1), nismkdir(1), nisaddcred(1M),
nisauthconf(1M), nisclient (1M), nisinit(1M),
nispopulate(1M), nisprefadm(1M), nissetup(1M), rpc.nisd(1M),
attributes(5)
NOTES
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
http://www.sun.com/directory/nisplus/transition.html.
Man(1) output converted with
man2html