Skip to content

node-linking.md

Latest commit

 

History

History
96 lines (61 loc) · 1.88 KB

node-linking.md

File metadata and controls

96 lines (61 loc) · 1.88 KB

Node Linking

pyCluster supports direct node links and keeps compatibility-focused behavior for legacy cluster families.

Concepts

Transport Address

How pyCluster opens the connection.

Examples:

  • tcp://host:port
  • pycluster://host:port?login=LOCALNODE-1&client=PEERNODE-1
  • dxspider://host:port?login=LOCALNODE-1&client=PEERNODE-1
  • kiss:///dev/ttyUSB0?baud=9600
  • ax25://DESTCALL?source=MYCALL&via=DIGI1,DIGI2

Cluster Family

How pyCluster behaves after the connection is established.

Supported labels:

  • dxspider
  • arcluster
  • dxnet
  • clx
  • pycluster

Peer Roles

Dial-out

Configured outbound peers.

These have:

  • a transport address
  • a family
  • retry behavior
  • optional peer password

Accepted

Inbound peers that connect to the local node.

These do not require:

  • a DSN/transport address on the local side
  • local retry logic

pyCluster DSN Example

pycluster://example.net:7300?login=LOCALNODE-1&client=PEERNODE-1

If the remote peer requires a password:

pycluster://example.net:7300?login=LOCALNODE-1&client=PEERNODE-1&password=secret

DXSpider DSN Example

dxspider://example.net:7300?login=LOCALNODE-1&client=PEERNODE-1

If the remote peer requires a password:

dxspider://example.net:7300?login=LOCALNODE-1&client=PEERNODE-1&password=secret

Operator Views

Useful visibility commands:

  • show/links
  • show/node
  • show/connect

Useful sysop commands:

  • sysop/connect
  • sysop/disconnect

In the System Operator web console, the Peers and Links editor now exposes Cluster Family as an explicit selector, including pyCluster for pyCluster-to-pyCluster links.

Notes

  • pyCluster avoids silently guessing peer family/version
  • explicit identity learned from protocol traffic is preferred over inference
  • loop suppression is surfaced in operator views and policy-drop summaries