There are various ways in which a component can be configured and launched, one of the ways being Manual Launch. To change a component's Launch Mode, click the component first and then change the Execution Type to 'Manual' in the Execution tab of Properties window.


Figure 1: Choosing 'Manual' Execution Type

Manual launch is a mode in which the Fiorano peer server does not control the launch and stop of components. 

Icon

For Manual execution type, the border of the component appears as a dotted border.


Figure 2: Component border changed to a dotted one

Scriptgen Tool

Manual launch can be achieved via a launch script that can be generated via the Fiorano Studio. The scriptgen tool is present at the location <fiorano_install_dir>/esb/tools/scriptgen

Icon

Manual launch should only be done after the Event Process (within which the Manual launch type component is an instance) has been previously launched. 

To generate a Manual Launch Script from the Fiorano Studio

  1. Right-click the component, go to Execution option, select Save Manual Launch Script option and save the script in the component_properties folder that gets created automatically.

    Icon

    These properties are used to launch the component using the scriptgen tool.


    Figure 3: Menu to save the manual launch script using Fiorano Studio
     

    Icon

    Ensure to change the Launch Mode of the selected component to 'Manual' in the Fiorano eStudio.

  2. After saving the generated script, a dialog appears with instruction to run the manual script; click OK.


    Figure 4: Dialog showing the steps to execute a component using scriptgen tool

    Icon

    The instruction says, "Execute scriptgen.sh/scriptgen.bat from $FIORANO_HOME\esb\tools\scriptgen directory"

  3. Executing the scriptgen.bat file (on Windows platform) or scriptgen.sh file (UNIX platform) sets the environment variables. In UNIX, type the command ant and press Enter to start the Launch Configuration UI (Figure 5) to configure the launch script saved above. Perform the following actions in the Launch Configuration dialog box:

    1. Click the ellipsis  button present under the Properties File text box and choose the properties file that was saved previously (Step 1); the path appears in the text box.

    2. Click the Load button to set the appropriate properties; values as saved in the properties file appear in the Launch Configuration window.

    3. Click OK to launch the component. 

    Icon

    Components that has Manual execution type will not be launched when the application is launched, since they need to be started manually, as described earlier.


    Figure 5: Launch Configuration UI to load the component properties for manual launch
     

  4. The console shows the progress of the launch of the component and the log statements during execution. Subsequently, the component gets launched and the window appears, which can be further used in the flow.


    Figure 6: Console displaying the details of the launch of the component

    Icon

    Closing the console kills the component.

Adaptavist ThemeBuilder EngineAtlassian Confluence