Tip

This is the documentation for the 24.06 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.

Package Glob Examples¶
`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 all packages:

package upgrade

To clean up cached downloaded copies of package files:

package cache-clean