'\" t
.\"     Title: pegasus-sc-client
.\"    Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 11/09/2018
.\"    Manual: Pegasus Manual
.\"    Source: Pegasus 4.4.0
.\"  Language: English
.\"
.TH "PEGASUS\-SC\-CLIENT" "1" "11/09/2018" "Pegasus 4\&.4\&.0" "Pegasus 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"
pegasus-sc-client \- generates a site catalog by querying sources\&.
.SH "SYNOPSIS"
.sp
.nf
\fBpegasus\-sc\-client\fR [\fB\-D\fR\fIproperty=value\fR\&...]
                  [\fB\-\-source\fR \fIsrc\fR]
                  [\fB\-g\fR|\fB\-\-grid\fR \fIgrid\fR]
                  [\fB\-o\fR|\fB\-\-vo\fR \fIvo\fR]
                  [\fB\-s\fR|\fB\-\-sc\fR \fIscfile\fR]
                  [\fB\-p\fR|\fB\-\-properties\fR \fIpropfile\fR]
                  [\fB\-V\fR|\fB\-\-version\fR]
                  [\fB\-v\fR|\fB\-\-verbose\fR]
                  [\fB\-h\fR|\fB\-\-help\fR]
.fi
.SH "DESCRIPTION"
.sp
\fBpegasus\-sc\-client\fR generates site catalog by querying sources like OSGMM, MYSOG, etc\&.
.SH "OPTIONS"
.PP
\fB\-D\fR\fIproperty=value\fR
.RS 4
The
\fB\-D\fR
option allows an experienced user to override certain properties which influence the program execution, among them the default location of the user\(cqs properties file and the
\fBPEGASUS_HOME\fR
location\&. One may set several CLI properties by giving this option multiple times\&.
.sp
The
\fB\-D\fR
option(s) must be the first option on the command line\&. CLI properties take precedence over the file\-based properties of the same key\&.
.RE
.PP
\fB\-\-source\fR \fIsrc\fR
.RS 4
the source to query for site information\&. Valid sources are: OSGMM
.RE
.PP
\fB\-g\fR \fIgrid\fR, \fB\-\-grid\fR \fIgrid\fR
.RS 4
the grid for which to generate the site catalog information\&.
.RE
.PP
\fB\-o\fR \fIvo\fR, \fB\-\-vo\fR \fIvo\fR
.RS 4
The Virtual Organization (VO) to which the user belongs\&. The default VO is LIGO\&. The collector host should be set by default unless overridden by the property
\fBpegasus\&.catalog\&.site\&.osgmm\&.collector\&.host\fR
according to the following rules:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
if VO is ligo then collector host queried is ligo\-osgmm\&.renci\&.org
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
if VO is engage then collector host queried is engage\-central\&.renci\&.org
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
for any other VO, engage\-central\&.renci\&.org will be queried and in all the paths the name of the engage VO will be replaced with the name of the VO passed\&. e\&.g if user specifies the VO to be
\fBcigi\fR,
\fBengage\fR
will be replaced by
\fBcigi\fR
in the directory paths\&.
.RE
.RE
.PP
\fB\-s\fR \fIscfile\fR, \fB\-\-sc\fR \fIscfile\fR
.RS 4
The path to the created site catalog file
.RE
.PP
\fB\-p\fR \fIpropfile\fR, \fB\-\-properties\fR \fIpropfile\fR
.RS 4
Generate a Pegasus properties file containing the SRM properties\&. The properties file is created only if
\fB\-\-source\fR
is set to
\fIOSGMM\fR\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
Increases the verbosity of messages about what is going on\&.
.RE
.PP
\fB\-V\fR, \fB\-\-version\fR
.RS 4
Displays the current version of Pegasus\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Displays all the options to the
\fBpegasus\-sc\-client\fR
command\&.
.RE
.SH "EXAMPLE"
.sp
Runs \fBpegasus\-sc\-client\fR and generates the site catalog:
.sp
.if n \{\
.RS 4
.\}
.nf
$ pegasus\-sc\-client \-\-source OSGMM \-\-sc osg\-sites\&.xml \-\-vo LIGO \-\-grid OSG
.fi
.if n \{\
.RE
.\}
.SH "AUTHORS"
.sp
Prasanth Thomas
.sp
Pegasus Team \m[blue]\fBhttp://pegasus\&.isi\&.edu\fR\m[]