¶ Register the new BMU
Go to “Network → BMU Overview” and click “Add New BMU” button. Select “Tarana” BMU type provide Name and API Key from Tarana, click “Save” button. You can change API Key or Name at any time.
¶ Register Device Type
Go to “Network → Devices → Device Type” and click “Add Device Type”. Provide basic information like Name, Category and select “Tarana” Monitoring Tool.
¶ Tarana Configuration
For correct operation and correct change of device statuses, it is necessary to provide a configuration compatible with Taran. In the navigation menu select “Third Party → Tarana Configuration”. Basic WebHook alerts settings are displayed here and the correct WebHook post back URL can be found.
To set it up correctly, you need to have alerts and a WebHook on Taran's side already configured. On the Taran portal, go “Admin → Webhooks” and click “Add New Webhook”, fill in the name and URL field (Webhook URL can be found on “Third Party → Tarana Configuration” page) and click “Done”. On the next window copy secret key and set up in the “Third Party → Tarana Configuration”.
Everything looks like this.
The next step is to create Alerts Configuration on the Tarana side and select “Notification Method” as “Notify via webhooks”, choice WebHook created above and save it.
After that, you can complete the setup:
The statuses of the devices are displayed on the left, and on the right Tarana Alert Name. Several alerts can be matched with one status. Setup is complete.
¶ Subscriber Management
On the configuration page to mange subscriber set Data VLAN value and SLA Profile for Delinquent (Powercode Customer Status is Delinquent) or Decommissioned customer (Any status that's not Active or Delinquent). In same time when customer status set to Active the SLA Profile and Data VLAN will be set to the value selected in the service belonging to the customer.
¶ Create Equipment
On the Add Equipment page provide Name (It’s equal to Hostname on the Tarana end and will be update by the API), select Device category and Device Type, fill the “MAC Address” and “Serial Number” of the Tarana device.
¶ Creating Tarana Equipment Through the API
Requires Powercode build 26.10.05 or later.
If you create customer equipment through the Powercode API with the createEquipment action, Tarana device types work differently from the Add Equipment page:
- No MAC address is needed. Leave out
macAddress. Powercode stores the placeholder MAC address00:00:00:00:00:0Aon the equipment. - You can create it from an inventory item. Send the inventory item's ID as
invItem. Powercode links the item to the new equipment and takes the serial number from the item. To use a different serial number, also sendtaranaSerialNumber. - A serial number is still required. Without
invItem, sendtaranaSerialNumber. - An address range is only needed for residential gateways. Send
addressRangev4only if the Tarana device type is a residential gateway.
The request is refused, and nothing is created, if:
| Error message | Cause |
|---|---|
invItem does not exist or has been deleted |
The inventory item ID is wrong or the item was deleted. |
invItem is already linked to equipment |
The item already belongs to another piece of equipment. |
invItem is assigned to another customer |
The item is assigned to a different customer than the one in customerID. |
Tarana equipment requires a serial number. |
No taranaSerialNumber was sent and the inventory item has no serial number. |
The Add Equipment page in Powercode still asks for a MAC address, as described above.
¶ Update SLA Profile by Service.
On the Add / Edit Service page, go to the tab “Tarana” and Enabled Tarana Service. Select one of the available “SLA Profile”. To set Data VLAN in the field below enter number: “Min (1) - Max (4091)”
and click save.
¶ Device in TCS
To go from the Powercode to the device in TCS, click Serial Number at the top of the Overview page.
This page also displays additional information about the device, like: Azimuth, Height, Title Angle. The log tab displays logs related to this device only. The general log available in the BMU page.
¶ Customer status change and effect SLA Profile
When changing the customer’s status to Delinquent from Active the SLA Profile will be set to “Min SLA”. In same time when customer status set to Active the SLA Profile will be set to the value selected in the service belonging to the customer.
¶ Installer Mobile View
Tarana add / edit device available in the Installer View.
Tarana device information also available on the device list page.
¶ CBRS Devices and User Certification
To associate Tarana CPI ID with user, log in and go to the Profile page. In the Certification tab provide CPI ID and click Save button.
