pegasus-sc-converter(1)
=======================
:doctype: manpage

Name
----
pegasus-sc-converter - A client to convert site catalog from one format to another format.


Synopsis
--------
[verse]
*pegasus-sc-converter* [*-v*] [*-V*] [*-h*] [*-Dproperty*='value'...] 
                     [*-I* 'fmt'] [*-O* 'fmt']
                     *-i* 'infile'[,'infile',...] *-o* 'outfile'


Description
-----------
The *pegasus-sc-converter* program is used to convert the site catalog 
from one format to another. 

Currently, the following formats of site catalog exist.

*Text*::
This is a easy to read  multiline textual format.
+
A sample entry in this format looks as follows
+
-----------------
site local{ 
  sysinfo "INTEL32::LINUX"
  gridlaunch "/nfs/software/pegasus/default/bin/kickstart"
  workdir "/scratch"
  gridftp "gsiftp://viz-login.isi.edu/scratch" "4.0.4"
  universe transfer "viz-login.isi.edu/jobmanager-fork" "4.0.4"
  universe vanilla "viz-login.isi.edu/jobmanager-pbs" "4.0.4"
  lrc "rlsn://smarty.isi.edu"
  profile  env "GLOBUS_LOCATION" "/nfs/software/globus/default"
  profile  env "LD_LIBRARY_PATH" "/nfs/software/globus/default/lib"
  profile  env "PEGASUS_HOME" "/nfs/software/pegasus/default"
}
------------------

*XML*::
This is equivalent to the *Text* format in XML. All information in the Text
format can be represented in the XMLS format and vice-a-versa.
+
A sample entry in this format looks as follows
+
---------------
<site handle="local" gridlaunch="/nfs/software/pegasus/default/bin/kickstart" sysinfo="INTEL32::LINUX">
  <profile namespace="env" key="GLOBUS_LOCATION" >/nfs/software/globus/default</profile>
  <profile namespace="env" key="LD_LIBRARY_PATH" >/nfs/software/globus/default/lib</profile>
  <profile namespace="env" key="PEGASUS_HOME" >/nfs/software/pegasus/default</profile>
  <lrc url="rlsn://smarty.isi.edu" />
  <gridftp  url="gsiftp://viz-login.isi.edu" storage="/scratch" major="4" minor="0" patch="4"> 
  </gridftp>
  <jobmanager universe="transfer" url="viz-login.isi.edu/jobmanager-fork" major="4" minor="0" patch="4" />
  <jobmanager universe="vanilla" url="viz-login.isi.edu/jobmanager-pbs" major="4" minor="0" patch="4" />
  <workdirectory >/scratch</workdirectory>
</site>
----------------
+
This format conforms to the  XML schema found at 
<http://pegasus.isi.edu/schema/sc-2.0.xsd>.

*XML3*::
This format is a superset of previous formats.  All information about a 
site that can be described about a site can be described in this format. 
In addition, the user has finer grained control over the specification 
of directories and FTP servers that are accessible at the *head node*
and the *worker node*.
+
A sample entry in this format looks as follows
+
----------------
<site  handle="local" arch="x86" os="LINUX">
  <grid  type="gt2" contact="viz-login.isi.edu/jobmanager-pbs" scheduler="PBS" jobtype="compute"/>
  <grid  type="gt2" contact="viz-login.isi.edu/jobmanager-fork" scheduler="Fork" jobtype="auxillary"/>
  <head-fs>
    <scratch>
      <shared>
        <file-server protocol="gsiftp" url="gsiftp://viz-login.isi.edu" mount-point="/scratch">
        </file-server>
        <internal-mount-point mount-point="/scratch" free-size="null" total-size="null"/>
      </shared>
    </scratch>
    <storage>
      <shared>
        <file-server protocol="gsiftp" url="gsiftp://viz-login.isi.edu" mount-point="/scratch">
        </file-server>
        <internal-mount-point mount-point="/scratch" free-size="null" total-size="null"/>
      </shared>
    </storage>
  </head-fs>
  <replica-catalog  type="LRC" url="rlsn://smarty.isi.edu">
  </replica-catalog>
  <profile namespace="env" key="GLOBUS_LOCATION" >/nfs/software/globus/default</profile>
  <profile namespace="env" key="LD_LIBRARY_PATH" >/nfs/software/globus/default/lib</profile>
  <profile namespace="env" key="PEGASUS_HOME" >/nfs/software/pegasus/default</profile>
</site>
----------------
+
This format conforms to the  XML schema found at 
<http://pegasus.isi.edu/schema/sc-3.0.xsd>.


Options
-------
*-i* 'infile'[,'infile',...]::
*--input* 'infile'[,'infile',...]::
The comma separated list of input files that need to be converted to a 
file in the format specified by *--oformat* option.

*-o* 'outfile'::
*--output* 'outfile'::
The output file to which the output needs to be written out to.


Other Options
~~~~~~~~~~~~~

*-I* 'fmt'::
*--iformat* 'fmt'::
The input format of the input files.
+
Valid values for the input format are *XML* and *Text*.

*-O* 'fmt'::
*--oformat* 'fmt'::
The output format of the output file.
+
Valid values for the output format is *XML3*.

*-v*::
*--verbose*::
Increases the verbosity of messages about what is going on.
+
By default, all FATAL ERROR, ERROR , WARNINGS and INFO messages are
logged.

*-V*::
*--version*::
Displays the current version number of the  Pegasus Workflow Planner
Software.

*-h*::
*--help*::
Displays all the options to the *pegasus-plan* command.


Example
-------
-------------
pegasus-sc-converter -i sites.xml -I XML -o sites.xml.new -O XML3 -vvvvv
-------------


Authors
-------
Karan Vahi `<vahi at isi dot edu>`

Gaurang Mehta `<gmehta at isi dot edu>`

Pegasus Team <http://pegasus.isi.edu>

