Legrand / Raritan / Server Technology Xerus™ JSON-RPC API
|
Cascading allows multiple devices to share one physical network connection, and optionally one IP address. There are two modes of cascading: bridging and port forwarding.
Linking means that one device (the primary unit) aggregates data from multiple others (link units). Link units run a reduced set of services and have a lower level of autonomy. On the upside it becomes possible to define e.g. outlet groups with outlets from multiple PDUs, or event rules that work with resources from multiple devices.
Cascading and linking can be used in combination.
In bridging mode all network ports of the device appear on the same physical subnet. All ports use the same IPv4/IPv6 settings.
Bridging is configured by enabling or disabling the interface br0
in the net.Settings structure:
In port forwarding mode only the primary unit is visible on the network and has an IP address. Network services of downstream devices can be accessed at custom port numbers (pos is 0 for the primary, 1..31 for expansion units):
Service | Protocol | Port Number |
---|---|---|
HTTPS | TCP | 50000 + pos |
HTTP | TCP | 50100 + pos |
SSH | TCP | 50200 + pos |
Telnet | TCP | 50300 + pos |
SNMP | UDP | 50500 + pos |
Modbus | TCP | 50600 + pos |
Port forwarding is configured in the common.portForwarding
structure of the net.Settings structure.
Link units are managed with the cascading.CascadeManager interface.
Link unit resources can be accessed through the primary unit's JSON-RPC interface by prepending /link/<n>
to the resource ID. There are also well-known RIDs for PDU resources starting with /model/pdu/<n>
: