Difference between revisions of "Template:Rms manual management device submenu add device list"

From Teltonika Networks Wiki
(38 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<ul>
+
To add a new device(s) to RMS, go to the RMS web page, Left sidebar panel, (<b>Management → Devices</b>) and click on <b>Devices</b> submenu.
    <li>First, you must compile a list of devices. The list must be comprised of devices' <b>serial numbers</b> and <b>LAN MAC addresses</b> (<b>IMEIs</b> for TRB) and it must be stored in a <b>CSV</b> file. You can create CSV files with programs like <i>Microsoft Excel</i>, <i>OpenOffice Calc</i> or a simple text editor like <i>Notepad</i>, which we'll be using for this example.<br>Create a new text file and list your devices. An entry for a single device should be comprised of the device's serial number and LAN MAC address (or IMEI) separated by a <b>comma</b> (<b>,</b>) symbol. Different entries for different devices should be separated by <b>line breaks</b>:<br>[[File:Networking_rms_manual_management_device_add_device_list_part_1_v1.png]]
+
 
    </li>
+
Scroll your mouse pointer to the Top control '''Device''' menu and select '''Add devices from file''' (Device → Add devices from file).
 +
 
 +
[[File:RMS-device-menu-left-sidebar-panel.jpg]] [[File:Rms manual top menu add devices v1.png]]
 +
 
 +
===Tutorial===
 
----
 
----
    <li>When you're done, do not save the file as is. Instead click the "Save As" option. Then next to "Save as type" choose "All Files" and add the '''.csv''' extension next to the file name (if you're using Linux, you can just add the same extension to the file name after saving the file the regular way):<br>[[File:Networking_rms_manual_management_device_add_device_list_part_2_v1.png]]
+
Watch our [https://youtu.be/cFYt_y15czo?t=236 '''Youtube tutorial'''] to learn how to add multiple devices from CSV file.
    </li>
+
 
 +
<br>
 +
<youtube>cFYt_y15czo</youtube>
 +
 
 +
<br>
 +
 
 +
===Step by step instructions===
 
----
 
----
    <li>Once you have the list file in order, navigate your mouse pointer to the Device submenu ('''Management → Device''') and click <b>Add device list</b>:<br>[[File:Networking_rms_manual_management_device_add_device_list_part_3_v1.png]]
+
Alternatively, read these step by step instructions to learn how to add multiple devices using the CSV file.
    </li>
+
 
 +
# [https://rms.teltonika-networks.com/assets/demo_files/Demo_add_device_list.csv Download demo CSV file]
 +
# Add your device information and prepare the CSV (see section Preparing CSV file for more details).
 +
# Once you have the CSV file in order, go to the RMS web page, Left sidebar panel (<b>Management → Devices</b>), and click on the <b>Devices</b> submenu.
 +
# Move your mouse pointer to the Top control '''Device''' menu (Device → Add devices from file).
 +
# Select the file type as '''CSV file''', choose '''Company''', select '''Device series''' and finally select your '''CSV file'''.
 +
# When ready, click the '''Upload''' button. Keep in mind, adding more than a few hundred devices at once will take some time.
 +
 
 +
A pop-up indicating the number of new devices that have been added should appear at the top of the screen:
 +
<br>
 +
[[File:RMS-Success-devices-added.jpg]]
 +
 
 +
'''<span style="color:#0455a4"><big>Important!</big></span>'''
 
----
 
----
    <li>In the pop-up box select the desired profile, upload the list file and click <b>Add device list</b>:<br>[[File:Networking_rms_manual_management_device_add_device_list_part_4_v1.png]]
+
*'''Enable auto crediting checkmark''' - if checked, a credit will automatically be assigned to the added device (if there are any available).
    </li>
+
*The devices should appear in the device table immediately, but at first they will be shown as offline (<span style="color:#e04549">'''red'''</span>).
 +
*When the status circle turns <span style="color:#368d3b">'''green'''</span>, the system will have finished adding the device to RMS.
 +
*The time it takes for the system to register all devices may vary depending on the number of devices.
 +
 
 +
[[File:RMS-add-device-green-light.jpg]]
 +
 
 +
<br>
 +
 
 +
===Preparing CSV file===
 
----
 
----
    <li>A new pop-up box signifying the number of new devices that have been added should appear. You can close it:<br>[[File:Networking_rms_manual_management_device_add_device_list_part_5_v1.png]]
+
You can download an example file [https://rms.teltonika-networks.com/assets/demo_files/Demo_add_device_list.csv from here]. Or you can prepare the CSV file for your list of devices manually. The list must be comprised of devices <b>LAN MAC addresses,</b> <b>Serial numbers</b> (<b>IMEIs</b> for TRB), and '''Name''' columns. You must save it as a <b>CSV</b> file. You can create/edit CSV files with programs like <i>Microsoft Excel</i>, <i>OpenOffice Calc</i>, or a simple text editor like <i>Notepad</i>, which we'll use for this example.
    </li>
+
 
 +
Create a new text file and set the order of device parameters in the first line. For example:
 +
 
 +
mac,serial,name
 +
 
 +
Single entry for single device consists of the device's LAN MAC address (or IMEI) and serial number separated by <b>commas</b> (<b>,</b>). Each line should contain information about a single device (see example below).
 +
 
 +
[[File:RMS-CSV-file-example-notepad.png]]
 +
 
 +
'''<span style="color:#0455a4"><big>Important!</big></span>'''
 +
 
 +
* 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 Files" 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).
 +
 
 +
===RMS WebUI settings===
 
----
 
----
    <li>Don't forget to set the <b>Connection type</b> field the <b>Enabled</b> on the device(s) that you are trying to add. You can do that from the <b>System → Administration → RMS</b>:<br>[[File:Networking rms manual management device add device part 4 v3.png]]
+
Although Teltonika devices have RMS service enabled by default, but make sure to set the <b>Connection type</b> field to the <b>Enabled</b> on the device(s) that you are trying to add. For RUTX11, you can do that from <b>Services → Cloud Solutions → RMS</b> and for RUT955 from the <b>System → Administration → RMS</b>.
    </li>
+
 
 +
[[File:RMS-connection-settings-for-webui.jpg]]
 +
 
 +
===Manufacturing file===
 
----
 
----
    <li>The devices should appear in the device table immediately, but at first they will be shown as offline (red). When the circle under the Status column turns green, then the device will have finished connecting to RMS:<br>[[File:Networking_rms_manual_management_device_add_device_list_part_6_v1.png]]<br>
+
This section allows you to import devices from the manufacturing file provided by the purchased devices. If you have not received such a file, please contact your Teltonika Networks sales manager.
<b>NOTE</b>: the time that it takes for all devices to be registered on the system may vary depending on the number of devices.
+
 
    </li>
+
Do add the devices from the manufacturing file follow step by step instructions below.
</ul>
+
 
 +
# Have the manufacturing file ready.
 +
# Go to the RMS web page, Left sidebar panel (<b>Management → Devices</b>) and click on <b>Devices</b> submenu.
 +
# Move your mouse pointer to the Top control '''Device''' menu (Device → '''Add devices from file''').
 +
# In the '''File type''' section select '''Manufacturing file'''
 +
 
 +
[[File:RMS-manufacturing-file-type.jpg]]
 +
 
 +
# Select your '''company''' add select your XSL file.
 +
# And when ready click '''Upload''' button. Keep in mind, adding more than a few hundred devices at once will take some time.
 +
 
 +
 
 +
'''<span style="color:#0455a4"><big>Important!</big></span>'''
 +
 
 +
* Only RUT devices can be added from manufacturing file.
 +
* If you have not received such a file please contact your Teltonika Networks sales manager.

Revision as of 17:58, 31 January 2021

To add a new device(s) to RMS, go to the RMS web page, Left sidebar panel, (Management → Devices) and click on Devices submenu.

Scroll your mouse pointer to the Top control Device menu and select Add devices from file (Device → Add devices from file).

RMS-device-menu-left-sidebar-panel.jpg Rms manual top menu add devices v1.png

Tutorial


Watch our Youtube tutorial to learn how to add multiple devices from CSV file.



Step by step instructions


Alternatively, read these step by step instructions to learn how to add multiple devices using the CSV file.

  1. Download demo CSV file
  2. Add your device information and prepare the CSV (see section Preparing CSV file for more details).
  3. Once you have the CSV file in order, go to the RMS web page, Left sidebar panel (Management → Devices), and click on the Devices submenu.
  4. Move your mouse pointer to the Top control Device menu (Device → Add devices from file).
  5. Select the file type as CSV file, choose Company, select Device series and finally select your CSV file.
  6. When ready, click the Upload button. Keep in mind, adding more than a few hundred devices at once will take some time.

A pop-up indicating the number of new devices that have been added should appear at the top of the screen:
RMS-Success-devices-added.jpg

Important!


  • Enable auto crediting checkmark - if checked, a credit will automatically be assigned to the added device (if there are any available).
  • The devices should appear in the device table immediately, but at first they will be shown as offline (red).
  • When the status circle turns green, the system will have finished adding the device to RMS.
  • The time it takes for the system to register all devices may vary depending on the number of devices.

RMS-add-device-green-light.jpg


Preparing CSV file


You can download an example file from here. Or you can prepare the CSV file for your list of devices manually. The list must be comprised of devices LAN MAC addresses, Serial numbers (IMEIs for TRB), and Name 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 and set the order of device parameters in the first line. For example:

mac,serial,name

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

RMS-CSV-file-example-notepad.png

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 Files" 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).

RMS WebUI settings


Although Teltonika devices have RMS service enabled by default, but make sure to set the Connection type field to the Enabled on the device(s) that you are trying to add. For RUTX11, you can do that from Services → Cloud Solutions → RMS and for RUT955 from the System → Administration → RMS.

RMS-connection-settings-for-webui.jpg

Manufacturing file


This section allows you to import devices from the manufacturing file provided by the purchased devices. If you have not received such a file, please contact your Teltonika Networks sales manager.

Do add the devices from the manufacturing file follow step by step instructions below.

  1. Have the manufacturing file ready.
  2. Go to the RMS web page, Left sidebar panel (Management → Devices) and click on Devices submenu.
  3. Move your mouse pointer to the Top control Device menu (Device → Add devices from file).
  4. In the File type section select Manufacturing file

RMS-manufacturing-file-type.jpg

  1. Select your company add select your XSL file.
  2. And when ready click Upload button. Keep in mind, adding more than a few hundred devices at once will take some time.


Important!

  • Only RUT devices can be added from manufacturing file.
  • If you have not received such a file please contact your Teltonika Networks sales manager.