Last Updated on 2022-05-17

KB00011: Renaming EVA ICS nodes

EVA ICS versions: 3.0.0 and 3.x above

Problem

A EVA ICS node need to be renamed (host name, or “name” param in controller configuration files)

Solution

EVA ICS 3.4.0 and above

Execute:

eva feature setup node_name name=NEW_NAME

EVA ICS 3.3.2 and below

Removing links between controllers

Remove links everywhere the node is connected, including local controller inter-connection:

eva sfa controller remove uc/OLD_NAME
eva sfa controller remove lm/OLD_NAME
eva sfa save

eva lm controller remove uc/OLD_NAME
eva lm save

If the old controller is still present in LM/SFA after restart, remove connection configuration files manually:

eva server stop
rm -f /opt/eva/runtime/lm_remote_uc.d/OLD_NAME.json
rm -f /opt/eva/runtime/sfa_remote_uc.d/OLD_NAME.json
rm -f /opt/eva/runtime/sfa_remote_lm.d/OLD_NAME.json
eva server start

Note

Removing links to the old node is not required if the controllers are connected via MQTT server. In this case, the secondary controllers will be automatically connected using new names, obsolete connections can be removed anytime later.

Setting new node name

Set new node name either by changing its host name or by editing “server/name” parameter in the controller configuration files.

Then restart the node controllers:

eva server restart

Restoring local inter-connection

eva sfa controller append -a \$default http://localhost:8812
eva sfa controller append -a \$default http://localhost:8817
eva sfa save

eva lm controller append -a \$default http://localhost:8812
eva lm save

If the local SFA is configured as cloud manager, set the master key back:

eva sfa controller set uc/NEW_NAME masterkey KEY_VALUE
eva sfa controller set lm/NEW_NAME masterkey KEY_VALUE
eva sfa save