HASNAP(1M)

NAME

hasnap - backs up or restores a predefined and user defined list of VCS configuration files on each node in the cluster.

SYNOPSIS

hasnap -include -add | -del | -list [-sys hostname] files | directories

hasnap -exclude -add | -del | -list [-sys hostname] files | directories

hasnap -backup [-f filename] [-n] [-m description]

hasnap -delete [-s snapid] [-f filename]

hasnap -display [-f filename] [-list | -s snapid] [-m] [-l] [-t]

hasnap -export -f filename [-s snapid]

hasnap -fdiff [-f filename] [-s snapid] [-sys hostname] filename

hasnap -restore [-f filename] [-n] [-s snapid]

hasnap -sdiff [-f filename] [-s snapid] [-sys hostname]

hasnap -help [-backup | -restore | -display | -sdiff | -fdiff | -export | -include | -exclude | -delete ]

AVAILABILITY

VRTSvcs, VRTScutil.

DESCRIPTION

The hasnap command backs up and restores a predefined and user-defined list of VCS configuration files on each node in a cluster. Use the -backup option to back up files in a snapshot format. A snapshot consists of a collection of VCS configuration files backed up at a particular point in time, typically before making changes to the existing VCS configuration. A snapshot also contains information such as the snapshot name, description, creation time, and file permissions. With the exception of the -include, -exclude, and -delete options, all options can be combined with the -f switch. This switch indicates that all files be backed up or restored from the specified single file instead of a local, predefined directory, /var/VRTSvcs/hasnap/data, on each node. This option is useful when you want to store the configuration data to an alternate location that is periodically backed up using backup software like VERITAS Net Backup (TM).

OPTIONS

-include -add | -del | -list [-sys hostname] files | directories
  Configures the list of files or directories that need to be included in new snapshots, in addition to those included automatically by the -backup option. Please see help on the -backup option for the list of files automatically included for VCS. Options include: -add to add files or directories to the include file list; -del to delete files or directories from the include file list; -list to display the files or directories in the include file list; -sys to specify the system on which the include list is to be updated or displayed (all cluster systems by default). Use files or directories with -add or -del options only.
-exclude -add | -del | -list [-sys hostname] files | directories
  Configures the list of files or directories that should not be included in new snapshots when backing up configuration using the -backup option. Please see help on the -backup option for the list of files automatically included for VCS. Options include: -add to add files or directories to the exclude file list; -del to delete files or directories from the exclude file list; -list to display the files or directories in the exclude file list; -sys to specify the system on which the exclude list is to be updated or displayed (all cluster systems by default). Use files or directories with -add or -del options only.
-backup [-f filename] [-n] [-m description]
  Backs up a predefined and user-defined list of VCS configuration files. The predefined list includes all the *.cf files, custom agents, LLT and GAB configuration files, triggers, custom heartbeats, and action scripts. Please see the -include and -exclude options to construct a user-defined list. Use the -n option to specify that no user interaction is required. Use the -m option with the -n option to describe the snapshot. If -m is not used, the description of the snapshot is automatically assigned based on the cluster name. If -n is not used, users are prompted whether or not to dump the VCS configuration prior to backup (the default is "y"), whether or not to confirm each file to be backed up (the default is "n").
-delete [ -s snapid] [-f filename]
  Deletes previously created snapshots from the predefined local directory on each node. Options include: -s to specify a particular snapshot to be deleted, -f to specify a specific file. If not specified, users will be asked to select from a list of existing snapshots.
-display [-f filename] [-list | -s snapid] [-m] [-l] [-t]
  Shows the details of a snapshot. Options include: -f to specify the source of snapshot information; -list to display a list of all snapshots in the repository; -s to specify the snapid of a particular snapshot to be displayed; -m to show the description of the snapshot; -l to show the list of files in the snapshot; -t to show the time the snapshot was created. If no options are used with -display, the full information of the latest snapshot is shown.
-export -f filename [-s snapid]
  Exports a snapshot from the local, predefined directory to the specified file. The -s option specifies a specific snapshot to be exported. If -s option is not specified, the latest snapshot is exported.
-fdiff [-f filename] [-s snapid] [-sys hostname] filename
  Displays the exact differences between a file currently on the cluster and its copy stored in a previously created snapshot. Options include: -s to specify the ID of snapshot with which to compare; -sys to specify the system on which the specified file is to be compared. If no options are specified, the -fdiff option uses the latest snapshot to compare the specified file on all systems in the cluster.
-restore [-f filename] [-n] [-s snapid]
  Restores configuration files for the cluster from a previously created snapshot. VCS must not be online on the cluster when -restore option is used. Use the -n option to specify that no user interaction is required. The -s option specifies the ID of the snapshot to be restored, else the latest snapshot is restored. If neither the -n or -s option is specified, users are asked to select from a list of snapshots and to confirm each file restore.
-sdiff [-f filename] [-s snapid] [-sys hostname]
  Displays files that were changed on the cluster after a specific snapshot was created. Options include: -s to specify the snapshot with which to compare; -sys to specify the system on which the the snapshot is to be compared. If no options are specified, the -sdiff option uses the latest snapshot to compare to files on all systems in the cluster.
-help [-backup | -restore | -display | -sdiff | -fdiff | -export | -include | -exclude | -delete ]
  Displays usage for the hasnap command, or, the usage for a specified option.

FILES

/etc/hasnaptab

The file /etc/hasnaptab is the configuration file for the hasnap utility. Make sure that changes to this file are uniformly applied to all nodes of the cluster. You can use this file to change the data, work, and log directories of the hasnap command.

COPYRIGHTS

Copyright (c) 2016 Veritas.

All rights reserved.


VCS 7.1 HASNAP(1M)