Tip

This is the documentation for the v21.03 version. Looking for the documentation of the latest version? Have a look here.

Package Management

The package management commands allow the operator to install new software packages as well as discover and perform updates for installed packages.

Package Information Commands

There are three commands which query the package database.

A <pkg-glob> is a simple regular expression. It consists of a string of alphanumeric characters which is optionally prefixed or suffixed with a * character. The * character indicates zero or more characters.

For example:

abc	matches only the package abc and would not match abcd.
*abc	matches abc or zabc and would not match abcz.
abc*	matches abc or abcz and would not match zabc.
*abc*	matches any package with abc contained anywhere in its name.
*	matches any package.

Tip

Do not escape or quote the glob as would typically be required by a Unix shell. The glob abc\* is not the same as abc*.

The first two commands have qualifiers that limit the scope of the packages to all, installed, or updatable packages. These limitations are optional, and if not specified then it defaults to all packages in the database.

To display detailed information on packages:

tnsr# package info [ available | installed | updates ] <pkg-glob>

Warning

package information is limited to the first 25 packages found. If a query returns more items, a more specific pkg-glob must be used to narrow the search.

To display a simple listing of package names and versions for all matching packages:

tnsr# package list [ available | installed | updates ] <pkg-glob>

The search command searches for a string in either the package name or description. The output includes the package name and description of the package. The search term is literal, it is not a regular expression or glob:

tnsr# package search <term>

Package Installation

Warning

Recommended procedure is to reboot the router after any package install, remove, or upgrade operation.

To install a package and its required dependencies:

package install <pkg-glob>

To reinstall a package which is already present on TNSR:

package reinstall <pkg-glob>

To remove a package:

package remove <pkg-glob>

To upgrade a package:

package upgrade [ <pkg-glob> ]

To clean up cached downloaded copies of package files:

package cache-clean