vztmpl-dl(8)

1vztmpl-dl(8)                      Containers                      vztmpl-dl(8)
2
3
4

NAME

6       vztmpl-dl - download/list/update OpenVZ templates
7

SYNOPSIS

9       vztmpl-dl [ option ... ] template [template ...]
10       vztmpl-dl [ option ... ] --update-all
11       vztmpl-dl --list-local|--list-remote|--list-all|--list-orphans
12       vztmpl-dl --config|--help
13

DESCRIPTION

15       The  main purpose of this utility is to download a precreated container
16       tarballs (also known as templates) from the OpenVZ download server.  It
17       can  be  used directly from the command line, and is also used by vzctl
18       create.
19
20       Usually one or more template names  are  required,  except  if  one  of
21       --update-all, --list*, --config or --help is used.
22

OPTIONS

24       --gpg-check
25              Check  GPG signatures of downloaded files. By default, GPG check
26              is  performed  if  CHECK_TEMPLATE_SIG   is   set   to   yes   in
27              /etc/vz/download.conf  file,  gpg(1)  tool is installed, and the
28              OpenVZ public key is available in the gpg keyring. See  EXAMPLES
29              section below on how to install OpenVZ public key.
30
31       --no-gpg-check
32              Do not check GPG signatures.
33
34       --ignore-errors
35              Keep  processing templates from the list and return 0 exit code,
36              even if some template failed to download. Without  this  option,
37              vztmpl-dl aborts upon first download failure.
38
39       --update
40              Update (re-download) existing templates.
41
42       --no-update
43              Do not try to update existing templates.
44
45
46       --quiet
47              Be less talkative (currently it only adds --quiet flag to
48              wget(1) ).
49
50       --no-quiet
51              Be more talkative (this can be used to negate the  effect
52              of QUIET=yes in download.conf.
53
54       --update-all
55              Try  to  update all templates that are available locally.
56              Note that there is no need  to  specify  individual  tem‐
57              plates.  This  options  implicitly  assumes  --update and
58              --ignore-errors options.
59
60       --list-remote
61              Output list of templates  available  for  download.  This
62              option is also used by vzctl(8) bash-completion script to
63              complete --ostemplate option arguments.
64
65       --list-local
66              Output list of templates available locally.
67
68       --list-all
69              Output combined list of templates.
70
71       --list-orphans
72              Output list of local templates not available remotely. In
73              trivial scenario this will give the list of old templates
74              that are no longer officially supported.
75
76       --config
77              Output current configuration. The tool has built-in  con‐
78              figuration   which  can  be  overwritten  by  options  in
79              /etc/vz/download.conf file.
80
81       --help Output help.
82

CONFIGURATION

84       The tool has a built-in configuration  defaults,  which  can  be
85       changed  by  editing  /etc/vz/download.conf  file. The following
86       parameters can be set:
87
88       UPDATE_TEMPLATE
89              Default is yes.  Setting to no has  the  same  effect  as
90              using --no-update option.
91
92       CHECK_TEMPLATE_SIG
93              Default  is  no.   Setting  to yes has the same effect as
94              using --gpg-check option.
95
96       QUIET  Default is no.  Setting to yes has  the  same  effect  as
97              using --quiet option.
98
99       TMPL_REPO_PREFIX
100              URL     repo     prefix.    Default    is    http://down‐
101              load.openvz.org/template/precreated.   Setting  this   to
102              location of your closest OpenVZ download mirror can speed
103              up download. Current list of OpenVZ mirrors is  available
104              at http://openvz.org/Download_mirrors.
105
106       TEMPLATE_REPOS
107              List  of  URLs  to  get  repositories  from.  Default  is
108              ${TMPL_REPO_PREFIX}.  More  URLs  can  be  added  to  get
109              access to beta or unsupported templates.
110

EXIT STATUS

112       Returns  0 upon success, or an appropriate error code in case of
113       an error:
114
115       1      Download error
116
117       2      Local template file already present, not updating
118
119       3      Error in usage (no argument provided)
120
121       4      wget binary not found
122
123       5      GPG signature check failed
124

EXAMPLES

126       To add OpenVZ public key to gpg keyring:
127         gpg --search-keys security@openvz.org
128
129       To list all available templates:
130         vztmpl-dl --list
131
132       To download (or update) centos-6 templates:
133         vztmpl-dl centos-6-x86 centos-6-x86_64
134
135       To use yandex.ru mirror (in /etc/vz/download.conf):
136         TMPL_REPO_PREFIX="http://mirror.yandex.ru/mirrors/download.openvz.org/template/precreated"
137
138       To enable beta templates (in /etc/vz/download.conf):
139         TEMPLATE_REPOS="${TEMPLATE_REPOS} ${TMPL_REPO_PREFIX}/beta/"
140

FILES

142       /etc/vz/download.conf
143       /vz/template/cache
144

LICENSE

150       Copyright (C) 2011-2013, Parallels, Inc. Licensed under GNU GPL.
151
152
153
154OpenVZ                            18 Jun 2013                     vztmpl-dl(8)