Managing PLC instances

PLC instances can be easily managed with rplc command-line tool.

The tool can be freely downloaded at https://github.com/eva-ics/rplc/releases

Note

The majority of the commands require CLI tool to be executed under root.

PLC var directory

By default, PLC instances use the system temporary directory to store their pid files, API sockets etc. This can be changed by setting PLC_VAR_DIR system environment variable.

If a custom var directory is used, the variable must be set before calling rplc command-line tool as well.

Registering a PLC instance

The command

rplc register path/to/plc_binary

registers a PLC instance in systemd. Additional arguments:

  • --force re-register an instance even if its already registered (stops PLC process if running)

  • --eapi specify EAPI path

  • -a specify PLC thread affinity, as NAME=CPU_ID,PRIORITY

  • --var specify a custom system environment variable

  • --start start the PLC instance after registering

Unregistering PLC instance

The command

rplc unregister plc_name # plc_name = binary name

unregisters a PLC instance from systemd. The PLC process is stopped if required.

Additional commands

The additional commands allow to list available PLC instances, get their info, stats, start, stop instances etc. The full list of available commands can be obtained with

rplc -h