Service control

Energy SOAR consists of six systemd services. All management commands require root privileges.

Services

Service

Component

energysoar

Energy SOAR Base (case management, alerting, API)

cortex

Energy SOAR Automation (analyzers, responders)

n8n

Energy SOAR Workflow engine

nginx

Reverse proxy and HTTPS termination

cassandra

Cassandra database

elasticsearch

Elasticsearch index

Start, stop, and restart

To control a single service:

systemctl start   <service>
systemctl stop    <service>
systemctl restart <service>
systemctl status  <service>

To restart all Energy SOAR services in the correct order:

systemctl restart cassandra
systemctl restart elasticsearch
systemctl restart energysoar
systemctl restart cortex
systemctl restart n8n
systemctl restart nginx

Warning

Start cassandra and elasticsearch before starting energysoar. Energy SOAR Base fails to start if either data store is unavailable.

License update

The license file is read from the directory configured in /etc/energysoar/application.conf.d/license.conf (default: /etc/energysoar/).

To replace the license:

  1. Remove the existing license file:

    rm /etc/energysoar/energysoar_*
    
  2. Copy the new license file into /etc/energysoar/. Only one license file must be present in that directory.

  3. The license service reloads automatically every 5 minutes. To apply it immediately, restart Energy SOAR Base:

    systemctl restart energysoar