17. Software Package Installation and Upgrading

Overview

The MikroTik RouterOS consists of a formatted HDD specific to our installation and of software packages. The main package is the system software package which provides the basic functionality of the router. Additional software packages can be installed that provide special support, e.g., PPPoE, PPTP, PPP, wireless, etc.

Features

The modular software package system of MikroTik RouterOS has following features: The following topics are covered in this section:

Software Upgrade Instructions

Upgrading of the MikroTik RouterOS can be done by uploading the newer version software packages to the router and rebooting it. Before upgrading the router please check the current version of the system software and of the additional software packages. The version of the MikroTik RouterOS system software (and the build number) are shown before the console login prompt, for example:
MikroTik v2.3.6 (build 7)
Login: 
Information about the version (and build) numbers of the installed MikroTik RouterOS software packages can be obtained using the /system package print command, for example:

[mikrotik]> system package print 
  # NAME                                        VERSION    BUILD UNINSTALL
  0 routing                                     2.3.6      6     no
  1 ssh                                         2.3.6      7     no
  2 pptp                                        2.3.6      5     no
  3 system                                      2.3.6      7     no
  4 ppp                                         2.3.6      5     no
  5 pppoe                                       2.3.6      9     no
[mikrotik]> 

The list shows the number, name, version and build number of the installed software packages. If the functions provided by a software package are not required for the router implementation, the package can be marked for uninstalling at the next shutdown/reboot of the router. Use the following command to mark the packages for uninstallation:

/system package uninstall number

Here, the argument value number is the number of the package as it appears on the list of /system package print command.

If a package is marked for uninstallation, but it is required for another (dependent) package, then the marked package cannot be uninstalled. For example, the ppp package wont be uninstalled, if the pptp package is installed. You should uninstall the depended package too. For package dependencies see the section about contents of the software packages below. The system package wont be uninstalled even if marked for uninstallation.

Be careful about marking packages for uninstallation, because the only way to reverse your decision is to use the /undo command. 'Undo' works on the configuration changes in reverse order they have been performed. It means, that all configuration changes done after marking the package for uninstallation would be undone too.

Software Package Installation Instructions

The software package files are compressed binary files, which can be lownloaded from MikroTik's web page www.mikrotik.com Dowload section. The full name of the package file consists of a descriptive name, version number, and file extension '.npk'. For example, 'system-2.3.7.npk', 'ppp-2.3.7.npk'. 'pppoe-2.3.7.npk', etc. To install (upgrade) newer version of the MikroTik RouterOS system software please follow the upgrade instructions below: Example output of the /system store print command:

[mikrotik] system store> print
  # NAME                                                   VERSION    BUILD
  0 routing                                                2.3.7      7
  1 system                                                 2.3.7      8
  2 ppp                                                    2.3.7      6
  3 pppoe                                                  2.3.7      10
  4 pptp                                                   2.3.7      6
[mikrotik] system store>

The installation/upgrade process is shown on the console screen (monitor) attached to the router. After successful installation the software packages are shown on the output list of the /system package print command, for example:

[mikrotik]> system package print
  # NAME                                         VERSION    BUILD UNINSTALL
  0 system                                       2.3.7      8     no
  1 ppp                                          2.3.7      6     no
  2 pppoe                                        2.3.7      10    no
  3 pptp                                         2.3.7      6     no
  4 routing                                      2.3.7      7     no
  5 ssh                                          2.3.6      7     no
[mikrotik]>

Here, the list of currently installed software packages is shown including the ssh package which was nor upgraded. We recommend to upgrade all packages to the newest version.

Automatic Software Package Upgarding

The automatic upgrade option of the MikroTik RouterOS software packages can be accessed under the /system package auto-update menu. The option is not functional and cannot be used yet.

Contents of the Software Packages

The system software package provides the basic functionality of the MikroTik RouterOS, namely: After installing the MikroTik RouterOS, a license should be obtained from MikroTik to enable the basic system functionality. The table below shows additional software packages, the provided functionality, the required prerequisites and additional licenses, if any.
Name Contents Prerequisites Additional License
routing Provides RIP & OSPF support - -
snmp Provides read only SNMP support - -
ssh Provides remote access via SSH - -
lcd Provides LCD monitor support - -
ups Provides APC Smart Mode UPS support - -
ppp Provides asynchronous PPP support - -
pptp Provides PPTP support ppp -
pppoe Provides PPPoE support ppp -
isdn Provides support for ISDN ppp -
telephony Provides IP telephony support (H.323) for Quicknet cards - -
moxa-c101 Provides support for Moxa C101 synchronous card - synchronous
lmc-wan Provides support for LMC synchronous cards - synchronous
cyclades provides support for PC300 synchronous interfaces - synchronous
aironet Provides support for CISCO Aironet IEEE 802.11 wireless PC/PCI/ISA cards - 2.4GHz wireless
arlan Provides support for DSSS 2.4GHz 2mbps Aironet ISA cards - 2.4GHz wireless
wavelan Provides support for Lucent WaveLAN IEEE 802.11 wireless cards - 2.4GHz wireless
teletronics Provides support for Teletronics IEEE 802.11 wireless cards - 2.4GHz wireless
radiolan Provides support for 5.8GHz RadioLAN ISA cards - radiolan

If additional license is required to enable the functionality of a software package, the license should be obtained for the Software ID of your system. The the new key should be entered using the /system license unlock command, for example:

[mikrotik] system license> print
Software ID: TPNG-SXN
[mikrotik] system license> unlock D45G-IJ6-QM3
[mikrotik] system license>

The router should be rebooted to enable the functionality after entering a new license. If there is no appropriate license, the appropriate interfaces wont show up under the interface list, even though the packages can be installed on the MikroTik RouterOS and corresponding drivers loaded.

Software Package Resource Usage

The following table shows the required resources of HDD storage and RAM for the various software packages. The total required storage space can be calculated by adding the together the required storage of all installed packages including the system software package.

Name Memory (RAM) usage, MB Storage (HDD) usage, MB
system 15.2 12.0
routing 1.4 1.3
snmp 0.9 0.5
ssh 2.0 1.2
lcd 2.4 0.2
ups 0.8 0.3
ppp 1.4 1.0
pptp 2.1 1.4
pppoe 2.0 1.5
isdn 2.5 1.2
telephony 8.8 9.1
moxa-c101 1.4 0.2
lmc-wan 0.9 0.2
cyclades 1.1 0.2
aironet 1.0 0.3
arlan 0.9 0.2
wavelan 1.4 0.3
teletronics 1.4 0.2
radiolan 1.5 0.25

Troubleshooting

  to the contents