Differences

This shows you the differences between two versions of the page.

--- wiki:wiki3:faq_message_buffering [2020/10/07 16:58]
tda
+++ wiki:wiki3:faq_message_buffering [2023/02/02 10:30] (current)
ehe [How to configure the number of messages in database ?]
@@ Line 5: / Line 5: @@
 To activate message buffering, issue the following command:
-<code>/usr/bin/lorafwdctl database.enable true</code>
+<code>lorafwdctl database.enable true</code>
 You can verify that the feature is enabled by reading the database.enable variable in the configuration file specified in ''/etc/default/lorafwd''
+  * For FW < 4.3.3 :
 <code>
@@ Line 21: / Line 24: @@
 root@klk-lpbs-050792:/etc/default # grep -i -A10 "\[ database \]" /user/etc/lorafwd/lorafwd.toml
+[ database ]
+# Whether or not a persistent database will store the incoming messages until
+# they will be sent and acknowledged.
+#
+# Type:    boolean
+# Example: true
+# Default: false
+#
+enable = true
+</code>
+   * For FW >= 4.3.3 :
+<code>
+root@klk-lpbs-050792:~ # cat /etc/default/lorafwd
+# Configuration file for lorafwd.
+# The configuration file.
+# The configuration files can be found in: /etc/lorafwd
+CONFIGURATION_FILE="/etc/lorafwd/lorafwd.toml"
+# The extra arguments.
+EXTRA_ARGS="-v"
+root@klk-lpbs-050792:/etc/default # grep -i -A10 "\[ database \]" /etc/lorafwd.toml
 [ database ]
@@ Line 34: / Line 65: @@
 </code>
 \\
+Then restart the packet forwarder:
+<code>
+monit stop lorafwd
+monit stop lorad
+monit start lorad
+monit start lorafwd
+</code>
 \\
 ===== How to deactivate the message buffering on my gateway? =====
@@ Line 41: / Line 80: @@
 <code>lorafwdctl database.enable false</code>
 You can verify that the feature is enabled by reading the database.enable variable in the configuration file specified in ''/etc/default/lorafwd''
+  * For FW < 4.3.3 :
 <code>
@@ Line 68: / Line 109: @@
 </code>
+  * For FW >= 4.3.3 :
+<code>
+root@klk-lpbs-050792:~ # cat /etc/default/lorafwd
+# Configuration file for lorafwd.
+# The configuration file.
+# The configuration files can be found in: /etc/lorafwd
+CONFIGURATION_FILE="/etc/lorafwd/lorafwd.toml"
+# The extra arguments.
+EXTRA_ARGS="-v"
+root@klk-lpbs-050792:/etc/default # grep -i -A10 "\[ database \]" /etc/lorafwd.toml
+[ database ]
+# Whether or not a persistent database will store the incoming messages until
+# they will be sent and acknowledged.
+#
+# Type:    boolean
+# Example: true
+# Default: false
+#
+enable = false
+</code>
 \\
+Then restart the packet forwarder:
+<code>
+monit stop lorafwd
+monit stop lorad
+monit start lorad
+monit start lorafwd
+</code>
 \\
-===== How to configurate the number of messages in database ? =====
+===== How to configure the number of messages in database ? =====
 <note important>
@@ Line 77: / Line 153: @@
 The maximum value is 1000 but **Kerlink does not recommend to change the default value of 200 to avoid system load issues**.
 </note>
+  * FW < 4.3.3:
 <code>
 root@klk-lpbs-050792:/etc/default # grep -i -A10 "\[ limit.messages \]" /user/etc/lorafwd/lorafwd.toml
+</code>
+  * FW >= 4.3.3:
+<code>
+root@klk-lpbs-050792:/etc/default # grep -i -A8 "The maximum number of messages" /etc/lorafwd.toml
+</code>
+<code>
 # The maximum number of messages allowed to be stored in the database. When
 # full the newest message will replace the oldest one.
@@ Line 89: / Line 176: @@
 #limit.messages = 200
 </code>
+Uncomment the variable limit.messages. Modify the value then restart the packet forwarder:
+<code>
+monit stop lorafwd
+monit stop lorad
+monit start lorad
+monit start lorafwd
+</code>
+\\
+===== How to enable the Message Buffering for a group of gateways ? =====
+The workflow is naturally designed to do this job. \\
+To enable the Message Buffering for a group of gateways, we will use the Workflow template "createGatewayCommand".
+=== Creating the template ===
+The first step is to create the workflow template. \\
+To achieve this, select the Workflows item from the main left menu and then select 'Templates'. \\
+Press the "+" icon to create a new one. \\
+{{:wiki3:creategatewaycommand.png?1000|}}
+Give a name to your template ex "createGatewayCommand" and give a description.
+Then drag and drop the web service "createGatewayCommand" to the "Selected" area.
+Finally select the "VALIDATE" button to confirm the template creation.
+=== Selecting gateways ===
+Select all the gateways you want to enable the Message Buffering feature.
+Care to select the same type of gateways (iSeries gateways or Wirnet Stations).
+{{:wiki3:selectinggateways.png?1000|}}
+=== Executing the template ===
+Click the "Selection" item from the top of the page :
+{{:wiki3:basketselection.png?800|}}
+Select "Execute workflow" item from the horizontal menu.
+Then, select the pull-down menu and select your template :
+{{:wiki3:executeworkflowmessagebuffering_1.png?1000|}}
+{{:wiki3:executeworkflowmessagebuffering_2.png?1000|}}
+Fill-in the field "command" with the following value :
+<code>
+monit stop lorafwd ; monit stop lorad ; lorafwdctl database.enable true ; monit start lorad ; monit start lorafwd
+</code>
+This command specifies to the system to stop the Packet Forwarder (lorad and lorafwd), changing the property "database.enable" to "true" to enable Message buffering and then restart the Packet Forwarder.
+Then press the "START" button to execute the workflow.
+The following message indicates that the workflow has started :
+{{:wiki3:executeworkflowmessagebuffering_3.png?300|}}
+Select the option "Running" in the "Workflows" menu from the left side of the page to check that the workflow is running and then select the option "Completed" and wait for the workflow completion (for 2 gateways the duration is 10 seconds). When terminating, the workflow disappears from the "Running" page and appears in the "Completed" page.
+{{:wiki3:executeworkflowmessagebuffering_4.png?1000|}}
+You can click the workflow template (here "createGatewayCommand" to see the individual result of the execution of the workflow for each gateway :
+{{:wiki3:executeworkflowmessagebuffering_5.png?1000|}}
+Message Buffering has been activated for all gateways specified in the workflow.

Wanesy™ Management Center (End Of Life)

User Tools

Site Tools

Differences

Page Tools