systemtape(1M)                   DG/UX 5.4.2                  systemtape(1M)


NAME
       systemtape - build a bootable DG/UX system tape

SYNOPSIS
       systemtape [ -f tapedevice ] [ -r rootfilesystem ] [ -u
       usrfilesystem ] [ -n packagename ]

DESCRIPTION
       The systemtape command builds a bootable DG/UX (Trademark) system
       tape using the values of rootfilesystem and usrfilesystem.  This
       command copies all file and directories from the rootfilesystem and
       the usrfilesystem to the tapedevice in a format that can later be
       read by diskman(1M), sysadm(1M), or admpackage(1M).

       Options are:

       -f tapedevice
              This option indicates which tape device to use during this
              process.  The default value is "/dev/rmt/0".

       -r rootfilesystem
              The option specifies the root file system to be placed on the
              tape.  The default is "/".

       -u usrfilesystem
              The option specifies the usr file system to be placed on the
              tape.  The default is "/usr".

       -n packagename
              This option indicates what to name the tape image(s).  The
              default is "dgux".

DIAGNOSTICS
       systemtape exits with a value of 0 if the system tape is successfully
       created.  If the command is unable to access the tape device or read
       the requested files, the exit value is 1.

SEE ALSO
       diskman(1M), sysadm(1M), and admpackage(1M).

NOTES
       This command must be run by root in order to build the tape
       correctly.  In addition, the designated root and usr file systems
       must be readable by root.

       Before invoking systemtape, you must ensure that the correct file
       systems are mounted and that all unwanted file systems have been
       unmounted.

       Files that are owned by users and groups not found in the local
       passwd(4) and group(4) databases will cause a warning message to be
       generated when the tape is unloaded.

       The target machines' root file system block size must be larger than



Licensed material--property of copyright holder(s)                         1

systemtape(1M)                   DG/UX 5.4.2                  systemtape(1M)


       the source machines' root file system.  The formula to use is:

              target_root_size = 3.6 * source_root_size

              where the the sizes are given in 512 byte blocks.

       The target machines' root file system may be downsized after loading
       by booting the stand-alone diskman, /usr/stand/diskman, and shrinking
       the root file system.
















































Licensed material--property of copyright holder(s)                         2