View source for Manual:System/Packages

==Summary==

RadioOS 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 Wireless Excellence download sites if required.
==RadioOS packages==

'''for each architecture'''

{| cellpadding="2" 
!width="300px" style="background:#cccccc; border-bottom:1px solid gray;"| Package
!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 ping tools. 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"|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"|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"|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"|[[Manual:IP/Hotspot|HotSpot 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 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"|[[Manual: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|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"|Network protocol client and service
|-
|style="border-bottom:1px solid gray;" valign="top"|'''ppp''' (<em>mipsle, mipsbe, ppc, x86</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"|'''routerboard''' (<em>mipsle, mipsbe, ppc, x86</em>)
|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"|dynamic routing protocols like [[Manual:Routing/RIP | RIP]], [[Manual:Routing/BGP | BGP]], [[Manual:Routing/OSPF|OSPF]] and routing utilities like [[Manual:Routing/BFD | BFD]], [[Manual: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"|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"|basic router features like ''static routing, ip addresses, sNTP, telnet, [[Manual:API | API]], queues, [[Manual:IP/Firewall | firewall]], [[Manual:IP/Proxy | web proxy]], [[Manual:IP/DNS | DNS cache]], [[Manual:IP/TFTP|TFTP]], [[Manual:IP/Pools | IP pool]], SNMP, packet sniffer, e-mail send tool, graphing, bandwidth-test, torch, [[Manual:Interface/EoIP | EoIP]], [[Manual:Interface/IPIP | IPIP]], [[Manual:Interface/Bridge | bridging]], [[Manual:Interface/VLAN | VLAN]], [[Manual:Interface/VRRP | VRRP]] etc.). Also, for RouterBOARD platform - [[Manual: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"|APC ups 
|-
|style="border-bottom:1px solid gray;" valign="top"|'''user-manager''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|[[Manual:User_Manager|User Manager]]
|-
|style="border-bottom:1px solid gray;" valign="top"|'''wireless''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"| [[Manual:Interface/Wireless|wireless interface]] support
|-
|style="border-bottom:1px solid gray;" valign="top"|'''arlan''' (<em>x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|legacy Aironet Arlan support
|-
|style="border-bottom:1px solid gray;" valign="top"|'''isdn''' (<em>x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|ISDN support 
|-
|style="border-bottom:1px solid gray;" valign="top"|'''lcd''' (<em>x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|LCD panel support
|-
|style="border-bottom:1px solid gray;" valign="top"|'''radiolan''' (<em>x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|RadioLan cards support
|-
|style="border-bottom:1px solid gray;" valign="top"|'''synchronous''' (<em>x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|FarSync support
|-
|style="border-bottom:1px solid gray;" valign="top"|'''xen''' (<em> discontinued x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|[[Manual:Xen|XEN Virtualization]]
|-
|style="border-bottom:1px solid gray;" valign="top"|'''kvm''' (<em>x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|[[Manual:KVM|KVM Virtualization]]
|-
|style="border-bottom:1px solid gray;" valign="top"|'''RadioOS-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"|'''RadioOS-mipsbe''' (<em>mipsbe</em>)
|style="border-bottom:1px solid gray;" valign="top"|combined package for mipsbe (RB400)  (includes <em>system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing</em>)
|-
|style="border-bottom:1px solid gray;" valign="top"|'''RadioOS-powerpc''' (<em>ppc</em>)
|style="border-bottom:1px solid gray;" valign="top"|combined package for powerpc (RB300, RB600, RB1000)  (includes <em>system, hotspot, wireless, ppp, security, mpls, advanced-tools, dhcp, routerboard, ipv6, routing</em>)
|-
|style="border-bottom:1px solid gray;" valign="top"|'''RadioOS-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"|'''mpls-test''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|Multi Protocol Labels Switching support improvements
|-
|style="border-bottom:1px solid gray;" valign="top"|'''routing-test''' (<em>mipsle, mipsbe, ppc, x86</em>)
|style="border-bottom:1px solid gray;" valign="top"|routing protocols (RIP, OSPF, BGP) improvements
|}

== Working with packages ==

'''Menu:''' <em>/system package</em>

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

{| cellpadding="2" 
!width="300px" style="background:#cccccc; border-bottom:1px solid gray;"| Command
!width="450px" style="background:#cccccc; border-bottom:1px solid gray;"| Desciption
|-
|style="border-bottom:1px solid gray;" valign="top"|'''disable'''
|style="border-bottom:1px solid gray;" valign="top"| schedule package to be disabled after next reboot. All features provided by package will not be accessible
|-
|style="border-bottom:1px solid gray;" valign="top"|'''downgrade'''
|style="border-bottom:1px solid gray;" valign="top"|will prompt for reboot. During reboot process will try to downgrade RadioOS to oldest version possible by checking packages that are uploaded to the router.
|-
|style="border-bottom:1px solid gray;" valign="top"|'''print'''
|style="border-bottom:1px solid gray;" valign="top"|outputs information about packages, like: version,  package state, planned state changes etc.
|-
|style="border-bottom:1px solid gray;" valign="top"|'''enable'''
|style="border-bottom:1px solid gray;" valign="top"|schedule package to be enabled after next reboot
|-
|style="border-bottom:1px solid gray;" valign="top"|'''uninstall'''
|style="border-bottom:1px solid gray;" valign="top"|schedule package to be removed from router. That will take place during reboot.
|-
|style="border-bottom:1px solid gray;" valign="top"|'''unschedule'''
|style="border-bottom:1px solid gray;" valign="top"|remove scheduled task for package.
|}

==Examples==

Upgrade process is described [[Manual:Upgrading_RadioOS|here]].

====List available packages====

<pre>
 /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   RadioOS-mipsle         3.13                                              
 9   security                3.13                                              
 10 X ppp                     3.13                                              
 11   advanced-tools          3.13
</pre>

====Uninstall package====

Schedules package for uninstallation and reboots router.

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

====Disable package====

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

====Downgrade====

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

====Cancel uninstall or disable action====

<pre>
 /system package unschedule ipv6
</pre>

[[Category: Manual|P]]
[[Category: System|P]]
[[Category:Basic|P]]