sncfgtransform(8) sncfgtransform(8)
NAME
sncfgtransform - Check two Xsan Volume configuration files for a valid
transformation
SYNOPSIS
sncfgtransform [-h] -n VolName caller file1 file2
DESCRIPTION
The sncfgtransform program will validate the transformation between two
Xsan file system configuration files for the given "caller" and file
system.
The valid caller values are:
fsm The transform is checked for a file system manager (fsm)
restart. This is the usual transform that administrators are
looking for since a change in the config file is usually fol-
lowed by a file system restart.
cvupdatefs
The transform is checked for a run of the cvupdatefs command.
This can be used when adding a stripe group or for stripe group
expansion.
updatefs
Same as cvupdatefs.
cvfsck The transform is checked for a run of cvfsck.
dbg The transform is checked for the cvfsdb command.
cvmkfs The transform is checked for the cvmkfs command.
cvmkfsr
The transform is checked for the cvmkfs command with the -r op-
tion which means that the file system meta data is being re-
stored from a database created because the restore journal was
configured.
Two configurations files must be given and the transformation is as-
sumed to be from file1 to file2.
Each configuration file is parsed and may fail. If they both succeed
parsing, the transformation is checked with any errors being displayed.
OPTIONS
-h Display usage.
-n VolName
Required. The name of the file system whose config files are
given.
EXIT VALUES
sncfgtransform will return 0 on success and non-zero on failure.
EXAMPLES
List usage:
# sncfgtransform -h
Usage: sncfgtransform [-h] -n <fsname> <caller> <file1> <file2>
-h This usage
-n Name of file system to validate
caller
fsm
cvfsck
cvmkfs
cvmkfsr
dbg
cvntfscfg
snadmin
cvupdatefs
updatefs
file1 file being changed
file2 new file transforming config too
Check a new config file under consideration for snfs1 with a copy in
/tmp (OK):
# sncfgtransform -n snfs1 fsm /tmp/snfs1.cfgx /tmp/snfs1.new.cfgx
'snfs1' transformation OK
Check a new config file under consideration for cvupdatefs of snfs1
(OK):
# sncfgtransform -n snfs1 updatefs /tmp/snfs1.cfgx /tmp/snfs1.new.cfgx
'snfs1' transformation OK
Check a modified config against the installed config (with a valid
change for cvupdatefs))
# sncfgtransform -n snfs1 updatefs /Library/Preferences/Xsan/snfs1.cfgx /tmp/cfgx
'snfs1' transformation OK
Check a modified config against the installed config (with an invalid
change)
# sncfgtransform -n snfs1 fsm /tmp/snfs1.cfgx /tmp/snfs1.new.cfgx
transformation failed for /tmp/snfs1.cfgx -> /tmp/snfs1.new.cfgx with -1
transformation for /tmp/snfs1.cfgx -> /tmp/snfs1.new.cfgx -- error: Stripe group metadata field changed at index 2 - mkfs required
SEE ALSO
snfs_config(5), sncfgvalidate(1)
Xsan File System June 2014 sncfgtransform(8)
Mac OS X 10.12.3 - Generated Fri Feb 10 08:25:44 CST 2017