RMS Devices

From Teltonika Networks Wiki
Main Page > IoT Platforms > RMS > RMS Manual > RMS Management > RMS Devices

Summary

The Management section's primary function is to control, monitor, and configure all your Teltonika Networks devices. First tab under this section is the Devices tab.


Overview

In this screen you can:

  1. Add devices to RMS, or change their parameters such as: location, names, tags. Also, configure devices and do various changes via the Actions button.
  2. Filter the table by various parameters such as: company, tags, mobile state and so on.
  3. Access the device WebUI and CLI, or view its details.
  4. Search through devices by their name, model, description, etc.
  5. In this action menu you can:
    1. Enable automatic table data refresh every 30s.
    2. Change table settings, presets, chart settings.
    3. Open devices map.
    4. Download the current table in CSV format.
    5. Do a manual refresh.

Actions button

All Management section features and functionalities are accessible using the Actions button. Press the button to open a dropdown menu. Below you will find in-depth information about each different menu.

Adding devices

Adding a device is the main prerequisite to start using RMS. You can either add a device by manually entering the required name, serial, LAN MAC/IMEI and password or by adding devices from the file.

Adding manually

  1. To add a new device(s) to RMS, click on Devices submenu
  2. Press the Actions button
  3. Select + Add device(s)

Alternatively, you can watch a Youtube tutorial:

Step by step instructions

Alternatively, read these step-by-step instructions to learn how to add a new device(s).

  • Make sure your device has an Internet connection.
  • Follow the directions above to locate the correct menu item.
  1. Select the desired company to which you will be adding the device.
  2. Select the model type of the device you will be adding.
  3. Enable device service if you want the device to be able to connect to the RMS platform (This will activate a trial credit or consume a credit from your RMS company credit pool)
  4. You can select the new firmware version and upload a configuration file (The firmware upgrade and configuration upload will be set as pending actions. They will be executed after the device successfully connects to RMS). Additionally, you can set a custom tag to the device.
  5. Provide the necessary details: input the desired device name, serial number, LAN MAC address, and the device's current admin password.
  6. Click Submit if all details are correct and you're ready to add the device to your RMS company.


  • Wait for about a minute for the system to finish adding the device(s). You will know the process is finished when the word "Done" appears under the Status field.
  • After closing the pop-up window, you will see the newly added device(s) a the top of the device table.

RMS Authentication code

In some cases, while adding the device, you will be provided an authentication code. This code is not related to the device's admin/root password. Code is only used to authorize the device with the associated RMS Company.

  • This authentication code for the provided device must be inserted in the devices RMS configuration.

Note: authentication code can only be inserted on devices with RutOS firmware 07.06.13, 07.07.x and above.

  1. In device's WebUI, navigate to Services -> Cloud Solutions -> RMS.
  2. In the field Authentication code, type in the code that was provided to you by RMS while adding the device. If you missed the authentication code during device registration, you can view it in the Device's details page in RMS or by changing table settings in the Devices page to display the Authentication code column.
  3. Save the change by clicking Save & Apply.
Adding a device with Authentication code

Important!

  • Click the plus () symbol to add more than one device.
  • Enable auto crediting checkmark - if checked, a credit will automatically be assigned to the added device (if there are credits available).
  • You can close the pop-up window earlier if you wish.
  • When the status circle turns green, the system will have finished adding the device to RMS.

Locating serial, MAC, IMEI

You can find the serial number, LAN MAC address, IMEI on the device or in the WebUI. For RUTX11 Services → Cloud Solutions → RMS or check for more information RUTX11 RMS page in Cloud Solutions. And for example, for RUT955, go to the System → Administration → RMS or visit RUT955 RMS page in Administration for more information.

Important! Make sure you are using the LAN MAC address when adding a device to RMS.

Adding from file

From CSV File:

  1. Select the From file tab.
  2. If needed, download the example CSV file from RMS (the file will change depending on the device series).
  3. Add your device information and prepare the file (see section Preparing CSV file for more details).
  4. Select the file type as CSV, choose Company, select Device series and finally select your CSV file.
  5. You can select the new firmware version and upload a configuration file (The firmware upgrade and configuration upload will be set as pending actions. They will be executed after the devices successfully connect to RMS). Additionally, you can set a custom tag to the devices.
  6. When ready, click the Upload button. Keep in mind, adding more than a few hundred devices at once might take some time.

A pop-up indicating the number of new devices that have been added should appear on the screen:

Finishing adding process

After you've added devices on the RMS web page, generally, they will connect to RMS by themselves. However, to speed up this process you can manually initiate a connection attempt from the device side. To do that:

  1. Connect to the WebUI
  2. Navigate to Services → Cloud solutions → RMS.
  3. Press Connect to initiate the connection between the device and RMS.

  • After a few moments you should see the state's status Connected.
  • Note: after a successful connection, the Connect button will change to Reconnect

Preparing CSV file

You can download an example file for RUT/TCR/TAP devices from here and for TRB devices from here. Or you can prepare the CSV file for your list of devices manually. The list must be have devices' LAN MAC addresses (IMEIs for TRB), Serial numbers, Name and Password columns. You must save it as a CSV file. You can create/edit CSV files with programs like Microsoft Excel, OpenOffice Calc, or a simple text editor like Notepad++, which we'll use for this example.

Create a new text file or download an example and set the order of device parameters in the first line. For example: 

mac,serial,name,password_confirmation

Each entry should consist of the device's LAN MAC address (or IMEI), serial number, and password separated by commas (,). Each line should contain information about a single device (see example below).

Important!

  • Do not forget to save your file as *.csv.
  • If you are editing the file with Notepad++. Click the "Save As" option. Then next to "Save as type", choose "All types" and add the .csv extension next to the file name.
  • If you're using Linux, you can add the same extension to the file name after saving the file the regular way.

View pending updates

If there are any devices with the Pending status (⬤) you can check any pending tasks by pressing the Actions button, selecting Management, and pressing View pending tasks. There you'll be able to select any pending tasks on devices and cancel them.

Page settings

Here, you can:

  • Change the order of the table and toggle on/off the table's columns.
  • Change table presets, and make a custom one.
  • Toggle on/off various charts, that you see on the top of the Devices page.

Toggle devices map

Here, you'll be able to view the devices' current location (either has to be set manually or have GPS enabled). You can also select any device by clicking on its pointer, or doing an area select.

Selecting multiple devices

To do an area selection:

  1. Click on the Select device(s) button.
  2. Select the devices by dragging an area on the map.
  3. Selected devices will have white pointers.

  • You can unselect devices by pressing Unselect
  • Toggle device table. If devices are selected on the map, they will also be selected in the device table.

Selecting a single device

  • You can also select a single device by clicking on its pointer. This will open a small overview of the device, from there you can view device details, and access its WebUI or CLI.

Device details

By clicking on the Device details icon in the actions column you'll be redirected to Device Details.

Retrieved from "https://wiki.teltonika-networks.com/index.php?title=RMS_Devices&oldid=148690"