Application Description Document

Writing a Simple ApplicationDescription Document

We mentioned in Chapter 1 that an application is uniquely identified by a fully qualified name (QName). An ApplicationDescription document identifies a particular deployment of an application. A sample is given below. For more details, refer its schema. This document is usually written by the application provider and must be registered with a well known Registry service.

Example

<ApplicationDescription xmlns="http://www.extreme.indiana.edu/namespaces/2004/01/gFac"
    xmlns:lead="http://www.extreme.indiana.edu/lead">

    <applicationName targetNamespace="http://www.extreme.indiana.edu/lead">TestApp</applicationName>

    <deploymentDescription>
        <hostName>rainier.extreme.indiana.edu</hostName>
        <executable>/tmp/testApp</executable>
        <workDir>/tmp</workDir>
        <tmpDir>/tmp</tmpDir>
        <applicationEnv>
            <name>envName1</name>
            <value>envValue1</value>
            <name>envName2</name>
            <value>envValue2</value>
        </applicationEnv>
		<leadNameListFile>
            gsiftp://tg-login.ncsa.teragrid.org//home/ac/drlead/inputfiles/arpsintrp.input
        </leadNameListFile>        
    </deploymentDescription>
    <jobType>mpi<jobType>
    <project>
        <projectName>TG-ASC060000N</projectName>
        <projectDescription>LEAD Account on TeraGrid</projectDescription>
    </project>
    <queue>
        <queueName>test_queue</queueName>
        <queueDescription>Test queue</queueDescription>
    </queue>
    <maxWallTime>30</maxWallTime>
    
    <count>
        <value>10</value>
        <decription>Run 10 counts of the application<description>
    </count>
    <rslparm name="archi" >64-bit</rslparm>
</ApplicationDescription>

Element/Attribute	Description	Required
hostName	specifies the name of the host on which the application has been deployed.	Yes
executable	path to the actual application on that host.	Yes
workDir	optional and specifies the working directory for that application.	Optional
tmpDir	optional and specifies the temporary directory for running the application. The temporary directory is usually used by the service to store the standard out,standard error and temporary files of the application.	Optional
applicationEnv	The environment variables to be passed to the application.	Optional
jobType	Deafult is single and If the application is an MPI application then you need to specify it using the. This will tell the application service can run the application as an MPI application.	Optional
leadNameListFile	The path to the LEAD Namelist file for this application on this host. This is used only if the application is a LEAD application that uses Namelists for input	Optional
project	Describes the project that must be charged for the job	Optional
queue	Describes the queue that must be used to submit this job	Optional
maxWallTime	Explicitly set the maximum walltime for a single execution of the executable. The units is in minutes.	Optional
count	The number of processors to use for the job	Optional
rslparm	Custom RSL parameters. You can have zero or more of them. They will be added to the RSL used for job submission	Optional