Software Package Management

Document revision 1.3 (06-Sep-2003)
This document applies to the MikroTik RouterOS V2.7

Table of Contents

Summary

The MikroTik RouterOS is distributed in the form of software packages. The basic functionality of the router and the operating system itself is provided by the system software package. Other packages contain additional software features as well as support to various network interface cards (NICs).

Specifications

Packages required : None
License required : Any
Home menu level : /system package
Standards and Technologies : FTP (RFC 959)
Hardware usage : not significant

Additional Documents

Basic Setup Guide
Device Driver Management
License management

Features

The modular software package system of MikroTik RouterOS has the following features:

Software Package Installation (Upgrade)

Description

Installation of the MikroTik RouterOS software packages can be done by uploading the newer version of the package to the router and rebooting it.

The software package files are compressed binary files, which can be downloaded from the 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.7rc4.npk, ppp-2.7rc4.npk, etc.

You should check the available hard disk space prior to downloading the package file by issuing /system resource print command. If there is not enough free disk space for storing the upgrade packages, it can be freed up by uninstalling some software packages, which provide functionality not required for your needs. If you have a sufficient amount of free space for storing the upgrade packages, connect to the router using ftp. Use user name and password of a user with full access privileges.

  • Select the BINARY mode file transfer.
  • Upload the software package files to the router and disconnect (Note that the packages uploaded should retain the original name and also be in lowercase)
  • View the information about the uploaded software packages using the /file print command.
  • Reboot the router by issuing the /system reboot command or by pressing Ctrl+Alt+Del keys at the router's console.
  • After successful installation the software packages installed can be viewed using /system package print command.

    Notes

    The installation/upgrade process is shown on the console screen (monitor) attached to the router.

    The Free Demo License do not allow software upgrades using ftp. You should use complete reinstall from floppies, or purchase the license.

    Before upgrading the router, please check the current version of the system package and of the additional software packages. The versions of additional packages should match the version number of the system software package. The version of the MikroTik RouterOS system software (and the build number) are shown before the console login prompt. 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:

    [admin@MikroTik] system license> .. package print
    Flags: I - invalid
      #   NAME                  VERSION              BUILD-TIME           UNINSTALL
      0   web-proxy             2.7.11               sep/04/2003 17:22:32 no
      1   ppp                   2.7.11               sep/04/2003 17:18:26 no
      2   dhcp                  2.7.11               sep/04/2003 17:13:37 no
      3   telephony             2.7.11               sep/04/2003 17:51:46 no
      4   system                2.7.11               sep/05/2003 13:17:40 no
      5   routing               2.7.11               sep/04/2003 17:20:20 no
      6   security              2.7.11               sep/04/2003 17:12:36 no
      7   advanced-tools        2.7.11               sep/04/2003 17:09:35 no
      8   ntp                   2.7.11               sep/04/2003 17:52:46 no
      9   dns-cache             2.7.11               sep/04/2003 17:20:49 no
    
    [admin@MikroTik] system license>
    
    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 scheduled for uninstallation at the next shutdown/reboot of the router. Use the /system package set command to mark the packages for uninstallation.

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

    Software Package List

    System Software Package

    The system software package provides the basic functionality of the MikroTik RouterOS, namely: It also includes winbox server as well as winbox executable with some plugins

    After installing the MikroTik RouterOS, a license should be obtained from MikroTik to enable the basic system functionality.

    Additional Software Feature Packages

    The table below shows additional software feature packages, the provided functionality, the required prerequisites and additional licenses, if any.
    Name Contents Prerequisites Additional License
    advanced-tools Provides email client, pingers, netwatch and other utilities - -
    arlan Provides support for DSSS 2.4GHz 2mbps Aironet ISA cards - 2.4GHz/5GHz Wireless Client
    dhcp Provides DHCP server and client support - -
    dns-cache DNS cache - -
    hotspot HotSpot gateway - any additional license
    isdn Provides ISDN support ppp -
    lcd Provides LCD monitor support - -
    ntp Provides network time protocol support - -
    ppp Provides support for PPP, PPTP, L2TP, PPPoE and ISDN PPP - -
    radiolan Provides support for 5.8GHz RadioLAN cards - 2.4GHz/5GHz Wireless Client
    routing Provides support for RIP, OSPF and BGP4 - -
    security Provides support for IPSEC, SSH and secure connectivity with WinBox - -
    synchronous Provides support for framerelay and Moxa C101, Moxa C512, Farsync, Cyclades PC300 and XPeed synchronous cards - Sync and Hotspot
    telephony Provides IP telephony support (H.323) - -
    thinrouter-pcipc Forces PCItoCardBus Bridge to use IRQ 11 as in ThinRouters - -
    ups Provides APC Smart Mode UPS support - -
    web-proxy HTTP Web proxy package - -
    wireless Provides support for Cisco Aironet cards and PrismII and Atheros wireless stations and APs - 2.4GHz/5GHz Wireless Client / 2.4GHz/5GHz Wireless Server (optional)

    Software Package Uninstalling

    Description

    Usually, you do not need to uninstall software packages. However, if you have installed a wrong package, or you need additional free space to install new one, you have to uninstall some unused packages.

    Installed software packages can be viewed using /system package print command.

    In order to uninstall software package, you have to set uninstall property for that package to yes and reboot the router.

    Example

    Suppose we need to uninstall web-proxy package from a router.
    [admin@MikroTik] > /system package print
    Flags: I - invalid
      #   NAME                  VERSION              BUILD-TIME           UNINSTALL
      0   web-proxy             2.7.11               sep/04/2003 17:22:32 no
      1   ppp                   2.7.11               sep/04/2003 17:18:26 no
      2   dhcp                  2.7.11               sep/04/2003 17:13:37 no
      3   telephony             2.7.11               sep/04/2003 17:51:46 no
      4   system                2.7.11               sep/05/2003 13:17:40 no
      5   routing               2.7.11               sep/04/2003 17:20:20 no
      6   security              2.7.11               sep/04/2003 17:12:36 no
      7   advanced-tools        2.7.11               sep/04/2003 17:09:35 no
      8   ntp                   2.7.11               sep/04/2003 17:52:46 no
      9   dns-cache             2.7.11               sep/04/2003 17:20:49 no
    
    [admin@MikroTik] > /system package set 0 uninstall=yes
    [admin@MikroTik] > /system reboot
    

    Troubleshooting


    Copyright 1999-2003, MikroTik