Manual:System/Packages: Difference between revisions

From MikroTik Wiki
Jump to navigation Jump to search
Line 15: Line 15:
!width="450px" style="background:#cccccc; border-bottom:1px solid gray;"| Features
!width="450px" style="background:#cccccc; border-bottom:1px solid gray;"| Features
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''advanced-tools''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''advanced-tools''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"| Advanced ping tools (flood-ping, ping-speed), Netwatch, ip-scan, SMS tool, Wake-on-LAN
|style="border-bottom:1px solid gray;" valign="top"| Advanced ping tools (flood-ping, ping-speed), Netwatch, ip-scan, SMS tool, Wake-on-LAN
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''calea''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''calea''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|Data gathering tool for specific use due to "Communications Assistance for Law Enforcement Act" in USA
|style="border-bottom:1px solid gray;" valign="top"|Data gathering tool for specific use due to "Communications Assistance for Law Enforcement Act" in USA
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''dhcp''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''dhcp''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|Dynamic Host Control Protocol client and server
|style="border-bottom:1px solid gray;" valign="top"|Dynamic Host Control Protocol client and server
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''gps''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''gps''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|Global Positioning System devices support
|style="border-bottom:1px solid gray;" valign="top"|Global Positioning System devices support
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''hotspot''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''hotspot''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|[[Hotspot|HotSpot]] captive portal server for user management
|style="border-bottom:1px solid gray;" valign="top"|[[Hotspot|HotSpot]] captive portal server for user management
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''ipv6''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''ipv6''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|IPv6 addressing support
|style="border-bottom:1px solid gray;" valign="top"|IPv6 addressing support
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''mpls''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''mpls''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|[[MPLS|Multi Protocol Labels Switching support]]
|style="border-bottom:1px solid gray;" valign="top"|[[MPLS|Multi Protocol Labels Switching support]]
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''multicast''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''multicast''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|[[Multicast|Protocol&nbsp;Independent&nbsp;Multicast&nbsp;-&nbsp;Sparse&nbsp;Mode]]; [[IGMP-Proxy|Internet&nbsp;Group&nbsp;Managing&nbsp;Protocol&nbsp;-&nbsp;Proxy]]
|style="border-bottom:1px solid gray;" valign="top"|[[Multicast|Protocol&nbsp;Independent&nbsp;Multicast&nbsp;-&nbsp;Sparse&nbsp;Mode]]; [[IGMP-Proxy|Internet&nbsp;Group&nbsp;Managing&nbsp;Protocol&nbsp;-&nbsp;Proxy]]
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''ntp''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''ntp''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|Network protocol server, also includes simplistic client. NTP client is also built into the system package and functions well without this package installed.  
|style="border-bottom:1px solid gray;" valign="top"|Network protocol server, also includes simplistic client. NTP client is also built into the system package and functions well without this package installed.  
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''openflow''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''openflow''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|Enables OpenFlow support
|style="border-bottom:1px solid gray;" valign="top"|Enables OpenFlow support
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''ppp''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''ppp''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|MlPPP client, PPP, PPTP, L2TP, PPPoE, ISDN PPP clients and servers
|style="border-bottom:1px solid gray;" valign="top"|MlPPP client, PPP, PPTP, L2TP, PPPoE, ISDN PPP clients and servers
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''routerboard''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''routerboard''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"| accessing and managing RouterBOOT. RouterBOARD specific imformation.
|style="border-bottom:1px solid gray;" valign="top"| accessing and managing RouterBOOT. RouterBOARD specific imformation.
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''routing''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''routing''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|dynamic routing protocols like [[M:Routing/RIP | RIP]], [[M:Routing/BGP | BGP]], [[M:Routing/OSPF|OSPF]] and routing utilities like [[M:Routing/BFD | BFD]], [[M:Routing/Routing_filters|filters for routes]].
|style="border-bottom:1px solid gray;" valign="top"|dynamic routing protocols like [[M:Routing/RIP | RIP]], [[M:Routing/BGP | BGP]], [[M:Routing/OSPF|OSPF]] and routing utilities like [[M:Routing/BFD | BFD]], [[M:Routing/Routing_filters|filters for routes]].
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''security''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''security''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|IPSEC, SSH, Secure WinBox  
|style="border-bottom:1px solid gray;" valign="top"|IPSEC, SSH, Secure WinBox  
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''system''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''system''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|basic router features like ''static routing, ip addresses, sNTP, telnet, [[M:API | API]], queues, [[M:IP/Firewall | firewall]], [[M:IP/Proxy | web proxy]], [[M:IP/DNS | DNS cache]], [[M:IP/TFTP|TFTP]], [[M:IP/Pools | IP pool]], SNMP, packet sniffer, e-mail send tool, graphing, bandwidth-test, torch, [[M:Interface/EoIP | EoIP]], [[M:Interface/IPIP | IPIP]], [[M:Interface/Bridge | bridging]], [[M:Interface/VLAN | VLAN]], [[M:Interface/VRRP | VRRP]] etc.). Also, for RouterBOARD platform - [[M:Metarouter|MetaROUTER | Virtualization]]
|style="border-bottom:1px solid gray;" valign="top"|basic router features like ''static routing, ip addresses, sNTP, telnet, [[M:API | API]], queues, [[M:IP/Firewall | firewall]], [[M:IP/Proxy | web proxy]], [[M:IP/DNS | DNS cache]], [[M:IP/TFTP|TFTP]], [[M:IP/Pools | IP pool]], SNMP, packet sniffer, e-mail send tool, graphing, bandwidth-test, torch, [[M:Interface/EoIP | EoIP]], [[M:Interface/IPIP | IPIP]], [[M:Interface/Bridge | bridging]], [[M:Interface/VLAN | VLAN]], [[M:Interface/VRRP | VRRP]] etc.). Also, for RouterBOARD platform - [[M:Metarouter|MetaROUTER | Virtualization]]
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''ups''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''ups''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|APC ups management interface
|style="border-bottom:1px solid gray;" valign="top"|APC ups management interface
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''user-manager''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''user-manager''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|[[User_Manager|MikroTik User Manager]] server for controlling Hotspot and other service users.  
|style="border-bottom:1px solid gray;" valign="top"|[[User_Manager|MikroTik User Manager]] server for controlling Hotspot and other service users.  
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''wireless''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''wireless''' (<em>mipsle, mipsbe, ppc, x86, mmips, arm</em>)
|style="border-bottom:1px solid gray;" valign="top"| [[M:Interface/Wireless|wireless interface]] support. Sometimes sub-types are released, for example '''wireless-fp''' introduced FastPath support, '''wireless-cm2''' introduced CAPsMAN v2 and '''wireless-rep''' introduced Repeater mode. These packages are occasionally released separately, before the new features get merged into the main wireless package.  
|style="border-bottom:1px solid gray;" valign="top"| [[M:Interface/Wireless|wireless interface]] support. Sometimes sub-types are released, for example '''wireless-fp''' introduced FastPath support, '''wireless-cm2''' introduced CAPsMAN v2 and '''wireless-rep''' introduced Repeater mode. These packages are occasionally released separately, before the new features get merged into the main wireless package.  
|-
|-
Line 92: Line 92:
|style="border-bottom:1px solid gray;" valign="top"|'''routeros-mipsle''' (<em>mipsle</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''routeros-mipsle''' (<em>mipsle</em>)
|style="border-bottom:1px solid gray;" valign="top"|combined package for mipsle (RB100, RB500) (includes <em>system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing</em>)
|style="border-bottom:1px solid gray;" valign="top"|combined package for mipsle (RB100, RB500) (includes <em>system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing</em>)
|-
|style="border-bottom:1px solid gray;" valign="top"|'''routeros-smips''' (<em>smips</em>)
|style="border-bottom:1px solid gray;" valign="top"|combined package for smips (hAP mini, hAP lite) (includes <em>system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing</em>)
|-
|-
|style="border-bottom:1px solid gray;" valign="top"|'''routeros-mipsbe''' (<em>mipsbe</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''routeros-mipsbe''' (<em>mipsbe</em>)
Line 101: Line 104:
|style="border-bottom:1px solid gray;" valign="top"|'''routeros-x86''' (<em>x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|'''routeros-x86''' (<em>x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|combined package for x86 (Intel/AMD PC, RB230)  (includes <em>system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing</em>)
|style="border-bottom:1px solid gray;" valign="top"|combined package for x86 (Intel/AMD PC, RB230)  (includes <em>system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing</em>)
|-
|style="border-bottom:1px solid gray;" valign="top"|'''routeros-mmips''' (<em>mmips</em>)
|style="border-bottom:1px solid gray;" valign="top"|combined package for multicore mips (Mxx, RB750v3) (includes <em>system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing</em>)
|-
|style="border-bottom:1px solid gray;" valign="top"|'''routeros-arm''' (<em>arm</em>)
|style="border-bottom:1px solid gray;" valign="top"|combined package for arm (cAP ac, hAP ac², CRS3xx, RB3011, RB1100AHx4, etc)  (includes <em>system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing</em>)
|}
|}



Revision as of 16:26, 26 March 2018

Summary

RouterOS supports a lot of different features and since every installation requires specific set of features supprted it is possible to add or remove certain groups of features using package system. As result user is able to control what features are available and size of installation. Packages are provided only by MikroTik and no 3rd parties are allowed to make them.

Acquiring packages

Packages can be downloaded from MikroTik download page or mirrors listed on that page. Either of provided download methods can be used.

RouterOS packages

For a simple home router, only the system package is needed for basic operation. Other packages are optional. The DHCP package might be the next most important, if your ISP provides IP addresses using this method. PPP is needed if you require PPPoE or PPTP for connectivity. Other packages are not required for a home router, and are completely optional. Install them only if you are sure of their purpose.

Package Features
advanced-tools (mipsle, mipsbe, ppc, x86, mmips, arm) Advanced ping tools (flood-ping, ping-speed), Netwatch, ip-scan, SMS tool, Wake-on-LAN
calea (mipsle, mipsbe, ppc, x86, mmips, arm) Data gathering tool for specific use due to "Communications Assistance for Law Enforcement Act" in USA
dhcp (mipsle, mipsbe, ppc, x86, mmips, arm) Dynamic Host Control Protocol client and server
gps (mipsle, mipsbe, ppc, x86, mmips, arm) Global Positioning System devices support
hotspot (mipsle, mipsbe, ppc, x86, mmips, arm) HotSpot captive portal server for user management
ipv6 (mipsle, mipsbe, ppc, x86, mmips, arm) IPv6 addressing support
mpls (mipsle, mipsbe, ppc, x86, mmips, arm) Multi Protocol Labels Switching support
multicast (mipsle, mipsbe, ppc, x86, mmips, arm) Protocol Independent Multicast - Sparse Mode; Internet Group Managing Protocol - Proxy
ntp (mipsle, mipsbe, ppc, x86, mmips, arm) Network protocol server, also includes simplistic client. NTP client is also built into the system package and functions well without this package installed.
openflow (mipsle, mipsbe, ppc, x86, mmips, arm) Enables OpenFlow support
ppp (mipsle, mipsbe, ppc, x86, mmips, arm) MlPPP client, PPP, PPTP, L2TP, PPPoE, ISDN PPP clients and servers
routerboard (mipsle, mipsbe, ppc, x86, mmips, arm) accessing and managing RouterBOOT. RouterBOARD specific imformation.
routing (mipsle, mipsbe, ppc, x86, mmips, arm) dynamic routing protocols like RIP, BGP, OSPF and routing utilities like BFD, filters for routes.
security (mipsle, mipsbe, ppc, x86, mmips, arm) IPSEC, SSH, Secure WinBox
system (mipsle, mipsbe, ppc, x86, mmips, arm) basic router features like static routing, ip addresses, sNTP, telnet, API, queues, firewall, web proxy, DNS cache, TFTP, IP pool, SNMP, packet sniffer, e-mail send tool, graphing, bandwidth-test, torch, EoIP, IPIP, bridging, VLAN, VRRP etc.). Also, for RouterBOARD platform - MetaROUTER | Virtualization
ups (mipsle, mipsbe, ppc, x86, mmips, arm) APC ups management interface
user-manager (mipsle, mipsbe, ppc, x86, mmips, arm) MikroTik User Manager server for controlling Hotspot and other service users.
wireless (mipsle, mipsbe, ppc, x86, mmips, arm) wireless interface support. Sometimes sub-types are released, for example wireless-fp introduced FastPath support, wireless-cm2 introduced CAPsMAN v2 and wireless-rep introduced Repeater mode. These packages are occasionally released separately, before the new features get merged into the main wireless package.
arlan (x86) legacy Aironet Arlan support
isdn (x86) ISDN modem support
lcd (x86) LCD panel support for serial/parallel port devices. Not needed for RouterBOARD LCD panels.
radiolan (x86) RadioLan cards support
synchronous (x86) FarSync support
xen ( discontinued x86) XEN Virtualization
kvm (x86) KVM Virtualization
routeros-mipsle (mipsle) combined package for mipsle (RB100, RB500) (includes system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing)
routeros-smips (smips) combined package for smips (hAP mini, hAP lite) (includes system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing)
routeros-mipsbe (mipsbe) combined package for mipsbe (RB400) (includes system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing)
routeros-powerpc (ppc) combined package for powerpc (RB300, RB600, RB1000) (includes system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing)
routeros-x86 (x86) combined package for x86 (Intel/AMD PC, RB230) (includes system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing)
routeros-mmips (mmips) combined package for multicore mips (Mxx, RB750v3) (includes system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing)
routeros-arm (arm) combined package for arm (cAP ac, hAP ac², CRS3xx, RB3011, RB1100AHx4, etc) (includes system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing)

Working with packages

Menu: /system package

Commands executed in this menu will take place only on restart of the router. Until then, user can freely schedule or revert set actions.

Command Desciption
disable schedule the package to be disabled after the next reboot. No features provided by the package will be accessible
downgrade will prompt for the reboot. During the reboot process will try to downgrade the RouterOS to the oldest version possible by checking the packages that are uploaded to the router.
print outputs information about the packages, like: version, package state, planned state changes etc.
enable schedule package to be enabled after the next reboot
uninstall schedule package to be removed from the router. That will take place during the reboot.
unschedule remove scheduled task for the package.

Examples

Upgrade process is described here.

List available packages

 /system package print 
Flags: X - disabled 
 #   NAME                    VERSION                    SCHEDULED              
 0 X ipv6                    3.13                                              
 1   system                  3.13                                              
 2 X mpls                    3.13                                              
 3 X hotspot                 3.13                                              
 4   routing                 3.13                                              
 5   wireless                3.13                                              
 6 X dhcp                    3.13                                              
 7   routerboard             3.13                                              
 8   routeros-mipsle         3.13                                              
 9   security                3.13                                              
 10 X ppp                     3.13                                              
 11   advanced-tools          3.13

Uninstall package

Schedules package for uninstallation and reboots router.

 /system package uninstall ppp; /system reboot; 
Reboot, yes? [y/N]:

Disable package

 /system package disable hotspot; /system reboot;
Reboot, yes? [y/N]:

Downgrade

 /system package downgrade; /system reboot;
Reboot, yes? [y/N]: 

Cancel uninstall or disable action

 /system package unschedule ipv6