<h1>'''Device Configuration'''</h1>
<h2>'''Introduction'''</h2>
This section is not a tutorial on configuration different manufacturers. Here you will find the minimum settings in the CLI (for access from MUPSBOX to devices).

<h2>'''Cisco - IOS v15'''</h2>Minimum* configuration:

'''BASIC ETHERNET CONFIGURATION - SUMMARY STEPS'''

1. Router> '''enable'''

2. Router# '''configure terminal'''

3. Router(config)# '''interface gigabitethernet''' 0/0

4. Router(config-if)# '''ip adress''' 10.9.90.201 255.255.255.0

5. Router(config-if)# '''ipv6 address''' 2001:db8:B40:4000::101/64

6. Router(config-if)# '''no shutdown'''

7. Router(config-if)# '''exit'''

8. Router(config)# '''ip route 0.0.0.0 0.0.0.0''' 10.9.90.1

9. Router(config)# '''ipv6 route''' ::/0 2001:db8:B40:4000::1

'''BASIC SSH CONFIGURATION - SUMMARY STEPS'''

10. Router(config)# '''ip domain name''' domain.local

11. Router(config)# '''hostname''' MBRouter

12. MBRouter(config)# '''crypto key generate rsa modulus 1024'''

13. MBRouter(config)# '''username''' ''root'' privilege 15 '''secret''' ''PassW0rd''

14. MBRouter(config)# '''aaa new-model'''

15. MBRouter(config)# '''line vty 0 4'''

16. MBRouter(config-line)# '''transport input ssh'''

17. MBRouter(config-line)# '''exit'''

'''ADDITIONAL CONFIGURATION - SUMMARY STEPS'''

18. MBRouter(config)# '''enable secret''' PassW0rd

19. MBRouter(config)# '''service password-encryption'''

20. MBRouter(config)# '''end'''

21. MBRouter# '''copy running-config startup-config'''



<h2>'''Cisco - IOS L2 v12'''</h2>Minimum* configuration:

'''BASIC ETHERNET CONFIGURATION - SUMMARY STEPS'''

1. Switch> '''enable'''

2. Switch# '''configure terminal'''

3. Switch(config)# '''interface vlan 1'''

4. Switch(config-if)# '''ip adress''' 172.17.33.5 255.255.255.0

5. Switch(config-if)# '''exit'''

6. Switch(config)# '''ip default-gateway''' 172.17.33.1

'''BASIC SSH CONFIGURATION - SUMMARY STEPS'''

7. Switch(config)# '''ip domain name''' domain.local

8. Switch(config)# '''hostname''' MBSwitch

9. MBSwitch(config)# '''crypto key generate rsa modulus 1024'''

10. MBSwitch(config)# '''username''' ''root'' privilege 15 '''secret''' ''PassW0rd''

11. MBSwitch(config)# '''aaa new-model'''

12. MBSwitch(config)# '''line vty 0 4'''

13. MBSwitch(config-line)# '''transport input ssh'''

14. MBSwitch(config-line)# '''exit'''

'''ADDITIONAL CONFIGURATION - SUMMARY STEPS'''

15. MBSwitch(config)# '''enable secret''' PassW0rd

16. MBSwitch(config)# '''service password-encryption'''

17. MBSwitch(config)# '''snmp-server community public RO'''

18. MBSwitch(config)# '''end'''

19. MBSwitch# '''copy running-config startup-config'''

<h2>'''Cisco - ASA'''</h2>
Minimum* configuration. ASA Version 8.2(5):

'''BASIC ETHERNET CONFIGURATION - SUMMARY STEPS'''

1. ciscoasa> '''enable'''

2. ciscoasa# '''configure termina'''l

3. (config)# '''enable password''' ''mtigroup''

4. ciscoasa(config)# '''hostname''' ''MBCiscoasa''

5. MBCiscoasa11(config)# '''interface''' ''gigabitEthernet 0/0''

6. MBCiscoasa11(config-if)# '''nameif inside'''

7. MBCiscoasa11(config-if)# '''ip address''' ''172.18.11.11 255.255.255.0''

8. MBCiscoasa11(config-if)# '''no shutdown'''

9. MBCiscoasa11(config-if)# '''exit'''

10. MBCiscoasa11(config)# '''route inside''' ''0.0.0.0 0.0.0.0 172.18.11.1''

'''BASIC SSH CONFIGURATION - SUMMARY STEPS'''

11. MBCiscoasa11(config)# '''ssh''' ''172.31.10.0 255.255.255.0'' '''inside'''

12. MBCiscoasa11(config)# '''username''' ''mupsbox password PassW0rd privilege 15''

13. MBCiscoasa11(config)# '''aaa authentication ssh console LOCAL'''

14. MBCiscoasa11(config)# '''write'''

'''ADDITIONAL CONFIGURATION - SUMMARY STEPS'''

<h2>'''MikroTik'''</h2>
Minimum configuration for RouterOS V6 (with "zero" configuration)'''BASIC ETHERNET CONFIGURATION - SUMMARY STEPS'''

1. [admin@MikroTik] > '''ip address add address='''''172.17.22.4/24'' '''interface='''''ether1''

2. [admin@MikroTik] > '''ip route add gateway='''''172.17.22.1''

3. [admin@MikroTik] > '''ipv6 address add address='''2001:db8:b40:4002::4/64 '''interface='''ether1

4. [admin@MikroTik] > '''ipv6 route add gateway='''2001:db8:b40:4002::1

5. [admin@MikroTik] > '''system identity set name='''MBMikroTik

6. [admin@MBMikroTik] > '''ip service disable telnet,ftp,www,api'''

7. [admin@MBMikroTik] > '''user add name='''mupsbox '''password='''PassW0rd '''group='''full

8. [admin@MBMikroTik] > '''user remove admin'''<h2>'''DLink DGS'''</h2>
Minimum* configuration:'''BASIC ETHERNET CONFIGURATION - SUMMARY STEPS'''

1. DGS-1210-28MP/ME:5# '''config ipif System ipaddress''' 172.17.22.2/24

2. DGS-1210-28MP/ME:5#'''config ipif System ipv6 ipv6address''' 2001:db8:b40:4002::2/64

3. DGS-1210-28MP/ME:5# '''create iproute default''' 172.17.22.1

4. DGS-1210-28MP/ME:5# '''create ipv6route default''' 2001:db8:b40:4002::1

5. DGS-1210-28MP/ME:5# '''enable ssh'''

6. DGS-1210-28MP/ME:5# '''enable password encryption'''

7. DGS-1210-28MP/ME:5# '''create account admin''' mupsbox

8. DGS-1210-28MP/ME:5# '''save'''

<h2>'''Huawei AR100'''</h2>

Minimum* configuration:

'''BASIC ETHERNET CONFIGURATION - SUMMARY STEPS'''

1. <Huawei> '''system-view'''

2. [Huawei] '''interface''' ''GigabitEthernet 0/0/0''

3. [Huawei-GigabitEthernet0/0/0] '''undo portswitch'''

4. [Huawei-GigabitEthernet0/0/0] '''ip address''' ''172.17.22.5 255.255.255.0''

5. [Huawei-GigabitEthernet0/0/0] '''quit'''

6. [Huawei] '''ip route-static''' '''0.0.0.0 0.0.0.0''' ''172.17.22.1''

7. [Huawei] '''save'''

8. [Huawei] '''aaa'''

9. [Huawei-aaa] '''local-user''' mupsbox '''password cipher''' PassW0rd

10. [Huawei-aaa] '''local-user''' '''admin privilege level 15'''

11. [Huawei-aaa] '''local-user admin service-type ssh'''

12. [Huawei-aaa] '''quit'''

13. [Huawei] '''quit save'''

14. [Huawei] '''stelnet server enable'''

15. [Huawei] '''save'''

<h2>'''Huawei Quidway 2000,3000,5000'''</h2>

Minimum* configuration:

'''BASIC ETHERNET CONFIGURATION - SUMMARY STEPS'''

1. <Quidway> '''system-view'''

2. [Quidway]'''management-vlan 1'''

3. [Quidway] '''interface Vlan-interface 1'''

4. [Quidway-Vlan-interface1] '''ip address''' ''172.17.55.7 255.255.255.0''

