MERIDIAN DATA SYSTEMS // ENVIRONMENT

services

DOCUMENT TYPE: SYSTEM REFERENCE NODE: services 68 DOCUMENTS
MDS://KNOWLEDGE/ENVIRONMENT/services
SERVICE MANAGEMENT
==================

Services run on the current virtual computer. Creating an instance and
installing its software are separate steps; see help package-manager when you
want to select an installed service program.

INSPECT INSTANCES
-----------------
    service list
    service status <instance>

CREATE AND START
----------------
Create the instance before starting it. A new instance is stopped and uses its
product's built-in behavior unless you select an installed service program.

    service create demo-sshd mds-sshd --port 2222
    service start demo-sshd

Service management changes require the local root user. To run a particular
installed program version, install the compatible file first, then set its
absolute path with --executable when creating or configuring the instance. See
help package-manager for installing service software.

CONFIGURE
---------
Stop an instance before changing its settings. Configuration is saved in
/etc/services/<instance>.json and loaded when the instance starts:

    service stop <instance>
    service configure <instance> --port <port>
    service start <instance>

See help configuration for details about service configuration files and
saved environment values.

STOP OR REMOVE
--------------
    service stop <instance>
    service remove <instance>

Removing an instance also removes its service configuration. It does not
remove any separately installed software files.