nisserver(1M)         Maintenance Commands          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 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 <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  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 <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.

     -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