Revision c8fca479

b/doc/admin.rst
115 115
the instance sees the same virtual drive in all cases, the node-level
116 116
configuration varies between them.
117 117

  
118
There are five disk templates you can choose from:
118
There are several disk templates you can choose from:
119 119

  
120
diskless
120
``diskless``
121 121
  The instance has no disks. Only used for special purpose operating
122 122
  systems or for testing.
123 123

  
124
file
124
``file`` *****
125 125
  The instance will use plain files as backend for its disks. No
126 126
  redundancy is provided, and this is somewhat more difficult to
127
  configure for high performance. Note that for security reasons the
128
  file storage directory must be listed under
129
  ``/etc/ganeti/file-storage-paths``, and that file is not copied
130
  automatically to all nodes by Ganeti. The format of that file is a
131
  newline-separated list of directories.
127
  configure for high performance.
132 128

  
133
sharedfile
129
``sharedfile`` *****
134 130
  The instance will use plain files as backend, but Ganeti assumes that
135 131
  those files will be available and in sync automatically on all nodes.
136 132
  This allows live migration and failover of instances using this
137
  method. As for ``file`` the file storage directory must be listed under
138
  ``/etc/ganeti/file-storage-paths`` or ganeti will refuse to create
139
  instances under it.
133
  method.
140 134

  
141
plain
135
``plain``
142 136
  The instance will use LVM devices as backend for its disks. No
143 137
  redundancy is provided.
144 138

  
145
drbd
139
``drbd``
146 140
  .. note:: This is only valid for multi-node clusters using DRBD 8.0+
147 141

  
148 142
  A mirror is set between the local node and a remote one, which must be
......
154 148
     DRBD stacked setup is not fully symmetric and as such it is
155 149
     not working with live migration.
156 150

  
157
rbd
151
``rbd``
158 152
  The instance will use Volumes inside a RADOS cluster as backend for its
159 153
  disks. It will access them using the RADOS block device (RBD).
160 154

  
161
ext
155
``gluster`` *****
156
  The instance will use a Gluster volume for instance storage. Disk
157
  images will be stored in the top-level ``ganeti/`` directory of the
158
  volume. This directory will be created automatically for you.
159

  
160
``ext``
162 161
  The instance will use an external storage provider. See
163 162
  :manpage:`ganeti-extstorage-interface(7)` for how to implement one.
164 163

  
164
.. note::
165
  Disk templates marked with an asterisk require Ganeti to access the
166
  file system. Ganeti will refuse to do so unless you whitelist the
167
  relevant paths in :pyeval:`pathutils.FILE_STORAGE_PATHS_FILE`.
168

  
169
  The default paths used by Ganeti are:
170

  
171
  =============== ===================================================
172
  Disk template   Default path
173
  =============== ===================================================
174
  ``file``        :pyeval:`pathutils.DEFAULT_FILE_STORAGE_DIR`
175
  ``sharedfile``  :pyeval:`pathutils.DEFAULT_SHARED_FILE_STORAGE_DIR`
176
  ``gluster``     :pyeval:`pathutils.DEFAULT_GLUSTER_STORAGE_DIR`
177
  =============== ===================================================
178

  
179
  Those paths can be changed at ``gnt-cluster init`` time. See
180
  :manpage:`gnt-cluster(8)` for details.
181

  
165 182

  
166 183
IAllocator
167 184
~~~~~~~~~~
b/lib/build/sphinx_ext.py
58 58
from ganeti import luxi
59 59
from ganeti import objects
60 60
from ganeti import http
61
from ganeti import pathutils
61 62

  
62 63
import ganeti.rapi.rlib2 # pylint: disable=W0611
63 64
import ganeti.rapi.connector # pylint: disable=W0611
......
94 95
#: Namespace for evaluating expressions
95 96
EVAL_NS = dict(compat=compat, constants=constants, utils=utils, errors=errors,
96 97
               rlib2=rapi.rlib2, luxi=luxi, rapi=rapi, objects=objects,
97
               http=http)
98
               http=http, pathutils=pathutils)
98 99

  
99 100
# Constants documentation for man pages
100 101
CV_ECODES_DOC = "ecodes"

Also available in: Unified diff