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

From Teltonika Networks Wiki
(46 intermediate revisions by 2 users not shown)
Line 1: Line 1:
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.
 
  
Scroll your mouse pointer to the Top control '''Device''' menu and select '''Add devices from file''' (Device → Add devices from file).
+
The '''Add device list''' function is used to add multiple RUT devices to your device table at once.
 +
----
 +
* To add multiple devices at once you must first compile a list of your devices. The list must be comprised of devices' serial numbers and LAN MAC addresses and it must be stored in a '''CSV''' file. CSV is a simple file format used to store tabular data. You can create CSV files with programs like Microsoft's Excel or OpenOffice Calc or a simple Notepad type of program, 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 router's serial number and LAN MAC address separated by a '''comma''' (''',''') symbol. Different entries for different devices should be separated by '''line breaks''':
  
[[File:RMS-device-menu-left-sidebar-panel.jpg]] [[File:Rms manual top menu add devices v1.png]]
+
[[File:Add device list to rms part 1 v1.PNG]]
 
 
===Tutorial===
 
 
----
 
----
Watch our [https://youtu.be/cFYt_y15czo?t=236 '''Youtube tutorial'''] to learn how to add multiple devices from CSV file.
+
* When you're done, do not save the file as is. Instead click 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:How to save as csv.PNG]]
<youtube>cFYt_y15czo</youtube>
 
 
 
<br>
 
 
 
===Step by step instructions===
 
 
----
 
----
Alternatively, read these step by step instructions to learn how to add multiple devices using the CSV file.
+
* Once you have the list file in order, scroll your mouse pointer to the Device submenu ('''Management → Device''') and click "Add device list":
 
 
# [https://rms.teltonika-networks.com/assets-static/demo_files/Add_device_list_example.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>'''
+
[[File:Add device list to rms part 2 v1.png]]
 
----
 
----
*'''Enable auto crediting checkmark''' - if checked, a credit will automatically be assigned to the added device (if there are any available).
+
* In the pop-up box select the desired profile, upload the list file and click "Add device list":
*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]]
+
[[File:Add device list to rms part 3 v1.png]]
 
 
<br>
 
 
 
===Preparing CSV file===
 
 
----
 
----
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.
+
* A new pop-up box signifying the number of new devices that have been added should appear. You can close it:   
 
 
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]]
+
[[File:Add device list to rms part 4 v1.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===
 
 
----
 
----
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>.
+
* Don't forget to '''enable remote monitoring''' on the devices that you are trying to add. To do so, go to the router's WebUI and navigate to '''System → Administration → RMS''' and place a check mark next to the "Enable remote monitoring" field (detailed instructions provided '''[[How to enable remote access for RMS on the router?|here]]'''). This can be done either before or after clicking "Add device list" and '''must''' be done for each device that you are trying to add:
 
 
[[File:RMS-connection-settings-for-webui.jpg]]
 
  
===Manufacturing file===
+
[[File:Add device to rms part 1 v4.png]]
 
----
 
----
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.
+
* The devices should appear in the device table immediately, but at first they will be shown as being offline. When the power button symbol turns green next to each device, then the system will have finished connecting all of the specified devices to RMS:
 
 
Do add the devices from the manufacturing file follow step by step instructions below.
 
 
 
# 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>'''
+
[[File:Add device list to rms part 5 v1.png]]
  
* Only RUT devices can be added from manufacturing file.
+
'''NOTE''': the time that it takes for all devices to be registered on the system may vary depending on the number of devices.
* If you have not received such a file please contact your Teltonika Networks sales manager.
 

Revision as of 14:53, 10 May 2018

The Add device list function is used to add multiple RUT devices to your device table at once.


  • To add multiple devices at once you must first compile a list of your devices. The list must be comprised of devices' serial numbers and LAN MAC addresses and it must be stored in a CSV file. CSV is a simple file format used to store tabular data. You can create CSV files with programs like Microsoft's Excel or OpenOffice Calc or a simple Notepad type of program, which we'll be using for this example.
    Create a new text file and list your devices. An entry for a single device should be comprised of the router's serial number and LAN MAC address separated by a comma (,) symbol. Different entries for different devices should be separated by line breaks:

Add device list to rms part 1 v1.PNG


  • When you're done, do not save the file as is. Instead click 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):

How to save as csv.PNG


  • Once you have the list file in order, scroll your mouse pointer to the Device submenu (Management → Device) and click "Add device list":

Add device list to rms part 2 v1.png


  • In the pop-up box select the desired profile, upload the list file and click "Add device list":

Add device list to rms part 3 v1.png


  • A new pop-up box signifying the number of new devices that have been added should appear. You can close it:

Add device list to rms part 4 v1.png


  • Don't forget to enable remote monitoring on the devices that you are trying to add. To do so, go to the router's WebUI and navigate to System → Administration → RMS and place a check mark next to the "Enable remote monitoring" field (detailed instructions provided here). This can be done either before or after clicking "Add device list" and must be done for each device that you are trying to add:

Add device to rms part 1 v4.png


  • The devices should appear in the device table immediately, but at first they will be shown as being offline. When the power button symbol turns green next to each device, then the system will have finished connecting all of the specified devices to RMS:

Add device list to rms part 5 v1.png

NOTE: the time that it takes for all devices to be registered on the system may vary depending on the number of devices.