Index Index for
Section 8
Index Alphabetical
listing for C
Bottom of page Bottom of
page		 

clonefset(8)


NAME

  clonefset - Creates a read-only copy of an AdvFS fileset.


SYNOPSIS

  /usr/sbin/clonefset domain fileset clonename


OPERANDS

  domain
      Specifies the name of an existing AdvFS domain.

  fileset
      Specifies the name of the original fileset that the clonefset utility
      will clone.

  clonename
      Specifies the name of the read-only fileset created by the clonefset
      utility.


DESCRIPTION

  The clonefset utility enables you to perform online backups of active files
  by making a read-only copy (clone) of an active fileset. Once you create
  and mount a clone fileset, you can back up the clone using the vdump
  command or other supported backup utility (the dump command is not
  supported by AdvFS). Note that the clonefset utility only clones AdvFS
  filesets; it does not clone UFS file systems.

  A clone fileset is a read-only snapshot of fileset data structures
  (metadata).  When you clone a fileset, the utility copies only the
  structure of the original fileset, not its data. When you modify files in
  the original fileset, the file system copies the original pages to the
  clone fileset. In this way, the clone fileset contents remain the same as
  when you first created it.

  You can create new versions of a clone fileset, but you can maintain only
  one clone per fileset at a time. You cannot rename a clone fileset, but
  there is a workaround. You can remove an existing clone fileset (and all
  its files) by using the rmfset command, then create a new one with the new
  name.


RESTRICTIONS

  You must be root user to clone an AdvFS fileset.

  Each fileset within a domain must have a unique name of up to 31
  characters.  All whitespace characters (tab, new line, space, and so forth)
  and the / # : * ? characters are invalid for fileset names.

  The clonefset command cannot be used on filesets enabled for the Data
  Management Application Programming Interface (DMAPI), since domains of
  DAMPI-enabled file systems are limited to one fileset only.  See the AdvFS
  Administration for more information about DMAPI.

  Do not create a clone fileset if the available disk space for the domain is
  less than 5 percent of the total. When a domain runs out of disk space, the
  file system loses its ability to maintain the consistency of files within
  clone filesets. When the file system can no longer maintain consistency, it
  displays warning messages similar to the following on the user's terminal
  and to the console:

       WARNING: advfs cannot copy-on-write data to a clone file.
       WARNING: encountered the following error: ENO_MORE_BLKS (-1040)
       WARNING: do not continue using the clone fileset.
       WARNING: original file set: name=mnt, id=2c06a73f.00027192.00000001.8001
       WARNING: clone file set: name=clone, id=2c06a73f.00027192.00000002.8002
       WARNING: file id = 0000000a.8002

  This message also appears in the
  /var/adm/syslog.dated/latest_boot_date/kern.log file.


EXAMPLES

  The following example creates a read-only copy of the credit_fs fileset
  that resides in the accounts_dmn domain.  The clone fileset name in this
  example is credit_clone1.  This example also performs an online backup and
  removes the clone fileset after the backup is complete:

       # mkdir /mnt/credit_clone1
       # clonefset accounts_dmn credit_fs credit_clone1
       # mount -t advfs account_dmn#credit_clone1 /mnt/credit_clone1
       # vdump /mnt/credit_clone1
       # umount /mnt/credit_clone1
       # rmfset account_dmn credit_clone1


SEE ALSO

  Commands: rmfset(8), tar(1), showfdmn(8), vdump(8), vrestore(8)

  Functions: advfs_clonefset(3)

  File Formats: advfs(4)

Index Index for
Section 8
Index Alphabetical
listing for C
Top of page Top of
page