5. [[Quidway-Vlan-interface1] '''quit'''

6. [Quidway] '''ip route-static''' '''0.0.0.0 0.0.0.0''' ''172.17.22.1''

7. [Quidway] '''save'''

'''BASIC SSH CONFIGURATION - SUMMARY STEPS'''

8. [Quidway] '''user-interface vty 0 4'''

9. [Quidway-ui-vty0-4] '''authentication-mode scheme'''

10. [Quidway-ui-vty0-4] '''protocol inbound ssh'''

11. [Quidway] '''local-user''' ''mupsbox''

12. [Quidway-luser-mupsbox] '''password simple''' ''PassW0rd''

13. [Quidway-luser-mupsbox] '''service-type ssh'''

14. [Quidway] '''ssh user''' ''mupsbox'' '''authentication-type password'''

15. [Quidway] '''rsa local-key-pair create'''

16. [Quidway] '''save'''

<h2>'''HP Procurve'''</h2>

Minimum* configuration:

'''BASIC ETHERNET CONFIGURATION - SUMMARY STEPS'''

1. ProCurve Switch 2510-48# '''config'''

2. ProCurve Switch 2510-48(config)# '''hostname''' ''MBHP-2510''

3. MBHP-2510(config)# '''vlan 1'''

4. MBHP-2510(vlan-1)# '''ip address''' ''172.17.44.2/24''

5. MBHP-2510(vlan-1)# '''exit'''

6. MBHP-2510(config)# '''ip default-gateway''' ''172.17.44.1''

'''BASIC SSH CONFIGURATION - SUMMARY STEPS'''

7. MBHP-2510(config)# '''ip ssh'''

8. MBHP-2510(config)# '''crypto key generate ssh'''

9. MBHP-2510(config)# '''password manager'''

10. MBHP-2510(config)# '''aaa authentication login privilege-mode'''

11. MBHP-2510(config)# '''aaa authentication ssh login tacacs local'''

12. MBHP-2510(config)# '''aaa authentication ssh enable tacacs local'''

13. MBHP-2510(config)# '''write memory'''

<h2>'''Juniper SRX'''</h2>

Minimum* configuration:

'''BASIC CONFIGURATION - SUMMARY STEPS'''

1. root@% '''cli'''

2. root> '''configure'''

3. root# '''set system host-name''' ''MBSRX100b''

4. root# <kbd>'''set system root-authentication plain-text-password'''</kbd>

''New password: <var>password</var>''

''Retype new password: <var>password</var>''

5. root# <kbd>'''set system login user''' ''mupsbox'' '''class super-user authentication plain-text-password'''</kbd>

6. root# '''commit'''

'''BASIC ETHERNET CONFIGURATION - SUMMARY STEPS'''

7. root@MBSRX100b# '''set interfaces''' ''fe-0/0/0'' '''unit 0 family inet address''' <var>172.17.44.4/24</var>

8. root@MBSRX100b# '''set routing-options static route''' '''0.0.0.0/0 next-hop''' 172.17.44.1

9. root@MBSRX100b# '''delete security zones security-zone untrust interfaces''' ''fe-0/0/0''

10. root@MBSRX100b# '''set security zones security-zone internal interfaces''' ''fe-0/0/0'' '''host-inbound-traffic system-services ping'''

11. root@MBSRX100b# '''set security zones security-zone internal interfaces''' ''fe-0/0/0'' '''host-inbound-traffic system-services ssh'''

12. root@MBSRX100b# '''set system services ssh'''

13. root@MBSRX100b# '''set system services ssh root-login allow'''

12. root@MBSRX100b# '''commit'''

<h2>'''Juniper ES'''</h2>

Minimum* configuration:

'''BASIC CONFIGURATION - SUMMARY STEPS'''

1. root@% '''cli'''

2. root> '''configure'''

3. root# '''set system host-name''' MBSRX100b

4. root# <kbd>'''set system root-authentication plain-text-password'''</kbd>

''New password: <var>password</var>''

''Retype new password: <var>password</var>''

5. root# <kbd>'''set system login user''' ''mupsbox'' '''class super-user authentication plain-text-password'''</kbd>

6. root# '''commit'''

'''BASIC ETHERNET CONFIGURATION - SUMMARY STEPS'''

7. root@MBSRX100b# delete interface ge-0/0/0 unit 0 family ethernet-switching

8. root@MBSRX100b# '''set interfaces''' ge-0/0/0 '''unit 0 family inet address''' <var>172.17.44.4/24</var>

9. root@MBSRX100b# '''set routing-options static route''' '''0.0.0.0/0 next-hop''' 172.17.44.1

10. root@MBSRX100b# '''set system services ssh'''

11. root@MBSRX100b# '''set system services ssh connection-limit 10 rate-limit 4'''

12. root@MBSRX100b# '''commit'''

<h2>'''Juniper SSG'''</h2>

Minimum* configuration:

'''BASIC CONFIGURATION - SUMMARY STEPS'''

1. root-> '''set hostname''' ''MBSSG5''

2. MBSSG5-> '''set admin name''' ''mupsbox''

3. MBSSG5-> '''set admin password''' ''PassW0rd''

4. MBSSG5-> <kbd>'''set interface''' ''bgroup0'' '''ip 172.17.44.5/24'''</kbd>

5. MBSSG5-> '''set route''' ''0.0.0.0/0'' '''interface''' ''bgroup0'' '''gateway''' ''172.17.44.1''

6. MBSSG5-> '''save'''

7. MBSSG5-> '''set interface''' ''bgroup0'' '''manage ssh'''

8. MBSSG5-> '''set ssh enable'''

<h2>'''Eltex MES'''</h2>

Minimum* configuration:

'''BASIC CONFIGURATION - SUMMARY STEPS'''

1. console> '''enable'''

2. console# '''configure'''

2. console(config)# '''interface vlan 1'''

3. console(config-if)# '''no ip address dhcp'''

4. console(config-if)# '''ip address''' ''172.17.55.4 255.255.255.0''

5. console(config-if)# '''exit'''

6. console(config)# '''ip route''' ''0.0.0.0 0.0.0.0 172.17.55.1''

7. console(config)# '''hostname''' ''MBEltexMES''

8. console(config)# '''ip ssh server'''

9. MBEltexMES(config)# '''username''' ''mupsbox'' ''privilege 15'' '''password''' ''PassW0rd!''

10. MBEltexMES(config)# '''enable password prpassword'''

<h2>'''Zyxel ZyWALL'''</h2>

Minimum* configuration:

'''BASIC CONFIGURATION - SUMMARY STEPS'''

1. Router> '''enable'''

2. Router# '''configure terminal'''

2. Router(config)# '''interface''' ''ge2''

3. Router(config-if-ge)# '''ip address''' ''172.17.44.7 255.255.255.0''

4. Router(config-if-ge)# '''ip gateway''' ''172.17.44.1''

5. Router(config-if-ge)# '''no shutdown'''

6. Router(config-if-ge)# '''exit'''

7. Router(config)# '''username''' ''mupsbox'' '''password''' ''PassW0rd'' '''user-type''' ''admin''

<h2>'''Qtech QSW'''</h2>

Minimum* configuration:

'''BASIC CONFIGURATION - SUMMARY STEPS'''

1. QSW-2850-28T-AC> '''enable'''

2. QSW-2850-28T-AC# '''config terminal'''

2. QSW-2850-28T-AC(config)# '''interface vlan 1'''

3. QSW-2850-28T-AC(config-if-vlan1)# '''ip address''' ''172.17.44.8 255.255.255.0''

4. QSW-2850-28T-AC(config-if-vlan1)# '''exit'''

5. QSW-2850-28T-AC(config)# '''ip default-gateway''' ''172.17.44.1''

6. QSW-2850-28T-AC(config)# '''ssh-server enable'''

7. QSW-2850-28T-AC(config)# '''username''' ''mupsbox'' privilege 15 '''password''' ''PassW0rd''

8. QSW-2850-28T-AC(config)# '''exit'''

9. QSW-2850-28T-AC# '''copy running-config startup-config'''

<h2>'''Allied Telesis'''</h2>

Minimum* configuration:

'''BASIC CONFIGURATION - SUMMARY STEPS'''

1. console# '''config'''

2. console(config)# '''interface vlan 1'''

3. console(config-if)# '''ip address''' ''172.17.55.9 255.255.255.0''

4.console(config-if)# '''exit'''

5. console(config)# '''ip default-gateway''' ''172.17.55.1''

6. console(config)# '''username''' ''mupsbox'' '''password''' ''PassW0rd'' level 15

7. console(config)# '''ip ssh server'''

8. console(config)# '''crypto key generate rsa'''

<h2>'''Fortinet'''</h2>

Minimum* configuration:

'''BASIC CONFIGURATION - SUMMARY STEPS'''

1. FortiGate-VM64-KVM # '''config system interface'''

2. FortiGate-VM64-KVM (interface) # '''edit''' ''port1''

2. FortiGate-VM64-KVM (port1) # '''set ip''' ''172.18.33.111 255.255.255.0''

3 FortiGate-VM64-KVM (port1) # '''end'''

4. FortiGate-VM64-KVM # '''config router static'''

5. FortiGate-VM64-KVM (static) # '''edit''' ''0''

6. FortiGate-VM64-KVM (0) # '''set gateway''' ''172.18.33.1''

7. FortiGate-VM64-KVM (0) # '''set device''' ''port1''

8. FortiGate-VM64-KVM (0) # '''end'''

9. FortiGate-VM64-KVM # '''config system admin'''

10. FortiGate-VM64-KVM (admin) # '''edit''' ''mupsbox''

11. FortiGate-VM64-KVM (mupsbox) # '''set accprofile''' ''"super_admin"''

12. FortiGate-VM64-KVM (mupsbox) # '''set vdom "root"'''

13. FortiGate-VM64-KVM (mupsbox) # '''set password''' ''PassW0rd''

14. FortiGate-VM64-KVM (mupsbox) # '''end'''

15. FortiGate-VM64-KVM # '''config system global'''

16. FortiGate-VM64-KVM (global) # '''set hostname''' ''FortiGateV''

17. FortiGate-VM64-KVM (global) # '''end'''

18. FortiGateV # '''execute cfg save'''

<h2>'''Extreme Networks'''</h2>

Minimum* configuration:

'''BASIC CONFIGURATION - SUMMARY STEPS'''

1. * EXOS-VM.1 # '''create account admin''' ''mupsbox'' ''PassW0rd''

2. * EXOS-VM.6 # '''configure''' ''Mgmt'' '''ipaddress''' ''172.18.33.222 255.255.255.0''

3. * EXOS-VM.9 # '''configure iproute add default''' ''172.18.33.1'' '''vr''' ''VR-Mgmt''

4.* EXOS-VM.11 # '''enable ssh2'''

5.* EXOS-VM.11 # '''save'''

<h2>'''Check Point'''</h2>

Minimum* configuration:

'''BASIC CONFIGURATION - SUMMARY STEPS'''

1. gw-170003>set expert-password

2.gw-170003>expert

3. [Expert@gw-170003:0]# hostname MBCheckPoint

4.[Expert@MBCheckPoint]# hostname MBCheckPoint

5.* EXOS-VM.11 # save

 <div id="BackToTop" class="noprint" style="background-color:#DDEFDD; position:fixed;

bottom:32px; left:2%; z-index:9999; padding:0; margin:0;">
[[#top| Back to the Top]]</div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div>
<div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div>
<div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div>

2021-06-08T08:24:13Z

Admin:

Devices Module

2021-06-08T08:24:03Z

Admin:

<h1>'''Device List'''</h1>
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.
[[File:device-listNew.png|Device List All]] 
[[File:device-list-Mikrotik.png|Device List Mikrotik]] 
[[File:device-list-Cisco.png|Device List Cisco]] 
[[File:device-list-Nix.png|Device List Nix]] 
<ul>
On the Device List tab, there are buttons (from left to right): 
<li>[[File:add.png|Add device]] - Add device </li>
<li>[[File:remove.png|Remove device]] - Remove device </li>
<li>[[File:enable.png|Enable device]] - Enable device </li>
<li>[[File:disable.png|Disable device]] - Disable device </li>
<li>[[File:device-settings.png|Device settings]] - Device settings </li>
<li>[[File:winbox.png|Start winbox]] - Start winbox </li>
<li>[[File:ssh.png|Start ssh]] - Start ssh </li>
<li>[[File:refresh.png|Refresh]] - Refresh </li>
<li>[[File:refresh-one.png|Check the availability of a dedicated device]] - Check the availability of a dedicated device </li>
<li>[[File:refresh-all.png|Check the availability of all devices]] - Check the availability of all devices </li>
<li>[[File:kill-treads.png|Kill threads]] - Kill threads </li>
<li>[[File:export-devices.png|Export the list of devices]] - Export the list of devices (including their data, such as un, login, password, etc.) </li>
<li>[[File:import-devices.png|Import the list of all devices]] - Import the list of all devices (including their data, such as un, login, password, etc.) </li>
<li>[[File:update-ros.png|Update the ROS version]] - Update the ROS version </li>
<li>[[File:upgrade-bios.png|Upgrade the BIOS]] - Upgrade the BIOS </li>
<li>[[File:cmd.png|CMD]] - Send a command to the selected device </li>
<li>[[File:exel.png|Export the visible list of devices in Excel]] - Export the visible list of devices in Excel </li>
<li>[[File:device-geo.png|Geolocation by coordinates]] - Geolocation by coordinates </li>
<li>[[File:device-over.png|re-read and overwrite data of selected devices]] - re-read and overwrite data of selected devices </li>
<li>[[File:device-over-all.png|re-read and overwrite data of all devices]] - re-read and overwrite data of all devices </li>
<li>[[File:upgrade_lte.png|Upgrade LTE modem]] - Upgrade LTE modem </li>
</ul>

<h2>'''Add device'''</h2>
To add a device, press [[File:add.png|Add device]], a window will appear where you need to enter device data.
[[File:add-device.png|Add Device]]
[[File:add-device-gps.png|Add Device GPS tab]]
[[File:add-device-lte.png|Add Device LTE tab]]

<ul>
<li>Hostname - Any convenient device name. </li>
<li>Username - Username to login to device. </li>
<li>Password - Password to login to device. </li>
<li>IP / AD - Device IP address. </li>
<li>Connect via - connecting to the device via </li>
<li>SSH port - Your ssh port, which you registered in Ip -> Services </li>
<li>FTP port - Your ftp port, which you registered in Ip -> Services </li>
<li>Telnet port - Your telnet port </li>
<li>Winbox port - Your winbox port </li>
<li>API SSL port - Your API SSL port </li>
<li>API SSL - Your API port </li>
<li>Version package channel - Your version package channel on royter </li>
<li>Join in group - Select the groups to which the device will belong. </li>
<li>Available groups - Existing groups created in the Groups tab. </li>
<li>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. </li>
<li>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. </li>
<li>Comment - Comment on the device. </li>
<li>GPS tab - you can enter the coordinates and address of the location of the device in order to display it on the map in the GeoTrack module </li>
<li>LTE tab - If your device has an LTE modem, specify them for the possibility of updating (At the moment it works only for Mikrotik devices) </li>
</ul>

<h2>'''Export and import devices'''</h2>
To export all devices with their data, click the [[File:export-devices.png|Export the list of devices]] button. A confirmation window will appear.
[[File:confirm-export.png|С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 [[File:import-devices.png|Import the list of devices]] button. A confirmation window will appear.
[[File:confirm-export.png|Сonfirm]]
If your file contains encrypted passwords, click yes; otherwise, click no. 

<h2>'''Command line'''</h2>
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 [[File:cmd.png|CMD]] button. The following window will appear:
[[File:cmd-window.png|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.
[[File:cmd-window-commands.png|CMD work space]]
If you entered several commands in a row, you can navigate between them using the up and down arrows
Also, you can load the RSC file with the settings. Select the file by clicking .. and press the GO button

<h2>'''Working with device lists and filtering'''</h2>
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.
[[File:device-list-search.png|Device List]]
Having sorted the devices by a certain attribute, you can export the sorted list to Excel by pressing the [[File:exel.png|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:
[[File:device-list-group-filter2.png|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.
 
<h3>'''Customize Device List'''</h3>
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.
[[File:customize-device-list2.png|Customize Device List]]

<h2>'''Add device from Net'''</h2>
Search and add Mikrotik devices in automatic mode.
[[File:add-dev-from-net2.png|Add device from Net by API]]
[[File:add-dev-from-net-ssh.png|Add device from Net by SSH]]
<ul>
<li>IP - subnet. </li>
<li>Prefix - Mask. </li>
<li>Username - Username to login to device. </li>
<li>Password - Password to login to device. </li>
<li>Port - Your api or api-ssl port that you opened on RouterOS. </li>
<li>New Group - Create new group. </li>
<li>Ignore check host ID - If you have several IP addresses on your device and you do not want to add them all, check the box and the program will check the software id and not add the same router. </li>
<li>Filtre - You can scan devices into specific groups from the entire network using the filter by board name or model. </li>
<li>Group name - Select the group to which devices will be added. </li>
</ul>

<h1>'''Groups'''</h1>
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.
[[File:groups.png|Groups]]

<h2>'''Add group'''</h2>
To add a group, click the [[File:add.png|Add group]] button and the following window will appear:
[[File:add-group.png|Add Group]]
<ul>
<li>Name - Any convenient group name. </li>
<li>Description - Group description. </li>
</ul>
<h2>'''Remove group'''</h2>
To remove a group, click the [[File:remove.png|Remove]] button. A query will appear:
[[File:delete-group.png|Deletegroup]]
Click Yes to delete or No to cancel.

<h2>'''Command line'''</h2>
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 [[File:cmd.png|CMD]] button. The following window will appear:
[[File:cmd-window.png|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.
[[File:cmd-window-commands.png|CMD work space]]
If you entered several commands in a row, you can navigate between them using the up and down arrows

<h2>'''Command line (API samples)'''</h2>
Using api - you get feedback. This is very important because you will always know if the command was executed successfully. Also, you get the opportunity to build reports using API: request->response. Here are some examples.
 
add new user
/user/add =name=username =group=full =password=userpassword =comment=this is new user

remove user
/user/remove =.id=username

on which router is the user 'admin'?
/user/print ?name=admin mbcount==1

on which router firewall is not configured, for example, rules < 3 ?
/ip/firewall/filter/print mbcount=<3

disable all rules in /ip/firewall/filter where chain=input and action=drop
/ip/firewall/filter/disable ?chain=input ?action=drop ?#& mbgetid

on which router is dns server 8.8.4.4 configured?
/ip/dns/print mb?servers=8.8.4.4

 
<div id="shbox" style=" border-width:1px; border-color:lightgrey; padding: 2px 5px 2px 10px; min-height:56px; border-style:solid; font-size: 0.9em;">
[[File:Icon-warn.png|left|56px|56px]]
Notice: mbcount - proproetary function mupsbox, gets counts data replies (!re),mbcount= (=x, >x , <x, ==x, =>x, =<x). mbgetid - allows you to combine several commands: perform an action with a preliminary request to get id, execute a print query c .proplist = .id, storing the result in the array and then performing the desired action. mb?filed - allows you to build queries where there is no where attribute, mb?(field)(=/!=/<>)</div>
 

<h2>'''Settings for groups'''</h2>
When you need to change data such as login, password, port, type of port for a group of devices, click on the [[File:settings-for-group.png|Settings for groups]] button. The following window will appear:
[[File:group-settings2.png|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.

<h1>'''Pooling jobs'''</h1>
This tab is intended for to create tasks for testing the availability of devices by groups.
[[File:pooling-jobs2.png|Pooling jobs]]
<h2>'''Add job'''</h2>
To add a group, click the [[File:add.png|Add job]] button and the following window will appear:
[[File:pooling-job-add.png|Add job]]
<ul>
<li>Job Name - Any convenient job name. </li>
<li>Group Name - Select group. </li>
<li>Period type - Select verification period. </li>
<li>GPS - Take GPS coordinates. </li>
<li>Description - Comment or description for the job. </li>
</ul>

<div id="BackToTop" class="noprint" style="background-color:#DDEFDD; position:fixed;
bottom:32px; left:2%; z-index:9999; padding:0; margin:0;">
[[#top| Back to the Top ]]</div>

Changelog

2021-06-08T08:21:07Z

Admin:

<h1>'''Changelog'''</h1>
'''MupsBox v1.4.1 x64 (June 08, 2021)'''
<ul>
<li>Stop all services and Firebird service to upgrade </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>A new way to install the program, now through the installer.</li>
<li>Device list - added vendors Cisco, Huawei, Nix, Dlink (DSG)</li>
<li>Device list - fixed work on updating Mikrotik</li>
<li>Device list - Sending commands for Mikrotik fixed</li>
<li>Device list - Sending ssh commands for nix, Cisco, huawei, dlink</li>
<li>Device list - Uniform form of device editing</li>
<li>Device list - Add device from net for Cisco, Dlink, Huawei</li>
<li>Device list - Mikrotik lte modem update</li>
<li>Device list - added new display fields such as serial number, mac address, etc.</li>
<li>Full software optimization, bugs fixed</li>
</ul>

'''MupsBox v1.3.10 x64 (December 29, 2020)'''
<ul>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Hotspot module - fixed some bugs </li>
<li>Hotspot module - added Hotspot wizard </li>
<li>Device module - fixed some bugs </li>
<li>Device module - accelerated work with a large number of equipment </li>
<li>Device module - added column time and date when the device was added </li>
<li>Device module - added the ability to distribute rights to device groups </li>
<li>Device module - Updating dedicated devices, not just all or one </li>
<li>WEB module - certificates updated </li>

</ul>

'''MupsBox v1.3.9 x64 (November 24, 2020)'''
<ul>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Backup module - added retention for nix </li>
<li>Hotspot module - fixed some bugs </li>
<li>Hotspot module - added spam detect </li>
<li>Hotspot module - fixed sms.ru </li>
</ul>

'''MupsBox v1.3.8 x64 (October 06, 2020)'''
<ul>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Backup module - added notification to Telegram, Email only if error or diff </li>
<li>Backup module - added backup if there were changes, for license BS </li>
<li>Device module - added new API function "mb?filed" </li>
<li>Hotspot module - fixed some bugs </li>
<li>WEB - fixed some bugs, added new functionality </li>
</ul>

'''MupsBox v1.3.6 x64 (September 07, 2020)'''
<ul>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Backup module - added notification to Telegram </li>
<li>Settings Notifications - added settings for Telegram </li>
<li>Device module - Now you can select several devices and send a command to all of them (without a group) </li>
<li>Backup module - backup sync improved performance </li>
<li>Hotspot module - added the ability to send passwords to Telegram </li>
<li>Hotspot module - added the ability to add MAC address </li>
<li>API command - new function mbgetid </li>
<li>Device module - added output uptime </li>
</ul>

'''MupsBox v1.3.4 x64 (June 24, 2020)'''
<ul>
<li>Backup service have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Backup module - Fixed bug with retention </li>
</ul>

'''MupsBox v1.3.3 x64 (June 18, 2020)'''
<ul>
<li>Database version updated to 1.73 </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Backup module - added UM backup db, Dude backup DB, folder types </li>
<li>Backup module - Nix backup job </li>
<li>Device module - added telnet port </li>
<li>Device module - added version package channel </li>
<li>Device module - added pooling job </li>
<li>Device module - added Nix devices </li>
<li>Device module - added the ability to control devices using the right mouse button </li>
<li>Device module - Using the right mouse button, you can add massively devices to groups </li>
<li>New hotspot module introduced ([[HotSpot#HotSpot_Module|HotSpot]]) </li>
<li>New web module - operator`s console for creating tickets in hotspot module </li>
<li>Settings - Notifications - added TLS support </li>
<li>Minor bugs fixed </li>
</ul>

'''MupsBox v1.3.1 x64 (January 18, 2020)'''
<ul>
<li>Database version updated to 1.59 </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Backup module - now the backup service uses multithreading </li>
<li>Access to the program is now available by login and password </li>
<li>Users may have different access rights to modules </li>
<li>Minor bugs fixed </li>
</ul>

'''MupsBox v1.3.0 x64 (Octomber 06, 2019)'''
<ul>
<li>Now our program has become 64 bit </li>
<li>Database version updated to 1.42 </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Geotrack module available in demo mode </li>
<li>Improved program multithreading </li>
<li>There are options where you can select the action by double-clicking, the number of threads and more </li>
<li>Devices module - now you can snap the device by coordinates and look at the map the location of all devices </li>
<li>Polling service added </li>
<li>Traffic module - improved module operation, increased reporting speed </li>
</ul>

'''MupsBox v1.2.7 (September 03, 2019)'''
<ul>
<li>Database version updated to 1.38 </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Added auto-scan of devices on the network and automatic addition to the MupsBox database </li>
<li>Improved work with the interface </li>
<li>Improved data display speed in the syslog module </li>
<li>Added version checking </li>
<li>Added automatic database packaging in the traffic module </li>
</ul>

'''MupsBox v1.2.6 (August 26, 2019)'''
<ul>
<li>Database version updated to 1.34 </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Added support for IPV6 </li>
<li>Added support for SFTP in the backup module </li>
<li>Added SFTP server </li>
<li>Added backup sync in the backup module </li>
<li>Added the ability to import a RSC file with a configuration to a group of devices </li>
<li>Improved program performance on multi-core systems </li>
<li>Devices - added comment for device </li>
<li>A new type of license for the D1 backup module (Demonstration of full functionality for 1 week) </li>
</ul>

'''MupsBox v1.2.2 (July 15, 2019)'''
<ul>
<li>Firebird 2.5 database support terminated </li>
<li>Database version updated to 1.21 </li>
<li>Added the ability to backup all program settings on a schedule. </li>
<li>Fixed recovery of program settings </li>
<li>Added version of services. </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Fixed traffic module (errors with multiple requests) </li>
<li>To switch from DB 2.5, you need to rewrite the MupBox to the folder with the old DB and run it. After updating the database version, go to the Backup module and click on the Settings backup button. Then save the old version of the program and database in another folder. Then install Firebird 3.0 and run the MupBox program. After creating a new database, go to the backup module and click the Settings restore button, select the folder where you saved them and click on any settings file. </li>
</ul>

'''MupsBox v1.2.1 (July 04, 2019)'''
<ul>
<li>Firebird 3.x support added (x32 and x64) </li>
<li>Database version updated to 1.20 </li>
<li>FTP and Backup services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Device List - added custom winbox and ssh port </li>
<li>Device List - added DNS resolve. Instead of the IP address, you can write DNS name. </li>
<li>Device List - Now you can connect to the router via the winbox and via ssh with an empty password. </li>
<li>Device on group - added data duplication check </li>
<li>Backup module - now you can back up to network folders on the server (Routers for NAT). </li>
<li>Backup module - Diff module full functionality. After the service has made a backup of your devices, it will send all changes to the routers to the email. </li>
<li>Backup module - Added backup storage depth </li>
<li>Backup module - Added the ability to backup all program settings and restore them. </li>
<li>Traffic module - Fixed adding jobs.</li>
<li>Traffic module - Added button delete all data.</li>
<li>Syslog module - Added auto update of the list of logs for a given period in seconds.</li>
</ul>

'''MupsBox v1.1.51 (June 14, 2019)'''
<ul>
<li>Database version updated to 1.11 (after starting the program, you need to update the database version) </li>
<li>All services have been updated (To upgrade, you must stop the services and overwrite them in the MupsBox folder) </li>
<li>Devices module added </li><ul>
<li>Filtering routers by groups </li>
<li>Filtering routers by keywords, ip addresses, etc. </li>
<li>The ability to upload the filtered or the entire list of devices in the Exel file. </li>
<li>Enter the device from the program via winbox or ssh (It is necessary to put the winbox and putty utilities in the program folder) </li>
<li>The ability to activate or deactivate the device. </li></ul></li>
<li>Configurator - VPN lite module added </li>
<li>Backup module - now you can back up to local folders on the server (Routers for NAT). </li>
<li>Backup module - now you can export a file along the way (Export Path) </li>
<li>Backup module - added Diff module (while in manual mode) </li>
<li>Syslog module added the ability to delete content </li>
<li>All passwords are stored in encrypted form. </li>
</ul>

'''MupsBox v1.1.49 (May 17, 2019)'''
<ul>
<li>Service backup fixed, now works with both local and external FTP server</li>
</ul>

'''MupsBox v1.1.48 (May 15, 2019)'''
<ul>
<li>The database version is updated to 1.6 (after starting the program, you need to update the database version and restart the MupsBox program)</li>
<li>All services have been updated (To upgrade, you must stop the services and overwrite them in the MupsBox folder)</li>
<li>Now email can send emails over SSL.</li>
<li>The Devices module has completely redesigned the process of polling routers and sending commands to routers.</li>
<li>Devices module added Settings for groups button</li>
<li>Devices module added Board-name and Model columns</li>
<li>The Devices module has the line below added - the total number of devices and the number of devices that are not available</li>
<li>Added module Configurator</li>
<li>The Traffic module has been added to the Packing base button and the module operation process has been completely revised.</li>
</ul>

'''MupsBox v1.1.47 (08 April 2019)'''
<ul>
<li>Database version updated to 1.4 (after starting the program, you need to update the database version and restart the MupsBox program)</li>
<li>The MBBackupService.exe service is updated (To update, you must stop the service and overwrite it in the MupsBox folder)</li>
<li>Email alert added</li>
<li>Devices module added a button to transfer command to router</li>
<li>Devices module added a button to transfer command to a group of routers</li>
<li>The Traffic module has added a tab to generate reports for the selected parameters.</li>
<li>The Backup module in the JOB has added the ability to send a report to an email upon completion of Job’s</li>
<li>Syslog module added the ability to filter by date and time interval in these dates.</li>
</ul>

'''MupsBox v1.1.46 (March 21, 2019)'''
<ul>
<li>Syslog module added</li>
<li>Traffic module improved data handling (search by conditions)</li>
<li>Devices module added columns with the current version, new version, current firmware, and new firmware</li>
<li>Devices module added operating system update and BIOS update buttons for a routers</li>
<li>Devices module added the ability to select routers via Ctrl (for now only for deletion)</li>
<li>The Backup module added a progress bar at the manual start to display the progress of the module.</li>
<li>Database version updated to 1.2 (after starting the program, update the database version and restart the MupsBox program)</li>
</ul>

'''MupsBox v1.1.45 (February 19, 2019)'''
<ul>
<li>Improved work with services.</li>
<li>Added API port for editing (Device list)</li>
<li>Increased the number of characters to enter the Hostname</li>
<li>Added tab to work with the Database database in Settings</li>
<li>Added version of the database (ver1.1)</li>
</ul>

<div id="BackToTop" class="noprint" style="background-color:#DDEFDD; position:fixed;
bottom:32px; left:2%; z-index:9999; padding:0; margin:0;">
[[#top| Back to the Top ]]</div>

Changelog

2021-06-08T08:03:20Z

Admin:

<h1>'''Changelog'''</h1>
'''MupsBox v1.4.1 x64 (June 08, 2021)'''
<ul>
<li>Stop all services and Firebird service to upgrade </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>A new way to install the program, now through the installer.</li>
<li>Device list - added vendors Cisco, Huawei, Nix, Dlink (DSG)</li>
<li>Device list - fixed work on updating Mikrotik</li>
<li>Device list - Sending commands for Mikrotik fixed</li>
<li>Device list - added new display fields such as serial number, mac address, etc.</li>
<li>Full software optimization, bugs fixed</li>
</ul>

'''MupsBox v1.3.10 x64 (December 29, 2020)'''
<ul>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Hotspot module - fixed some bugs </li>
<li>Hotspot module - added Hotspot wizard </li>
<li>Device module - fixed some bugs </li>
<li>Device module - accelerated work with a large number of equipment </li>
<li>Device module - added column time and date when the device was added </li>
<li>Device module - added the ability to distribute rights to device groups </li>
<li>Device module - Updating dedicated devices, not just all or one </li>
<li>WEB module - certificates updated </li>

</ul>

'''MupsBox v1.3.9 x64 (November 24, 2020)'''
<ul>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Backup module - added retention for nix </li>
<li>Hotspot module - fixed some bugs </li>
<li>Hotspot module - added spam detect </li>
<li>Hotspot module - fixed sms.ru </li>
</ul>

'''MupsBox v1.3.8 x64 (October 06, 2020)'''
<ul>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Backup module - added notification to Telegram, Email only if error or diff </li>
<li>Backup module - added backup if there were changes, for license BS </li>
<li>Device module - added new API function "mb?filed" </li>
<li>Hotspot module - fixed some bugs </li>
<li>WEB - fixed some bugs, added new functionality </li>
</ul>

'''MupsBox v1.3.6 x64 (September 07, 2020)'''
<ul>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Backup module - added notification to Telegram </li>
<li>Settings Notifications - added settings for Telegram </li>
<li>Device module - Now you can select several devices and send a command to all of them (without a group) </li>
<li>Backup module - backup sync improved performance </li>
<li>Hotspot module - added the ability to send passwords to Telegram </li>
<li>Hotspot module - added the ability to add MAC address </li>
<li>API command - new function mbgetid </li>
<li>Device module - added output uptime </li>
</ul>

'''MupsBox v1.3.4 x64 (June 24, 2020)'''
<ul>
<li>Backup service have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Backup module - Fixed bug with retention </li>
</ul>

'''MupsBox v1.3.3 x64 (June 18, 2020)'''
<ul>
<li>Database version updated to 1.73 </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Backup module - added UM backup db, Dude backup DB, folder types </li>
<li>Backup module - Nix backup job </li>
<li>Device module - added telnet port </li>
<li>Device module - added version package channel </li>
<li>Device module - added pooling job </li>
<li>Device module - added Nix devices </li>
<li>Device module - added the ability to control devices using the right mouse button </li>
<li>Device module - Using the right mouse button, you can add massively devices to groups </li>
<li>New hotspot module introduced ([[HotSpot#HotSpot_Module|HotSpot]]) </li>
<li>New web module - operator`s console for creating tickets in hotspot module </li>
<li>Settings - Notifications - added TLS support </li>
<li>Minor bugs fixed </li>
</ul>

'''MupsBox v1.3.1 x64 (January 18, 2020)'''
<ul>
<li>Database version updated to 1.59 </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Backup module - now the backup service uses multithreading </li>
<li>Access to the program is now available by login and password </li>
<li>Users may have different access rights to modules </li>
<li>Minor bugs fixed </li>
</ul>

'''MupsBox v1.3.0 x64 (Octomber 06, 2019)'''
<ul>
<li>Now our program has become 64 bit </li>
<li>Database version updated to 1.42 </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Geotrack module available in demo mode </li>
<li>Improved program multithreading </li>
<li>There are options where you can select the action by double-clicking, the number of threads and more </li>
<li>Devices module - now you can snap the device by coordinates and look at the map the location of all devices </li>
<li>Polling service added </li>
<li>Traffic module - improved module operation, increased reporting speed </li>
</ul>

'''MupsBox v1.2.7 (September 03, 2019)'''
<ul>
<li>Database version updated to 1.38 </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Added auto-scan of devices on the network and automatic addition to the MupsBox database </li>
<li>Improved work with the interface </li>
<li>Improved data display speed in the syslog module </li>
<li>Added version checking </li>
<li>Added automatic database packaging in the traffic module </li>
</ul>

'''MupsBox v1.2.6 (August 26, 2019)'''
<ul>
<li>Database version updated to 1.34 </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Added support for IPV6 </li>
<li>Added support for SFTP in the backup module </li>
<li>Added SFTP server </li>
<li>Added backup sync in the backup module </li>
<li>Added the ability to import a RSC file with a configuration to a group of devices </li>
<li>Improved program performance on multi-core systems </li>
<li>Devices - added comment for device </li>
<li>A new type of license for the D1 backup module (Demonstration of full functionality for 1 week) </li>
</ul>

'''MupsBox v1.2.2 (July 15, 2019)'''
<ul>
<li>Firebird 2.5 database support terminated </li>
<li>Database version updated to 1.21 </li>
<li>Added the ability to backup all program settings on a schedule. </li>
<li>Fixed recovery of program settings </li>
<li>Added version of services. </li>
<li>All services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Fixed traffic module (errors with multiple requests) </li>
<li>To switch from DB 2.5, you need to rewrite the MupBox to the folder with the old DB and run it. After updating the database version, go to the Backup module and click on the Settings backup button. Then save the old version of the program and database in another folder. Then install Firebird 3.0 and run the MupBox program. After creating a new database, go to the backup module and click the Settings restore button, select the folder where you saved them and click on any settings file. </li>
</ul>

'''MupsBox v1.2.1 (July 04, 2019)'''
<ul>
<li>Firebird 3.x support added (x32 and x64) </li>
<li>Database version updated to 1.20 </li>
<li>FTP and Backup services have been updated ([[Install_and_Basic_Configuration#How_to_Upgrade_MupsBox|How to upgrade MupsBox]]) </li>
<li>Device List - added custom winbox and ssh port </li>
<li>Device List - added DNS resolve. Instead of the IP address, you can write DNS name. </li>
<li>Device List - Now you can connect to the router via the winbox and via ssh with an empty password. </li>
<li>Device on group - added data duplication check </li>
<li>Backup module - now you can back up to network folders on the server (Routers for NAT). </li>
<li>Backup module - Diff module full functionality. After the service has made a backup of your devices, it will send all changes to the routers to the email. </li>
<li>Backup module - Added backup storage depth </li>
<li>Backup module - Added the ability to backup all program settings and restore them. </li>
<li>Traffic module - Fixed adding jobs.</li>
<li>Traffic module - Added button delete all data.</li>
<li>Syslog module - Added auto update of the list of logs for a given period in seconds.</li>
</ul>

'''MupsBox v1.1.51 (June 14, 2019)'''
<ul>
<li>Database version updated to 1.11 (after starting the program, you need to update the database version) </li>
<li>All services have been updated (To upgrade, you must stop the services and overwrite them in the MupsBox folder) </li>
<li>Devices module added </li><ul>
<li>Filtering routers by groups </li>
<li>Filtering routers by keywords, ip addresses, etc. </li>
<li>The ability to upload the filtered or the entire list of devices in the Exel file. </li>
<li>Enter the device from the program via winbox or ssh (It is necessary to put the winbox and putty utilities in the program folder) </li>
<li>The ability to activate or deactivate the device. </li></ul></li>
<li>Configurator - VPN lite module added </li>
<li>Backup module - now you can back up to local folders on the server (Routers for NAT). </li>
<li>Backup module - now you can export a file along the way (Export Path) </li>
<li>Backup module - added Diff module (while in manual mode) </li>
<li>Syslog module added the ability to delete content </li>
<li>All passwords are stored in encrypted form. </li>
</ul>

'''MupsBox v1.1.49 (May 17, 2019)'''
<ul>
<li>Service backup fixed, now works with both local and external FTP server</li>
</ul>

'''MupsBox v1.1.48 (May 15, 2019)'''
<ul>
<li>The database version is updated to 1.6 (after starting the program, you need to update the database version and restart the MupsBox program)</li>
<li>All services have been updated (To upgrade, you must stop the services and overwrite them in the MupsBox folder)</li>
<li>Now email can send emails over SSL.</li>
<li>The Devices module has completely redesigned the process of polling routers and sending commands to routers.</li>
<li>Devices module added Settings for groups button</li>
<li>Devices module added Board-name and Model columns</li>
<li>The Devices module has the line below added - the total number of devices and the number of devices that are not available</li>
<li>Added module Configurator</li>
<li>The Traffic module has been added to the Packing base button and the module operation process has been completely revised.</li>
</ul>

'''MupsBox v1.1.47 (08 April 2019)'''
<ul>
<li>Database version updated to 1.4 (after starting the program, you need to update the database version and restart the MupsBox program)</li>
<li>The MBBackupService.exe service is updated (To update, you must stop the service and overwrite it in the MupsBox folder)</li>
<li>Email alert added</li>
<li>Devices module added a button to transfer command to router</li>
<li>Devices module added a button to transfer command to a group of routers</li>
<li>The Traffic module has added a tab to generate reports for the selected parameters.</li>
<li>The Backup module in the JOB has added the ability to send a report to an email upon completion of Job’s</li>
<li>Syslog module added the ability to filter by date and time interval in these dates.</li>
</ul>

'''MupsBox v1.1.46 (March 21, 2019)'''
<ul>
<li>Syslog module added</li>
<li>Traffic module improved data handling (search by conditions)</li>
<li>Devices module added columns with the current version, new version, current firmware, and new firmware</li>
<li>Devices module added operating system update and BIOS update buttons for a routers</li>
<li>Devices module added the ability to select routers via Ctrl (for now only for deletion)</li>
<li>The Backup module added a progress bar at the manual start to display the progress of the module.</li>
<li>Database version updated to 1.2 (after starting the program, update the database version and restart the MupsBox program)</li>
</ul>

'''MupsBox v1.1.45 (February 19, 2019)'''
<ul>
<li>Improved work with services.</li>
<li>Added API port for editing (Device list)</li>
<li>Increased the number of characters to enter the Hostname</li>
<li>Added tab to work with the Database database in Settings</li>
<li>Added version of the database (ver1.1)</li>
</ul>

<div id="BackToTop" class="noprint" style="background-color:#DDEFDD; position:fixed;
bottom:32px; left:2%; z-index:9999; padding:0; margin:0;">
[[#top| Back to the Top ]]</div>

Install and Basic Configuration

2021-06-07T12:42:49Z

Admin:

<h1>'''How to install and Upgrade MupsBox'''</h1>
Starting with version 1.4, the program is shipped with the installer, which simplifies the process of installing and updating the program. When you start the installer, you are prompted to select the installation path. By default destination location is Letter of installed operation system and application name. For example: C:\MupsBox.

[[File:Install selectdir.png|Install selectdir]]
 Type Installation page provides chose options between:

<li>Server - default installation application with database on current machine. 
</li>
<li>Client - Installation only application without database. There is need put IP address and folder path information for connect to database on remote host.
</li>

[[File:Installation - Type installation.png]]

On select components page can be chosen custom next options:

* Main Files - the core of application.
* Firebird SQL Server - Database, that keep information data of application. During update process installer will be compare current database SQL server and new one.
* Web components - Not necessary components for new web features.

[[File:Installation - select components.png]]

During first installation, if Firebird SQL served was not installed and select component was checked, application provide page for fill SYSDBA password for new instance.

[[File:Installation - SYSDBA password.png]]

Select Start Menu folder:

[[File:Installation - select start menu option.png]]

Create desktop shortcut

[[File:Installation - create shortcut.png]]

After progress installation, installer show

[[File:Installation - Complete.png]]

<h2>'''Using Firebird 3.x'''</h2>
There is a Firebird database used to store data like connection data to devices, temporary data, statistical data, etc. MupsBox uses version 3.x. Firebird can be installed using application installer or manually. When you run manual installation, select a language, accept the terms of the agreement, select the installation folder, select which components to install (you can leave the default), create shortcuts in the menu, select additional tasks ( can be left by default). 
<div id="shbox" style=" border-width:1px; border-color:lightgrey; padding: 2px 5px 2px 10px; min-height:56px; border-style:solid; font-size: 0.9em;">[[File:Icon-warn.png|left|56px]]
Warning: Firebird 2.5 database support terminated. Firebird 4.0 database support not optimized. Please use only 3.0 version.</div>
 
It's necessary to enable api or api-ssl port for communication between MUPSBOX application and RouterOS device. Use command on ROS: IP → Services 

[[File:api-enable.png|API]]

ip service disable www,www-ssl,ftp,ssh,telnet 
ip service set api-ssl disabled=no address=1.1.1.1 
1.1.1.1 - ip address of the PC where MUPSBOX is installed 

<h2>The location of the program on the server.</h2>
You need to place the executable program files in the same folder with the following files
<div id="shbox" style=" border-width:1px; border-color:lightgrey; padding: 2px 5px 2px 10px; min-height:56px; border-style:solid; font-size: 0.9em;">
[[File:Icon-warn.png|left|56px]]
Attention: If your antivirus warns that one of our services is Trojan or Malware, send these files to the antivirus vendor so that they add their signatures to the exceptions. We do not have Trojans and other filth.</div>There is some of main files of application:<ul>
<li>MupsBox.exe - is the main application, a device management GUI application. 
</li>
<li>MBTrafficser.exe - is a service for regularly receiving Traffic Accounting data. </li>
<li>MBBackupService.exe - is a service for running backup tasks. </li>
<li>MBFtpService.exe - is a service for running an ftp server on your PC. </li>
<li>MBSyslogService.exe - is a data collection service for the Syslog module. </li>
<li>MBPoolingService.exe - A service that polls devices for a given timer. </li>
<li>Config.ini - application configuration file. </li>
<li>MBDB.FDB - application database file. </li>
<li>Fbclient.dll - is an application and database interaction library. </li>
<li>deftitle.rtf - File for editing the report title </li>
<li>defbottom.rtf - File for editing report style </li>
<li>ssleay32.dll and libeay32.dll - SSL libraries</li>
<li>libssh2.dll and libcrypto-1_1-x64.dll - library for the client part of sftp</li>
<li>msvcp110.dll, vcruntime140.dll, msvcr110.dll, msvcr100.dll - supporting libraries</li>
</ul>

<h1>'''First start'''</h1>
When you first start MupsBox.exe, you should create a new database or open an existing database.
[[File:Create-DB.png|DataBase Settings]]
If you are installing the program for the first time, then click Create. If you already have a database, click Open.
After clicking on the selected button, a window will appear, where you need to select the path and name to save or open your database.
[[File:select-path.png|Select Path]]
After you have chosen a place to create or open your database and give it a name, click the Save or Open button. And you will see that the database was created (opened) as in the image below.
[[File:DB-created2.png|DB Created]]

<h1>'''Before install services'''</h1>
It's necessary to configure settings for services Syslog, FTP and also configure notifications.

<h2>Notifications</h2>
[[File:notifications.png|Notifications]]
<ul>
<li>Mail server - your mail server</li>
<li>Mail port - port without SSL</li>
<li>Mail user - username to logon to mail server</li>
<li>Mail password - password for your username</li>
<li>Mail From - Custom MAIL FROM</li>
<li>Mail global recipient - mail to send all notifications(can be redefined in jobs)</li>
<li>SSL port - port with SSL</li>
<li>Save - save your settings for notifications</li>
<li>Check - MupsBox will send a test email</li>
</ul>

<h2>Local FTP/SFTP</h2>
[[File:ftp-service.png|FTP Service]]
 
[[File:sftp-service.png|SFTP Service]]
<ul>
<li>User - username to connect to the local FTP service</li>
<li>Password - Password to connect to the local FTP service</li>
<li>Directory - Folder in which they will connect via FTP</li>
<li>Port - FTP - port</li>
</ul>

<h2>Syslog</h2>
[[File:syslog-service.png|Syslog]]
<ul>
<li>127.0.0.1 - your local IP or your IP address to listen all by UDP</li>
<li>514 - UDP port to listen to messages</li>
</ul>

<h2>HotSpot</h2>
[[File:hotspot-service.png|Hotspot]]
<ul>
<li>IP AddressSyslog for Hotspot gateway - your local IP or your IP address to listen all by UDP</li>
<li>Port Syslog for Hotspot Gateway - UDP port to listen to messages. Warning: The port must be different from the port for syslog </li>
</ul>

<h2>Options</h2>
[[File:options.png|Options]]
<ul>
<li>Number of device threads - How many threads to use for polling devices</li>
<li>Number of IP scanner threads - How many threads to use to search for devices</li>
<li>Web server port - port on which the web server will be launched</li>
<li>* debug - additional logs for services</li>
<li>Device service timer (min) - how often to automatically poll devices</li>
<li>Double click on device - choose what will happen when you double-click or when you click on enter</li>
<li>SSH/Telnet - which application will open when you click on the button [[File:ssh.png|Start ssh]]</li>
<li>Text Backup alert - Adds a warning with the given text to the message body</li>
<li>Size logs/tmp - shows folder size</li>
<li>Clear logs/tmp - clears all contents of folders</li>
</ul>

<h3>Users and permissions</h3>
When you click on the [[File:add.png|Add User]] button, you can add a user with defined access rights to the application.
[[File:adduser2.jpg|Users and permissions]]

<h1>'''Install and Start services'''</h1>
<ul>
<li>To install the service, you must click on the install button next to the name of the service.</li>
<li>To start the service, you must click on the start button next to the name of the service.</li>
</ul>
[[File:Services.png|Services]]

<h1>'''How to Upgrade MupsBox'''</h1>
<ul>
<li>The first step is to stop all services.</li>
<li>Next, you need to uninstall all services.</li>
<li>After downloading the archive of the new version of the program.</li>
<li>Unpack the contents of the archive into the folder where MupsBox software is installed.</li>
<li>After starting the program, the system will offer you to update the database. Click Update.</li>
</ul>
[[File:Upgrade_db2.png|Upgrade DB]]
<ul>
<li>After updating the database, install and start the services.</li>
</ul>
<h1>'''Activation'''</h1>
Activation shows what level of license is installed in your copy of the MupsBOX program.
To activate your license level, you need to fill your real email address, select the license level of the module you want to activate and click Save Level. After that, you need to generate your License ID by clicking the Get License ID button, you will receive a unique identifier that you need to send to email '''support@mupssoft.com''', our specialists will generate a key that will send you back to email. The resulting key must be placed in the License key field, click the Save button and restart the program.
[[File:activation.png|Activation]]

<div id="BackToTop" class="noprint" style="background-color:#DDEFDD; position:fixed;
bottom:32px; left:2%; z-index:9999; padding:0; margin:0;">
[[#top| Back to the Top]]</div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div>
<div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div>
<div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div>
<div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div>
<div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div>
<div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div><div id="turnkey-credit"> <div style="clear: both;"> [https://www.turnkeylinux.org/mediawiki MediaWiki Appliance] - Powered by [https://www.turnkeylinux.org TurnKey Linux] </div> </div>

2021-06-07T12:13:48Z

Admin:

File:Device-list-group-filter.png

2021-06-07T12:10:49Z

Admin: Admin uploaded a new version of File:Device-list-group-filter.png

File:Device-list-search.png

2021-06-07T12:07:29Z

Admin: Admin uploaded a new version of File:Device-list-search.png

Devices Module

2021-06-07T11:56:12Z

Admin:

<h1>'''Device List'''</h1>
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.
[[File:device-listNew.png|Device List All]] 
[[File:device-list-Mikrotik.png|Device List Mikrotik]] 
[[File:device-list-Cisco.png|Device List Cisco]] 
[[File:device-list-Nix.png|Device List Nix]] 
<ul>
On the Device List tab, there are buttons (from left to right): 
<li>[[File:add.png|Add device]] - Add device </li>
<li>[[File:remove.png|Remove device]] - Remove device </li>
<li>[[File:enable.png|Enable device]] - Enable device </li>
<li>[[File:disable.png|Disable device]] - Disable device </li>
<li>[[File:device-settings.png|Device settings]] - Device settings </li>
<li>[[File:winbox.png|Start winbox]] - Start winbox </li>
<li>[[File:ssh.png|Start ssh]] - Start ssh </li>
<li>[[File:refresh.png|Refresh]] - Refresh </li>
<li>[[File:refresh-one.png|Check the availability of a dedicated device]] - Check the availability of a dedicated device </li>
<li>[[File:refresh-all.png|Check the availability of all devices]] - Check the availability of all devices </li>
<li>[[File:kill-treads.png|Kill threads]] - Kill threads </li>
<li>[[File:export-devices.png|Export the list of devices]] - Export the list of devices (including their data, such as un, login, password, etc.) </li>
<li>[[File:import-devices.png|Import the list of all devices]] - Import the list of all devices (including their data, such as un, login, password, etc.) </li>
<li>[[File:update-ros.png|Update the ROS version]] - Update the ROS version </li>
<li>[[File:upgrade-bios.png|Upgrade the BIOS]] - Upgrade the BIOS </li>
<li>[[File:cmd.png|CMD]] - Send a command to the selected device </li>
<li>[[File:exel.png|Export the visible list of devices in Excel]] - Export the visible list of devices in Excel </li>
<li>[[File:device-geo.png|Geolocation by coordinates]] - Geolocation by coordinates </li>
<li>[[File:device-over.png|re-read and overwrite data of selected devices]] - re-read and overwrite data of selected devices </li>
<li>[[File:device-over-all.png|re-read and overwrite data of all devices]] - re-read and overwrite data of all devices </li>
</ul>

<h2>'''Add device'''</h2>
To add a device, press [[File:add.png|Add device]], a window will appear where you need to enter device data.
[[File:add-device.png|Add Device]]
[[File:add-device-gps.png|Add Device GPS tab]]
[[File:add-device-lte.png|Add Device LTE tab]]

<ul>
<li>Hostname - Any convenient device name. </li>
<li>Username - Username to login to device. </li>
<li>Password - Password to login to device. </li>
<li>IP / AD - Device IP address. </li>
<li>Connect via - connecting to the device via </li>
<li>SSH port - Your ssh port, which you registered in Ip -> Services </li>
<li>FTP port - Your ftp port, which you registered in Ip -> Services </li>
<li>Telnet port - Your telnet port </li>
<li>Winbox port - Your winbox port </li>
<li>API SSL port - Your API SSL port </li>
<li>API SSL - Your API port </li>
<li>Version package channel - Your version package channel on royter </li>
<li>Join in group - Select the groups to which the device will belong. </li>
<li>Available groups - Existing groups created in the Groups tab. </li>
<li>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. </li>
<li>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. </li>
<li>Comment - Comment on the device. </li>
<li>GPS tab - you can enter the coordinates and address of the location of the device in order to display it on the map in the GeoTrack module </li>
<li>LTE tab - If your device has an LTE modem, specify them for the possibility of updating (At the moment it works only for Mikrotik devices) </li>
</ul>

<h2>'''Export and import devices'''</h2>
To export all devices with their data, click the [[File:export-devices.png|Export the list of devices]] button. A confirmation window will appear.
[[File:confirm-export.png|С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 [[File:import-devices.png|Import the list of devices]] button. A confirmation window will appear.
[[File:confirm-export.png|Сonfirm]]
If your file contains encrypted passwords, click yes; otherwise, click no. 

<h2>'''Command line'''</h2>
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 [[File:cmd.png|CMD]] button. The following window will appear:
[[File:cmd-window.png|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.
[[File:cmd-window-commands.png|CMD work space]]
If you entered several commands in a row, you can navigate between them using the up and down arrows
Also, you can load the RSC file with the settings. Select the file by clicking .. and press the GO button

<h2>'''Working with device lists and filtering'''</h2>
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.
[[File:device-list-search.png|Device List]]
Having sorted the devices by a certain attribute, you can export the sorted list to Excel by pressing the [[File:exel.png|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:
[[File:device-list-group-filter.png|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.
 
<h3>'''Customize Device List'''</h3>
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.
[[File:customize-device-list.png|Customize Device List]]

<h2>'''Add device from Net'''</h2>
Search and add Mikrotik devices in automatic mode.
[[File:add-dev-from-net.png|Add device from Net]]
<ul>
<li>IP - subnet. </li>
<li>Prefix - Mask. </li>
<li>Username - Username to login to device. </li>
<li>Password - Password to login to device. </li>
<li>Port - Your api or api-ssl port that you opened on RouterOS. </li>
<li>New Group - Create new group. </li>
<li>Ignore check host ID - If you have several IP addresses on your device and you do not want to add them all, check the box and the program will check the software id and not add the same router. </li>
<li>Filtre - You can scan devices into specific groups from the entire network using the filter by board name or model. </li>
<li>Group name - Select the group to which devices will be added. </li>
</ul>

<h1>'''Groups'''</h1>
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.
[[File:groups.png|Groups]]

<h2>'''Add group'''</h2>
To add a group, click the [[File:add.png|Add group]] button and the following window will appear:
[[File:add-group.png|Add Group]]
<ul>
<li>Name - Any convenient group name. </li>
<li>Description - Group description. </li>
</ul>
<h2>'''Remove group'''</h2>
To remove a group, click the [[File:remove.png|Remove]] button. A query will appear:
[[File:delete-group.png|Deletegroup]]
Click Yes to delete or No to cancel.

<h2>'''Command line'''</h2>
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 [[File:cmd.png|CMD]] button. The following window will appear:
[[File:cmd-window.png|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.
[[File:cmd-window-commands.png|CMD work space]]
If you entered several commands in a row, you can navigate between them using the up and down arrows

<h2>'''Command line (API samples)'''</h2>
Using api - you get feedback. This is very important because you will always know if the command was executed successfully. Also, you get the opportunity to build reports using API: request->response. Here are some examples.
 
add new user
/user/add =name=username =group=full =password=userpassword =comment=this is new user

remove user
/user/remove =.id=username

on which router is the user 'admin'?
/user/print ?name=admin mbcount==1

on which router firewall is not configured, for example, rules < 3 ?
/ip/firewall/filter/print mbcount=<3

disable all rules in /ip/firewall/filter where chain=input and action=drop
/ip/firewall/filter/disable ?chain=input ?action=drop ?#& mbgetid

on which router is dns server 8.8.4.4 configured?
/ip/dns/print mb?servers=8.8.4.4

 
<div id="shbox" style=" border-width:1px; border-color:lightgrey; padding: 2px 5px 2px 10px; min-height:56px; border-style:solid; font-size: 0.9em;">
[[File:Icon-warn.png|left|56px|56px]]
Notice: mbcount - proproetary function mupsbox, gets counts data replies (!re),mbcount= (=x, >x , <x, ==x, =>x, =<x). mbgetid - allows you to combine several commands: perform an action with a preliminary request to get id, execute a print query c .proplist = .id, storing the result in the array and then performing the desired action. mb?filed - allows you to build queries where there is no where attribute, mb?(field)(=/!=/<>)</div>
 

<h2>'''Settings for groups'''</h2>
When you need to change data such as login, password, port, type of port for a group of devices, click on the [[File:settings-for-group.png|Settings for groups]] button. The following window will appear:
[[File:group-settings.png|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.

<h1>'''Pooling jobs'''</h1>
This tab is intended for to create tasks for testing the availability of devices by groups.
[[File:pooling-jobs.png|Pooling jobs]]
<h2>'''Add job'''</h2>
To add a group, click the [[File:add.png|Add job]] button and the following window will appear:
[[File:pooling-job-add.png|Add job]]
<ul>
<li>Job Name - Any convenient job name. </li>
<li>Group Name - Select group. </li>
<li>Period type - Select verification period. </li>
<li>GPS - Take GPS coordinates. </li>
<li>Description - Comment or description for the job. </li>
</ul>

<h1>'''Nix device List'''</h1>
It is used to add Nix devices to the database. Further, when using other modules of mupsbox.
[[File:nix-dev-list.png|Device List]]

<ul>
On the Nix device List tab, there are buttons (from left to right): 
<li>[[File:add.png|Add device]] - Add device </li>
<li>[[File:remove.png|Remove device]] - Remove device </li>
<li>[[File:enable.png|Enable device]] - Enable device </li>
<li>[[File:disable.png|Disable device]] - Disable device </li>
<li>[[File:ssh.png|Start ssh]] - Start ssh </li>
<li>[[File:refresh.png|Refresh]] - Refresh </li>
<li>[[File:refresh-one.png|Check the availability of a dedicated device]] - Check the availability of a dedicated device </li>
<li>[[File:refresh-all.png|Check the availability of all devices]] - Check the availability of all devices </li>
</ul>

<h2>'''Add nix device'''</h2>
To add a device, press [[File:add.png|Add nix device]], a window will appear where you need to enter device data.
[[File:add-nix-dev.png|Add Nix Device]]

<ul>
<li>Hostname - Any convenient device name. </li>
<li>Host IP - Device IP address. </li>
<li>Username - Username to login to device. </li>
<li>Password - Password to login to device. </li>
<li>SSH port - Your ssh port, which you registered in Ip -> Services </li>
<li>FTP port - Your ftp port, which you registered in Ip -> Services </li>
<li>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. </li>
<li>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. </li>
</ul>

<div id="BackToTop" class="noprint" style="background-color:#DDEFDD; position:fixed;
bottom:32px; left:2%; z-index:9999; padding:0; margin:0;">
[[#top| Back to the Top ]]</div>

File:Add-device-lte.png

2021-06-07T11:47:36Z

Admin:

File:Add-device-gps.png

2021-06-07T11:47:25Z

Admin: Admin uploaded a new version of File:Add-device-gps.png

File:Add-device.png

2021-06-07T11:47:10Z

Admin: Admin uploaded a new version of File:Add-device.png

Devices Module

2021-06-07T11:41:26Z

2021-06-07T11:29:52Z

Admin:

File:Device-list.png

2021-06-07T11:27:59Z

Admin: Admin uploaded a new version of File:Device-list.png