set-desired-state

Sets the desired state for the service or all services on local machine.

The desired state is updated in the yml file located in <EM_HOME>/services/desired_state/

emsca set-desired-state [--all] [-s=<serviceName>] <desired-state>

desired-state values:

• up
• down
• ignored

--all: Run command for all services

-s, --service=<serviceName> The service name targeted by command

get-desired-state

Returns the desired state of a service.

emsca get-desired-state -s=<serviceName>

get-current-state

Returns the current state of a service.

emsca get-current-state -s=<serviceName>

service

Starts the services configuration agent application in a service mode

emsca service

services-details

Returns basic information about the services that are running on the machine, including details such as the PID, timestamp, and state.

emsca services-details

status

Returns the services state on current machine.

Retrieved values:

• rc=0: All services current state matches their desired state
• rc=1: All services current state is down
• rc=2: At least one service's current state doesn't match its desired state
• rc=-1: General error

emsca status

shutdown

Shutdown all services including services-config-agent (watch-dog). SCA shutdown gracefully all processes by running the following:

• UNIX: ‘kill -15 <PID>’
• Windows: ‘wmic process <PID> delete’

To force shutdown by killing all remaining processes:

UNIX: ‘kill -9 <PID>’

emsca shutdown [-f]