Software Upgrade Instructions
Upgrading of the MikroTik RouterOS can be done by uploading the newer version software
packages to the router and rebooting it.
Note! The Free Demo Licence does not allow software upgrades by ftp. You schould use complete reinstall from floppies, or purchase the license.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.5 Login:Information about the version numbers and build time of the installed MikroTik RouterOS software packages can be obtained using the /system package print command, for example:
[MikroTik] > system package print Flags: I - invalid # NAME VERSION BUILD-TIME UNINSTALL 0 routing 2.5rc4 jan/30/2002 10:43:38 no 1 pppoe 2.5rc4 jan/30/2002 10:37:47 no 2 ssh 2.5rc4 jan/30/2002 10:33:52 no 3 system 2.5rc4 jan/30/2002 10:31:32 no 4 snmp 2.5rc4 jan/30/2002 10:32:13 no 5 ppp 2.5rc4 jan/30/2002 10:36:03 no 6 pptp 2.5rc4 jan/30/2002 10:36:42 no 7 aironet 2.5rc4 jan/30/2002 10:39:05 no 8 prism 2.5rc4 jan/30/2002 15:51:12 no [MikroTik] >
The list shows the number, name, version, and build time 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 /system package set command to mark the packages for uninstallation:
[MikroTik] > system package set 0 uninstall=yes [MikroTik] > system package print Flags: I - invalid # NAME VERSION BUILD-TIME UNINSTALL 0 routing 2.5rc4 jan/30/2002 10:43:38 yes 1 pppoe 2.5rc4 jan/30/2002 10:37:47 no 2 ssh 2.5rc4 jan/30/2002 10:33:52 no 3 system 2.5rc4 jan/30/2002 10:31:32 no 4 snmp 2.5rc4 jan/30/2002 10:32:13 no 5 ppp 2.5rc4 jan/30/2002 10:36:03 no 6 pptp 2.5rc4 jan/30/2002 10:36:42 no 7 aironet 2.5rc4 jan/30/2002 10:39:05 no 8 prism 2.5rc4 jan/30/2002 15:51:12 no [MikroTik] >
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.
Software Package Installation Instructions
The software package files are compressed binary files,
which can be downloaded from MikroTik's web page www.mikrotik.com Download section.
The full name of the package file consists of a descriptive name, version number, and file extension '.npk'.
For example, 'system-2.5.npk', 'ppp-2.5.npk'. 'pppoe-2.5.npk', etc.
To install (upgrade) newer version of the MikroTik RouterOS system software
please follow the upgrade instructions below:
[MikroTik] > system resource print
uptime: 22h8m26s
free-memory: 35592 kB
total-memory: 62840 kB
cpu: Celeron
cpu-frequency: 632 MHz
cpu-load: 8
free-hdd-space: 23073 kB
total-hdd-space: 46474 kB
[MikroTik] >
Note! If there is not enough free disk space for storing the upgrade packages, disk space can be freed up by uninstalling some software packages, which provide functionality not required for your needs.
[MikroTik] > file print # NAME TYPE SIZE CREATION-TIME 0 ssh_host_key.pub unknown 332 jan/23/2002 18:45:02 1 ssh_host_dsa_key.pub unknown 603 jan/23/2002 18:45:08 2 cyclades-2.5rc4.npk package 114321 jan/31/2002 17:45:27 3 framerelay-2.5rc4.npk package 94632 jan/31/2002 17:45:29 [MikroTik] >
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.
Note! The versions of packages should match the version number of the system software package.
Contents of the Software Packages
| Name | Contents | Prerequisites | Additional License |
|---|---|---|---|
| advanced-tools | Provides network monitor and support for other advanced tools | - | - |
| 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 |
| bgp | Provides BGP support | - | - |
| cyclades | Provides support for PC300 synchronous interfaces | - | synchronous |
| ddns | Provides dynamic DNS support | - | - |
| dhcp | Provides DHCP server and client support | - | - |
| farsync | Provides support FarSync interfaces | - | synchronous |
| framerelay | Provides support for frame relay (used with Moxa C101, Cyclades PC300, or FarSync interfaces | - | - |
| isdn | Provides support for ISDN | ppp | - |
| lcd | Provides LCD monitor support | - | - |
| lmc-wan | Provides support for LMC synchronous cards | - | synchronous |
| moxa-c101 | Provides support for Moxa C101 synchronous card | - | synchronous |
| ntp | Provides network time protocol support | - | - |
| ppp | Provides asynchronous PPP support | - | - |
| pppoe | Provides PPPoE support | ppp | - |
| pptp | Provides PPTP support | ppp | - |
| prism | Provides support for Prism II chipset based IEEE 802.11 wireless cards as clients or as access points | - | 2.4GHz wireless (station mode); 2.4GHz wireless and Prism II AP (AP mode) |
| radiolan | Provides support for 5.8GHz RadioLAN ISA cards | - | radiolan |
| routing | Provides RIP & OSPF support | - | - |
| snmp | Provides read only SNMP support | - | - |
| ssh | Provides remote access via SSH | - | - |
| telephony | Provides IP telephony support (H.323) for Quicknet cards | - | - |
| ups | Provides APC Smart Mode UPS support | - | - |
| wavelan | Provides support for Lucent WaveLAN IEEE 802.11 wireless cards | - | 2.4GHz wireless |
| web-proxy | provides squid based web proxy support | - | - |
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 new key should be entered using the /system license set key command, and the router should be rebooted afterwards:
[MikroTik] system license> print
software-id: TPNG-SXN
key: 2C6A-YUE-3H2
upgradable-to: may/01/2002
[MikroTik] system license> feature print
Flags: X - disabled
# FEATURE
0 X AP
1 X synchronous
2 X radiolan
3 X wireless-2.4gHz
4 licensed
[MikroTik] system license> set key=D45G-IJ6-QM3
[MikroTik] system license> /system reboot
Reboot, yes? [y/N]: y
system will reboot shortly
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 | 16.5 | 16.0 |
| routing | 0.6 | 1.2 |
| snmp | 0.6 | 0.5 |
| ssh | 1.0 | 1.2 |
| lcd | 0.4 | 0.1 |
| ups | 0.5 | 0.2 |
| ppp | 2.0 | 0.8 |
| pptp | 1.3 | 0.3 |
| pppoe | 1.2 | 0.4 |
| isdn | 2.4 | 1.0 |
| telephony | 4.8 | 4.5 |
| framerelay | 0.1 | 0.1 |
| moxa-c101 | 0.8 | 0.1 |
| lmc-wan | 0.8 | 0.1 |
| cyclades | 0.8 | 0.1 |
| aironet | 1.1 | 0.2 |
| arlan | 0.8 | 0.1 |
| wavelan | 1.1 | 0.1 |
| radiolan | 0.8 | 0.2 |
| prism | 1.3 | 0.5 |