migration(1M) — AMIX 2.01



migration(1M)     MISC. REFERENCE MANUAL PAGES      migration(1M)



NAME
     migration - move an archive  from  one  set  of  volumes  to
     another

SYNOPSIS
     migration -B [ -dlmotuvAENS ] bkjobid ofsname ofsdev ofslab descript

DESCRIPTION
     migration is invoked as a child process by  bkdaemon(1M)  to
     move an existing archive made by some other arbitrary method
     to a new set of volumes.  The existing  backup  history  log
     entry  of  the archive is updated to reflect the new volumes
     and destination information of the archive.  bkjobid is  the
     job  id  assigned  by backup(1M).  ofsdev is the name of the
     UNIX raw (character) device on which  the  archive  resides.
     ofslab is the volume label on the archive [see labelit(1M)].
     descript is a description for a destination  device  in  the
     form:

          dgroup:dname:dchar:dlabels

     dgroup specifies a device group.  dname specifies  a  device
     name.   dchars  specifies  characteristics for the specified
     device and group (see device.tab(4) for a  further  descrip-
     tion  of  device  characteristics).   dlabels  specifies the
     media names for the media to be used for the archive.

  Options
     d*        Do not update the backup history log entry for the
               archive.

     l*        Create a long form of the backup history log  that
               includes  a  table-of-contents  for  the  archive.
               This includes the data used to generate an ls  -l-
               like listing of each file in the archive.

     m*        Mount the originating filesystem read-only  before
               starting the backup and remount it with its origi-
               nal permissions after completing the backup.

     o         Permit  the  user  to  override  media   insertion
               requests (see getvol(1M) -o).

     t*        Create a table of contents for the backup on addi-
               tional media instead of in the backup history log.

     u*        Unmount the originating filesystem before perform-
               ing  the  backup  and remount it with its original
               permissions after completing the backup.

     v*        Validate the archive as it is written.  A checksum
               is  computed  as  the archive is being written; as



          Last change: System Administration Utilities          1



migration(1M)     MISC. REFERENCE MANUAL PAGES      migration(1M)



               each medium is completed, it is  re-read  and  the
               checksum  recomputed  to verify that each block is
               readable and correct.  If either check fails,  the
               medium  is  considered unreadable.  If -A has been
               specified, the archiving operation  fails;  other-
               wise,  the  operator  is  prompted  to replace the
               failed medium.

     A         Do not prompt the user for removable media  opera-
               tions (automated operation).

     E*        Report an estimate of media usage for the archive;
               then perform the backup.

     N*        Report an estimate of media usage for the archive;
               do not perform the backup.

     S*        Generate a period (.) for  every  100  (512  byte)
               blocks  read-from or written-to the archive on the
               destination device.

  User Interactions
     The connection between an archiving method and backup(1M) is
     more complex than a simple fork/exec or pipe.  backup(1M) is
     responsible for  all  interactions  with  the  user,  either
     directly,  or through bkoper(1M).  Therefore, migration nei-
     ther reads from standard-input nor writes to standard-output
     or  standard-error.  A method library must be used [see lib-
     brmeth(3)]  to  communicate  reports  (estimates,   periods,
     status, etc.) to backup(1M).

DIAGNOSTICS
     If migration successfully completes its task, it exits  with
     a  0  status.   If  any  of  the parameters to migration are
     invalid, it exits with a 1  status.   If  any  error  occurs
     which  causes  migration to fail to complete all portions of
     its task, it exits with a 2 status.  Errors are reported  if
     any of the following occur:

     1.   -t is specified together with -A.

     2.   -A is specified together with -o.

     3.   -t is specified and the  destination  device  does  not
          support removable media.

     4.   -A is specified and more than one removable  medium  is
          required.

     5.   Unrecoverable errors occurred  in  trying  to  read  or
          write the destination device.




          Last change: System Administration Utilities          2



migration(1M)     MISC. REFERENCE MANUAL PAGES      migration(1M)



     6.   -m is specified and the  originating  filesystem  could
          not be mounted read-only.

     7.   -m is specified and the  originating  filesystem  could
          not be unmounted.

     8.   -o is not specified and insufficient  media  names  are
          supplied in descript.

     9.   -u  is  specified  and  the  filesystem  could  not  be
          unmounted.

     10.  -u  is  specified  and  the  filesystem  could  not  be
          remounted.

FILES
     /usr/oam/bkrs/tables/bkhist.tab
     $TMP/filelist$$

SEE ALSO
     awk(1),  backup(1M),  device.tab(4),  getvol(1M),   grep(1),
     labelit(1M),  libbrmeth(3), ls(1), prtvtoc(1M), restore(1M),
     rsoper(1M), sed(1), time(2), urestore(1M).
































          Last change: System Administration Utilities          3

Museum

Related Articles