.\" disk_license.1: auto-generated, DO NOT EDIT
.\"
.\" Copyright 2014-2018. 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 DISK_LICENSE 1 "October 2018" "Xsan File System"
.SH NAME
disk_license \- Disk License Tool
.SH SYNOPSIS
.na
.nh
.HP
.B disk_license
.RB [ \-hHqrsvX ]
.RB [ \-d n ] [ \-f \fIfilename\fP ] [ \-H ] [ \-F \fIformat\fP ]
.HP
.B disk_license
.RB [ \-i \fIdiskcatalog\fP ]
.ad
.hy
.SH DESCRIPTION
\fBdisk_license\fR is used to interrogate disk drives, StorNext
disk licenses and the Quantum Disk Catalog.
It can report current disk licensing status and create reports
for manually requesting disk licenses on an MDC.
.PP
All the disks in all of an MDC's
file systems are categorized into Quantum Branded, Quantum Certified,
and Uncertified (all other) as defined in
the quantum_disk_catalog.dat database.
.PP
The Disk Usage licenses are free, but aid Quantum support
in understanding the usage and requirements of a site.
.SH OPTIONS
.IP "\fB-c\fP \fI<filename>\fP"
Use catalog
.I <filename>
instead of the default disk-license-request report file.
.IP "\fB-C\fP"
Only print the Disk Catalog to standard out.
.IP "\fB-d\fP \fI<n>\fP"
Print additional details on a per\-file\-system basis.
Larger values for \fI<n>\fP yield more details, up to a point.
.IP "\fB-f\fP \fI<filename>\fP"
Send reports to the file \fI<filename>\fP.
.IP "\fB-F\fP \fIformat\fP"
Print the output in format \fI<format>\fP.
Supported formats are: \fIascii\fP, \fIxml\fP, and \fIjson\fP.
.IP \fB-h\fR
Print the command's usage message and quit.
.IP \fB-H\fR
Display capacity values in human readable, terabyte values
(only for ASCII format).
.IP \fB-q\fR
Quiet mode.
Suppress status messages to standard out.
.IP "\fB-R\fP \fI<filename>\fP"
Input a Disk License Request report from
.IR <filename> .
This option is not available on some platforms.
.IP \fB-r\fR
Print a Disk License Request report to standard out.
.IP \fB-s\fR
Print a Disk Usage Summary report to standard out.
.IP \fB-u\fR
Update the XML file specified with the \fB-R\fR option to the
current version and format.
.IP \fB-v\fR
Print additional internal details as the command
collects the information to categorize the MDC's disks.
Additional \fBv\fP options increase the amount of detail.
.IP \fB-X\fR
Update the default Disk License Request file.
When Disk Usage is over licensed capacity,
create a periodic RAS message.
.IP "\fB-i\fP \fIdiskcatalog\fP"
Import the specified disk catalog when it has
a newer generation number than the currently installed disk catalog.
.SH FILES
.I /Library/Preferences/Xsan/quantum_disk_catalog.dat
.br
.I /Library/Preferences/Xsan/license.dat
.br
.I /Library/Preferences/Xsan/*.cfg
.sp
Default Disk License Request report file:
.br
.I /Library/Logs/Xsan/debug/quantum_disk_license_report.xml
.br
.SH "SEE ALSO"