One of the features of the Agent Controller is its ability to allow a remote client to launch applications on the local host. In order to do this, a configuration description for the application must be specified in the Agent Controller configuration file. This description is specified via <Application> element and its children. Only application descriptions that are provided by the <Application> elements in the active configuration can be launched by the Agent Controller.
To create a configuration description, follow these steps:
<Application configuration="default" executable="TestApplication" path="<testapp_dir>/testapp" location="<working_dir>">
<Variable name="PATH" value="<testapp_dir>" position="prepend"/>r></Application>
This fragment describes an application called TestApplication
that maps to the executable <testapp_dir>/testapp.
When it is launched, its preferred execution working directory is the
directory <working_dir
>.
Also, TestApplication will have its PATH variable prepended
with <testapp_dir
>
directory.
The remote client can only ask the Agent Controller to launch TestApplication and has no notion of what actual executable is being run as a result of this request. Furthermore, it is not possible to remotely list the application descriptions available. As a result, the Agent Controller needs to be properly configured in order to respond to a remote client's request to run an application.
Note
Application descriptions also have the ability to override or to extend environment variable values for the application being launched as well as to override or to extend the parameters that will be provided to the application executable at launch time.
Related concepts
Agent Controller Overview
Related tasks
Locating the configuration files
Administering the Agent Controller
The pluginconfig.xml File
The serviceconfig.xml File
Copyright (C) 2006 Intel Corporation.