RMS Task Manager

Summary

The RMS Task Manager is a remote scripting tool with a user friendly graphics interface integrated into RMS platform. It is located in the Management section.

Introduction

---

Using Task Manager allows users to create Task Groups which can be executed on demand and for as many devices simultaneously as required. Task groups allows us to automate the process of downloading/uploading/executing. Each task group can consist of a lot of smaller tasks with different types, timeout intervals and acceptable return code configurations.

This article will provide information on what is needed in order to start using RMS Task Manager as well as configuration examples with step-by-step instructions for different usage scenarios.

Overview

In the main Task Manager page, you'll be able to:

1. Create a new task group or view files that have been created/imported during task execution.
2. Search through existing task groups.
3. Edit or remove task group
4. Change table settings or refresh data.

Creating a new Task Group

A new task group can be created by selecting Actions and then clicking on the + Create task group button inside Task Manager configuration menu,

A New task group window will open:

On a new task group window, settings of this task group and its tasks can be edited:

1. Task group name - it is a name of your entire Task group
2. Assign tags when task group succeeds - enabling this allows the user to select tags that will be automatically applied if the task succeeds
3. Assign tags when task group fails - enabling this allows the user to select tags that will be automatically applied if the task fails

4. Task name - this field names one of your tasks inside this specific task group
5. Task type - select one type from the drop down menu for this specific task:

• Upload file

• File to upload - select file to be uploaded to the device
• Target file path - location of where this file should be uploaded

• Download file

• File path in device - location of the file in the device to be downloaded

6. Command variables - when set, value of the key can be changed during the execution of the task group. Press the + Add variable button to create a new variable

1. Key - variable key to be written into the command
2. Value - default value of the key
3. Description - this is an optional field, can be used to clarify the purpose of the variable
4. Other selectable values

7. Command - command that needs to be executed on the device
8. Timeout(seconds) - set a time limit of how long the task is allowed to take before timeout
9. Acceptable codes - add return codes that are accepted as 'non failure', which means the task will count as completed without fail
10. Stop task group on failure - if the box is unchecked, next task will be executed even if the current one fails

11. [+] Add new task - used to add another task to this specific task group
12. Save button saves the task group changes
13. In this section all tasks in the task group will be displayed.

Executing Task Groups

Once task groups are created, you can execute them on selected devices.

	Navigate to the Management → Devices section Select one or more devices to execute the task on Click on the Actions dropdown menu In the expanded menu, open the Actions submenu Click Execute task

The Execute task window will pop up: Reconfirm the selection by checking the boxes for the devices where the task group should be executed Execute the task group Once the task is finished, the Action status menu will display whether the task group tasks were successful or not:

Editing Task Groups

Task groups can be edited by clicking Edit group tasks button, which is located in the Task manager's main page:

Deleting Task Groups

Task groups can be deleted by clicking Remove group button, which is located in the Task manager's main page:

Configuration Examples

In this section, several configuration examples will be demonstrated to illustrate different setups and use cases.

Setting Mobile Data Limit

---

In this example, we will set mobile data limit on SIM1 interface. We will achieve this by creating new Task group in RMS Task Manager and using Command as a task type.

• Create a new task group by clicking the + Create task group button as described in the Creating a new Task Group section of this page.
• Define Task group name, select Command as a task type on the first task and insert the following text into Command field:

uci set quota_limit.mob1s1a1.enabled='1'

• Click on the [+] (Add new task) button to add a second task, make settings identical to the first task and insert the following command into the Command field (this will set the mobile limit to 2GB or 2048MB):

uci set quota_limit.mob1s1a1.data_limit='2048'

• Add another task with identical settings and insert the following text into the Command field (this will set the period of the data limit to 1 day:

uci set quota_limit.mob1s1a1.period='1'

• Add another task with identical settings and insert the following text into the Command field (this will commit the changes and restart the mobile interface):

uci commit && ifdown mob1s1a1 && ifup mob1s1a1

Here is a review of all 4 tasks in this task group:

Installing Additional Packages

---

In this example, we will install an additional package to the device using opkg commands as well as generate and download a log file to see if package was installed successfully. For this example, we will install DNP3 package.

• Create a new task group by clicking the + Create task group button as described in the Creating a new Task Group section of this page.
• Define Task group name, select Command as a task type on the first task and insert the following text into Command field:

opkg update

• Set Timeout to 30 seconds, since updating package repository might take longer than the default 10 seconds.
• Add "1" to acceptable codes, since while updating repositories, some links might be unavailable, this is done to avoid getting an error message while executing a task. Alternatively, you can uncheck "Stop task group on failure" box to achieve the same result.
• Configuration of the first task should look like the following image:

• Click on the [+] (Add new task) button to add a second task, once again select Command as a task type and insert the following text into command field:

opkg install dnp3 >> /tmp/opkglog.log

• This will install the package as well as save the installation logs to the defined log file.
• Set the timeout to 30 seconds, since the installation process can take longer than the default 10 seconds.
• Second task configuration should look like the following image:

• Now we will download the generated log file to read the logs of installation.

• Click on the [+] (Add new task) button to add a third task, this time, select Download file as a task type and insert the following path to the File path in device field:

/tmp/opkglog.log

• Configuration of the third task should look like the following image:

Note: Downloaded files can be found by navigating to Management → Files