Contents
NAME
vztmpl-dl − download/list/update OpenVZ templates
SYNOPSIS
|
vztmpl-dl |
[--no-gpg-check] [--no-update] template [template ...] | ||
|
vztmpl-dl |
--config|--list|--help |
DESCRIPTION
The main purpose of this utility is to download a precreated container tarballs (also known as templates) from the OpenVZ download server. It can be used directly from the command line, and is also used by vzctl create.
OPTIONS
--no-gpg-check
Do not check GPG signatures of downloaded files. By default, GPG check is performed if gpg(1) tool is installed and the OpenVZ public key is available in the gpg keyring. See EXAMPLES section below on how to install OpenVZ public key.
--no-update
Do not try to update (re-download) existing templates.
--config
Output current configuration. The tool has built-in configuration which can be overwritten by options in /etc/vz/download.conf file.
|
--list |
Output list of templates available for download. This option is also used by vzctl(8) bash-completion script to complete --ostemplate option arguments. | ||
|
--help |
Output help. |
CONFIGURATION
The tool has a
built-in configuration defaults, which can be changed by
editing /etc/vz/download.conf file. The following
parameters can be set:
UPDATE_TEMPLATE
Default is yes. Setting to no has the same effect as using --no-update option.
CHECK_TEMPLATE_SIG
Default is yes. Setting to no has the same effect as using --no-gpg-check option.
TMPL_REPO_PREFIX
URL repo prefix. Default is http://download.openvz.org/template/precreated. Setting this to location of your closest OpenVZ download mirror can speed up download. Current list of OpenVZ mirrors is available at http://openvz.org/Download_mirrors.
TEMPLATE_REPOS
List of URLs to get repositories from. Default is ${TMPL_REPO_PREFIX}. More URLs can be added to get access to beta or unsupported templates.
EXIT STATUS
Returns 0 upon success, or an appropriate error code in case of an error:
|
1 |
Download error |
|||
|
2 |
Local template file already present, not updating |
|||
|
3 |
Error in usage (no argument provided) |
|||
|
4 |
wget binary not found |
|||
|
5 |
GPG signature check failed |
EXAMPLES
To add OpenVZ public key to gpg keyring:
gpg --search-keys security@openvz.org
To list all available templates:
vztmpl-dl --list
To download (or update) centos-6 templates:
vztmpl-dl centos-6-x86 centos-6-x86_64
To use yandex.ru mirror (in /etc/vz/download.conf):
TMPL_REPO_PREFIX="http://mirror.yandex.ru/mirrors/download.openvz.org/template/precreated"
To enable beta templates (in /etc/vz/download.conf):
TEMPLATE_REPOS="${TEMPLATE_REPOS} ${TMPL_REPO_PREFIX}/beta/"
FILES
/etc/vz/download.conf /vz/template/cache
SEE ALSO
arpsend(8), download.conf(5), Package_signatures#Importing_the_public_key.
LICENSE
Copyright (C) 2011-2013, Parallels, Inc. Licensed under GNU GPL.