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

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: It is named in the config file. 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.