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 matchabcd
.
*abc
matches
abc
orzabc
and would not matchabcz
.
abc*
matches
abc
orabcz
and would not matchzabc
.
*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