Submission Interface Usage

Submission Interface Usage


The following describes the general procedure for using Submission Interface:

  1. Modify your script/tool to call xgSubmit.exe and (optionally) xgWait.exe so that processes whose execution you wish to distribute are queued in the Grid Engine queue.
  2. Run the script/tool with IBConsole.exe.

To convert your scripts for use with IncrediBuild:

  1. Copy your script to a new location.
  2. Place each command that is to be run via IncrediBuild within an xgSubmit call.
  3. Create any Groups needed for sequential processing.
  4. Add any necessary xgWait statements to the script, associating each of them with the appropriate Group(s) or all Groups.
  5. Save the new script and run it using IBConsole (supplying either a command line for the Job, or the name of the batch file).


Example 1

A batch script such as this one can easily be modified for IncrediBuild.

DummyProcess.exe 3000
DummyProcess.exe 2500
DummyProcess.exe 2500

DummyProcess.exe 3000
DummyProcess.exe 2800
DummyProcess.exe 2000

(See the sample supplied in the Samples directory.)

In order to instruct IncrediBuild to execute each of the above commands using remote helper machines, change the script file as follows (Batch File 4tasks.bat):

xgSubmit /ForceRemote /group=Group1 /caption=Task1-Group1 /command DummyProcess.exe 3000
xgSubmit /ForceRemote /group=Group1 /caption=Task2-Group1 /command DummyProcess.exe 2500
xgSubmit /ForceRemote /group=Group1 /caption=Task3-Group1 /command DummyProcess.exe 2500
xgWait /group=Group1
xgSubmit /ForceRemote /group=Group2 /caption=Task4-Group2 /command DummyProcess.exe 3000
xgSubmit /ForceRemote /group=Group2 /caption=Task5-Group2 /command DummyProcess.exe 2800
xgSubmit /ForceRemote /group=Group2 /caption=Task6-Group2 /command DummyProcess.exe 2000
xgWait /group=Group2

In order to execute the script file using IncrediBuild (assuming the script name is 4tasks.bat), execute the following command:

xgConsole "4tasks.bat” /openmonitor

Example 2

Your rendering program needs to process one thousand frames and your script / command line is designed to work on one frame at a time.

RenderApp 1-1000

This command will take 1000 times the time needed to process one frame. Similarly, a script that divides the job into 100 tasks might help show a progress bar but does not save any processing time:

RenderApp 1-100
RenderApp 101-200
RenderApp 201-300

RenderApp 901-1000

Using IncrediBuild, you can create the following script:

xgSubmit / command RenderApp 1-100
xgSubmit / command RenderApp 101-200
xgSubmit / command RenderApp 201-300

xgSubmit / command RenderApp 901-1000)

IncrediBuild sends each task off to the queue and, based on information from the Coordinator, the processing is distributed in parallel among the ten remote and local cores registered in the IncrediBuild Grid pool. The processing is completed in a tenth of the original time required.

For a comprehensive overview of the IBConsole.exe command line options see this section.