Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎

nisserver


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+ server with level 2
     security (DES). If other authentication mechanisms are  con-
     figured  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  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  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
     Solaris  Operating  system.  Tools to aid the migration from
     NIS+ to LDAP are available in the current  Solaris  release.
     For            more            information,            visit
     http://www.sun.com/directory/nisplus/transition.html.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments