.\" sncfginstall.8: auto-generated, DO NOT EDIT
.\"
.\" Copyright 2010-2014. Quantum Corporation. All Rights Reserved.
.\" StorNext is either a trademark or registered trademark of
.\" Quantum Corporation in the US and/or other countries.
.\"
.\" Code start macro
.de Cs
.sp
.ft C
.in +0.3i
.nf
..
.\" Code end macro
.de Ce
.fi
.in -0.3i
.ft R
..
.TH SNCFGINSTALL 8 "June 2014" "Xsan File System"
.SH NAME
sncfginstall \- Install Xsan Volume configuration file
.SH SYNOPSIS
.na
.nh
.HP
.B sncfginstall
.BI -n \ VolName
.BI -f \ config_file
.RB [ -M \ \fImsg_format\fP]
.HP
.B sncfginstall -h
.ad
.hy
.SH DESCRIPTION
The \fBsncfginstall\fR program will install a Xsan file system
configuration file into the proper location, after validating that it
is a valid config file, and comparing it against an already existing
config file for the named file system if one exists.
.PP
The input file need not have a .cfg or .cfgx suffix - the converter
will automatically figure out the format of the input file.
.SH OPTIONS
.IP \fB\-h\fR
Display usage.
.IP "\fB\-n \fIVolName\fR"
Required. The name of the file system whose config is to be installed.
.IP "\fB\-f \fIconfig_file\fR"
Specify the config file to install.
.IP "\fB\-M \fImsg_format\fR"
Specify \fIXML\fR if you want messages to come back in XML format.
This defaults to ASCII.
.SH EXIT VALUES
\fBsncfginstall\fR will return 0 on success and non-zero on failure.
.SH EXAMPLES
List usage:
.Cs
# sncfginstall -h
Usage: sncfginstall -f <config_path> -n <fs_name> [-M <fmt>]
  -f            Path to file to install
  -n            Name of file system to install
  -M            Message format: ASCII, XML (default ASCII)
  -h            This usage
.Ce
.PP
Install a config in a temporary location to the
Xsan configuration directory:
.Cs
# sncfginstall -n snfs1 -f /tmp/fs1.copy
\(aqsnfs1\(aq installed
.Ce
.SH FILES
.I /Library/Logs/Xsan/data/\fRVolName\fP/config_history/
.SH "SEE ALSO"
.BR snfs_config (5)