DDTSRELEASE(1)

     NAME
          ddtsrelease - make a copy of a customized ClearDDTS system
          for installation on another machine

     SYNOPSIS
          ddtsrelease [-c] destination

     DESCRIPTION
          Use ddtsrelease to create a copy of an existing system
          including all of its customizations so that it can be
          installed on another machine using the normal installation
          procedure.

          If the template files or state transition rules have been
          modified on your machine to better meet your organization's
          needs, you can use ddtsrelease to create a custom
          distribution tape for the rest of your organization.

          Be aware that none of the projects or any of the defect data
          is copied in the new release. This is because projects must
          be unique within the ClearDDTS network.

     OPTIONS
          -c    Tells ddtsrelease to use cpio(1) instead of tar(1) to
                copy ClearDDTS.  See BUGS below.

          destination
                The name of an existing (empty) directory where the
                custom release will be placed.  Once the custom
                release has been created, you can use tar(1) or some
                other archiving program to create a release tape that
                then can be used to install ClearDDTS on the other
                machines in your organization.

          It is assumed that the source of the copy is your current
          installation of ClearDDTS which is from ~ddts or from
          $DDTSHOME if it is set.

     EXAMPLE
          To create a release tape you could execute the following
          commands:

               mkdir newdir
               ddtsrelease newdir
               cd newdir
               tar cvf /dev/xxx .

          where /dev/xxx is the name of a magnetic tape device.

     WARNINGS
          The ddtsrelease utility should only be used to create a
          release tape for installation on a new machine.  It should
          not be used to upgrade an existing ClearDDTS system.

     BUGS
          On some early AT&T System V systems, the tar(1) utility may
          not work properly for moving directory hierarchies.  Because
          ddtsrelease uses tar(1) in this fashion, you may encounter
          this problem.  If tar(1) goes into an infinite loop and/or
          stops printing file names for more than a few seconds,
          interrupt it, remove the partially created release
          directory, and use the -c option to use cpio instead.

     SEE ALSO
          tar(1), cpio(1), ddtsinstall(1)