Skip to main content

TetraNode

Intro

Rohill TetraNode is pure IP-based solution, for better TetraPack service implementation we decided to use proprietary InterTNX protocol instead of available TetraNode Interconnect Gateway protocol (TIGv2). By this approach we created a special agent software - TetraPack Peak, which should be run inside TetraNode' private IP network and emulates a subset of required TNX functionality. 
BM-TP-2025-TNX.png
On the one side it connects to TNXs directly, on the other side it connects to TetraPack Core system over public Internet.

Limitations

  • TetraPack Peak should be run inside TNX' private network
  • It requires separated Debian Linux host with amd64 or arm64 architecture (could be dedicated PC, Raspberry PI or virtual machine)
  • All TNX nodes inside zone have to use numeric node names from 1 to 62
  • TetraPack phone trunks should be numeric and be equal to corresponding ISSIs (16777184, 16777186)
  • At least TetraNode 2.28
  • Good license to pass as much ISSIs as possible :)
    Every ISSI to be accepted by TNX from TetraPack should be added to TNX database (E.g. to make a Group Call, every ID involved in the call needs to be in TNX database)

Peak installation and configuration

  1. Add repository and install a package
    curl http://packages.tetrapack.online/install/tools/Debian/add-repository.sh | bash
    sudo apt install -y tetrapack-peak

  2. Configure Peak - /opt/TetraPack/default.env

    # TNX connection settings
    
    # Port settings should correspond to values on your TNXs
    NODE_PORT=39451
    CONFIG_PORT=39450
    
    # That is optional multicast address used by TNXs for discovery
    # If you use broadcast or static configuration, you can comment it 
    CONFIG_ADDRESS=238.1.2.3
    
    # You have to use any free Node ID since Peak emulates a node,
    # exchange and location should be unique inside TetraNode zon
    LOCAL_NODE=3
    LOCAL_EXCHANGE=peak
    LOCAL_LOCATION=peak
    
    # Server connection URI in format http(s)://[user]:[password]@[address]/[path and parameters]
    # If you care about securely stored password, please put credentials into /opt/TetraPack/.netrc (man netrc)
    
    TRANSPORT_CONNECTION="http://core.tetrapack.online:8081/peak/?country=901&network=9999"
  3. Restart service - sudo systemctl restart peak@default
  4. Logs are available in syslog / journald

TNX configuration

Node Settings

as above All Interconnected Nodes must have Numerical ID's

Settings can be configured via WebNMS at the link http://#IP_OF_TNX#/nms/Tnx/Install

The Settings should look Similar to the Below:

image.png

InterTNX

This is usually fine to leave as the Defaults - But the main Setting to Watch out for is in the InterTNX Configuration.
this Watches on a Multicast Address (238.1.2.3 By Default)
It Can be Checked via the TNX WebNMS Configurator:
http://#IP_OF_TNX#/nms/Tnx/InterTnx

image.png

the page should look like the above (If the default configuration is still applied.

If not, Match these Settings.