Local clustering and secondary points
A EVA ICS node can be split into the primary and secondary points.
The secondary points contain service launchers, which allow moving heavy-loaded services to additional machines. Also, secondary points can be used for high-availability of certain types of services (e.g. HMI service).
When a secondary point is connected, it creates two bus instances:
eva.spoint.<NAME> for system communications
eva.launcher.<NAME> for service launching
The launchers get all required information from the primary point, where EVA ICS core is located, so secondary points can not launch services until connected.
When a s-point gets connected, it asks the core to launch all services assigned to it.
When the primary point is shut down, all secondaries enter the waiting mode and attempt to reconnect every 1 second.
Secondary points do not host inventory, registry or any kind of resources and can be easily dropped at any time. Certain services may host their data in EVA_DIR/runtime folder at a secondary point.
Secondary points also do not have any logs, all messages are sent and logged by the primary point.
To prepare a node to act as the local cluster primary point, edit eva/config/bus key:
eva edit config/bus # or /opt/eva4/sbin/eva-registry-cli edit eva/config/bus
in the section “sockets” append a network socket to listen on, e.g. “0.0.0.0:7777”:
# .... sockets: - var/bus.ipc # KEEP THIS - "0.0.0.0:7777"
As the bus sockets provide very minimal security, it is highly recommended to host both the primary and the secondary points in a trusted network and use VPN/firewall for network-to-network communications.
Restart the primary:
eva server restart # or /opt/eva4/sbin/eva-control restart
Install EVA ICS on a secondary point machine.
Edit eva_config and set the following:
MODE=spoint ARGS="--connection-path your_ip_or_host:7777"
Restart the secondary point
The point should appear in the list:
eva spoint list # or /opt/eva4/sbin/bus rpc call eva.core spoint.list
Moving services to secondary points
Edit/deploy/re-deploy a service, with the configuration parameters:
bus: # ..... path: your_ip_or_host:7777 # must be set to the bus public socket # ..... launcher: eva.launcher.<NAME>
- id: eva.svc.locker2 params: bus: path: 192.168.1.1:7777 command: svc/eva-svc-locker config: locks: - lock1 - lock2 - lock3 workers: 1 user: nobody launcher: eva.launcher.point_b # the point name
As soon as the service configuration is modified, it is stopped at the primary point and launched at the secondary one.
For services, not included in the default EVA ICS distribution, make sure they are installed on the secondary point machine.
Secondary points can be updated either locally or using cloud updates (both local and remote).
Uploading files via deployment
Secondary points do not run file management services by default. To make file deployment available, firstly deploy a file management service, specifying the target secondary point as a launcher.
After started, the service is ready to accept file deployment calls, which are performed on the secondary point it is running on.