Devices Module

From Wiki Mupssoft
Jump to: navigation, search

Device List

It is used to add devices to the database and group them according to the selected attribute. Further, when using other modules of mupsbox, we will work with groups of devices.

Device List

    On the Device List tab, there are buttons (from left to right):
  • Add device - Add device
  • Remove device - Remove device
  • Enable device - Enable device
  • Disable device - Disable device
  • Start winbox - Start winbox
  • Start ssh - Start ssh
  • Refresh - Refresh
  • Check the availability of a dedicated device - Check the availability of a dedicated device
  • Check the availability of all devices - Check the availability of all devices
  • Kill threads - Kill threads
  • Export the list of devices - Export the list of devices (including their data, such as un, login, password, etc.)
  • Import the list of all devices - Import the list of all devices (including their data, such as un, login, password, etc.)
  • Update the ROS version - Update the ROS version
  • Upgrade the BIOS - Upgrade the BIOS
  • CMD - Send a command to the selected device
  • Export the visible list of devices in Excel - Export the visible list of devices in Excel

Add device

To add a device, press Add device, a window will appear where you need to enter device data.

Add Device

  • Hostname - Any convenient device name.
  • Host IP - Device IP address.
  • Use default port - Your api or api-ssl port that you opened on RouterOS.
  • Username - Username to login to device.
  • Password - Password to login to device.
  • Winbox port - Your winbox port, which you registered in Ip -> Services
  • SSH port - Your ssh port, which you registered in Ip -> Services
  • Join in group - Select the groups to which the device will belong.
  • Available groups - Existing groups created in the Groups tab.
  • Add device - After entering all the data, click the add device button. All data will be applied and you will see your device in the device list.
  • Copy - If you have many devices with the same data, and differ only in Hostname and IP address, use the copy button to speed up the process of making devices.

Export and import devices

To export all devices with their data, click the Export the list of devices button. A confirmation window will appear.

Сonfirm

If you want to export all data including passwords, click yes. If you want to export all data without passwords, click no. (All passwords in the program are encrypted.)


To import all devices with their data, click the Import the list of devices button. A confirmation window will appear.

Сonfirm

If your file contains encrypted passwords, click yes; otherwise, click no.


Command line

To send a ROS command to a specific router, select the router using the navigation keys or click on it with the mouse and click the CMD button. The following window will appear:

CMD work space

Enter the command in the field and click Enter. Don`t use SSL checkbox is used to ignore the API-SSL port and send commands on the API port.

CMD work space

If you entered several commands in a row, you can navigate between them using the up and down arrows

Working with device lists and filtering

If you have a lot of devices and you need to filter the device (s) by a specific attribute (Hostname, IP address, board-name, etc.), start typing this character in the Search field.

Device List

Having sorted the devices by a certain attribute, you can export the sorted list to Excel by pressing the Export the visible list of devices in Excel button.

To filter devices by groups, check the box to use group filtering. To select filtering conditions by group, click the Select groups button. The following window will appear:

Device List Group Filter

Check the box next to the group (s) you want to display. If you check a NOT IN, it will show all devices that are not included in the marked group.

To navigate through the devices, you can use the up and down navigation keys. Clicking Enter on the selected device opens a window with its data. Clicking delete the program will prompt you to delete the selected device or selected devices. To select devices, use shift and ctrl keys. You can select devices with the left mouse button, deselect with the right.


Customize Device List

To turn off unnecessary columns, click the down arrow next to the hostname column. As shown in the picture below. Use the mouse to select the columns you want to disable or enable for viewing.

Customize Device List


Device on Group

In this tab, you can add a device to the group or remove it from the group. To add a device, click the Add device button and the following window will appear:

Device to group

Select the device and group to which it should belong. And click the Add link button.


To remove a device from a group, click the Remove button. A query will appear:

Device delete from group

Click Yes to delete or No to cancel.

Groups

This tab is intended for creating groups, sending commands to a group of devices and for modifying the data of a group of devices in the device list.

Groups

Add group

To add a group, click the Add group button and the following window will appear:

Add Group

  • Name - Any convenient group name.
  • Description - Group description.

Remove group

To remove a group, click the Remove button. A query will appear:

Deletegroup

Click Yes to delete or No to cancel.

Command line

To send a ROS command to a group of devices, select the group using the navigation keys or click on it with the mouse and click the CMD button. The following window will appear:

CMD work space

Enter the command in the field and click Enter. Don`t use SSL checkbox is used to ignore the API-SSL port and send commands on the API port.

CMD work space

If you entered several commands in a row, you can navigate between them using the up and down arrows

Settings for groups

When you need to change data such as login, password, port, type of port for a group of devices, click on the Settings for groups button. The following window will appear:

Settings for groups

Enter the new data and tick the changes that you want to apply for the selected group of devices. Click OK and in the device settings for the selected group the data that you noted will change.