IBM Streams 4.3.0

Launching a build configuration

You can launch a build configuration to run an SPL application in Streams Studio.

About this task

A build configuration describes how an SPL application is to be built. Each build configuration contains an output directory where the output of the build is stored. A build configuration is a launch-able entity in Streams Studio. When launched, the launch shortcut finds the output from the build configuration and use that information to launch the SPL application. To launch a build configuration, follow this procedure:

Procedure

  1. In the Project Explorer view, select the main composite that you want to launch.
  2. Expand the main composite and you see all the build configurations that are associated with this main composite.
  3. Select and right-click one of the build configurations.
  4. From the menu, select Launch > Launch As Standalone or Launch > Launch As Distributed.

    The Launch attempts to find all launch configurations that are associated with the selected build configuration and reuses existing launch configurations to run the application. If no existing launch configuration can be found, then a new launch configuration is created. The generated launch configuration is named using the following naming convention: <Project>-<namespace>__<main composite name>-<name of build configuration>.

    If the Always Prompt option is enabled in the launch configuration, you are presented with the Launch Configuration window, which you use to change the launch options before launching. If you change options, you must save them when prompted. If you do not save them, the launch proceeds with the previous values. The changes are saved in the launch configuration. If this option is disabled, then you are presented only with the Launch Configuration window if the launch configuration contains errors.

    If more than one launch configuration is found for the selected build configuration, you are prompted to select a launch configuration to run.

  5. In the Select a configuration to launch window, select the launch configuration to run.
  6. Optional: For distributed applications, specify a job configuration overlay file that contains configuration options to run the application.
    Note: The options you configure in the Launch Configuration window will overwrite the value of these options in the job configuration overlay file.

    To prevent the options in the Launch Configuration window from overwriting the options in the job configuration overlay file, click Load to load the options in the job configuration overlay file into the Launch Configuration window.

  7. Optional: Run a preview to see how the operators will be placed into PEs when the job is submitted. When you preview the job, you can determine which submission-time configuration parameters need to be adjusted to optimize the job. For more information, see Previewing a job before you deploy it.
  8. Click Launch.

    The selected launch configuration is used to run the application. You can see information about the launch in the Streams Studio Console from the Console view.