'\" t
.\"     Title: globus-gram-audit
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03/31/2018
.\"    Manual: Grid Community Toolkit Manual
.\"    Source: Grid Community Toolkit 6
.\"  Language: English
.\"
.TH "GLOBUS\-GRAM\-AUDIT" "8" "03/31/2018" "Grid Community Toolkit 6" "Grid Community Toolkit Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
globus-gram-audit \- Load GRAM5 audit records into a database
.SH "SYNOPSIS"
.sp
\fBglobus\-gram\-audit\fR [ \-\-conf \fICONFIG\-FILE\fR ] [ \-\-create | \-\-update=\fIOLD\-VERSION\fR ] [ \-\-check ] [ \-\-delete ] [ \-\-audit\-directory=\fIAUDITDIR\fR ] [ \-\-quiet ]
.SH "DESCRIPTION"
.sp
The \fBglobus\-gram\-audit\fR program loads audit records to an SQL\-based database\&. It reads /etc/globus\-job\-manager\&.conf by default to determine the audit directory and then uploads all files in that directory that contain valid audit records to the database configured by the \fBglobus_gram_job_manager_auditing_setup_scripts\fR package\&. If the upload completes successfully, the audit files will be removed\&.
.sp
The full set of command\-line options to \fBglobus\-gram\-audit\fR consist of:
.PP
\fB\-\-conf \fR\fB\fICONFIG\-FILE\fR\fR
.RS 4
Use
\fICONFIG\-FILE\fR
instead of the default from the configuration file for audit database configuration\&.
.RE
.PP
\fB\-\-check\fR
.RS 4
Check whether the insertion of a record was successful by querying the database after inserting the records\&. This is used in tests\&.
.RE
.PP
\fB\-\-delete\fR
.RS 4
Delete audit records from the database right after inserting them\&. This is used in tests to avoid filling the databse with test records\&.
.RE
.PP
\fB\-\-audit\-directory \fR\fB\fIAUDITDIR\fR\fR
.RS 4
Look for audit records in
\fIAUDITDIR\fR, instead of looking in the directory specified in the job manager configuration\&. This is used in tests to control which records are loaded to the database and then deleted\&.
.RE
.PP
\fB\-\-query \fR\fB\fISQL\fR\fR
.RS 4
Perform the given SQL query on the audit database\&. This uses the database information from the configuration file to determine how to contact the database\&.
.RE
.PP
\fB\-\-quiet\fR
.RS 4
Reduce the amount of output for common operations\&.
.RE
.SH "FILES"
.sp
The \fBglobus\-gram\-audit\fR uses the following files:
.PP
\fB/etc/globus\-gram\-job\-manager\&.conf\fR
.RS 4
GRAM5 job manager configuration\&. It includes the default path to the audit directory
.RE
.PP
\fB/etc/globus\-gram\-audit\&.conf\fR
.RS 4
Audit configuration\&. It includes the information needed to contact the audit database\&.
.RE
.SH "AUTHOR"
.sp
Copyright \(co 1999\-2016 University of Chicago