7. Creating Launch Configurations — Modeling Guide

### Navigation

- index
- next |
- previous |
- Modeling Guide »

# 7. Creating Launch Configurations

This section describes how to set up ‘launch configurations’ for the Vortex OpenSplice Modeler which provide additional convenient ways to run and control the Modeler.

A Vortex OpenSplice daemon must be running on the host where your code will be run and for the domain within which your code will operate.

  Starting a Vortex OpenSplice daemon is only required when running a Shared Memory Deployment. For more details about starting Vortex OpenSplice, please see the Vortex OpenSplice Deployment Guide.

The Modeler includes an HDE icon (located in the Eclipse Icon Bar) which can start and stop the Vortex OpenSplice daemon. However, configurations can be manually created to start and stop the daemon if desired or if the daemon does not start when using the HDE tool from the icon bar.

The instructions provided in this section describe how to manually create, start, and stop configurations for the Vortex OpenSplice (OSPL) daemon.

  It is recommended that Vortex OpenSplice launch configurations are created which can start and stop the Vortex OpenSplice daemon: this will enable Vortex OpenSplice code to be run from within Eclipse. These instructions assume that the environment is configured for the version of Vortex OpenSplice that will be used. Refer to the Vortex OpenSplice Getting Started Guide for configuration information. Environment variables can be set for specific launch configurations by selecting the launch configuration and clicking on the Environment tab.

## 7.1. Creating and Running an `OSPL start` Launch Configuration

### 7.1.1. Creating the `start` Configuration

Step 1

> Choose Run > External Tools > External Tools from the Eclipse Menu Bar. This will open the External Tools dialog.

Step 2

> Right-click on the Program item located in tree view (located on the left-hand side of the External Tools dialog) and choose New. This will create a new item under the Program item.

Step 3

> Enter `OSPL start` in the Name text field (located near the top of the dialog); this is for the launch configuration.

Step 4

> In the Location text box, use the Browse File System button to locate the `OSPL` executable (`ospl.exe` on Windows platforms). The full pathname for the `OSPL` executable should appear in the Location text box.

> For example, on Windows this could be `"C:\Program Files (x86)\ADLINK\Vortex_v2\Device\VortexOpenSplice\6.6.0p1\HDE\x86.win32\bin\ospl.exe"`.

Step 5

> Enter the word `start` in the Arguments text box. This will instruct the `OSPL` executable to start the daemon.

Step 6

> Click the Apply button to apply the changes.

Step 7

> Click the Close button to close the dialog.

### 7.1.2. Running the `start` Configuration

Running the `start` launch configuration executes the `ospl start` command and starts the daemon.

Step 1

> Choose Run > External Tools > External Tools from the Eclipse Menu Bar. This will open the External Tools dialog.

Step 2

> Select the `OSPL start` item (located under the Program item) in tree view (located on the left-hand side of the External Tools dialog).

Step 3

> Click the Run button (located at the bottom of the dialog). This will start the daemon.

Step 4

> Click the Close button to close the dialog.

## 7.2. Creating and Running an `OSPL stop` Launch Configuration

### 7.2.1. Creating the `stop` Configuration

Either:

Repeat all of the steps shown under Section 3.8.1.1, Creating the start Configuration, above, but use `OSPL stop` for the launch configuration’s name, and enter `stop` in the Arguments text box instead of `start`.

OR:

Step 1

> Right-click on the launch configuration created under Section 3.8.1.1, Creating the start Configuration.

Step 2

> Click Duplicate.

Step 3

> Select Duplicate Launch Configuration.

Step 4

> Rename it from `OSPL start (1)` to `OSPL stop` by entering the new name in the Name field

Step 5

> Replace `start` with `stop` in the argument field.

Step 6

> Click Apply.

### 7.2.2. Running the `stop` Configuration

Running the `stop` launch configuration executes the `ospl stop` command and stops the daemon.

Step 1

> Choose Run > External Tools > External Tools from the Eclipse Menu Bar. This will open the External Tools dialog.

Step 2

> Select the `OSPL stop` item (located under the Program item) in tree view (located on the left-hand side of the External Tools dialog).

Step 3

> Click the Run button. This will stop the daemon.

Step 4

> Click the Close button to close the dialog.

### Navigation

- index
- next |
- previous |
- Modeling Guide »