NAME

       vztmpl-dl - download/list/update OpenVZ templates

SYNOPSIS

       vztmpl-dl [ option ... ] template [template ...]
       vztmpl-dl [ option ... ] --update-all
       vztmpl-dl --list-local|--list-remote|--list-all|--list-orphans
       vztmpl-dl --config|--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.

       Usually  one  or more template names are required, except if one of --update-all, --list*,
       --config or --help is used.

OPTIONS

       --gpg-check
              Check GPG signatures of downloaded files. By default, GPG  check  is  performed  if
              CHECK_TEMPLATE_SIG  is  set  to  yes  in /etc/vz/download.conf file, 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-gpg-check
              Do not check GPG signatures.

       --ignore-errors
              Keep  processing  templates  from  the  list  and  return 0 exit code, even if some
              template failed to download. Without  this  option,  vztmpl-dl  aborts  upon  first
              download failure.

       --update
              Update (re-download) existing templates.

       --no-update
              Do not try to update existing templates.

       --quiet
              Be less talkative (currently it only adds --quiet flag to wget(1) ).

       --no-quiet
              Be  more  talkative  (this  can  be  used  to  negate  the  effect  of QUIET=yes in
              download.conf.

       --update-all
              Try to update all templates that are available locally. Note that there is no  need
              to  specify  individual  templates.  This  options  implicitly assumes --update and
              --ignore-errors options.

       --list-remote
              Output list of templates available for  download.  This  option  is  also  used  by
              vzctl(8) bash-completion script to complete --ostemplate option arguments.

       --list-local
              Output list of templates available locally.

       --list-all
              Output combined list of templates.

       --list-orphans
              Output  list  of  local  templates not available remotely. In trivial scenario this
              will give the list of old templates that are no longer officially supported.

       --config
              Output current configuration. The tool has  built-in  configuration  which  can  be
              overwritten by options in /etc/vz/download.conf file.

       --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 no.  Setting to yes has the same effect as using --gpg-check option.

       QUIET  Default is no.  Setting to yes has the same effect as using --quiet 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),
       http://wiki.openvz.org/Package_signatures#Importing_the_public_key.

LICENSE

       Copyright (C) 2011-2013, Parallels, Inc. Licensed under GNU GPL.