Application/Gateway Group Structure Guide

Application/Gateway Group Structure Guide

In this guide, you will learn how to correctly set up your Application/Gateway Group Structure.

Application

An Application is an organizational unit used to manage and organize your various devices on the TEKTELIC Network Server.


  1. If you want pre-decoded device data to arrive at your 3rd-party application server, we recommend to create one application per device type. Mixing device types in your application is not recommended as the integration can only support one data converter. Hence, should you decide to integrate an application with multiple device types, the integration will only support one type of device.
  2. If you want to decode all of the device data on your 3rd-party application server (raw data pass-through), we recommend to create a single application and have devices of all types placed in this one application. The integration has the ability to pass the data to your application server without modifying the payload in any way. More details on this can be found in the Integration section below.

Gateway Groups

A Gateway Group is an organizational unit used to manage and organize your various gateways on the TEKTELIC Network Server. We would recommend that customers separate their gateways into different gateway groups based on gateway model. (i.e Kona Micro's in one group, Kona Macro's in a different gateway group, Third-Party gateways in their own group). This is so customers can properly use the Tektelic REST API to initiate a Bulk BSP Upgrade for their gateways.

Integration

An Integration is how you send your device data to your 3rd-party application server.


When you are creating a new integration, you must select a data converter.
  1. For an application with a single type of device, select the data converter that corresponds to your device.
  2. For an application with mixed types of devices (raw data pass-through integration), create a new custom data converter and use the newly created data converter in your integration.
    1. When you create a new custom data converter, there will be pre-existing code by default. This code allows you to directly pass raw device data without any modifications to the payload.