This section presents information on how to define external applications directly in EKM. See Defining External Applications Using XML if you want to define an application using XML.
To create a new application directly in EKM:
Go to the Administration/Servers/Master and select the queue with which you want to associate the external application.
Select
(New) > . This will open the New External Application dialog box, shown below.
Enter the Application key, Application name, Execution path, 0 or more Command line parameters, 0 or more Environment variables and optional Job submission options. Click the buttons to add more parameters or environment variables. Environment variables are specified as a name and value. Click the buttons to remove parameters or environment variables.
It is highly recommended that you specify a different Application key and Application name in each external application file that you define. (Do not use the same key or label in more than one file.) This ensures that applications are uniquely identified when they are displayed in a list, and ensures that the correct execution path is used.
In Windows clusters, any parameter that contains a space (for example, a file path) should be enclosed in double quotation marks “” to ensure that it is treated as a single parameter. Otherwise, the job may fail.
A string that identifies the application. For example, when you execute a batch task in a process, custom application or analysis project, the Application key name that you specify here is used to execute the application.
The name that will be used to identify the application in the interface (for example, in the job wizard, in the Job Details view, or the Edit Batch Node dialog box).
The full path to the application executable on your local file system.
Parameters that can be added to the command that will be run.
Variables that can be added and will be defined when the command is run. These variables only exist while the command is executing.
Settings relating to the batch submission system. Leave this blank if you do not have any options to specify.
When you have finished defining your new external application, click to create the application and exit the dialog box, or to continue to create more applications.
The application will be automatically saved as an XML file with
the file extension .app.xml in the queue’s
folder, with the name that is specified for the Application
key. In our example, the application file myAppKey.app.xml is saved as: /Administration/Servers/Master/Local/myAppKey.app.xml
To edit an existing application definition using a dialog:
Select the queue with which the application is associated. Queues are located in the /Administration/Servers/Master folder.
Right-click and select > from the context menu. This will open the Edit External Application dialog box.
Make any changes to the Application key, Application name, Execution path, Command line parameters, Environment variables and Job submission options and then click to save your changes.
Important: In Windows clusters, any parameter that contains a space (for example, a file path) should be enclosed in double quotation marks “” to ensure that it is treated as a single parameter. Otherwise, the job may fail.
You can edit the definition of an external application by editing the content of the XML file. You can do this directly within EKM.
Select the queue with which the application is associated. Queues are located in the /Administration/Servers/Master folder.
Right-click and select > from the context menu. This will open the Edit Content dialog box.
Make the desired changes to the file content, and then click to save your changes.
If you want, you can also download the file first, modify it in an XML or text editor, and then upload the file and overwrite the existing application definition with the modified one.