Line 1: |
Line 1: |
| <!-- Template uses {{{name}}}, {{{series}}}, {{{bluetooth}}}, {{{wifi}}}--> | | <!-- Template uses {{{name}}}, {{{series}}}, {{{bluetooth}}}, {{{wifi}}}--> |
− | {{Template:Networking_rutos_manual_fw_disclosure | + | {{Template: Networking_rutos_manual_fw_disclosure |
− | | fw_version = {{{series}}}_R_00.02.05 | + | | fw_version ={{Template: Networking_rutos_manual_latest_fw |
− | | series = {{{series}}} | + | | series = {{{series}}} |
| + | | name = {{{name}}} |
| + | }} |
| }} | | }} |
− | | + | {{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} Modbus (legacy WebUI)#Modbus_Data_to_Server|click here]]</b> for the old style WebUI (FW version {{Template: Networking_rutos_manual_latest_fw | series = RUT9XX}} and earlier) user manual page.</i>|}} |
| + | {{#ifeq: {{{series}}} | RUT2 |<br><i><b>Note</b>: <b>[[{{{name}}} Modbus (legacy WebUI)#Modbus_Data_to_Server|click here]]</b> for the old style WebUI (FW version {{Template: Networking_rutos_manual_latest_fw | series = RUT2XX}} and earlier) user manual page.</i>|}} |
| + | __TOC__ |
| ==Summary== | | ==Summary== |
| | | |
| The <b>Data to Server</b> feature provides you with the possibility to set up data senders that collect data from various sources and periodically send it to remote servers. | | The <b>Data to Server</b> feature provides you with the possibility to set up data senders that collect data from various sources and periodically send it to remote servers. |
| + | {{#switch: {{{series}}} |
| + | | RUTX = |
| + | | TRB1 = |
| + | | TRB2 = |
| + | | RUT9|RUT9M = |
| + | | #default = |
| + | <u><b> |
| | | |
| + | Note:</b> On {{{name}}}, Data to Server is additional software that can be installed from the <b>Services → [[{{{name}}} Package Manager|Package Manager]]</b> page. |
| + | |
| + | </u>}} |
| {{Template:Networking_rutos_manual_basic_advanced_webui_disclaimer | | {{Template:Networking_rutos_manual_basic_advanced_webui_disclaimer |
| | series = {{{series}}} | | | series = {{{series}}} |
Line 17: |
Line 31: |
| A <b>Data Sender</b> is an instance that gathers and periodically sends collected data to a specified server. The Data Senders list is empty by default so, in order to begin configuration you must add a new data sender first. To add a new data sender, click the 'Add' button. | | A <b>Data Sender</b> is an instance that gathers and periodically sends collected data to a specified server. The Data Senders list is empty by default so, in order to begin configuration you must add a new data sender first. To add a new data sender, click the 'Add' button. |
| | | |
− | [[File:Networking_rutos_manual_data_to_server_data_senders_edit_button.png|border|class=tlt-border]] | + | [[File:Networking_rutos_manual_data_to_server_data_senders_add_button.png|border|class=tlt-border]] |
| | | |
| After this you should be redirected to the newly added data sender's configuration page. | | After this you should be redirected to the newly added data sender's configuration page. |
Line 27: |
Line 41: |
| <b>Note</b>: these tables have coloring schemes to indicate which fields can be seen with different configuration. | | <b>Note</b>: these tables have coloring schemes to indicate which fields can be seen with different configuration. |
| | | |
− | [[File:Networking_rutos_manual_data_to_server_advanced_sender_settings.png|border|class=tlt-border]] | + | [[File:Networking_rutos_manual_data_to_server_advanced_sender_settings_v2.png|border|class=tlt-border]] |
| | | |
| ====General==== | | ====General==== |
− | ----
| + | |
| <table class="nd-mantable"> | | <table class="nd-mantable"> |
| <tr> | | <tr> |
Line 46: |
Line 60: |
| <td>string; default: <b>none</b></td> | | <td>string; default: <b>none</b></td> |
| <td>Name of the data sender. Used for easier data senders management purposes only (optional).</td> | | <td>Name of the data sender. Used for easier data senders management purposes only (optional).</td> |
− | </tr>{{#ifeq: {{{wifi}}} | 1 | | + | </tr> |
| <tr> | | <tr> |
| <td>Data source</td> | | <td>Data source</td> |
− | <td>Modbus data {{#ifeq:{{{bluetooth}}}|1|<nowiki>|</nowiki> Bluetooth data |}}{{#ifeq:{{{wifi}}}|1|<nowiki>|</nowiki> WiFi scanner data|}}; default: <b>Modbus data</b></td> | + | <td><span style="color:red">Modbus data</span>{{#ifeq:{{{series}}}|RUT36X|<span class="asterisk">*</span>|}}{{#ifeq:{{{series}}}|RUT30X|<span class="asterisk">*</span>|}} {{#ifeq:{{{bluetooth}}}|1|<nowiki>|</nowiki> <span style="color:green">Bluetooth data</span> |}} {{#ifeq:{{{wifi}}}|1|<nowiki>|</nowiki> WiFi scanner data{{#ifeq: {{{series}}} | RUTX | | <span class="asterisk">*</span>}}|}} | <span style="color:magenta">DNP3</span><span class="asterisk">*</span> {{!}} DNP3 data flash<span class="asterisk">*</span>; default: <b>Modbus data</b></td> |
| <td>Source of the data to be sent to server.</td> | | <td>Source of the data to be sent to server.</td> |
− | </tr>|}} | + | </tr> |
| <tr> | | <tr> |
| <td>Protocol</td> | | <td>Protocol</td> |
− | <td>HTTP(S) | MQTT | Kinesis; default: <b>HTTP(S)</b></td> | + | <td>HTTP(S) | MQTT{{#ifeq: {{{series}}} | RUTX || <span class="asterisk">*</span>}} | Kinesis; default: <b>HTTP(S)</b></td> |
| <td>Protocol used for sending the data to server.</td> | | <td>Protocol used for sending the data to server.</td> |
| </tr> | | </tr> |
Line 83: |
Line 97: |
| </tr> | | </tr> |
| <tr> | | <tr> |
− | <td>Data filtering</td> | + | <td><span style="color:red">Data filtering</span></td> |
| <td>All data | <span style="color:darkred">By slave ID</span> | <span style="color:blue">By slave IP</span>; default: <b>All data</b></td> | | <td>All data | <span style="color:darkred">By slave ID</span> | <span style="color:blue">By slave IP</span>; default: <b>All data</b></td> |
− | <td>Choose which data this sender will send to server.</td> | + | <td>If Data source: <span style="color:red">Modbus data</span>. Choose which data this sender will send to server.</td> |
| </tr> | | </tr> |
| <tr> | | <tr> |
Line 94: |
Line 108: |
| <tr> | | <tr> |
| <td><span style="color:blue">By slave IP:</span> Slave IP</td> | | <td><span style="color:blue">By slave IP:</span> Slave IP</td> |
− | <td>ip; default: </b>none</b></td> | + | <td>ip; default: <b>none</b></td> |
| <td>IP address of the Modbus slave whose collected data will be sent to server (for Modbus TCP slaves).</td> | | <td>IP address of the Modbus slave whose collected data will be sent to server (for Modbus TCP slaves).</td> |
| + | </tr>{{#ifeq:{{{bluetooth}}}|1| |
| + | <tr> |
| + | <td><span style="color:green">Data filtering</span></td> |
| + | <td>All data <nowiki>|</nowiki> <span style="color:darkred">By MAC address</span> <nowiki>|</nowiki> <span style="color:blue">By device name</span>; default: <b>All data</b></td> |
| + | <td>If Data source: <span style="color:green">Bluetooth data</span>. Choose which data this sender will send to server.</td> |
| + | </tr> |
| + | <tr> |
| + | <td><span style="color:darkred">By MAC address:</span> MAC address</td> |
| + | <td>mac; default: <b>none</b></td> |
| + | <td>MAC address of bluetooth device whose collected data will be sent to server.</td> |
| + | </tr> |
| + | <tr> |
| + | <td><span style="color:blue">By device name:</span> Device name</td> |
| + | <td>string; default: <b>none</b></td> |
| + | <td>Device name of bluetooth device whose collected data will be sent to server.</td> |
| + | </tr>|}} |
| + | <tr> |
| + | <td><span style="color:magenta">Data filtering</span></td> |
| + | <td>All data <nowiki>|</nowiki> <span style="color:darkred">DNP3 Address</span> <nowiki>|</nowiki> <span style="color:blue">DNP3 IP</span>; default: <b>All data</b></td> |
| + | <td>If Data source: <span style="color:magenta">DNP3</span>. Choose which data this sender will send to server.</td> |
| + | </tr> |
| + | <tr> |
| + | <td><span style="color:darkred">DNP3 Address:</span> DNP3 Address</td> |
| + | <td>integer [0..65519]; default: <b>none</b></td> |
| + | <td>DNP3 address of device whose collected data will be sent to server.</td> |
| + | </tr> |
| + | <tr> |
| + | <td><span style="color:blue">DNP3 IP:</span> DNP3 IP</td> |
| + | <td>ip | domain; default: <b>none</b></td> |
| + | <td>IP address of DNP3 device whose collected data will be sent to server.</td> |
| </tr> | | </tr> |
| <tr> | | <tr> |
Line 104: |
Line 148: |
| </table> | | </table> |
| <br> | | <br> |
| + | |
| + | <span class="asterisk">*</span> This is additional software that can be installed from the <b>Services → [[{{{name}}} Package Manager|Package Manager]]</b> page. |
| ====Protocol HTTP(S)==== | | ====Protocol HTTP(S)==== |
− | ----
| + | |
| <table class="nd-mantable"> | | <table class="nd-mantable"> |
| <tr> | | <tr> |
Line 120: |
Line 166: |
| <td>Use TLS</td> | | <td>Use TLS</td> |
| <td>off | <span style="color:red">on</span>; default: '''off'''</td> | | <td>off | <span style="color:red">on</span>; default: '''off'''</td> |
− | <td>Enables the use of TSL certificates.</td> | + | <td>Enables the use of TLS certificates.</td> |
| </tr> | | </tr> |
| <tr> | | <tr> |
Line 128: |
Line 174: |
| </tr> | | </tr> |
| <tr> | | <tr> |
− | <td><span style="color:red">On:</span> A File</td> | + | <td><span style="color:red">On:</span> CA File</td> |
| <td>.ca file; default: <b>none</b></td> | | <td>.ca file; default: <b>none</b></td> |
| <td>'''Certificate authority''' is an entity that issues digital certificates. A digital certificate certifies the ownership of a public key by the named subject of the certificate.</td> | | <td>'''Certificate authority''' is an entity that issues digital certificates. A digital certificate certifies the ownership of a public key by the named subject of the certificate.</td> |
Line 145: |
Line 191: |
| <br> | | <br> |
| ====Protocol MQTT==== | | ====Protocol MQTT==== |
− | ----
| + | |
| <table class="nd-mantable"> | | <table class="nd-mantable"> |
| <tr> | | <tr> |
Line 166: |
Line 212: |
| <td>string; default: <b>none</b></td> | | <td>string; default: <b>none</b></td> |
| <td>MQTT topic to be used for publishing the data.</td> | | <td>MQTT topic to be used for publishing the data.</td> |
| + | </tr> |
| + | <tr> |
| + | <td>Client ID</td> |
| + | <td>string; default: <b>none</b></td> |
| + | <td>Client ID to send with the data. If empty, a random client ID will be generated</td> |
| </tr> | | </tr> |
| <tr> | | <tr> |
Line 178: |
Line 229: |
| <td>Use TLS</td> | | <td>Use TLS</td> |
| <td>off | <span style="color:red">on</span>; default: '''off'''</td> | | <td>off | <span style="color:red">on</span>; default: '''off'''</td> |
− | <td>Enables the use of TSL certificates.</td> | + | <td>Enables the use of TLS certificates.</td> |
| </tr> | | </tr> |
| <tr> | | <tr> |
Line 224: |
Line 275: |
| <td>string; default: <b>none</b></td> | | <td>string; default: <b>none</b></td> |
| <td>Password used in authentication.</td> | | <td>Password used in authentication.</td> |
| + | </tr> |
| + | </table> |
| + | </br> |
| + | ====Protocol Kinesis==== |
| + | |
| + | <table class="nd-mantable"> |
| + | <tr> |
| + | <th>Field</th> |
| + | <th>Value</th> |
| + | <th>Description</th> |
| + | </tr> |
| + | <tr> |
| + | <td>Stream name</td> |
| + | <td>string; default: <b>none</b></td> |
| + | <td>The name of the stream for which to start encrypting records.</td> |
| + | </tr> |
| + | <tr> |
| + | <td>Partition key</td> |
| + | <td>string; default: <b>none</b></td> |
| + | <td>The partition key is used by Kinesis Data Streams as input to a hash function that maps the partitionkey and associated data to a specific shard.</td> |
| + | </tr> |
| + | <tr> |
| + | <td>API version</td> |
| + | <td>positive integer; default: <b>none</b></td> |
| + | <td>Optional. Used version of the Kinesis API.</td> |
| + | </tr> |
| + | <tr> |
| + | <td>Region</td> |
| + | <td>string; default: <b>none</b></td> |
| + | <td>Region code of the Kinesis server.</td> |
| + | </tr> |
| + | <tr> |
| + | <td>Domain</td> |
| + | <td>domain; default: <b>none</b></td> |
| + | <td>Domain of the Kinesis server. E.g. 'amazonaws.com'</td> |
| + | </tr> |
| + | <tr> |
| + | <td>Access key</td> |
| + | <td>string; default: <b>none</b></td> |
| + | <td>Access key ID is a part of Access keys used for authentication.</td> |
| + | </tr> |
| + | <tr> |
| + | <td>Secret key</td> |
| + | <td>string; default: <b>none</b></td> |
| + | <td>Secret access key is a part of Access keys used for authentication.</td> |
| + | </tr> |
| + | <tr> |
| + | <td>Use TLS</td> |
| + | <td>off | <span style="color:red">on</span>; default: '''off'''</td> |
| + | <td>Enables the use of TLS certificates.</td> |
| + | </tr> |
| + | <tr> |
| + | <td><span style="color:red">On:</span> TLS type</td> |
| + | <td>Certificate based; default: '''Certificate based'''</td> |
| + | <td>Select type of TLS.</td> |
| + | </tr> |
| + | <tr> |
| + | <td><span style="color:red">On:</span> CA File</td> |
| + | <td>.ca file; default: <b>none</b></td> |
| + | <td>'''Certificate authority''' is an entity that issues digital certificates. A digital certificate certifies the ownership of a public key by the named subject of the certificate.</td> |
| + | </tr> |
| + | <tr> |
| + | <td><span style="color:red">On:</span> Client Certificate</td> |
| + | <td>.crt file; default: <b>none</b></td> |
| + | <td>Certificate file is a type of digital certificate that is used by client systems to make authenticated requests to a remote server. If client certificate is not needed, leave both client certificate and client key fields empty.</td> |
| + | </tr> |
| + | <tr> |
| + | <td><span style="color:red">On:</span> Private Key</td> |
| + | <td>.key file; default: <b>none</b></td> |
| + | <td>File containing private key for this client. This file needs to be not encrypted.</td> |
| </tr> | | </tr> |
| </table> | | </table> |
| | | |
| [[Category:{{{name}}} Services section]] | | [[Category:{{{name}}} Services section]] |