BAG·Tower: Difference between revisions

Revision as of 14:26, 18 January 2023

Main Page > General Information > Configuration Examples > Third party services > IoT platforms > BAG·Tower

BAG·Tower is a monitoring and prevention platform that is compatible with Teltonika-Netwokrs devices. Their main goal is to provide a complete solution to control your equipment, manage your asset fleet and its operations.

Introduction

This article contains step-by-step instructions on how to connect a Teltonika-Networks device to BAG·Tower platform.

Basic setup

Create an account

First of all, you will need to create your BAG·Tower account.

Register an account on BAG·Tower.
Go to your registered email account, find the email from BAG·Tower and click on the Signup now by clicking here link.

In the new window enter a new Password and press Send.

Now you should have access to BAG·Tower platform.

Create an asset

Set up BAG·Tower asset for your Teltonika-Networks device.

Login to your BAG·Tower account.
In Asset Management -> Your assets -> Asset List press Add Asset button.

In the popup window press Create an Asset Manually button.

Enter your assets Name and press the Save button.

After saving the asset should appear in the Asset List.

Connect device to BAG·Tower

Connect Teltonika-Networks device to the created BAG·Tower asset.

Go to the Details page of the created BAG·Tower asset in Asset Management -> Your assets -> Asset List.
In the Asset Detail page copy the generated API Key.

Log in to Teltonika-Networks device and navigate to System -> CLI. Login using these credentials: Username - root, Password - Your set Admin password. Alternatively you can connect to your device through your terminal using ssh command:
```
ssh root@<device_ip_address> 
```
and then when prompted enter your device Admin password.

Run the following command with __API_KEY__ replaced by the previously copied assets API Key:

sh -c "$(wget -qO - https://scripts.bagtower.bag-era.fr/install_push_teltonika.sh)" '' __API_KEY__

After you execute that command you should get a similar response to this with device type and version variations:

install script version 1.4.4
Configuring your asset ...
.. configuration ok
pushing data ..

push script version 1.4.4

** getting asset info ...
      getting TRB141 data
   .. ok 

** pushing asset info ...
600: 600
   .. done 

** updating crontab ...
      asset_period: 600 seconds
   .. done 
.. data pushed
!! all set !!!

Now your device should start sending information to the BAG·Tower platform. You should see your assets status change to Anomaly detected in the BAG·Tower platform Asset Management -> Your assets -> Asset List.

Create a decoder

Create a BAG·Tower decoder so that BAG·Tower platform can understand information from Teltonika-Netwokrs device.

To understand the information that is being sent from the device BAG·Tower needs to have a decoder. To configure it go to BAG·Tower platform page and in Asset Management -> Your assets -> Asset List click on details of an asset with the Status showing as Anomaly detected.

In the Asset Details page click Create a Decoder button.

Change the name of the Decoder. Download Teltonika decoder file and replace the Code section content with the content from Teltonika decoder. Select an Asset and a Frame. You can get the latest version of Teltonika decoder from this BAG·Tower page.

Press Test Decoder and wait for the test to finish.

Then click on Save and Attach.

In the opened dialog window choose the Asset, Tag or Group to attach this decoder to and click the Save button.

Now you should be all set and your device information should now periodically update in the linked Assets Detail page. Your device asset in BAG·Tower platform should now be shows as Online and its Detail page should now show graphs with information from device.

If that is not the case try repeating these steps or contacting support for more information.

References

BAG·Tower official site: https://www.getbagtower.com/en/home

BAG·Tower guide to connecting Teltonika asset: https://bagtower.tawk.help/en-us/article/connecting-teltonika-asset

@@ Line 1: / Line 1: @@
-BAG·Tower is a monitoring and prevention platform that is compatible with Teltonika-Netwokrs devices. Their main goal is to provide a complete solution to control your equipment, manage your asset fleet and its operations.
+'''BAG·Tower''' is a monitoring and prevention platform that is compatible with '''Teltonika-Netwokrs''' devices. Their main goal is to provide a complete solution to control your equipment, manage your asset fleet and its operations.
 ==Introduction==
-This article contains step-by-step instructions on how to connect a Teltonika-Networks device to BAG·Tower platform.
+This article contains step-by-step instructions on how to connect a '''Teltonika-Networks''' device to '''BAG·Tower''' platform.
 ==Basic setup==
@@ Line 11: / Line 11: @@
 #[[BAG·Tower Usecase#Create a decoder|Create a decoder for the device.]]
