Previous page

Next page

Locate page in Contents

Print this page

vzpkg install

This command is used to add an application EZ template to or install a software package inside a Container. It has the following syntax:

vzpkg install [ options ] < CT_ID >|< CT_NAME > < object > [...]

The vzpkg install command will add an object ( <o bject > ) which can be either an application EZ template or a standard software package to the Container with the ID of < CT_ID > or with the name of < CT_NAME > . You can specify a number of objects to be applied to your Container.

When executed, vzpkg install automatically handles the interdependencies among the packages to be installed inside a Container and ensures that all dependencies are satisfied. If the package dependencies cannot be resolved, the installation process will fail and the corresponding message will be displayed.

Options available to this command are:

Name

Description

-p, --package

Tells the vzpkg install command to install software packages instead of EZ templates.

-f, --force

Forces the EZ template/package installation.

-C, --cache

Makes the vzpkg install command look for the packages included in the EZ template in the local vzpkg cache only. If there is a package not available locally, the command will fail.

You can omit this parameter if the elapsed time from the last vzpkg cache update does not exceed the value of the METADATA_EXPIRE parameter specified in the /etc/vztt/vztt.conf file.

-r, --remote

If the elapsed time from the last vzpkg cache update does not exceed the value of the METADATA_EXPIRE parameter specified in the /etc/vztt/vztt.conf file, you should use this option to make vzpkg install look for the packages in the remote repositories set for handling the corresponding EZ template.

-n, --check-only

Simulates the same operations as vzpkg install completes without specifying this option (downloads the software packages to the server, handles the package interdependencies, etc.); however, the packages themselves are not installed in the specified the Container.

-d, --debug
< num >

Sets the debugging level to one of the specified values (from 0 to 10). 10 is the highest debug level and 0 sets the debug level to its minimal value.

-q, --quiet

Disables logging to the screen and to the log file.

By default, the specified object is treated by vzpkg install as an application EZ template. However, you can use the -p option to explicitly specify that the object should be considered as a software package.

Installing packages by using the vzpkg install command has the following main advantages:

  • The dependencies for software packages are automatically checked during the installation process; so, you do not have to bother any more on how to resolve possible package dependencies.
  • During the package installation, only symlinks to the installed files on the server are created and added to the Container private area, which allows you to noticeably save disk space inside your Containers.
  • You can update the installed packages by running the vzpkg update command. For the information on this command, please see the next subsection.

Note: A Container has to be running in order to apply an application EZ template to or install a package inside this Container.