NAME

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

SYNOPSIS

       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

                                                   02/28/2012                              PEGASUS-SC-CONVERT(1)