renamefset(8) [osf1 man page]

renamefset(8)						      System Manager's Manual						     renamefset(8)

NAME

       renamefset - Rename an existing AdvFS fileset

SYNOPSIS

       /usr/sbin/renamefset domain oldfileset newfileset

OPERANDS

       Specifies  the name of an existing AdvFS file domain.  Specifies the name of a fileset in the domain.  Specifies the new name for the file-
       set.

DESCRIPTION

       The renamefset command assigns a new name to an existing fileset within an AdvFS file domain. Before renaming a fileset, unmount the  file-
       set and its clone fileset, if there is one.

       After renaming a fileset, update the corresponding entries in the /etc/fstab file to reflect the name change.

RESTRICTIONS

       Because clone filesets are read-only, they cannot be renamed.

       You must be the root user to use this command.

       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.

EXAMPLES

       The following example changes the name of the credit_fs fileset in the accounts_dmn file domain to new_credit_fs: # renamefset accounts_dmn
       credit_fs new_credit_fs

SEE ALSO

       Commands: chfsets(8), mkfdmn(8), mkfset(8), rmfset(8), showfsets(8)

       File Formats: advfs(4)

																     renamefset(8)

clonefset(8)						      System Manager's Manual						      clonefset(8)

NAME

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

SYNOPSIS

       /usr/sbin/clonefset domain fileset clonename

OPERANDS

       Specifies  the  name  of  an existing AdvFS file domain.  Specifies the name of the original fileset that the clonefset utility will clone.
       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  file-
       set, 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

       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.

       Do  not create a clone fileset if the available disk space for the file domain is less than 5 percent of the total. When a file 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 file  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 com-
       plete:  #  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: tar(1), showfdmn(8), vdump(8), vrestore(8)

       Functions: advfs_clonefset(3)

       File Formats: advfs(4)

																      clonefset(8)