package

The package command is used to view and manage software packages.

Note

The package command can only be used by an administrator.

When package is entered without any actions or parameters, the system displays usage information for the command.

Package files are digitally signed to ensure integrity and authenticity. Package component signatures and their certificate validity are verified when downloading, manually with the verify action, and when actually performing the installation upon reboot.

If the verification fails after downloading, an error message is reported by the download command and the downloaded package is discarded. If verification fails while actually installing upon reboot, installation is canceled and a package install failure notice is added to the messages displayed to administrators. A successful package installation notice is added to the messages upon successful installation.

Synopsis

package list
package info <pkgfile>.hai
package verify <pkgfile>.hai
package install <pkgfile>.hai
package download <pkgfile>.hai <tftpipaddr>
package delete <pkgfile>.hai | all
package cancel <pkgfile>.hai

Actions

Action	Description
list	Displays a list of downloaded packages.
info	Displays information about the currently installed package. If a filename is specified, displays information about the package.
verify	Verifies the authenticity and integrity of the specified package.
install	Installs the specified package. The package will be automatically verified before installation.
download	Downloads the specified package file using TFTP and then verifies.
delete	Deletes a previously downloaded package file. You can specify the package file or all.
cancel	Cancels installation of a package scheduled for the next reboot.

Parameters

N/A

Example #1: Package Download and Installation

# package download makitox_enc_v2.2.0-59.hai mytftp.example.com
1/5) Temporarily pausing encoder(s)...
2/5) Downloading package makitox_enc_v2.2.0-59.hai from mytftp.example.com...
3/5) Verifying integrity of downloaded package...Package verified successfully.
4/5) Synching file system...
5/5) Resuming encoder(s)...
Package downloaded successfully.

                
# package install makitox_enc_v2.2.0-59.hai
Package makitox_enc_v2.2.0-59.hai will be installed on next boot sequence.
You must REBOOT to complete the update process!

Example #2: Package Download Verification Failure

# package download makitox_enc_v2.2.0-59.hai mytftp.example.com
1/5) Temporarily pausing encoder(s)...
2/5) Downloading package makitox_enc_v2.2.0-59.hai from mytftp.example.com...
3/5) Verifying integrity of downloaded package...Package verification failed!
Try downloading the package again.

Examples (General)

# package list

Displays the list of downloaded packages:

Package Files (in /usr/share/haivision/packages/):
  makitox_enc_v2.2.0-59.hai
  makitox_enc_v2.2.0-58.hai

# package info makitox_enc_v2_2_0.hai

Displays information about the package.

# package install makitox_enc_v2_2_0.hai

Installs the package.

Related Topics

messages (CLI command)