-
Notifications
You must be signed in to change notification settings - Fork 24
Manage Servers
Multiple DMR servers can be managed from the HBNet Web Service. This pages describes the Manage Servers page in HBNet.
When adding a new server configuration to HBNet, it is important to remember that certain options, such as file paths and port numbers, are relative to the DMR server to which the configuration has been requested.
You will also notice that the default values for a server configuration are identical to the example configuration file from hblink.
Every aspect of a server configuration can be managed in the web service, however there are 2 sections in the configuration file that you will need to modify ([LOGGER] and [WEB_SERVICE]).
Import Rules - Copy and paste rules.py to automatically create rules for server. SYSTEMS (MASTER, PROXY, PEER, OBP, etc.) must already exist before you import rules. You must create these if they don't already exist in the server configuration.
Export Rules - Prints out a Python dictionary that can be placed in rules.py.
Delete Server - Deletes server configuration. Will also delete MASTER, PEER, OBP, etc. associated with server.
The first box of options contains items not found in "original hblink".
Server Name: Name of DMR server. Must match THIS_SERVER_NAME in hbnet.cfg.
Server Secret: Password used by DMR server to download configuration at startup. Must match SHARED_SECRET in hbnet.cfg
Dashboard URL: URL of dashboard, such as HBMonitor2. This link is displayed to users.
Host: IP address/DNS name of server. This value is used in the generation of a setup script for users and is displayed on the Pasphrase page. Leave blank to hide server from public pages. Uses for this would include the data gateway, where users don't need to connect directly to it.
Unit Call Timeout: Amount of time in seconds to keep track of where each individual DMR ID is located. This is for private call (unit call) routing. When a DMR ID times out, HBNet will "flood" all SYSTEMS that have unit calling enabled.
Misc Options: Miscellaneous options for HBNet. Data gateway can be configured from this.
Notes: Internal note displayed to admin users about server.
Public Notes: Note displayed to users on Passphrase page about server.
This section is the same as the [GLOBAL] section in hblink. Nothing new here. Some of this description has been taken from the config file. Default values are usually fine.
Path: Working path for files, leave it alone unless you NEED to change it
PING_TIME: The interval that peers will ping the master, and re-try registration. Also how often the Master maintenance loop runs.
MAX_MISSED: How many pings are missed before we give up and re-register. Also the number of times the master maintenance loop runs before de-registering a peer.
Access Control Lists are a very powerful tool for administering your system. But they consume packet processing time. Disable them if you are not using them. But be aware that, as of now, the configuration stanzas still need the ACL sections configured even if you're not using them.
The 'action' May be PERMIT|DENY. Each entry may be a single radio id, or a hypenated range (e.g. 1-2999)
ACLs may be repeated for individual systems if needed for granularity. Global ACLs will be processed BEFORE the system level ACLs. Packets will be matched against all ACLs, GLOBAL first. If a packet 'passes'. All elements, processing continues. Packets are discarded at the first negative match, or 'reject' from an ACL element.
If you do not wish to use ACLs, set them to 'PERMIT:ALL'.
USE_ACL: Enable/Disable ACLs.
REG_ACL, SUB_ACL, TGID_TS1_ACL, TGID_TS2_ACL: ACL values.
Enabling "REPORT" will configure a socket-based reporting system that will send the configuration and other items to a another process (local or remote) that may process the information for some useful purpose, like a web dashboard.
Enable: True to enable, False to disable
INTERVAL: Seconds between reports
PORT: TCP port to listen on
CLIENTS: Comma separated list of IPs you will allow clients to connect on. Entering a * will allow all.
Download list of all DMR IDs from radioid.net.
Download: Enable/Disable downloading of files.
PATH: Where to store files.
Peer File: Name of file containing peers (repeaters).
Subscriber File: Name of file containing radio IDs.
Talkgroup ID File: Name of file containing talkgroups.
Peer URL: Where to get peer file.
Subscriber URL: Where to get subscriber ID file.
Stale Time: After this amount of time, new files will be downloaded.
Set to true if you want to use individual passphrases. The rest of this is configured in the [WEB_SERVICE] stanza of hbnet.cfg and in config.py for the web service.
Use short passphrase: Shorten the passphrase used for user authentication.
Burned IDs File: Name of file containing compromised passphrases. See PEER Authentication for more on this.