Prev Next

Services

Enterprise Architect provides two services to facilitate remote script execution and remote debugging. The services primarily support Enterprise Architect running on Linux to allow users to run native Linux shell scripts and debug Linux programs. The Satellite service supports Analyzer Scripts while the Agent service supports debugging.

Access

Ribbon

Execute > Tools > Services

The Satellite Service

The Satellite service is responsible for executing Analyzer Scripts on the machine on which it is running. The feature can help Linux users to execute native Linux programs and shell commands directly, bypassing Wine. The service can be managed from the ribbon, and it can also be run independently from a terminal.

The Linux Shell

The default shell used by Enterprise Architect is 'bash'. To override the Linux Shell used by Enterprise Architect, open a Linux terminal, run 'wine regedit ' and add a string value to this registry key:

HKEY_CURRENT_USER\Software\Sparx Systems\EA400\EA\Options

where:

  • key name: "LINUX"
  • key value: path

and path is the Linux path to the shell program "/bin/bash", for example.

Permissions

Under Linux you must check that the service programs have the appropriate permissions. The programs are located under the Enterprise Architect installation folder, in the sub directory 'VEA/x86/linux'. Check that each of the programs in this directory has the execute permission set for the owner.

Notes

  • The Satellite services are enabled in the Unified and Ultimate Editions of Enterprise Architect

The Agent Service

The Agent service is responsible for managing debugging sessions for Enterprise Architect's GDB debugger. The service allows Enterprise Architect users to debug Linux programs. The service can be managed from the ribbon. It can also be run independently from a terminal.

The Services Menu

Option

Description

See also

View Status of all Service(s)

Displays a View that lists the status of each Enterprise Architect service named in the config file, and its state.

Analyzer Services Window

Satellite Service

Start

Starts the service. The service listens on the Satellite Port configured in any Analyzer Script Services Page.

Stop

Stops the service.

Test

Tests the status of the Satellite Service, whether it is running or not.

Agent Service

Start

Starts the service. The service listens on the Agent Port configured in an Analyzer Script Services Page.

Stop

Stops the service.

Test

Tests the status of the Agent Service, whether it is running or not.

Code Miner Service

Start

This option reads the current Service Configuration file and starts services that are configured to run, and stops running services that are not configured to run. A service is configured if:

  1. It is named in the config file.
  2. It has the attribute status:ON.

Stop All

This option stops any services that are currently running.

Edit Configuration File

This option prompts for the Service Configuration file to use, then opens that file in an Enterprise Architect text editor. The system remembers where the file is held.

Auto Start with EA

This option automatically starts services having the 'status:ON' attribute when the model opens.

The messages logged to the System Output window here when the model is opened indicate that the service was already running.

Auto Stop on Close

This option automatically stops running services when Enterprise Architect is closed down.