-=== Create an account===
+===Create an account===
-----First of all, you will need to create your BAG·Tower account.
+----First of all, you will need to create your '''BAG·Tower''' account.
-*[https://www.getbagtower.com/en/home Register an account] on BAG·Tower.
+*[https://www.getbagtower.com/en/home '''Register an account'''] on '''BAG·Tower'''.
-*Go to your specified email, find the email from BAG·Tower and click on the Signup now by clicking here link.
+*Go to your registered email account, find the email from '''BAG·Tower''' and click on the '''Signup now by clicking here''' link.
-*Insert Picture Here
+[[File:Networking_rutos_configuration_example_bag_tower_usecase_acount_email_v1.jpg|border|class=tlt-border]]
-* In the new window enter a new password and press Send.
+*In the new window enter a new '''Password''' and press '''Send'''.
-* Insert Picture Here
+[[File:Networking rutos configuration example bag tower usecase acount password v1.jpg|border|class=tlt-border]]
-*Now you should have access to BAG·Tower platform.
+*Now you should have access to '''BAG·Tower''' platform.
 ===Create an asset===
-----Set up BAG·Tower asset for your Teltonika-Networks account.
+----Set up BAG·Tower asset for your Teltonika-Networks device.
-* Login to your BAG·Tower account.
+*Login to your BAG·Tower account.
-* In Asset Management -> Your assets press Add Asset button in Asset List section.
+* In '''Asset Management -> Your assets -> Asset List''' press '''Add Asset''' button.
-*Insert Picture Here
+[[File:Networking rutos configuration example bag tower usecase empty asset list v1.jpg|border|class=tlt-border|1102x1102px|alt=]]
-*In the popup window press Create An Asset Manually button.
+*In the popup window press '''Create an Asset Manually''' button.
-*Insert Picture Here
+[[File:Networking rutos configuration example bag tower usecase create asset first step v1.jpg|border|class=tlt-border|1102x1102px|alt=]]
-*Enter your asset name and press Save button.
+*Enter your assets '''Name''' and press the '''Save''' button.
-*Insert Picture Here
+[[File:Networking rutos configuration example bag tower usecase create asset second step v2.jpg|border|class=tlt-border]]
-*After saving the asset should appear in the Asset List.
+*After saving the asset should appear in the '''Asset List'''.
-*Insert Picture Here
+[[File:Networking rutos configuration example bag tower usecase asset list initialized asset v1.jpg|border|class=tlt-border|1200x1200px]]
 ===Connect device to BAG·Tower===
-----Connect Teltonika-Networks device to the created BAG·Tower asset.
+----Connect '''Teltonika-Networks''' device to the created '''BAG·Tower''' asset.
-*Go to the details page of the created BAG·Tower asset in Asset Management -> Your assets -> Asset List.
+*Go to the '''Details''' page of the created '''BAG·Tower''' asset in '''Asset Management -> Your assets -> Asset List'''.
-*Insert Picture Here
+*In the '''Asset Detail''' page copy the generated '''API Key'''.
-*In the Asset Detail page copy the generated API Key.
+[[File:Networking rutos configuration example bag tower usecase asset details v1.jpg|border|class=tlt-border|1200x1200px]]
-*Insert Picture Here
+*Log in to '''Teltonika-Networks''' device and navigate to '''System -> CLI'''. Login using these credentials: '''Username - root''', '''Password - Your set Admin password'''. Alternatively you can connect to your device through your terminal using ssh command: <pre>ssh root@<device_ip_address> </pre> and then when prompted enter your device Admin password.
-*Log in to Teltonika-Networks device, make sure the device is in Advanced mode and navigate to System -> CLI. Login using these credentials: Username - root, Password - Your set Admin password.
+[[File:Networking rutos configuration example bag tower usecase webui cli v1.jpg|border|class=tlt-border|800x800px]]
-*Insert Picture Here
+* Run the following command with __API_KEY__ replaced by the previously copied assets API Key:
-*Run the following command: sh -c "$(wget -qO - <nowiki>https://scripts.bagtower.bag-era.fr/install_push_teltonika.sh</nowiki>)" <nowiki>''</nowiki> __API_KEY__ ,with __API_KEY__ replaced by the previously copied assets API Key. After that you should see something similar to this.
+<pre>
-*Insert Picture Here
+sh -c "$(wget -qO - <nowiki>https://scripts.bagtower.bag-era.fr/install_push_teltonika.sh</nowiki>)" <nowiki>''</nowiki> __API_KEY__
+</pre>
-===Create a decoder ===
+*After you execute that command you should get a similar response to this with device type and version variations:
-----Create a BAG·Tower decoder so that BAG·Tower platform can understand information from Teltonika-Netwokrs device.
+<pre>
-*To understand the information that is being sent from the device BAG·Tower needs to have a decoder. To configure it go to BAG·Tower platform and in Asset Management -> Your assets -> Asset List click on details of an asset with the Status Anomaly detected.
+install script version 1.4.4
-*Insert Picture Here
+Configuring your asset ...
-*In the detail page click Create a Decoder button.
+.. configuration ok
-*Insert Picture Here
+pushing data ..
-*Copy the content of Teltonika decoder in the code section. You can get the latest version of Teltonika decoder from BAG·Tower page. Pick a Frame and press Test Decoder.
-*Insert Picture here
-* Click on Save and Attach. Choose the Asset, Tag or Group to attach this decoder to. Then click the Save button.
-*Insert Picture Here
-* Now you should be all set and your device should now start periodically pushing information to BAG·Tower platform. Your device asset in BAG·Tower platform should now be Online and its Detail page should now show graphs with information from device. If that is not the case try repeating these steps or contacting support for more information.
-== References ==
+push script version 1.4.4
+** getting asset info ...
+      getting TRB141 data
+   .. ok
+** pushing asset info ...
+: 600
+   .. done
+** updating crontab ...
+      asset_period: 600 seconds
+   .. done
+.. data pushed
+!! all set !!!
+</pre>
+*Now your device should start sending information to the BAG·Tower platform. You should see your assets status change to Anomaly detected in the BAG·Tower platform Asset Management -> Your assets -> Asset List.
+[[File:Networking rutos configuration example bag tower usecase asset list anomaly v2.jpg|border|class=tlt-border|1102x1102px]]
+===Create a decoder===
+----Create a '''BAG·Tower''' decoder so that '''BAG·Tower''' platform can understand information from '''Teltonika-Netwokrs''' device.
+*To understand the information that is being sent from the device '''BAG·Tower''' needs to have a decoder. To configure it go to '''BAG·Tower''' platform page and in '''Asset Management -> Your assets -> Asset List''' click on details of an asset with the '''Status''' showing as '''Anomaly detected'''.
+*In the '''Asset''' '''Detail'''s page click '''Create a Decoder''' button.
+[[File:Networking rutos configuration example bag tower usecase asset details decoder v2.jpg|border|class=tls-border]]
+*Change the name of the '''Decoder'''. Download Teltonika decoder file and replace the '''Code''' section content with the content from Teltonika decoder. Select an Asset and a Frame. You can get the latest version of Teltonika decoder from this BAG·Tower page.
+[[File:Networking rutos configuration example bag tower usecase decoder step 1 v1.jpg|border|class=tlt-border|1104x1104px]]
+*Press '''Test Decoder''' and wait for the test to finish.
+[[File:Networking rutos configuration example bag tower usecase decoder step 2 v1.jpg|border|class=tlt-border|1104x1104px]]
+*
+*Then click on '''Save and Attach'''.
+[[File:Networking rutos configuration example bag tower usecase decoder step 3 v1.jpg|border|class=tlt-border|1104x1104px]]
+*In the opened dialog window choose the '''Asset''', '''Tag''' or '''Group''' to attach this decoder to and click the '''Save''' button.
+[[File:Networking rutos configuration example bag tower usecase decoder step 4 v2.jpg|border|class=tlt-border]]
+*Now you should be all set and your device information should now periodically update in the linked Assets Detail page. Your device asset in BAG·Tower platform should now be shows as Online and its Detail page should now show graphs with information from device.
+[[File:Networking rutos configuration example bag tower usecase asset list online asset v2.jpg|border|class=tlt-border|1104x1104px]]
+[[File:Networking rutos configuration example bag tower usecase asset details online v1.jpg|border|class=tlt-border|1104x1104px]]
+*If that is not the case try repeating these steps or contacting support for more information.
+==References==
 BAG·Tower official site: https://www.getbagtower.com/en/home
 BAG·Tower guide to connecting Teltonika asset: https://bagtower.tawk.help/en-us/article/connecting-teltonika-asset