PEGASUS-SC-CONVERT(1)													     PEGASUS-SC-CONVERT(1)

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

								    05/24/2012						     PEGASUS-SC-CONVERT(1)