nisrestore(1M)




NAME

     nisrestore - restore NIS+ directory backup


SYNOPSIS

     nisrestore [-fv] backup-dir directory...

     nisrestore [-fv] -a backup-dir

     nisrestore -t backup-dir


DESCRIPTION

     nisrestore restores an existing backup of a  NIS+  directory
     object  that  was created using  nisbackup(1M). The  backup-
     dir is the UNIX directory that contains the NIS+  backup  on
     the  server  being  restored. The  nisrestore command can be
     used to restore a NIS+ directory object or a complete   NIS+
     database.  It  also  can  be  used  as an "out of band" fast
     replication  for a new replica server being initialized. The
     rpc.nisd(1M)  daemon  must be stopped before running  nisre-
     store.

     The first synopsis is used to  restore  a  single  directory
     object  or a specified list of directory objects. The direc-
     tory can be partially  qualified  or  fully  qualified.  The
     server  being  restored will be verified against the list of
     servers serving the directory. If this server is not config-
     ured  to  serve  this  object,  nisrestore will exit with an
     error. The  -f option will override this check and force the
     operation.

     The second  synopsis  will  restore  all  of  the  directory
     objects contained in the  backup-dir. Again, the server will
     be validated against the serving list for each of the direc-
     tory  objects  in  the  backup-dir. If one of the objects in
     the backup-dir are not served by  this  server,   nisrestore
     will  exit  with an error. The  -f option will override this
     check and force the operation.

     The  -a option will attempt to restore all NIS+ objects con-
     tained  in  the  backup-dir. If any of these objects are not
     served by the server,  nisrestore will exit with  an  error.
     If  the   backup-dir contains objects that are not served by
     the server,  nisrestore must be  executed  without  the   -a
     option and the specific directory objects listed.

     The  -f option will disable verification of the server being
     configured  to serve the objects being restored. This option
     should be used with care, as  data  could  be  inadvertently
     restored  to  a server that doesn't serve the restored data.
     This option is required in the case of  restoring  a  single
     server  domain  (master  server  only)  or if the other NIS+
     servers are unavailable for NIS+ lookups.
     The combination of options  -f and  -a should be  used  with
     caution,  as  no  validation  of  the  server  serving   the
     restored objects will be done.

     New replicas can be quickly added to a  namespace  with  the
     nisrestore command. The steps are as follows.

     Configure  the  new  replica  on  the  master  server   (see
     nisserver(1M)):

     master# nisserver -R -h replica

     Kill the  rpc.nisd server process on the new replica server:

     replica# kill rpc.nisd-pid

     Create a backup of the NIS+ database on  the  master,  which
     will    include    the    new   replica   information.   See
     nisbackup(1M). The  /backup will need to be exported to  the
     new replica. See  share_nfs(1M).

     master# nisbackup -a /backup

     Restore the backup of the NIS+ database on the new  replica.
     Use  the  -f  option  if  nisrestore is unable to lookup the
     NIS+ objects being restored. The backup should  be available
     through nfs or similar means. See  share_nfs(1M).

     replica# nisrestore -f -a //nfs-mnt/backup

     Restart the  rpc.nisd(1M) process on the  new  replica,  and
     the server will immediately be available for service.


OPTIONS

     -a    Restores  all  directory  objects  included   in   the
           backup-dir partition.

     -f    Forces the restoration  of  a  directory  without  the
           validation  of  the   server in the directory object's
           serving list.

     -t    Lists all directory objects contained in  backup-dir.

     -v    Verbose option. Additional  output  will  be  produced
           upon execution of  the command.


OPERANDS

     backup-dir
           The UNIX directory that contains the  data  files  for
           the NIS+ directory objects to be restored.

     directory
           The NIS+ directory object(s) to be restored. This  can
           be a fully or partially qualified name.


EXAMPLES

     Example 1: Restoring  the  Directory  Object  on  a  Replica
     Server from a Local UFS Partition

     To restore the   org_dir  directory  object  of  the  domain
     foo.com on a replica server from a local ufs partition named
     /var/backup:

     replica_server# nisrestore /var/backup org_dir.foo.com.

     Example 2: Forcing the Restore of a Backed up NIS+ Namespace
     to a Replica Server From the Backup Partition

     To force the restore of an entire backed up  NIS+  namespace
     to   a  replica  server  from  the  backup  partition  named
     /var/backup:

     replica_server# nisrestore -f -a /var/backup

     Example 3: Restoring the Subdomain on a Master Server From a
     Backup that Includes Other Directory Objects

     To restore the subdomain  sub.foo.com on  a  master  server,
     from a backup that includes other directory objects:

     master_server# nisrestore /var/backup sub.foo.com. \
       org_dir.sub.foo.com. groups_dir.sub.foo.com.


EXIT STATUS

     0     Successful completion.

     1     An error occurred.


FILES

     /backup-dir/backup_list
           This ASCII file contains a list  of  all  the  objects
           contained  in this  backup-dir directory.  This infor-
           mation can be displayed with the  -t option.

     /backup-dir/directory-object
           A subdirectory that  is  created  in  the   backup-dir
           which contains the directory-object backup.

     /backup-dir/directory-object/data
           A subdirectory that contains the data files  that  are
           part of the directory-object backup.

     /backup-dir/directory-object/last.upd
           This data file contains  timestamp  information  about
           the directory-object.

     /backup-dir/directory-object/data.dict
           A NIS+ data dictionary for all  of  the  objects  con-
           tained in this  directory-object backup.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |        ATTRIBUTE VALUE      |
    |_____________________________|_____________________________|
    | Availability                | SUNWnisu                    |
    |_____________________________|_____________________________|


SEE ALSO

     nis+(1),   nisdefaults(1),   nisbackup(1M),   nisserver(1M),
     rpc.nisd(1M), share_nfs( 1M), nisfiles(4), 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