Overview
CopperTree’s K-Link connects to the BAS control’s LAN or VLAN and requires outbound internet access.
At a minimum, at least one K-Link will be attached to each network. Based on system size and latency, additional K-Links may be required to allow the data collection load to be balanced. A CopperTree representative will advise you on the total number of devices being shipped and whatever follow-up devices are required.
Physical Requirements
The following is required within 5 feet of the permanent location of each K-Link:
- 110-240 Volt AC receptacle for K-Link power supply.
- Ethernet jack to the BAS controls LAN or VLAN.
- If wired network access is not available wifi can be configured upon request
- At an additional cost, a cellular modem can also be supplied
- Suggested: an isolated location to place the appliance to prevent disruption.
- Example: A network rack or control enclosure. If wifi is being used, be sure the device is located outside of the control enclosure.
Port & Web Requirements
CopperTree uses Balena.io to manage its IoT fleet, Balena provides the OS, Hypervisor, Deployment, and Management platform. Their official network requirement documentation can be found here. For clients performing firewall filtering, we recommend whitelisting *.balena-cloud.com, and *.coppertreeanalytics.com. If subdomain filtering or IP level filtering is required; below is a complete list of all servers which will use established related communications for the full functionality of CopperTree Analytics.
Port & Web Address
| Domain \ SubDomain | Port | Traffic Type |
|---|---|---|
| api.balena-cloud.com | 443 | HTTPS |
| vpn.balena-cloud.com | 443 | HTTPS, OPENVPN |
| tunnel.balena-cloud.com | 443 | HTTPS, OPENVPN |
| delta.balena-cloud.com | 443 | HTTPS |
| registry2.balena-cloud.com | 443 | HTTPS |
| registry-data.balena-cloud.com | 443 | HTTPS |
| cloudlink.balena-cloud.com | 443 | HTTPS |
| api.coppertreeanalytics.com | 443 | HTTPS |
| fleetc3.coppertreeanalytics.com | 443 | HTTPS |
| parser.coppertreeanalytics.com | 443 | HTTPS |
| kaizen.coppertreeanalytics.com | 80,443 | HTTP,HTTPS |
| kaizen-east.coppertreeanalytics.com | 80,443 | HTTP,HTTPS |
| intake1.coppertreeanalytics.com | 5671 | AMQPS |
| intake2.coppertreeanalytics.com | 5671 | AMQPS |
| Google Public DNS (Optional) | 53 | DNS |
| 0.resinio.pool.ntp.org (Optional) | 123 | NTP |
The K-Link can be configured to use local DNS and NTP. Please contact your account rep to confirm device settings prior to shipment. Note that Balena has 8.8.8.8 hard coded as an emergency backup DNS, you will see traffic to this IP on port 53 when provided DNS is failing to resolve.
If the site used IP address filtering instead of FQDN filtering, please let CopperTree know and a workaround may be possible.
*If a static IP is required, please provide IPs to a CopperTree representative for configuration before delivery may occur.
