Statistics
| Branch: | Tag: | Revision:

root / lib / constants.py @ a5450d2a

History | View | Annotate | Download (64.5 kB)

1
#
2
#
3

    
4
# Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 Google Inc.
5
#
6
# This program is free software; you can redistribute it and/or modify
7
# it under the terms of the GNU General Public License as published by
8
# the Free Software Foundation; either version 2 of the License, or
9
# (at your option) any later version.
10
#
11
# This program is distributed in the hope that it will be useful, but
12
# WITHOUT ANY WARRANTY; without even the implied warranty of
13
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14
# General Public License for more details.
15
#
16
# You should have received a copy of the GNU General Public License
17
# along with this program; if not, write to the Free Software
18
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
19
# 02110-1301, USA.
20

    
21

    
22
"""Module holding different constants."""
23

    
24
import re
25
import socket
26

    
27
from ganeti import _constants
28
from ganeti import _vcsversion
29
from ganeti import compat
30
from ganeti import pathutils
31

    
32

    
33
# various versions
34
RELEASE_VERSION = _constants.RELEASE_VERSION
35
OS_API_V10 = _constants.OS_API_V10
36
OS_API_V15 = _constants.OS_API_V15
37
OS_API_V20 = _constants.OS_API_V20
38
OS_API_VERSIONS = _constants.OS_API_VERSIONS
39
VCS_VERSION = _vcsversion.VCS_VERSION
40
EXPORT_VERSION = 0
41
RAPI_VERSION = 2
42

    
43
VERSION_MAJOR = _constants.VERSION_MAJOR
44
VERSION_MINOR = _constants.VERSION_MINOR
45
VERSION_REVISION = _constants.VERSION_REVISION
46

    
47
DIR_VERSION = _constants.DIR_VERSION
48

    
49
CONFIG_MAJOR = _constants.CONFIG_MAJOR
50
CONFIG_MINOR = _constants.CONFIG_MINOR
51
CONFIG_REVISION = _constants.CONFIG_REVISION
52
CONFIG_VERSION = _constants.CONFIG_VERSION
53

    
54
#: RPC protocol version
55
PROTOCOL_VERSION = _constants.PROTOCOL_VERSION
56

    
57
# user separation
58
DAEMONS_GROUP = _constants.DAEMONS_GROUP
59
ADMIN_GROUP = _constants.ADMIN_GROUP
60
MASTERD_USER = _constants.MASTERD_USER
61
MASTERD_GROUP = _constants.MASTERD_GROUP
62
RAPI_USER = _constants.RAPI_USER
63
RAPI_GROUP = _constants.RAPI_GROUP
64
CONFD_USER = _constants.CONFD_USER
65
CONFD_GROUP = _constants.CONFD_GROUP
66
LUXID_USER = _constants.LUXID_USER
67
LUXID_GROUP = _constants.LUXID_GROUP
68
NODED_USER = _constants.NODED_USER
69
NODED_GROUP = _constants.NODED_GROUP
70
MOND_USER = _constants.MOND_USER
71
MOND_GROUP = _constants.MOND_GROUP
72
SSH_LOGIN_USER = _constants.SSH_LOGIN_USER
73
SSH_CONSOLE_USER = _constants.SSH_CONSOLE_USER
74

    
75
# cpu pinning separators and constants
76
CPU_PINNING_SEP = ":"
77
CPU_PINNING_ALL = "all"
78
# internal representation of "all"
79
CPU_PINNING_ALL_VAL = -1
80
# one "all" entry in a CPU list means CPU pinning is off
81
CPU_PINNING_OFF = [CPU_PINNING_ALL_VAL]
82

    
83
# A Xen-specific implementation detail - there is no way to actually say
84
# "use any cpu for pinning" in a Xen configuration file, as opposed to the
85
# command line, where you can say "xm vcpu-pin <domain> <vcpu> all".
86
# The workaround used in Xen is "0-63" (see source code function
87
# xm_vcpu_pin in <xen-source>/tools/python/xen/xm/main.py).
88
# To support future changes, the following constant is treated as a
89
# blackbox string that simply means use-any-cpu-for-pinning-under-xen.
90
CPU_PINNING_ALL_XEN = "0-63"
91

    
92
# A KVM-specific implementation detail - the following value is used
93
# to set CPU affinity to all processors (#0 through #31), per taskset
94
# man page.
95
# FIXME: This only works for machines with up to 32 CPU cores
96
CPU_PINNING_ALL_KVM = 0xFFFFFFFF
97

    
98
# Wipe
99
DD_CMD = _constants.DD_CMD
100
MAX_WIPE_CHUNK = _constants.MAX_WIPE_CHUNK
101
MIN_WIPE_CHUNK_PERCENT = _constants.MIN_WIPE_CHUNK_PERCENT
102

    
103
RUN_DIRS_MODE = _constants.RUN_DIRS_MODE
104
SECURE_DIR_MODE = _constants.SECURE_DIR_MODE
105
SECURE_FILE_MODE = _constants.SECURE_FILE_MODE
106
ADOPTABLE_BLOCKDEV_ROOT = _constants.ADOPTABLE_BLOCKDEV_ROOT
107
ENABLE_CONFD = _constants.ENABLE_CONFD
108
ENABLE_MOND = _constants.ENABLE_MOND
109
ENABLE_SPLIT_QUERY = _constants.ENABLE_SPLIT_QUERY
110
ENABLE_RESTRICTED_COMMANDS = _constants.ENABLE_RESTRICTED_COMMANDS
111

    
112
# SSH constants
113
SSH = _constants.SSH
114
SCP = _constants.SCP
115

    
116
NODED = _constants.NODED
117
CONFD = _constants.CONFD
118
LUXID = _constants.LUXID
119
RAPI = _constants.RAPI
120
MASTERD = _constants.MASTERD
121
MOND = _constants.MOND
122

    
123
DAEMONS = _constants.DAEMONS
124

    
125
DAEMONS_PORTS = _constants.DAEMONS_PORTS
126

    
127
DEFAULT_NODED_PORT = _constants.DEFAULT_NODED_PORT
128
DEFAULT_CONFD_PORT = _constants.DEFAULT_CONFD_PORT
129
DEFAULT_MOND_PORT = _constants.DEFAULT_MOND_PORT
130
DEFAULT_RAPI_PORT = _constants.DEFAULT_RAPI_PORT
131

    
132
FIRST_DRBD_PORT = _constants.FIRST_DRBD_PORT
133
LAST_DRBD_PORT = _constants.LAST_DRBD_PORT
134

    
135
DAEMONS_LOGBASE = _constants.DAEMONS_LOGBASE
136

    
137
DAEMONS_LOGFILES = \
138
    dict((daemon, pathutils.GetLogFilename(DAEMONS_LOGBASE[daemon]))
139
         for daemon in DAEMONS_LOGBASE)
140

    
141
# Some daemons might require more than one logfile.
142
# Specifically, right now only the Haskell http library "snap", used by the
143
# monitoring daemon, requires multiple log files.
144

    
145
# These are the only valid reasons for having an extra logfile
146
EXTRA_LOGREASON_ACCESS = "access"
147
EXTRA_LOGREASON_ERROR = "error"
148

    
149
VALID_EXTRA_LOGREASONS = compat.UniqueFrozenset([
150
  EXTRA_LOGREASON_ACCESS,
151
  EXTRA_LOGREASON_ERROR,
152
  ])
153

    
154
# These are the extra logfiles, grouped by daemon
155
DAEMONS_EXTRA_LOGBASE = {
156
  MOND: {
157
    EXTRA_LOGREASON_ACCESS: _constants.EXTRA_LOGREASON_ACCESS,
158
    EXTRA_LOGREASON_ERROR: _constants.EXTRA_LOGREASON_ERROR,
159
    }
160
  }
161

    
162
DAEMONS_EXTRA_LOGFILES = \
163
  dict((daemon, dict((extra,
164
       pathutils.GetLogFilename(DAEMONS_EXTRA_LOGBASE[daemon][extra]))
165
       for extra in DAEMONS_EXTRA_LOGBASE[daemon]))
166
         for daemon in DAEMONS_EXTRA_LOGBASE)
167

    
168
DEV_CONSOLE = _constants.DEV_CONSOLE
169

    
170
PROC_MOUNTS = "/proc/mounts"
171

    
172
# Local UniX Interface related constants
173
LUXI_EOM = chr(3)
174
LUXI_VERSION = CONFIG_VERSION
175
#: Environment variable for the luxi override socket
176
LUXI_OVERRIDE = "FORCE_LUXI_SOCKET"
177
LUXI_OVERRIDE_MASTER = "master"
178
LUXI_OVERRIDE_QUERY = "query"
179

    
180
# one of "no", "yes", "only"
181
SYSLOG_USAGE = _constants.SYSLOG_USAGE
182
SYSLOG_NO = _constants.SYSLOG_NO
183
SYSLOG_YES = _constants.SYSLOG_YES
184
SYSLOG_ONLY = _constants.SYSLOG_ONLY
185
SYSLOG_SOCKET = _constants.SYSLOG_SOCKET
186

    
187
EXPORT_CONF_FILE = "config.ini"
188

    
189
XEN_BOOTLOADER = _constants.XEN_BOOTLOADER
190
XEN_KERNEL = _constants.XEN_KERNEL
191
XEN_INITRD = _constants.XEN_INITRD
192
XEN_CMD_XM = _constants.XEN_CMD_XM
193
XEN_CMD_XL = _constants.XEN_CMD_XL
194
KNOWN_XEN_COMMANDS = _constants.KNOWN_XEN_COMMANDS
195

    
196
# When the Xen toolstack used is "xl", live migration requires the source host
197
# to connect to the target host via ssh (xl runs this command). We need to pass
198
# the command xl runs some extra info so that it can use Ganeti's key
199
# verification and not fail. Note that this string is incomplete: it must be
200
# filled with the cluster name before being used.
201
XL_SSH_CMD = ("ssh -l %s -oGlobalKnownHostsFile=%s"
202
              " -oUserKnownHostsFile=/dev/null"
203
              " -oCheckHostIp=no -oStrictHostKeyChecking=yes"
204
              " -oHostKeyAlias=%%s") % (SSH_LOGIN_USER,
205
                                        pathutils.SSH_KNOWN_HOSTS_FILE)
206

    
207
KVM_PATH = _constants.KVM_PATH
208
KVM_KERNEL = _constants.KVM_KERNEL
209
SOCAT_PATH = _constants.SOCAT_PATH
210
SOCAT_USE_ESCAPE = _constants.SOCAT_USE_ESCAPE
211
SOCAT_USE_COMPRESS = _constants.SOCAT_USE_COMPRESS
212
SOCAT_ESCAPE_CODE = "0x1d"
213

    
214
#: Console as SSH command
215
CONS_SSH = "ssh"
216

    
217
#: Console as VNC server
218
CONS_VNC = "vnc"
219

    
220
#: Console as SPICE server
221
CONS_SPICE = "spice"
222

    
223
#: Display a message for console access
224
CONS_MESSAGE = "msg"
225

    
226
#: All console types
227
CONS_ALL = compat.UniqueFrozenset([
228
  CONS_SSH,
229
  CONS_VNC,
230
  CONS_SPICE,
231
  CONS_MESSAGE,
232
  ])
233

    
234
# For RSA keys more bits are better, but they also make operations more
235
# expensive. NIST SP 800-131 recommends a minimum of 2048 bits from the year
236
# 2010 on.
237
RSA_KEY_BITS = 2048
238

    
239
# Ciphers allowed for SSL connections. For the format, see ciphers(1). A better
240
# way to disable ciphers would be to use the exclamation mark (!), but socat
241
# versions below 1.5 can't parse exclamation marks in options properly. When
242
# modifying the ciphers, ensure not to accidentially add something after it's
243
# been removed. Use the "openssl" utility to check the allowed ciphers, e.g.
244
# "openssl ciphers -v HIGH:-DES".
245
OPENSSL_CIPHERS = "HIGH:-DES:-3DES:-EXPORT:-ADH"
246

    
247
# Digest used to sign certificates ("openssl x509" uses SHA1 by default)
248
X509_CERT_SIGN_DIGEST = "SHA1"
249

    
250
# Default validity of certificates in days
251
X509_CERT_DEFAULT_VALIDITY = 365 * 5
252

    
253
# commonName (CN) used in certificates
254
X509_CERT_CN = "ganeti.example.com"
255

    
256
X509_CERT_SIGNATURE_HEADER = "X-Ganeti-Signature"
257

    
258
# Import/export daemon mode
259
IEM_IMPORT = "import"
260
IEM_EXPORT = "export"
261

    
262
# Import/export transport compression
263
IEC_NONE = "none"
264
IEC_GZIP = "gzip"
265
IEC_ALL = compat.UniqueFrozenset([
266
  IEC_NONE,
267
  IEC_GZIP,
268
  ])
269

    
270
IE_CUSTOM_SIZE = "fd"
271

    
272
IE_MAGIC_RE = re.compile(r"^[-_.a-zA-Z0-9]{5,100}$")
273

    
274
# Import/export I/O
275
# Direct file I/O, equivalent to a shell's I/O redirection using '<' or '>'
276
IEIO_FILE = "file"
277
# Raw block device I/O using "dd"
278
IEIO_RAW_DISK = "raw"
279
# OS definition import/export script
280
IEIO_SCRIPT = "script"
281

    
282
VALUE_DEFAULT = "default"
283
VALUE_AUTO = "auto"
284
VALUE_GENERATE = "generate"
285
VALUE_NONE = "none"
286
VALUE_TRUE = "true"
287
VALUE_FALSE = "false"
288
VALUE_HS_NOTHING = {"Nothing": None}
289

    
290

    
291
# External script validation mask
292
EXT_PLUGIN_MASK = re.compile("^[a-zA-Z0-9_-]+$")
293

    
294
# hooks-related constants
295
HOOKS_PHASE_PRE = "pre"
296
HOOKS_PHASE_POST = "post"
297
HOOKS_NAME_CFGUPDATE = "config-update"
298
HOOKS_NAME_WATCHER = "watcher"
299
HOOKS_VERSION = 2
300
HOOKS_PATH = "/sbin:/bin:/usr/sbin:/usr/bin"
301

    
302
# hooks subject type (what object type does the LU deal with)
303
HTYPE_CLUSTER = "CLUSTER"
304
HTYPE_NODE = "NODE"
305
HTYPE_GROUP = "GROUP"
306
HTYPE_INSTANCE = "INSTANCE"
307
HTYPE_NETWORK = "NETWORK"
308

    
309
HKR_SKIP = 0
310
HKR_FAIL = 1
311
HKR_SUCCESS = 2
312

    
313
# Storage types
314
ST_BLOCK = _constants.ST_BLOCK
315
ST_DISKLESS = _constants.ST_DISKLESS
316
ST_EXT = _constants.ST_EXT
317
ST_FILE = _constants.ST_FILE
318
ST_LVM_PV = _constants.ST_LVM_PV
319
ST_LVM_VG = _constants.ST_LVM_VG
320
ST_RADOS = _constants.ST_RADOS
321
STORAGE_TYPES = _constants.STORAGE_TYPES
322

    
323
# the set of storage types for which storage reporting is available
324
# FIXME: Remove this, once storage reporting is available for all types.
325
STS_REPORT = compat.UniqueFrozenset([ST_FILE, ST_LVM_PV, ST_LVM_VG])
326

    
327
# Storage fields
328
# first two are valid in LU context only, not passed to backend
329
SF_NODE = _constants.SF_NODE
330
SF_TYPE = _constants.SF_TYPE
331
# and the rest are valid in backend
332
SF_NAME = _constants.SF_NAME
333
SF_SIZE = _constants.SF_SIZE
334
SF_FREE = _constants.SF_FREE
335
SF_USED = _constants.SF_USED
336
SF_ALLOCATABLE = _constants.SF_ALLOCATABLE
337

    
338
# Storage operations
339
SO_FIX_CONSISTENCY = "fix-consistency"
340

    
341
# Available fields per storage type
342
VALID_STORAGE_FIELDS = compat.UniqueFrozenset([
343
  SF_NODE,
344
  SF_NAME,
345
  SF_TYPE,
346
  SF_SIZE,
347
  SF_USED,
348
  SF_FREE,
349
  SF_ALLOCATABLE,
350
  ])
351

    
352
MODIFIABLE_STORAGE_FIELDS = {
353
  ST_LVM_PV: frozenset([SF_ALLOCATABLE]),
354
  }
355

    
356
VALID_STORAGE_OPERATIONS = {
357
  ST_LVM_VG: frozenset([SO_FIX_CONSISTENCY]),
358
  }
359

    
360
# Volume fields
361
VF_DEV = "dev"
362
VF_INSTANCE = "instance"
363
VF_NAME = "name"
364
VF_NODE = "node"
365
VF_PHYS = "phys"
366
VF_SIZE = "size"
367
VF_VG = "vg"
368

    
369
# Local disk status
370
# Note: Code depends on LDS_OKAY < LDS_UNKNOWN < LDS_FAULTY
371
(LDS_OKAY,
372
 LDS_UNKNOWN,
373
 LDS_FAULTY) = range(1, 4)
374

    
375
LDS_NAMES = {
376
  LDS_OKAY: "ok",
377
  LDS_UNKNOWN: "unknown",
378
  LDS_FAULTY: "faulty",
379
}
380

    
381
# disk template types
382
DT_BLOCK = _constants.DT_BLOCK
383
DT_DISKLESS = _constants.DT_DISKLESS
384
DT_DRBD8 = _constants.DT_DRBD8
385
DT_EXT = _constants.DT_EXT
386
DT_FILE = _constants.DT_FILE
387
DT_PLAIN = _constants.DT_PLAIN
388
DT_RBD = _constants.DT_RBD
389
DT_SHARED_FILE = _constants.DT_SHARED_FILE
390
DISK_TEMPLATE_PREFERENCE = _constants.DISK_TEMPLATE_PREFERENCE
391
DISK_TEMPLATES = _constants.DISK_TEMPLATES
392
DEFAULT_ENABLED_DISK_TEMPLATES = _constants.DEFAULT_ENABLED_DISK_TEMPLATES
393

    
394
# mapping of disk templates to storage types
395
MAP_DISK_TEMPLATE_STORAGE_TYPE = {
396
  DT_BLOCK: ST_BLOCK,
397
  DT_DISKLESS: ST_DISKLESS,
398
  DT_DRBD8: ST_LVM_VG,
399
  DT_EXT: ST_EXT,
400
  DT_FILE: ST_FILE,
401
  DT_PLAIN: ST_LVM_VG,
402
  DT_RBD: ST_RADOS,
403
  DT_SHARED_FILE: ST_FILE,
404
  }
405

    
406
# the set of network-mirrored disk templates
407
DTS_INT_MIRROR = compat.UniqueFrozenset([DT_DRBD8])
408

    
409
# the set of externally-mirrored disk templates (e.g. SAN, NAS)
410
DTS_EXT_MIRROR = compat.UniqueFrozenset([
411
  DT_DISKLESS, # 'trivially' externally mirrored
412
  DT_SHARED_FILE,
413
  DT_BLOCK,
414
  DT_RBD,
415
  DT_EXT,
416
  ])
417

    
418
# the set of non-lvm-based disk templates
419
DTS_NOT_LVM = compat.UniqueFrozenset([
420
  DT_DISKLESS,
421
  DT_FILE,
422
  DT_SHARED_FILE,
423
  DT_BLOCK,
424
  DT_RBD,
425
  DT_EXT,
426
  ])
427

    
428
# the set of disk templates which can be grown
429
DTS_GROWABLE = compat.UniqueFrozenset([
430
  DT_PLAIN,
431
  DT_DRBD8,
432
  DT_FILE,
433
  DT_SHARED_FILE,
434
  DT_RBD,
435
  DT_EXT,
436
  ])
437

    
438
# the set of disk templates that allow adoption
439
DTS_MAY_ADOPT = compat.UniqueFrozenset([
440
  DT_PLAIN,
441
  DT_BLOCK,
442
  ])
443

    
444
# the set of disk templates that *must* use adoption
445
DTS_MUST_ADOPT = compat.UniqueFrozenset([DT_BLOCK])
446

    
447
# the set of disk templates that allow migrations
448
DTS_MIRRORED = frozenset.union(DTS_INT_MIRROR, DTS_EXT_MIRROR)
449

    
450
# the set of file based disk templates
451
DTS_FILEBASED = compat.UniqueFrozenset([
452
  DT_FILE,
453
  DT_SHARED_FILE,
454
  ])
455

    
456
# the set of disk templates that can be moved by copying
457
# Note: a requirement is that they're not accessed externally or shared between
458
# nodes; in particular, sharedfile is not suitable.
459
DTS_COPYABLE = compat.UniqueFrozenset([
460
  DT_FILE,
461
  DT_PLAIN,
462
  ])
463

    
464
# the set of disk templates that are supported by exclusive_storage
465
DTS_EXCL_STORAGE = compat.UniqueFrozenset([DT_PLAIN])
466

    
467
# templates for which we don't perform checks on free space
468
DTS_NO_FREE_SPACE_CHECK = compat.UniqueFrozenset([
469
  DT_FILE,
470
  DT_SHARED_FILE,
471
  DT_RBD,
472
  DT_EXT,
473
  ])
474

    
475
DTS_BLOCK = compat.UniqueFrozenset([
476
  DT_PLAIN,
477
  DT_DRBD8,
478
  DT_BLOCK,
479
  DT_RBD,
480
  DT_EXT,
481
  ])
482

    
483
# drbd constants
484
DRBD_HMAC_ALG = "md5"
485
DRBD_DEFAULT_NET_PROTOCOL = "C"
486
DRBD_MIGRATION_NET_PROTOCOL = "C"
487
DRBD_STATUS_FILE = "/proc/drbd"
488

    
489
#: Size of DRBD meta block device
490
DRBD_META_SIZE = 128
491

    
492
# drbd barrier types
493
DRBD_B_NONE = "n"
494
DRBD_B_DISK_BARRIERS = "b"
495
DRBD_B_DISK_DRAIN = "d"
496
DRBD_B_DISK_FLUSH = "f"
497

    
498
# Valid barrier combinations: "n" or any non-null subset of "bfd"
499
DRBD_VALID_BARRIER_OPT = compat.UniqueFrozenset([
500
  frozenset([DRBD_B_NONE]),
501
  frozenset([DRBD_B_DISK_BARRIERS]),
502
  frozenset([DRBD_B_DISK_DRAIN]),
503
  frozenset([DRBD_B_DISK_FLUSH]),
504
  frozenset([DRBD_B_DISK_DRAIN, DRBD_B_DISK_FLUSH]),
505
  frozenset([DRBD_B_DISK_BARRIERS, DRBD_B_DISK_DRAIN]),
506
  frozenset([DRBD_B_DISK_BARRIERS, DRBD_B_DISK_FLUSH]),
507
  frozenset([DRBD_B_DISK_BARRIERS, DRBD_B_DISK_FLUSH, DRBD_B_DISK_DRAIN]),
508
  ])
509

    
510
# rbd tool command
511
RBD_CMD = "rbd"
512

    
513
# file backend driver
514
FD_BLKTAP = _constants.FD_BLKTAP
515
FD_LOOP = _constants.FD_LOOP
516

    
517
# the set of drbd-like disk types
518
LDS_DRBD = compat.UniqueFrozenset([DT_DRBD8])
519

    
520
# disk access mode
521
DISK_RDONLY = _constants.DISK_RDONLY
522
DISK_RDWR = _constants.DISK_RDWR
523
DISK_ACCESS_SET = _constants.DISK_ACCESS_SET
524
DISK_USERSPACE = _constants.DISK_USERSPACE
525
DISK_KERNELSPACE = _constants.DISK_KERNELSPACE
526
DISK_VALID_ACCESS_MODES = _constants.DISK_VALID_ACCESS_MODES
527

    
528
REPLACE_DISK_PRI = _constants.REPLACE_DISK_PRI
529
REPLACE_DISK_SEC = _constants.REPLACE_DISK_SEC
530
REPLACE_DISK_CHG = _constants.REPLACE_DISK_CHG
531
REPLACE_DISK_AUTO = _constants.REPLACE_DISK_AUTO
532
REPLACE_MODES = _constants.REPLACE_MODES
533

    
534
# Instance export mode
535
EXPORT_MODE_LOCAL = _constants.EXPORT_MODE_LOCAL
536
EXPORT_MODE_REMOTE = _constants.EXPORT_MODE_REMOTE
537
EXPORT_MODES = _constants.EXPORT_MODES
538

    
539
# instance creation modes
540
INSTANCE_CREATE = _constants.INSTANCE_CREATE
541
INSTANCE_IMPORT = _constants.INSTANCE_IMPORT
542
INSTANCE_REMOTE_IMPORT = _constants.INSTANCE_REMOTE_IMPORT
543
INSTANCE_CREATE_MODES = _constants.INSTANCE_CREATE_MODES
544

    
545
# Remote import/export handshake message and version
546
RIE_VERSION = 0
547
RIE_HANDSHAKE = "Hi, I'm Ganeti"
548

    
549
# Remote import/export certificate validity in seconds
550
RIE_CERT_VALIDITY = 24 * 60 * 60
551

    
552
# Overall timeout for establishing connection
553
RIE_CONNECT_TIMEOUT = 180
554

    
555
# Export only: how long to wait per connection attempt (seconds)
556
RIE_CONNECT_ATTEMPT_TIMEOUT = 20
557

    
558
# Export only: number of attempts to connect
559
RIE_CONNECT_RETRIES = 10
560

    
561
#: Give child process up to 5 seconds to exit after sending a signal
562
CHILD_LINGER_TIMEOUT = 5.0
563

    
564
FILE_DRIVER = compat.UniqueFrozenset([FD_LOOP, FD_BLKTAP])
565

    
566
# import/export config options
567
INISECT_EXP = "export"
568
INISECT_INS = "instance"
569
INISECT_HYP = "hypervisor"
570
INISECT_BEP = "backend"
571
INISECT_OSP = "os"
572

    
573
# dynamic device modification
574
DDM_ADD = _constants.DDM_ADD
575
DDM_MODIFY = _constants.DDM_MODIFY
576
DDM_REMOVE = _constants.DDM_REMOVE
577
DDMS_VALUES = _constants.DDMS_VALUES
578
DDMS_VALUES_WITH_MODIFY = _constants.DDMS_VALUES_WITH_MODIFY
579
# TODO: DDM_SWAP, DDM_MOVE?
580

    
581
# common exit codes
582
EXIT_SUCCESS = _constants.EXIT_SUCCESS
583
EXIT_FAILURE = _constants.EXIT_FAILURE
584
EXIT_NOTCLUSTER = _constants.EXIT_NOTCLUSTER
585
EXIT_NOTMASTER = _constants.EXIT_NOTMASTER
586
EXIT_NODESETUP_ERROR = _constants.EXIT_NODESETUP_ERROR
587
EXIT_CONFIRMATION = _constants.EXIT_CONFIRMATION # need user confirmation
588

    
589
#: Exit code for query operations with unknown fields
590
EXIT_UNKNOWN_FIELD = _constants.EXIT_UNKNOWN_FIELD
591

    
592
# tags
593
TAG_CLUSTER = _constants.TAG_CLUSTER
594
TAG_NODEGROUP = _constants.TAG_NODEGROUP
595
TAG_NODE = _constants.TAG_NODE
596
TAG_INSTANCE = _constants.TAG_INSTANCE
597
TAG_NETWORK = _constants.TAG_NETWORK
598
VALID_TAG_TYPES = _constants.VALID_TAG_TYPES
599

    
600
MAX_TAG_LEN = _constants.MAX_TAG_LEN
601
MAX_TAGS_PER_OBJ = _constants.MAX_TAGS_PER_OBJ
602

    
603
# others
604
DEFAULT_BRIDGE = "xen-br0"
605
DEFAULT_OVS = "switch1"
606
CLASSIC_DRBD_SYNC_SPEED = 60 * 1024  # 60 MiB, expressed in KiB
607
IP4_ADDRESS_LOCALHOST = "127.0.0.1"
608
IP4_ADDRESS_ANY = "0.0.0.0"
609
IP6_ADDRESS_LOCALHOST = "::1"
610
IP6_ADDRESS_ANY = "::"
611
IP4_VERSION = 4
612
IP6_VERSION = 6
613
VALID_IP_VERSIONS = compat.UniqueFrozenset([IP4_VERSION, IP6_VERSION])
614
# for export to htools
615
IP4_FAMILY = socket.AF_INET
616
IP6_FAMILY = socket.AF_INET6
617

    
618
TCP_PING_TIMEOUT = 10
619
DEFAULT_VG = "xenvg"
620
DEFAULT_DRBD_HELPER = "/bin/true"
621
MIN_VG_SIZE = 20480
622
DEFAULT_MAC_PREFIX = "aa:00:00"
623
# default maximum instance wait time, in seconds.
624
DEFAULT_SHUTDOWN_TIMEOUT = 120
625
NODE_MAX_CLOCK_SKEW = _constants.NODE_MAX_CLOCK_SKEW
626
# Time for an intra-cluster disk transfer to wait for a connection
627
DISK_TRANSFER_CONNECT_TIMEOUT = 60
628
# Disk index separator
629
DISK_SEPARATOR = _constants.DISK_SEPARATOR
630
IP_COMMAND_PATH = _constants.IP_COMMAND_PATH
631

    
632
#: Key for job IDs in opcode result
633
JOB_IDS_KEY = "jobs"
634

    
635
# runparts results
636
(RUNPARTS_SKIP,
637
 RUNPARTS_RUN,
638
 RUNPARTS_ERR) = range(3)
639

    
640
RUNPARTS_STATUS = compat.UniqueFrozenset([
641
  RUNPARTS_SKIP,
642
  RUNPARTS_RUN,
643
  RUNPARTS_ERR,
644
  ])
645

    
646
# RPC constants
647
(RPC_ENCODING_NONE,
648
 RPC_ENCODING_ZLIB_BASE64) = range(2)
649

    
650
# Various time constants for the timeout table
651
RPC_TMO_URGENT = 60 # one minute
652
RPC_TMO_FAST = 5 * 60 # five minutes
653
RPC_TMO_NORMAL = 15 * 60 # 15 minutes
654
RPC_TMO_SLOW = 3600 # one hour
655
RPC_TMO_4HRS = 4 * 3600
656
RPC_TMO_1DAY = 86400
657

    
658
# Timeout for connecting to nodes (seconds)
659
RPC_CONNECT_TIMEOUT = 5
660

    
661
# os related constants
662
OS_SCRIPT_CREATE = "create"
663
OS_SCRIPT_IMPORT = "import"
664
OS_SCRIPT_EXPORT = "export"
665
OS_SCRIPT_RENAME = "rename"
666
OS_SCRIPT_VERIFY = "verify"
667
OS_SCRIPTS = compat.UniqueFrozenset([
668
  OS_SCRIPT_CREATE,
669
  OS_SCRIPT_IMPORT,
670
  OS_SCRIPT_EXPORT,
671
  OS_SCRIPT_RENAME,
672
  OS_SCRIPT_VERIFY,
673
  ])
674

    
675
OS_API_FILE = "ganeti_api_version"
676
OS_VARIANTS_FILE = "variants.list"
677
OS_PARAMETERS_FILE = "parameters.list"
678

    
679
OS_VALIDATE_PARAMETERS = "parameters"
680
OS_VALIDATE_CALLS = compat.UniqueFrozenset([OS_VALIDATE_PARAMETERS])
681

    
682
# External Storage (ES) related constants
683
ES_ACTION_CREATE = "create"
684
ES_ACTION_REMOVE = "remove"
685
ES_ACTION_GROW = "grow"
686
ES_ACTION_ATTACH = "attach"
687
ES_ACTION_DETACH = "detach"
688
ES_ACTION_SETINFO = "setinfo"
689
ES_ACTION_VERIFY = "verify"
690

    
691
ES_SCRIPT_CREATE = ES_ACTION_CREATE
692
ES_SCRIPT_REMOVE = ES_ACTION_REMOVE
693
ES_SCRIPT_GROW = ES_ACTION_GROW
694
ES_SCRIPT_ATTACH = ES_ACTION_ATTACH
695
ES_SCRIPT_DETACH = ES_ACTION_DETACH
696
ES_SCRIPT_SETINFO = ES_ACTION_SETINFO
697
ES_SCRIPT_VERIFY = ES_ACTION_VERIFY
698
ES_SCRIPTS = frozenset([
699
  ES_SCRIPT_CREATE,
700
  ES_SCRIPT_REMOVE,
701
  ES_SCRIPT_GROW,
702
  ES_SCRIPT_ATTACH,
703
  ES_SCRIPT_DETACH,
704
  ES_SCRIPT_SETINFO,
705
  ES_SCRIPT_VERIFY
706
  ])
707

    
708
ES_PARAMETERS_FILE = "parameters.list"
709

    
710
# reboot types
711
INSTANCE_REBOOT_SOFT = _constants.INSTANCE_REBOOT_SOFT
712
INSTANCE_REBOOT_HARD = _constants.INSTANCE_REBOOT_HARD
713
INSTANCE_REBOOT_FULL = _constants.INSTANCE_REBOOT_FULL
714
REBOOT_TYPES = _constants.REBOOT_TYPES
715

    
716
# instance reboot behaviors
717
INSTANCE_REBOOT_ALLOWED = "reboot"
718
INSTANCE_REBOOT_EXIT = "exit"
719

    
720
REBOOT_BEHAVIORS = compat.UniqueFrozenset([
721
  INSTANCE_REBOOT_ALLOWED,
722
  INSTANCE_REBOOT_EXIT,
723
  ])
724

    
725
VTYPE_STRING = _constants.VTYPE_STRING
726
VTYPE_MAYBE_STRING = _constants.VTYPE_MAYBE_STRING
727
VTYPE_BOOL = _constants.VTYPE_BOOL
728
VTYPE_SIZE = _constants.VTYPE_SIZE
729
VTYPE_INT = _constants.VTYPE_INT
730
ENFORCEABLE_TYPES = _constants.ENFORCEABLE_TYPES
731

    
732
# Constant representing that the user does not specify any IP version
733
IFACE_NO_IP_VERSION_SPECIFIED = 0
734

    
735
VALID_SERIAL_SPEEDS = compat.UniqueFrozenset([
736
  75,
737
  110,
738
  300,
739
  600,
740
  1200,
741
  1800,
742
  2400,
743
  4800,
744
  9600,
745
  14400,
746
  19200,
747
  28800,
748
  38400,
749
  57600,
750
  115200,
751
  230400,
752
  345600,
753
  460800,
754
  ])
755

    
756
# HV parameter names (global namespace)
757
HV_BOOT_ORDER = "boot_order"
758
HV_CDROM_IMAGE_PATH = "cdrom_image_path"
759
HV_KVM_CDROM2_IMAGE_PATH = "cdrom2_image_path"
760
HV_KVM_FLOPPY_IMAGE_PATH = "floppy_image_path"
761
HV_NIC_TYPE = "nic_type"
762
HV_DISK_TYPE = "disk_type"
763
HV_KVM_CDROM_DISK_TYPE = "cdrom_disk_type"
764
HV_VNC_BIND_ADDRESS = "vnc_bind_address"
765
HV_VNC_PASSWORD_FILE = "vnc_password_file"
766
HV_VNC_TLS = "vnc_tls"
767
HV_VNC_X509 = "vnc_x509_path"
768
HV_VNC_X509_VERIFY = "vnc_x509_verify"
769
HV_KVM_SPICE_BIND = "spice_bind"
770
HV_KVM_SPICE_IP_VERSION = "spice_ip_version"
771
HV_KVM_SPICE_PASSWORD_FILE = "spice_password_file"
772
HV_KVM_SPICE_LOSSLESS_IMG_COMPR = "spice_image_compression"
773
HV_KVM_SPICE_JPEG_IMG_COMPR = "spice_jpeg_wan_compression"
774
HV_KVM_SPICE_ZLIB_GLZ_IMG_COMPR = "spice_zlib_glz_wan_compression"
775
HV_KVM_SPICE_STREAMING_VIDEO_DETECTION = "spice_streaming_video"
776
HV_KVM_SPICE_AUDIO_COMPR = "spice_playback_compression"
777
HV_KVM_SPICE_USE_TLS = "spice_use_tls"
778
HV_KVM_SPICE_TLS_CIPHERS = "spice_tls_ciphers"
779
HV_KVM_SPICE_USE_VDAGENT = "spice_use_vdagent"
780
HV_ACPI = "acpi"
781
HV_PAE = "pae"
782
HV_USE_BOOTLOADER = "use_bootloader"
783
HV_BOOTLOADER_ARGS = "bootloader_args"
784
HV_BOOTLOADER_PATH = "bootloader_path"
785
HV_KERNEL_ARGS = "kernel_args"
786
HV_KERNEL_PATH = "kernel_path"
787
HV_INITRD_PATH = "initrd_path"
788
HV_ROOT_PATH = "root_path"
789
HV_SERIAL_CONSOLE = "serial_console"
790
HV_SERIAL_SPEED = "serial_speed"
791
HV_USB_MOUSE = "usb_mouse"
792
HV_KEYMAP = "keymap"
793
HV_DEVICE_MODEL = "device_model"
794
HV_INIT_SCRIPT = "init_script"
795
HV_MIGRATION_PORT = "migration_port"
796
HV_MIGRATION_BANDWIDTH = "migration_bandwidth"
797
HV_MIGRATION_DOWNTIME = "migration_downtime"
798
HV_MIGRATION_MODE = "migration_mode"
799
HV_USE_LOCALTIME = "use_localtime"
800
HV_DISK_CACHE = "disk_cache"
801
HV_SECURITY_MODEL = "security_model"
802
HV_SECURITY_DOMAIN = "security_domain"
803
HV_KVM_FLAG = "kvm_flag"
804
HV_VHOST_NET = "vhost_net"
805
HV_KVM_USE_CHROOT = "use_chroot"
806
HV_CPU_MASK = "cpu_mask"
807
HV_MEM_PATH = "mem_path"
808
HV_PASSTHROUGH = "pci_pass"
809
HV_BLOCKDEV_PREFIX = "blockdev_prefix"
810
HV_REBOOT_BEHAVIOR = "reboot_behavior"
811
HV_CPU_TYPE = "cpu_type"
812
HV_CPU_CAP = "cpu_cap"
813
HV_CPU_WEIGHT = "cpu_weight"
814
HV_CPU_CORES = "cpu_cores"
815
HV_CPU_THREADS = "cpu_threads"
816
HV_CPU_SOCKETS = "cpu_sockets"
817
HV_SOUNDHW = "soundhw"
818
HV_USB_DEVICES = "usb_devices"
819
HV_VGA = "vga"
820
HV_KVM_EXTRA = "kvm_extra"
821
HV_KVM_MACHINE_VERSION = "machine_version"
822
HV_KVM_PATH = "kvm_path"
823
HV_VIF_TYPE = "vif_type"
824
HV_VIF_SCRIPT = "vif_script"
825
HV_XEN_CMD = "xen_cmd"
826
HV_XEN_CPUID = "cpuid"
827
HV_VNET_HDR = "vnet_hdr"
828
HV_VIRIDIAN = "viridian"
829

    
830

    
831
HVS_PARAMETER_TYPES = {
832
  HV_KVM_PATH: VTYPE_STRING,
833
  HV_BOOT_ORDER: VTYPE_STRING,
834
  HV_KVM_FLOPPY_IMAGE_PATH: VTYPE_STRING,
835
  HV_CDROM_IMAGE_PATH: VTYPE_STRING,
836
  HV_KVM_CDROM2_IMAGE_PATH: VTYPE_STRING,
837
  HV_NIC_TYPE: VTYPE_STRING,
838
  HV_DISK_TYPE: VTYPE_STRING,
839
  HV_KVM_CDROM_DISK_TYPE: VTYPE_STRING,
840
  HV_VNC_PASSWORD_FILE: VTYPE_STRING,
841
  HV_VNC_BIND_ADDRESS: VTYPE_STRING,
842
  HV_VNC_TLS: VTYPE_BOOL,
843
  HV_VNC_X509: VTYPE_STRING,
844
  HV_VNC_X509_VERIFY: VTYPE_BOOL,
845
  HV_KVM_SPICE_BIND: VTYPE_STRING,
846
  HV_KVM_SPICE_IP_VERSION: VTYPE_INT,
847
  HV_KVM_SPICE_PASSWORD_FILE: VTYPE_STRING,
848
  HV_KVM_SPICE_LOSSLESS_IMG_COMPR: VTYPE_STRING,
849
  HV_KVM_SPICE_JPEG_IMG_COMPR: VTYPE_STRING,
850
  HV_KVM_SPICE_ZLIB_GLZ_IMG_COMPR: VTYPE_STRING,
851
  HV_KVM_SPICE_STREAMING_VIDEO_DETECTION: VTYPE_STRING,
852
  HV_KVM_SPICE_AUDIO_COMPR: VTYPE_BOOL,
853
  HV_KVM_SPICE_USE_TLS: VTYPE_BOOL,
854
  HV_KVM_SPICE_TLS_CIPHERS: VTYPE_STRING,
855
  HV_KVM_SPICE_USE_VDAGENT: VTYPE_BOOL,
856
  HV_ACPI: VTYPE_BOOL,
857
  HV_PAE: VTYPE_BOOL,
858
  HV_USE_BOOTLOADER: VTYPE_BOOL,
859
  HV_BOOTLOADER_PATH: VTYPE_STRING,
860
  HV_BOOTLOADER_ARGS: VTYPE_STRING,
861
  HV_KERNEL_PATH: VTYPE_STRING,
862
  HV_KERNEL_ARGS: VTYPE_STRING,
863
  HV_INITRD_PATH: VTYPE_STRING,
864
  HV_ROOT_PATH: VTYPE_MAYBE_STRING,
865
  HV_SERIAL_CONSOLE: VTYPE_BOOL,
866
  HV_SERIAL_SPEED: VTYPE_INT,
867
  HV_USB_MOUSE: VTYPE_STRING,
868
  HV_KEYMAP: VTYPE_STRING,
869
  HV_DEVICE_MODEL: VTYPE_STRING,
870
  HV_INIT_SCRIPT: VTYPE_STRING,
871
  HV_MIGRATION_PORT: VTYPE_INT,
872
  HV_MIGRATION_BANDWIDTH: VTYPE_INT,
873
  HV_MIGRATION_DOWNTIME: VTYPE_INT,
874
  HV_MIGRATION_MODE: VTYPE_STRING,
875
  HV_USE_LOCALTIME: VTYPE_BOOL,
876
  HV_DISK_CACHE: VTYPE_STRING,
877
  HV_SECURITY_MODEL: VTYPE_STRING,
878
  HV_SECURITY_DOMAIN: VTYPE_STRING,
879
  HV_KVM_FLAG: VTYPE_STRING,
880
  HV_VHOST_NET: VTYPE_BOOL,
881
  HV_KVM_USE_CHROOT: VTYPE_BOOL,
882
  HV_CPU_MASK: VTYPE_STRING,
883
  HV_MEM_PATH: VTYPE_STRING,
884
  HV_PASSTHROUGH: VTYPE_STRING,
885
  HV_BLOCKDEV_PREFIX: VTYPE_STRING,
886
  HV_REBOOT_BEHAVIOR: VTYPE_STRING,
887
  HV_CPU_TYPE: VTYPE_STRING,
888
  HV_CPU_CAP: VTYPE_INT,
889
  HV_CPU_WEIGHT: VTYPE_INT,
890
  HV_CPU_CORES: VTYPE_INT,
891
  HV_CPU_THREADS: VTYPE_INT,
892
  HV_CPU_SOCKETS: VTYPE_INT,
893
  HV_SOUNDHW: VTYPE_STRING,
894
  HV_USB_DEVICES: VTYPE_STRING,
895
  HV_VGA: VTYPE_STRING,
896
  HV_KVM_EXTRA: VTYPE_STRING,
897
  HV_KVM_MACHINE_VERSION: VTYPE_STRING,
898
  HV_VIF_TYPE: VTYPE_STRING,
899
  HV_VIF_SCRIPT: VTYPE_STRING,
900
  HV_XEN_CMD: VTYPE_STRING,
901
  HV_XEN_CPUID: VTYPE_STRING,
902
  HV_VNET_HDR: VTYPE_BOOL,
903
  HV_VIRIDIAN: VTYPE_BOOL,
904
  }
905

    
906
HVS_PARAMETERS = frozenset(HVS_PARAMETER_TYPES.keys())
907

    
908
HVS_PARAMETER_TITLES = {
909
  HV_ACPI: "ACPI",
910
  HV_BOOT_ORDER: "Boot_order",
911
  HV_CDROM_IMAGE_PATH: "CDROM_image_path",
912
  HV_DISK_TYPE: "Disk_type",
913
  HV_INITRD_PATH: "Initrd_path",
914
  HV_KERNEL_PATH: "Kernel_path",
915
  HV_NIC_TYPE: "NIC_type",
916
  HV_PAE: "PAE",
917
  HV_VNC_BIND_ADDRESS: "VNC_bind_address",
918
  HV_PASSTHROUGH: "pci_pass",
919
  HV_CPU_TYPE: "cpu_type",
920
  }
921

    
922
# Migration statuses
923
HV_MIGRATION_COMPLETED = "completed"
924
HV_MIGRATION_ACTIVE = "active"
925
HV_MIGRATION_FAILED = "failed"
926
HV_MIGRATION_CANCELLED = "cancelled"
927

    
928
HV_MIGRATION_VALID_STATUSES = compat.UniqueFrozenset([
929
  HV_MIGRATION_COMPLETED,
930
  HV_MIGRATION_ACTIVE,
931
  HV_MIGRATION_FAILED,
932
  HV_MIGRATION_CANCELLED,
933
  ])
934

    
935
HV_MIGRATION_FAILED_STATUSES = compat.UniqueFrozenset([
936
  HV_MIGRATION_FAILED,
937
  HV_MIGRATION_CANCELLED,
938
  ])
939

    
940
# KVM-specific statuses
941
HV_KVM_MIGRATION_VALID_STATUSES = HV_MIGRATION_VALID_STATUSES
942

    
943
# Node info keys
944
HV_NODEINFO_KEY_VERSION = "hv_version"
945

    
946
# Hypervisor state
947
HVST_MEMORY_TOTAL = "mem_total"
948
HVST_MEMORY_NODE = "mem_node"
949
HVST_MEMORY_HV = "mem_hv"
950
HVST_CPU_TOTAL = "cpu_total"
951
HVST_CPU_NODE = "cpu_node"
952

    
953
HVST_DEFAULTS = {
954
  HVST_MEMORY_TOTAL: 0,
955
  HVST_MEMORY_NODE: 0,
956
  HVST_MEMORY_HV: 0,
957
  HVST_CPU_TOTAL: 1,
958
  HVST_CPU_NODE: 1,
959
  }
960

    
961
HVSTS_PARAMETER_TYPES = {
962
  HVST_MEMORY_TOTAL: VTYPE_INT,
963
  HVST_MEMORY_NODE: VTYPE_INT,
964
  HVST_MEMORY_HV: VTYPE_INT,
965
  HVST_CPU_TOTAL: VTYPE_INT,
966
  HVST_CPU_NODE: VTYPE_INT,
967
  }
968

    
969
HVSTS_PARAMETERS = frozenset(HVSTS_PARAMETER_TYPES.keys())
970

    
971
# Disk state
972
DS_DISK_TOTAL = "disk_total"
973
DS_DISK_RESERVED = "disk_reserved"
974
DS_DISK_OVERHEAD = "disk_overhead"
975

    
976
DS_DEFAULTS = {
977
  DS_DISK_TOTAL: 0,
978
  DS_DISK_RESERVED: 0,
979
  DS_DISK_OVERHEAD: 0,
980
  }
981

    
982
DSS_PARAMETER_TYPES = {
983
  DS_DISK_TOTAL: VTYPE_INT,
984
  DS_DISK_RESERVED: VTYPE_INT,
985
  DS_DISK_OVERHEAD: VTYPE_INT,
986
  }
987

    
988
DSS_PARAMETERS = frozenset(DSS_PARAMETER_TYPES.keys())
989
DS_VALID_TYPES = compat.UniqueFrozenset([DT_PLAIN])
990

    
991
# Backend parameter names
992
BE_MEMORY = "memory" # deprecated and replaced by max and min mem
993
BE_MAXMEM = "maxmem"
994
BE_MINMEM = "minmem"
995
BE_VCPUS = "vcpus"
996
BE_AUTO_BALANCE = "auto_balance"
997
BE_ALWAYS_FAILOVER = "always_failover"
998
BE_SPINDLE_USE = "spindle_use"
999

    
1000
BES_PARAMETER_TYPES = {
1001
  BE_MAXMEM: VTYPE_SIZE,
1002
  BE_MINMEM: VTYPE_SIZE,
1003
  BE_VCPUS: VTYPE_INT,
1004
  BE_AUTO_BALANCE: VTYPE_BOOL,
1005
  BE_ALWAYS_FAILOVER: VTYPE_BOOL,
1006
  BE_SPINDLE_USE: VTYPE_INT,
1007
  }
1008

    
1009
BES_PARAMETER_TITLES = {
1010
  BE_AUTO_BALANCE: "Auto_balance",
1011
  BE_MAXMEM: "ConfigMaxMem",
1012
  BE_MINMEM: "ConfigMinMem",
1013
  BE_VCPUS: "ConfigVCPUs",
1014
  }
1015

    
1016
BES_PARAMETER_COMPAT = {
1017
  BE_MEMORY: VTYPE_SIZE,
1018
  }
1019
BES_PARAMETER_COMPAT.update(BES_PARAMETER_TYPES)
1020

    
1021
BES_PARAMETERS = frozenset(BES_PARAMETER_TYPES.keys())
1022

    
1023
# instance specs
1024
ISPEC_MEM_SIZE = "memory-size"
1025
ISPEC_CPU_COUNT = "cpu-count"
1026
ISPEC_DISK_COUNT = "disk-count"
1027
ISPEC_DISK_SIZE = "disk-size"
1028
ISPEC_NIC_COUNT = "nic-count"
1029
ISPEC_SPINDLE_USE = "spindle-use"
1030

    
1031
ISPECS_PARAMETER_TYPES = {
1032
  ISPEC_MEM_SIZE: VTYPE_INT,
1033
  ISPEC_CPU_COUNT: VTYPE_INT,
1034
  ISPEC_DISK_COUNT: VTYPE_INT,
1035
  ISPEC_DISK_SIZE: VTYPE_INT,
1036
  ISPEC_NIC_COUNT: VTYPE_INT,
1037
  ISPEC_SPINDLE_USE: VTYPE_INT,
1038
  }
1039

    
1040
ISPECS_PARAMETERS = frozenset(ISPECS_PARAMETER_TYPES.keys())
1041

    
1042
ISPECS_MINMAX = "minmax"
1043
ISPECS_MIN = "min"
1044
ISPECS_MAX = "max"
1045
ISPECS_STD = "std"
1046
IPOLICY_DTS = "disk-templates"
1047
IPOLICY_VCPU_RATIO = "vcpu-ratio"
1048
IPOLICY_SPINDLE_RATIO = "spindle-ratio"
1049

    
1050
ISPECS_MINMAX_KEYS = compat.UniqueFrozenset([
1051
  ISPECS_MIN,
1052
  ISPECS_MAX,
1053
  ])
1054

    
1055
IPOLICY_PARAMETERS = compat.UniqueFrozenset([
1056
  IPOLICY_VCPU_RATIO,
1057
  IPOLICY_SPINDLE_RATIO,
1058
  ])
1059

    
1060
IPOLICY_ALL_KEYS = (IPOLICY_PARAMETERS |
1061
                    frozenset([ISPECS_MINMAX, ISPECS_STD, IPOLICY_DTS]))
1062

    
1063
# Node parameter names
1064
ND_OOB_PROGRAM = "oob_program"
1065
ND_SPINDLE_COUNT = "spindle_count"
1066
ND_EXCLUSIVE_STORAGE = "exclusive_storage"
1067
ND_OVS = "ovs"
1068
ND_OVS_NAME = "ovs_name"
1069
ND_OVS_LINK = "ovs_link"
1070

    
1071
NDS_PARAMETER_TYPES = {
1072
  ND_OOB_PROGRAM: VTYPE_STRING,
1073
  ND_SPINDLE_COUNT: VTYPE_INT,
1074
  ND_EXCLUSIVE_STORAGE: VTYPE_BOOL,
1075
  ND_OVS: VTYPE_BOOL,
1076
  ND_OVS_NAME: VTYPE_MAYBE_STRING,
1077
  ND_OVS_LINK: VTYPE_MAYBE_STRING,
1078
  }
1079

    
1080
NDS_PARAMETERS = frozenset(NDS_PARAMETER_TYPES.keys())
1081

    
1082
NDS_PARAMETER_TITLES = {
1083
  ND_OOB_PROGRAM: "OutOfBandProgram",
1084
  ND_SPINDLE_COUNT: "SpindleCount",
1085
  ND_EXCLUSIVE_STORAGE: "ExclusiveStorage",
1086
  ND_OVS: "OpenvSwitch",
1087
  ND_OVS_NAME: "OpenvSwitchName",
1088
  ND_OVS_LINK: "OpenvSwitchLink",
1089
  }
1090

    
1091
# Logical Disks parameters
1092
LDP_RESYNC_RATE = "resync-rate"
1093
LDP_STRIPES = "stripes"
1094
LDP_BARRIERS = "disabled-barriers"
1095
LDP_NO_META_FLUSH = "disable-meta-flush"
1096
LDP_DEFAULT_METAVG = "default-metavg"
1097
LDP_DISK_CUSTOM = "disk-custom"
1098
LDP_NET_CUSTOM = "net-custom"
1099
LDP_PROTOCOL = "protocol"
1100
LDP_DYNAMIC_RESYNC = "dynamic-resync"
1101
LDP_PLAN_AHEAD = "c-plan-ahead"
1102
LDP_FILL_TARGET = "c-fill-target"
1103
LDP_DELAY_TARGET = "c-delay-target"
1104
LDP_MAX_RATE = "c-max-rate"
1105
LDP_MIN_RATE = "c-min-rate"
1106
LDP_POOL = "pool"
1107
LDP_ACCESS = "access"
1108
DISK_LD_TYPES = {
1109
  LDP_RESYNC_RATE: VTYPE_INT,
1110
  LDP_STRIPES: VTYPE_INT,
1111
  LDP_BARRIERS: VTYPE_STRING,
1112
  LDP_NO_META_FLUSH: VTYPE_BOOL,
1113
  LDP_DEFAULT_METAVG: VTYPE_STRING,
1114
  LDP_DISK_CUSTOM: VTYPE_STRING,
1115
  LDP_NET_CUSTOM: VTYPE_STRING,
1116
  LDP_PROTOCOL: VTYPE_STRING,
1117
  LDP_DYNAMIC_RESYNC: VTYPE_BOOL,
1118
  LDP_PLAN_AHEAD: VTYPE_INT,
1119
  LDP_FILL_TARGET: VTYPE_INT,
1120
  LDP_DELAY_TARGET: VTYPE_INT,
1121
  LDP_MAX_RATE: VTYPE_INT,
1122
  LDP_MIN_RATE: VTYPE_INT,
1123
  LDP_POOL: VTYPE_STRING,
1124
  LDP_ACCESS: VTYPE_STRING,
1125
  }
1126
DISK_LD_PARAMETERS = frozenset(DISK_LD_TYPES.keys())
1127

    
1128
# Disk template parameters (can be set/changed by the user via gnt-cluster and
1129
# gnt-group)
1130
DRBD_RESYNC_RATE = "resync-rate"
1131
DRBD_DATA_STRIPES = "data-stripes"
1132
DRBD_META_STRIPES = "meta-stripes"
1133
DRBD_DISK_BARRIERS = "disk-barriers"
1134
DRBD_META_BARRIERS = "meta-barriers"
1135
DRBD_DEFAULT_METAVG = "metavg"
1136
DRBD_DISK_CUSTOM = "disk-custom"
1137
DRBD_NET_CUSTOM = "net-custom"
1138
DRBD_PROTOCOL = "protocol"
1139
DRBD_DYNAMIC_RESYNC = "dynamic-resync"
1140
DRBD_PLAN_AHEAD = "c-plan-ahead"
1141
DRBD_FILL_TARGET = "c-fill-target"
1142
DRBD_DELAY_TARGET = "c-delay-target"
1143
DRBD_MAX_RATE = "c-max-rate"
1144
DRBD_MIN_RATE = "c-min-rate"
1145
LV_STRIPES = "stripes"
1146
RBD_POOL = "pool"
1147
RBD_ACCESS = "access"
1148
DISK_DT_TYPES = {
1149
  DRBD_RESYNC_RATE: VTYPE_INT,
1150
  DRBD_DATA_STRIPES: VTYPE_INT,
1151
  DRBD_META_STRIPES: VTYPE_INT,
1152
  DRBD_DISK_BARRIERS: VTYPE_STRING,
1153
  DRBD_META_BARRIERS: VTYPE_BOOL,
1154
  DRBD_DEFAULT_METAVG: VTYPE_STRING,
1155
  DRBD_DISK_CUSTOM: VTYPE_STRING,
1156
  DRBD_NET_CUSTOM: VTYPE_STRING,
1157
  DRBD_PROTOCOL: VTYPE_STRING,
1158
  DRBD_DYNAMIC_RESYNC: VTYPE_BOOL,
1159
  DRBD_PLAN_AHEAD: VTYPE_INT,
1160
  DRBD_FILL_TARGET: VTYPE_INT,
1161
  DRBD_DELAY_TARGET: VTYPE_INT,
1162
  DRBD_MAX_RATE: VTYPE_INT,
1163
  DRBD_MIN_RATE: VTYPE_INT,
1164
  LV_STRIPES: VTYPE_INT,
1165
  RBD_POOL: VTYPE_STRING,
1166
  RBD_ACCESS: VTYPE_STRING,
1167
  }
1168

    
1169
DISK_DT_PARAMETERS = frozenset(DISK_DT_TYPES.keys())
1170

    
1171
# dynamic disk parameters
1172
DDP_LOCAL_IP = "local-ip"
1173
DDP_REMOTE_IP = "remote-ip"
1174
DDP_PORT = "port"
1175
DDP_LOCAL_MINOR = "local-minor"
1176
DDP_REMOTE_MINOR = "remote-minor"
1177

    
1178
# OOB supported commands
1179
OOB_POWER_ON = _constants.OOB_POWER_ON
1180
OOB_POWER_OFF = _constants.OOB_POWER_OFF
1181
OOB_POWER_CYCLE = _constants.OOB_POWER_CYCLE
1182
OOB_POWER_STATUS = _constants.OOB_POWER_STATUS
1183
OOB_HEALTH = _constants.OOB_HEALTH
1184
OOB_COMMANDS = _constants.OOB_COMMANDS
1185

    
1186
OOB_POWER_STATUS_POWERED = _constants.OOB_POWER_STATUS_POWERED
1187

    
1188
OOB_TIMEOUT = _constants.OOB_TIMEOUT
1189
OOB_POWER_DELAY = _constants.OOB_POWER_DELAY
1190

    
1191
OOB_STATUS_OK = _constants.OOB_STATUS_OK
1192
OOB_STATUS_WARNING = _constants.OOB_STATUS_WARNING
1193
OOB_STATUS_CRITICAL = _constants.OOB_STATUS_CRITICAL
1194
OOB_STATUS_UNKNOWN = _constants.OOB_STATUS_UNKNOWN
1195
OOB_STATUSES = _constants.OOB_STATUSES
1196

    
1197
# Instance Parameters Profile
1198
PP_DEFAULT = "default"
1199

    
1200
# NIC_* constants are used inside the ganeti config
1201
NIC_MODE = _constants.NIC_MODE
1202
NIC_LINK = _constants.NIC_LINK
1203
NIC_VLAN = _constants.NIC_VLAN
1204

    
1205
NIC_MODE_BRIDGED = _constants.NIC_MODE_BRIDGED
1206
NIC_MODE_ROUTED = _constants.NIC_MODE_ROUTED
1207
NIC_MODE_OVS = _constants.NIC_MODE_OVS
1208
NIC_IP_POOL = _constants.NIC_IP_POOL
1209
NIC_VALID_MODES = _constants.NIC_VALID_MODES
1210

    
1211
RESERVE_ACTION = "reserve"
1212
RELEASE_ACTION = "release"
1213

    
1214
NICS_PARAMETER_TYPES = {
1215
  NIC_MODE: VTYPE_STRING,
1216
  NIC_LINK: VTYPE_STRING,
1217
  NIC_VLAN: VTYPE_MAYBE_STRING,
1218
  }
1219

    
1220
NICS_PARAMETERS = frozenset(NICS_PARAMETER_TYPES.keys())
1221

    
1222
# IDISK_* constants are used in opcodes, to create/change disks
1223
IDISK_SIZE = "size"
1224
IDISK_SPINDLES = "spindles"
1225
IDISK_MODE = "mode"
1226
IDISK_ADOPT = "adopt"
1227
IDISK_VG = "vg"
1228
IDISK_METAVG = "metavg"
1229
IDISK_PROVIDER = "provider"
1230
IDISK_NAME = "name"
1231
IDISK_PARAMS_TYPES = {
1232
  IDISK_SIZE: VTYPE_SIZE,
1233
  IDISK_SPINDLES: VTYPE_INT,
1234
  IDISK_MODE: VTYPE_STRING,
1235
  IDISK_ADOPT: VTYPE_STRING,
1236
  IDISK_VG: VTYPE_STRING,
1237
  IDISK_METAVG: VTYPE_STRING,
1238
  IDISK_PROVIDER: VTYPE_STRING,
1239
  IDISK_NAME: VTYPE_MAYBE_STRING,
1240
  }
1241
IDISK_PARAMS = frozenset(IDISK_PARAMS_TYPES.keys())
1242

    
1243
# INIC_* constants are used in opcodes, to create/change nics
1244
INIC_MAC = "mac"
1245
INIC_IP = "ip"
1246
INIC_MODE = "mode"
1247
INIC_LINK = "link"
1248
INIC_NETWORK = "network"
1249
INIC_NAME = "name"
1250
INIC_VLAN = "vlan"
1251
INIC_BRIDGE = "bridge"
1252
INIC_PARAMS_TYPES = {
1253
  INIC_IP: VTYPE_MAYBE_STRING,
1254
  INIC_LINK: VTYPE_STRING,
1255
  INIC_MAC: VTYPE_STRING,
1256
  INIC_MODE: VTYPE_STRING,
1257
  INIC_NETWORK: VTYPE_MAYBE_STRING,
1258
  INIC_NAME: VTYPE_MAYBE_STRING,
1259
  INIC_VLAN: VTYPE_MAYBE_STRING,
1260
  INIC_BRIDGE: VTYPE_MAYBE_STRING
1261
  }
1262
INIC_PARAMS = frozenset(INIC_PARAMS_TYPES.keys())
1263

    
1264
# Hypervisor constants
1265
HT_XEN_PVM = _constants.HT_XEN_PVM
1266
HT_FAKE = _constants.HT_FAKE
1267
HT_XEN_HVM = _constants.HT_XEN_HVM
1268
HT_KVM = _constants.HT_KVM
1269
HT_CHROOT = _constants.HT_CHROOT
1270
HT_LXC = _constants.HT_LXC
1271
HYPER_TYPES = _constants.HYPER_TYPES
1272
HTS_REQ_PORT = _constants.HTS_REQ_PORT
1273

    
1274
VNC_BASE_PORT = 5900
1275
VNC_DEFAULT_BIND_ADDRESS = IP4_ADDRESS_ANY
1276

    
1277
# NIC types
1278
HT_NIC_RTL8139 = "rtl8139"
1279
HT_NIC_NE2K_PCI = "ne2k_pci"
1280
HT_NIC_NE2K_ISA = "ne2k_isa"
1281
HT_NIC_I82551 = "i82551"
1282
HT_NIC_I85557B = "i82557b"
1283
HT_NIC_I8259ER = "i82559er"
1284
HT_NIC_PCNET = "pcnet"
1285
HT_NIC_E1000 = "e1000"
1286
HT_NIC_PARAVIRTUAL = HT_DISK_PARAVIRTUAL = "paravirtual"
1287

    
1288
HT_HVM_VALID_NIC_TYPES = compat.UniqueFrozenset([
1289
  HT_NIC_RTL8139,
1290
  HT_NIC_NE2K_PCI,
1291
  HT_NIC_E1000,
1292
  HT_NIC_NE2K_ISA,
1293
  HT_NIC_PARAVIRTUAL,
1294
  ])
1295
HT_KVM_VALID_NIC_TYPES = compat.UniqueFrozenset([
1296
  HT_NIC_RTL8139,
1297
  HT_NIC_NE2K_PCI,
1298
  HT_NIC_NE2K_ISA,
1299
  HT_NIC_I82551,
1300
  HT_NIC_I85557B,
1301
  HT_NIC_I8259ER,
1302
  HT_NIC_PCNET,
1303
  HT_NIC_E1000,
1304
  HT_NIC_PARAVIRTUAL,
1305
  ])
1306

    
1307
# Vif types
1308
# default vif type in xen-hvm
1309
HT_HVM_VIF_IOEMU = "ioemu"
1310
HT_HVM_VIF_VIF = "vif"
1311
HT_HVM_VALID_VIF_TYPES = compat.UniqueFrozenset([
1312
  HT_HVM_VIF_IOEMU,
1313
  HT_HVM_VIF_VIF,
1314
  ])
1315

    
1316
# Disk types
1317
HT_DISK_IOEMU = "ioemu"
1318
HT_DISK_IDE = "ide"
1319
HT_DISK_SCSI = "scsi"
1320
HT_DISK_SD = "sd"
1321
HT_DISK_MTD = "mtd"
1322
HT_DISK_PFLASH = "pflash"
1323

    
1324
HT_CACHE_DEFAULT = "default"
1325
HT_CACHE_NONE = "none"
1326
HT_CACHE_WTHROUGH = "writethrough"
1327
HT_CACHE_WBACK = "writeback"
1328
HT_VALID_CACHE_TYPES = compat.UniqueFrozenset([
1329
  HT_CACHE_DEFAULT,
1330
  HT_CACHE_NONE,
1331
  HT_CACHE_WTHROUGH,
1332
  HT_CACHE_WBACK,
1333
  ])
1334

    
1335
HT_HVM_VALID_DISK_TYPES = compat.UniqueFrozenset([
1336
  HT_DISK_PARAVIRTUAL,
1337
  HT_DISK_IOEMU,
1338
  ])
1339
HT_KVM_VALID_DISK_TYPES = compat.UniqueFrozenset([
1340
  HT_DISK_PARAVIRTUAL,
1341
  HT_DISK_IDE,
1342
  HT_DISK_SCSI,
1343
  HT_DISK_SD,
1344
  HT_DISK_MTD,
1345
  HT_DISK_PFLASH,
1346
  ])
1347

    
1348
# Mouse types:
1349
HT_MOUSE_MOUSE = "mouse"
1350
HT_MOUSE_TABLET = "tablet"
1351

    
1352
HT_KVM_VALID_MOUSE_TYPES = compat.UniqueFrozenset([
1353
  HT_MOUSE_MOUSE,
1354
  HT_MOUSE_TABLET,
1355
  ])
1356

    
1357
# Boot order
1358
HT_BO_FLOPPY = "floppy"
1359
HT_BO_CDROM = "cdrom"
1360
HT_BO_DISK = "disk"
1361
HT_BO_NETWORK = "network"
1362

    
1363
HT_KVM_VALID_BO_TYPES = compat.UniqueFrozenset([
1364
  HT_BO_FLOPPY,
1365
  HT_BO_CDROM,
1366
  HT_BO_DISK,
1367
  HT_BO_NETWORK,
1368
  ])
1369

    
1370
# SPICE lossless image compression options
1371
HT_KVM_SPICE_LOSSLESS_IMG_COMPR_AUTO_GLZ = "auto_glz"
1372
HT_KVM_SPICE_LOSSLESS_IMG_COMPR_AUTO_LZ = "auto_lz"
1373
HT_KVM_SPICE_LOSSLESS_IMG_COMPR_QUIC = "quic"
1374
HT_KVM_SPICE_LOSSLESS_IMG_COMPR_GLZ = "glz"
1375
HT_KVM_SPICE_LOSSLESS_IMG_COMPR_LZ = "lz"
1376
HT_KVM_SPICE_LOSSLESS_IMG_COMPR_OFF = "off"
1377

    
1378
HT_KVM_SPICE_VALID_LOSSLESS_IMG_COMPR_OPTIONS = compat.UniqueFrozenset([
1379
  HT_KVM_SPICE_LOSSLESS_IMG_COMPR_AUTO_GLZ,
1380
  HT_KVM_SPICE_LOSSLESS_IMG_COMPR_AUTO_LZ,
1381
  HT_KVM_SPICE_LOSSLESS_IMG_COMPR_QUIC,
1382
  HT_KVM_SPICE_LOSSLESS_IMG_COMPR_GLZ,
1383
  HT_KVM_SPICE_LOSSLESS_IMG_COMPR_LZ,
1384
  HT_KVM_SPICE_LOSSLESS_IMG_COMPR_OFF,
1385
  ])
1386

    
1387
# SPICE lossy image compression options (valid for both jpeg and zlib-glz)
1388
HT_KVM_SPICE_LOSSY_IMG_COMPR_AUTO = "auto"
1389
HT_KVM_SPICE_LOSSY_IMG_COMPR_NEVER = "never"
1390
HT_KVM_SPICE_LOSSY_IMG_COMPR_ALWAYS = "always"
1391

    
1392
HT_KVM_SPICE_VALID_LOSSY_IMG_COMPR_OPTIONS = compat.UniqueFrozenset([
1393
  HT_KVM_SPICE_LOSSY_IMG_COMPR_AUTO,
1394
  HT_KVM_SPICE_LOSSY_IMG_COMPR_NEVER,
1395
  HT_KVM_SPICE_LOSSY_IMG_COMPR_ALWAYS,
1396
  ])
1397

    
1398
# SPICE video stream detection
1399
HT_KVM_SPICE_VIDEO_STREAM_DETECTION_OFF = "off"
1400
HT_KVM_SPICE_VIDEO_STREAM_DETECTION_ALL = "all"
1401
HT_KVM_SPICE_VIDEO_STREAM_DETECTION_FILTER = "filter"
1402

    
1403
HT_KVM_SPICE_VALID_VIDEO_STREAM_DETECTION_OPTIONS = compat.UniqueFrozenset([
1404
  HT_KVM_SPICE_VIDEO_STREAM_DETECTION_OFF,
1405
  HT_KVM_SPICE_VIDEO_STREAM_DETECTION_ALL,
1406
  HT_KVM_SPICE_VIDEO_STREAM_DETECTION_FILTER,
1407
  ])
1408

    
1409
# Security models
1410
HT_SM_NONE = "none"
1411
HT_SM_USER = "user"
1412
HT_SM_POOL = "pool"
1413

    
1414
HT_KVM_VALID_SM_TYPES = compat.UniqueFrozenset([
1415
  HT_SM_NONE,
1416
  HT_SM_USER,
1417
  HT_SM_POOL,
1418
  ])
1419

    
1420
# Kvm flag values
1421
HT_KVM_ENABLED = "enabled"
1422
HT_KVM_DISABLED = "disabled"
1423

    
1424
HT_KVM_FLAG_VALUES = compat.UniqueFrozenset([HT_KVM_ENABLED, HT_KVM_DISABLED])
1425

    
1426
# Migration type
1427
HT_MIGRATION_LIVE = _constants.HT_MIGRATION_LIVE
1428
HT_MIGRATION_NONLIVE = _constants.HT_MIGRATION_NONLIVE
1429
HT_MIGRATION_MODES = _constants.HT_MIGRATION_MODES
1430

    
1431
# Cluster Verify steps
1432
VERIFY_NPLUSONE_MEM = _constants.VERIFY_NPLUSONE_MEM
1433
VERIFY_OPTIONAL_CHECKS = _constants.VERIFY_OPTIONAL_CHECKS
1434

    
1435
# Cluster Verify error classes
1436
CV_TCLUSTER = _constants.CV_TCLUSTER
1437
CV_TGROUP = _constants.CV_TGROUP
1438
CV_TNODE = _constants.CV_TNODE
1439
CV_TINSTANCE = _constants.CV_TINSTANCE
1440

    
1441
# Cluster Verify error codes and documentation
1442
CV_ECLUSTERCFG = _constants.CV_ECLUSTERCFG
1443
CV_ECLUSTERCERT = _constants.CV_ECLUSTERCERT
1444
CV_ECLUSTERFILECHECK = _constants.CV_ECLUSTERFILECHECK
1445
CV_ECLUSTERDANGLINGNODES = _constants.CV_ECLUSTERDANGLINGNODES
1446
CV_ECLUSTERDANGLINGINST = _constants.CV_ECLUSTERDANGLINGINST
1447
CV_EGROUPDIFFERENTPVSIZE = _constants.CV_EGROUPDIFFERENTPVSIZE
1448
CV_EINSTANCEBADNODE = _constants.CV_EINSTANCEBADNODE
1449
CV_EINSTANCEDOWN = _constants.CV_EINSTANCEDOWN
1450
CV_EINSTANCELAYOUT = _constants.CV_EINSTANCELAYOUT
1451
CV_EINSTANCEMISSINGDISK = _constants.CV_EINSTANCEMISSINGDISK
1452
CV_EINSTANCEFAULTYDISK = _constants.CV_EINSTANCEFAULTYDISK
1453
CV_EINSTANCEWRONGNODE = _constants.CV_EINSTANCEWRONGNODE
1454
CV_EINSTANCESPLITGROUPS = _constants.CV_EINSTANCESPLITGROUPS
1455
CV_EINSTANCEPOLICY = _constants.CV_EINSTANCEPOLICY
1456
CV_EINSTANCEUNSUITABLENODE = _constants.CV_EINSTANCEUNSUITABLENODE
1457
CV_EINSTANCEMISSINGCFGPARAMETER = _constants.CV_EINSTANCEMISSINGCFGPARAMETER
1458
CV_ENODEDRBD = _constants.CV_ENODEDRBD
1459
CV_ENODEDRBDVERSION = _constants.CV_ENODEDRBDVERSION
1460
CV_ENODEDRBDHELPER = _constants.CV_ENODEDRBDHELPER
1461
CV_ENODEFILECHECK = _constants.CV_ENODEFILECHECK
1462
CV_ENODEHOOKS = _constants.CV_ENODEHOOKS
1463
CV_ENODEHV = _constants.CV_ENODEHV
1464
CV_ENODELVM = _constants.CV_ENODELVM
1465
CV_ENODEN1 = _constants.CV_ENODEN1
1466
CV_ENODENET = _constants.CV_ENODENET
1467
CV_ENODEOS = _constants.CV_ENODEOS
1468
CV_ENODEORPHANINSTANCE = _constants.CV_ENODEORPHANINSTANCE
1469
CV_ENODEORPHANLV = _constants.CV_ENODEORPHANLV
1470
CV_ENODERPC = _constants.CV_ENODERPC
1471
CV_ENODESSH = _constants.CV_ENODESSH
1472
CV_ENODEVERSION = _constants.CV_ENODEVERSION
1473
CV_ENODESETUP = _constants.CV_ENODESETUP
1474
CV_ENODETIME = _constants.CV_ENODETIME
1475
CV_ENODEOOBPATH = _constants.CV_ENODEOOBPATH
1476
CV_ENODEUSERSCRIPTS = _constants.CV_ENODEUSERSCRIPTS
1477
CV_ENODEFILESTORAGEPATHS = _constants.CV_ENODEFILESTORAGEPATHS
1478
CV_ENODEFILESTORAGEPATHUNUSABLE = _constants.CV_ENODEFILESTORAGEPATHUNUSABLE
1479
CV_ENODESHAREDFILESTORAGEPATHUNUSABLE = \
1480
  _constants.CV_ENODESHAREDFILESTORAGEPATHUNUSABLE
1481

    
1482
CV_ALL_ECODES = _constants.CV_ALL_ECODES
1483
CV_ALL_ECODES_STRINGS = _constants.CV_ALL_ECODES_STRINGS
1484

    
1485
# Node verify constants
1486
NV_BRIDGES = "bridges"
1487
NV_DRBDHELPER = "drbd-helper"
1488
NV_DRBDVERSION = "drbd-version"
1489
NV_DRBDLIST = "drbd-list"
1490
NV_EXCLUSIVEPVS = "exclusive-pvs"
1491
NV_FILELIST = "filelist"
1492
NV_ACCEPTED_STORAGE_PATHS = "allowed-file-storage-paths"
1493
NV_FILE_STORAGE_PATH = "file-storage-path"
1494
NV_SHARED_FILE_STORAGE_PATH = "shared-file-storage-path"
1495
NV_HVINFO = "hvinfo"
1496
NV_HVPARAMS = "hvparms"
1497
NV_HYPERVISOR = "hypervisor"
1498
NV_INSTANCELIST = "instancelist"
1499
NV_LVLIST = "lvlist"
1500
NV_MASTERIP = "master-ip"
1501
NV_NODELIST = "nodelist"
1502
NV_NODENETTEST = "node-net-test"
1503
NV_NODESETUP = "nodesetup"
1504
NV_OOB_PATHS = "oob-paths"
1505
NV_OSLIST = "oslist"
1506
NV_PVLIST = "pvlist"
1507
NV_TIME = "time"
1508
NV_USERSCRIPTS = "user-scripts"
1509
NV_VERSION = "version"
1510
NV_VGLIST = "vglist"
1511
NV_VMNODES = "vmnodes"
1512

    
1513
# Instance status
1514
INSTST_RUNNING = _constants.INSTST_RUNNING
1515
INSTST_ADMINDOWN = _constants.INSTST_ADMINDOWN
1516
INSTST_ADMINOFFLINE = _constants.INSTST_ADMINOFFLINE
1517
INSTST_NODEOFFLINE = _constants.INSTST_NODEOFFLINE
1518
INSTST_NODEDOWN = _constants.INSTST_NODEDOWN
1519
INSTST_WRONGNODE = _constants.INSTST_WRONGNODE
1520
INSTST_ERRORUP = _constants.INSTST_ERRORUP
1521
INSTST_ERRORDOWN = _constants.INSTST_ERRORDOWN
1522
INSTST_ALL = _constants.INSTST_ALL
1523

    
1524
# Admin states
1525
ADMINST_UP = _constants.ADMINST_UP
1526
ADMINST_DOWN = _constants.ADMINST_DOWN
1527
ADMINST_OFFLINE = _constants.ADMINST_OFFLINE
1528
ADMINST_ALL = _constants.ADMINST_ALL
1529

    
1530
# Node roles
1531
NR_REGULAR = _constants.NR_REGULAR
1532
NR_MASTER = _constants.NR_MASTER
1533
NR_MCANDIDATE = _constants.NR_MCANDIDATE
1534
NR_DRAINED = _constants.NR_DRAINED
1535
NR_OFFLINE = _constants.NR_OFFLINE
1536
NR_ALL = _constants.NR_ALL
1537

    
1538
# SSL certificate check constants (in days)
1539
SSL_CERT_EXPIRATION_WARN = 30
1540
SSL_CERT_EXPIRATION_ERROR = 7
1541

    
1542
# Allocator framework constants
1543
IALLOCATOR_VERSION = _constants.IALLOCATOR_VERSION
1544
IALLOCATOR_DIR_IN = _constants.IALLOCATOR_DIR_IN
1545
IALLOCATOR_DIR_OUT = _constants.IALLOCATOR_DIR_OUT
1546
VALID_IALLOCATOR_DIRECTIONS = _constants.VALID_IALLOCATOR_DIRECTIONS
1547

    
1548
IALLOCATOR_MODE_ALLOC = _constants.IALLOCATOR_MODE_ALLOC
1549
IALLOCATOR_MODE_RELOC = _constants.IALLOCATOR_MODE_RELOC
1550
IALLOCATOR_MODE_CHG_GROUP = _constants.IALLOCATOR_MODE_CHG_GROUP
1551
IALLOCATOR_MODE_NODE_EVAC = _constants.IALLOCATOR_MODE_NODE_EVAC
1552
IALLOCATOR_MODE_MULTI_ALLOC = _constants.IALLOCATOR_MODE_MULTI_ALLOC
1553
VALID_IALLOCATOR_MODES = _constants.VALID_IALLOCATOR_MODES
1554

    
1555
IALLOCATOR_SEARCH_PATH = _constants.IALLOCATOR_SEARCH_PATH
1556
DEFAULT_IALLOCATOR_SHORTCUT = _constants.DEFAULT_IALLOCATOR_SHORTCUT
1557

    
1558
# Node evacuation
1559
NODE_EVAC_PRI = _constants.NODE_EVAC_PRI
1560
NODE_EVAC_SEC = _constants.NODE_EVAC_SEC
1561
NODE_EVAC_ALL = _constants.NODE_EVAC_ALL
1562
NODE_EVAC_MODES = _constants.NODE_EVAC_MODES
1563

    
1564
# Job queue
1565
JOB_QUEUE_VERSION = 1
1566
JOB_QUEUE_SIZE_HARD_LIMIT = 5000
1567
JOB_QUEUE_FILES_PERMS = 0640
1568

    
1569
JOB_ID_TEMPLATE = r"\d+"
1570
JOB_FILE_RE = re.compile(r"^job-(%s)$" % JOB_ID_TEMPLATE)
1571

    
1572
# unchanged job return
1573
JOB_NOTCHANGED = "nochange"
1574

    
1575
# Job status
1576
JOB_STATUS_QUEUED = _constants.JOB_STATUS_QUEUED
1577
JOB_STATUS_WAITING = _constants.JOB_STATUS_WAITING
1578
JOB_STATUS_CANCELING = _constants.JOB_STATUS_CANCELING
1579
JOB_STATUS_RUNNING = _constants.JOB_STATUS_RUNNING
1580
JOB_STATUS_CANCELED = _constants.JOB_STATUS_CANCELED
1581
JOB_STATUS_SUCCESS = _constants.JOB_STATUS_SUCCESS
1582
JOB_STATUS_ERROR = _constants.JOB_STATUS_ERROR
1583
JOBS_PENDING = _constants.JOBS_PENDING
1584
JOBS_FINALIZED = _constants.JOBS_FINALIZED
1585
JOB_STATUS_ALL = _constants.JOB_STATUS_ALL
1586

    
1587
# OpCode status
1588
# not yet finalized
1589
OP_STATUS_QUEUED = _constants.OP_STATUS_QUEUED
1590
OP_STATUS_WAITING = _constants.OP_STATUS_WAITING
1591
OP_STATUS_CANCELING = _constants.OP_STATUS_CANCELING
1592
OP_STATUS_RUNNING = _constants.OP_STATUS_RUNNING
1593
# finalized
1594
OP_STATUS_CANCELED = _constants.OP_STATUS_CANCELED
1595
OP_STATUS_SUCCESS = _constants.OP_STATUS_SUCCESS
1596
OP_STATUS_ERROR = _constants.OP_STATUS_ERROR
1597
OPS_FINALIZED = _constants.OPS_FINALIZED
1598

    
1599
# OpCode priority
1600
OP_PRIO_LOWEST = _constants.OP_PRIO_LOWEST
1601
OP_PRIO_HIGHEST = _constants.OP_PRIO_HIGHEST
1602
OP_PRIO_LOW = _constants.OP_PRIO_LOW
1603
OP_PRIO_NORMAL = _constants.OP_PRIO_NORMAL
1604
OP_PRIO_HIGH = _constants.OP_PRIO_HIGH
1605
OP_PRIO_SUBMIT_VALID = _constants.OP_PRIO_SUBMIT_VALID
1606
OP_PRIO_DEFAULT = _constants.OP_PRIO_DEFAULT
1607

    
1608
# Lock recalculate mode
1609
LOCKS_REPLACE = "replace"
1610
LOCKS_APPEND = "append"
1611

    
1612
# Lock timeout (sum) before we should go into blocking acquire (still
1613
# can be reset by priority change); computed as max time (10 hours)
1614
# before we should actually go into blocking acquire given that we
1615
# start from default priority level; in seconds
1616
# TODO
1617
LOCK_ATTEMPTS_TIMEOUT = 10 * 3600 / (OP_PRIO_DEFAULT - OP_PRIO_HIGHEST)
1618
LOCK_ATTEMPTS_MAXWAIT = 15.0
1619
LOCK_ATTEMPTS_MINWAIT = 1.0
1620

    
1621
# Execution log types
1622
ELOG_MESSAGE = _constants.ELOG_MESSAGE
1623
ELOG_REMOTE_IMPORT = _constants.ELOG_REMOTE_IMPORT
1624
ELOG_JQUEUE_TEST = _constants.ELOG_JQUEUE_TEST
1625

    
1626
# /etc/hosts modification
1627
ETC_HOSTS_ADD = "add"
1628
ETC_HOSTS_REMOVE = "remove"
1629

    
1630
# Job queue test
1631
JQT_MSGPREFIX = "TESTMSG="
1632
JQT_EXPANDNAMES = "expandnames"
1633
JQT_EXEC = "exec"
1634
JQT_LOGMSG = "logmsg"
1635
JQT_STARTMSG = "startmsg"
1636
JQT_ALL = compat.UniqueFrozenset([
1637
  JQT_EXPANDNAMES,
1638
  JQT_EXEC,
1639
  JQT_LOGMSG,
1640
  JQT_STARTMSG,
1641
  ])
1642

    
1643
# Query resources
1644
QR_CLUSTER = "cluster"
1645
QR_INSTANCE = "instance"
1646
QR_NODE = "node"
1647
QR_LOCK = "lock"
1648
QR_GROUP = "group"
1649
QR_OS = "os"
1650
QR_JOB = "job"
1651
QR_EXPORT = "export"
1652
QR_NETWORK = "network"
1653
QR_EXTSTORAGE = "extstorage"
1654

    
1655
#: List of resources which can be queried using L{opcodes.OpQuery}
1656
QR_VIA_OP = compat.UniqueFrozenset([
1657
  QR_CLUSTER,
1658
  QR_INSTANCE,
1659
  QR_NODE,
1660
  QR_GROUP,
1661
  QR_OS,
1662
  QR_EXPORT,
1663
  QR_NETWORK,
1664
  QR_EXTSTORAGE,
1665
  ])
1666

    
1667
#: List of resources which can be queried using Local UniX Interface
1668
QR_VIA_LUXI = QR_VIA_OP.union([
1669
  QR_LOCK,
1670
  QR_JOB,
1671
  ])
1672

    
1673
#: List of resources which can be queried using RAPI
1674
QR_VIA_RAPI = QR_VIA_LUXI
1675

    
1676
# Query field types
1677
QFT_UNKNOWN = "unknown"
1678
QFT_TEXT = "text"
1679
QFT_BOOL = "bool"
1680
QFT_NUMBER = "number"
1681
QFT_UNIT = "unit"
1682
QFT_TIMESTAMP = "timestamp"
1683
QFT_OTHER = "other"
1684

    
1685
#: All query field types
1686
QFT_ALL = compat.UniqueFrozenset([
1687
  QFT_UNKNOWN,
1688
  QFT_TEXT,
1689
  QFT_BOOL,
1690
  QFT_NUMBER,
1691
  QFT_UNIT,
1692
  QFT_TIMESTAMP,
1693
  QFT_OTHER,
1694
  ])
1695

    
1696
# Query result field status (don't change or reuse values as they're used by
1697
# clients)
1698
#: Normal field status
1699
RS_NORMAL = 0
1700
#: Unknown field
1701
RS_UNKNOWN = 1
1702
#: No data (e.g. RPC error), can be used instead of L{RS_OFFLINE}
1703
RS_NODATA = 2
1704
#: Value unavailable/unsupported for item; if this field is supported
1705
#: but we cannot get the data for the moment, RS_NODATA or
1706
#: RS_OFFLINE should be used
1707
RS_UNAVAIL = 3
1708
#: Resource marked offline
1709
RS_OFFLINE = 4
1710

    
1711
RS_ALL = compat.UniqueFrozenset([
1712
  RS_NORMAL,
1713
  RS_UNKNOWN,
1714
  RS_NODATA,
1715
  RS_UNAVAIL,
1716
  RS_OFFLINE,
1717
  ])
1718

    
1719
#: Dictionary with special field cases and their verbose/terse formatting
1720
RSS_DESCRIPTION = {
1721
  RS_UNKNOWN: ("(unknown)", "??"),
1722
  RS_NODATA: ("(nodata)", "?"),
1723
  RS_OFFLINE: ("(offline)", "*"),
1724
  RS_UNAVAIL: ("(unavail)", "-"),
1725
  }
1726

    
1727
# max dynamic devices
1728
MAX_NICS = 8
1729
MAX_DISKS = 16
1730

    
1731
# SSCONF file prefix
1732
SSCONF_FILEPREFIX = "ssconf_"
1733
# SSCONF keys
1734
SS_CLUSTER_NAME = "cluster_name"
1735
SS_CLUSTER_TAGS = "cluster_tags"
1736
SS_FILE_STORAGE_DIR = "file_storage_dir"
1737
SS_SHARED_FILE_STORAGE_DIR = "shared_file_storage_dir"
1738
SS_MASTER_CANDIDATES = "master_candidates"
1739
SS_MASTER_CANDIDATES_IPS = "master_candidates_ips"
1740
SS_MASTER_IP = "master_ip"
1741
SS_MASTER_NETDEV = "master_netdev"
1742
SS_MASTER_NETMASK = "master_netmask"
1743
SS_MASTER_NODE = "master_node"
1744
SS_NODE_LIST = "node_list"
1745
SS_NODE_PRIMARY_IPS = "node_primary_ips"
1746
SS_NODE_SECONDARY_IPS = "node_secondary_ips"
1747
SS_OFFLINE_NODES = "offline_nodes"
1748
SS_ONLINE_NODES = "online_nodes"
1749
SS_PRIMARY_IP_FAMILY = "primary_ip_family"
1750
SS_INSTANCE_LIST = "instance_list"
1751
SS_RELEASE_VERSION = "release_version"
1752
SS_HYPERVISOR_LIST = "hypervisor_list"
1753
SS_MAINTAIN_NODE_HEALTH = "maintain_node_health"
1754
SS_UID_POOL = "uid_pool"
1755
SS_NODEGROUPS = "nodegroups"
1756
SS_NETWORKS = "networks"
1757

    
1758
# This is not a complete SSCONF key, but the prefix for the hypervisor keys
1759
SS_HVPARAMS_PREF = "hvparams_"
1760

    
1761
# Hvparams keys:
1762
SS_HVPARAMS_XEN_PVM = SS_HVPARAMS_PREF + HT_XEN_PVM
1763
SS_HVPARAMS_XEN_FAKE = SS_HVPARAMS_PREF + HT_FAKE
1764
SS_HVPARAMS_XEN_HVM = SS_HVPARAMS_PREF + HT_XEN_HVM
1765
SS_HVPARAMS_XEN_KVM = SS_HVPARAMS_PREF + HT_KVM
1766
SS_HVPARAMS_XEN_CHROOT = SS_HVPARAMS_PREF + HT_CHROOT
1767
SS_HVPARAMS_XEN_LXC = SS_HVPARAMS_PREF + HT_LXC
1768

    
1769
VALID_SS_HVPARAMS_KEYS = compat.UniqueFrozenset([
1770
  SS_HVPARAMS_XEN_PVM,
1771
  SS_HVPARAMS_XEN_FAKE,
1772
  SS_HVPARAMS_XEN_HVM,
1773
  SS_HVPARAMS_XEN_KVM,
1774
  SS_HVPARAMS_XEN_CHROOT,
1775
  SS_HVPARAMS_XEN_LXC,
1776
  ])
1777

    
1778
SS_FILE_PERMS = 0444
1779

    
1780
# cluster wide default parameters
1781
DEFAULT_ENABLED_HYPERVISOR = HT_XEN_PVM
1782

    
1783
HVC_DEFAULTS = {
1784
  HT_XEN_PVM: {
1785
    HV_USE_BOOTLOADER: False,
1786
    HV_BOOTLOADER_PATH: XEN_BOOTLOADER,
1787
    HV_BOOTLOADER_ARGS: "",
1788
    HV_KERNEL_PATH: XEN_KERNEL,
1789
    HV_INITRD_PATH: "",
1790
    HV_ROOT_PATH: "/dev/xvda1",
1791
    HV_KERNEL_ARGS: "ro",
1792
    HV_MIGRATION_PORT: 8002,
1793
    HV_MIGRATION_MODE: HT_MIGRATION_LIVE,
1794
    HV_BLOCKDEV_PREFIX: "sd",
1795
    HV_REBOOT_BEHAVIOR: INSTANCE_REBOOT_ALLOWED,
1796
    HV_CPU_MASK: CPU_PINNING_ALL,
1797
    HV_CPU_CAP: 0,
1798
    HV_CPU_WEIGHT: 256,
1799
    HV_VIF_SCRIPT: "",
1800
    HV_XEN_CMD: XEN_CMD_XM,
1801
    HV_XEN_CPUID: "",
1802
    HV_SOUNDHW: "",
1803
    },
1804
  HT_XEN_HVM: {
1805
    HV_BOOT_ORDER: "cd",
1806
    HV_CDROM_IMAGE_PATH: "",
1807
    HV_NIC_TYPE: HT_NIC_RTL8139,
1808
    HV_DISK_TYPE: HT_DISK_PARAVIRTUAL,
1809
    HV_VNC_BIND_ADDRESS: IP4_ADDRESS_ANY,
1810
    HV_VNC_PASSWORD_FILE: pathutils.VNC_PASSWORD_FILE,
1811
    HV_ACPI: True,
1812
    HV_PAE: True,
1813
    HV_KERNEL_PATH: "/usr/lib/xen/boot/hvmloader",
1814
    HV_DEVICE_MODEL: "/usr/lib/xen/bin/qemu-dm",
1815
    HV_MIGRATION_PORT: 8002,
1816
    HV_MIGRATION_MODE: HT_MIGRATION_NONLIVE,
1817
    HV_USE_LOCALTIME: False,
1818
    HV_BLOCKDEV_PREFIX: "hd",
1819
    HV_PASSTHROUGH: "",
1820
    HV_REBOOT_BEHAVIOR: INSTANCE_REBOOT_ALLOWED,
1821
    HV_CPU_MASK: CPU_PINNING_ALL,
1822
    HV_CPU_CAP: 0,
1823
    HV_CPU_WEIGHT: 256,
1824
    HV_VIF_TYPE: HT_HVM_VIF_IOEMU,
1825
    HV_VIF_SCRIPT: "",
1826
    HV_VIRIDIAN: False,
1827
    HV_XEN_CMD: XEN_CMD_XM,
1828
    HV_XEN_CPUID: "",
1829
    HV_SOUNDHW: "",
1830
    },
1831
  HT_KVM: {
1832
    HV_KVM_PATH: KVM_PATH,
1833
    HV_KERNEL_PATH: KVM_KERNEL,
1834
    HV_INITRD_PATH: "",
1835
    HV_KERNEL_ARGS: "ro",
1836
    HV_ROOT_PATH: "/dev/vda1",
1837
    HV_ACPI: True,
1838
    HV_SERIAL_CONSOLE: True,
1839
    HV_SERIAL_SPEED: 38400,
1840
    HV_VNC_BIND_ADDRESS: "",
1841
    HV_VNC_TLS: False,
1842
    HV_VNC_X509: "",
1843
    HV_VNC_X509_VERIFY: False,
1844
    HV_VNC_PASSWORD_FILE: "",
1845
    HV_KVM_SPICE_BIND: "",
1846
    HV_KVM_SPICE_IP_VERSION: IFACE_NO_IP_VERSION_SPECIFIED,
1847
    HV_KVM_SPICE_PASSWORD_FILE: "",
1848
    HV_KVM_SPICE_LOSSLESS_IMG_COMPR: "",
1849
    HV_KVM_SPICE_JPEG_IMG_COMPR: "",
1850
    HV_KVM_SPICE_ZLIB_GLZ_IMG_COMPR: "",
1851
    HV_KVM_SPICE_STREAMING_VIDEO_DETECTION: "",
1852
    HV_KVM_SPICE_AUDIO_COMPR: True,
1853
    HV_KVM_SPICE_USE_TLS: False,
1854
    HV_KVM_SPICE_TLS_CIPHERS: OPENSSL_CIPHERS,
1855
    HV_KVM_SPICE_USE_VDAGENT: True,
1856
    HV_KVM_FLOPPY_IMAGE_PATH: "",
1857
    HV_CDROM_IMAGE_PATH: "",
1858
    HV_KVM_CDROM2_IMAGE_PATH: "",
1859
    HV_BOOT_ORDER: HT_BO_DISK,
1860
    HV_NIC_TYPE: HT_NIC_PARAVIRTUAL,
1861
    HV_DISK_TYPE: HT_DISK_PARAVIRTUAL,
1862
    HV_KVM_CDROM_DISK_TYPE: "",
1863
    HV_USB_MOUSE: "",
1864
    HV_KEYMAP: "",
1865
    HV_MIGRATION_PORT: 8102,
1866
    HV_MIGRATION_BANDWIDTH: 32, # MiB/s
1867
    HV_MIGRATION_DOWNTIME: 30,  # ms
1868
    HV_MIGRATION_MODE: HT_MIGRATION_LIVE,
1869
    HV_USE_LOCALTIME: False,
1870
    HV_DISK_CACHE: HT_CACHE_DEFAULT,
1871
    HV_SECURITY_MODEL: HT_SM_NONE,
1872
    HV_SECURITY_DOMAIN: "",
1873
    HV_KVM_FLAG: "",
1874
    HV_VHOST_NET: False,
1875
    HV_KVM_USE_CHROOT: False,
1876
    HV_MEM_PATH: "",
1877
    HV_REBOOT_BEHAVIOR: INSTANCE_REBOOT_ALLOWED,
1878
    HV_CPU_MASK: CPU_PINNING_ALL,
1879
    HV_CPU_TYPE: "",
1880
    HV_CPU_CORES: 0,
1881
    HV_CPU_THREADS: 0,
1882
    HV_CPU_SOCKETS: 0,
1883
    HV_SOUNDHW: "",
1884
    HV_USB_DEVICES: "",
1885
    HV_VGA: "",
1886
    HV_KVM_EXTRA: "",
1887
    HV_KVM_MACHINE_VERSION: "",
1888
    HV_VNET_HDR: True,
1889
    },
1890
  HT_FAKE: {
1891
    HV_MIGRATION_MODE: HT_MIGRATION_LIVE,
1892
  },
1893
  HT_CHROOT: {
1894
    HV_INIT_SCRIPT: "/ganeti-chroot",
1895
    },
1896
  HT_LXC: {
1897
    HV_CPU_MASK: "",
1898
    },
1899
  }
1900

    
1901
HVC_GLOBALS = compat.UniqueFrozenset([
1902
  HV_MIGRATION_PORT,
1903
  HV_MIGRATION_BANDWIDTH,
1904
  HV_MIGRATION_MODE,
1905
  HV_XEN_CMD,
1906
  ])
1907

    
1908
BEC_DEFAULTS = {
1909
  BE_MINMEM: 128,
1910
  BE_MAXMEM: 128,
1911
  BE_VCPUS: 1,
1912
  BE_AUTO_BALANCE: True,
1913
  BE_ALWAYS_FAILOVER: False,
1914
  BE_SPINDLE_USE: 1,
1915
  }
1916

    
1917
NDC_DEFAULTS = {
1918
  ND_OOB_PROGRAM: "",
1919
  ND_SPINDLE_COUNT: 1,
1920
  ND_EXCLUSIVE_STORAGE: False,
1921
  ND_OVS: False,
1922
  ND_OVS_NAME: DEFAULT_OVS,
1923
  ND_OVS_LINK: ""
1924
  }
1925

    
1926
NDC_GLOBALS = compat.UniqueFrozenset([
1927
  ND_EXCLUSIVE_STORAGE,
1928
  ])
1929

    
1930
DISK_LD_DEFAULTS = {
1931
  DT_DRBD8: {
1932
    LDP_RESYNC_RATE: CLASSIC_DRBD_SYNC_SPEED,
1933
    LDP_BARRIERS: _constants.DRBD_BARRIERS,
1934
    LDP_NO_META_FLUSH: _constants.DRBD_NO_META_FLUSH,
1935
    LDP_DEFAULT_METAVG: DEFAULT_VG,
1936
    LDP_DISK_CUSTOM: "",
1937
    LDP_NET_CUSTOM: "",
1938
    LDP_PROTOCOL: DRBD_DEFAULT_NET_PROTOCOL,
1939
    LDP_DYNAMIC_RESYNC: False,
1940

    
1941
    # The default values for the DRBD dynamic resync speed algorithm
1942
    # are taken from the drbsetup 8.3.11 man page, except for
1943
    # c-plan-ahead (that we don't need to set to 0, because we have a
1944
    # separate option to enable it) and for c-max-rate, that we cap to
1945
    # the default value for the static resync rate.
1946
    LDP_PLAN_AHEAD: 20, # ds
1947
    LDP_FILL_TARGET: 0, # sectors
1948
    LDP_DELAY_TARGET: 1, # ds
1949
    LDP_MAX_RATE: CLASSIC_DRBD_SYNC_SPEED, # KiB/s
1950
    LDP_MIN_RATE: 4 * 1024, # KiB/s
1951
    },
1952
  DT_PLAIN: {
1953
    LDP_STRIPES: _constants.LVM_STRIPECOUNT
1954
    },
1955
  DT_FILE: {},
1956
  DT_SHARED_FILE: {},
1957
  DT_BLOCK: {},
1958
  DT_RBD: {
1959
    LDP_POOL: "rbd",
1960
    LDP_ACCESS: DISK_KERNELSPACE,
1961
    },
1962
  DT_EXT: {},
1963
  }
1964

    
1965
# readability shortcuts
1966
_LV_DEFAULTS = DISK_LD_DEFAULTS[DT_PLAIN]
1967
_DRBD_DEFAULTS = DISK_LD_DEFAULTS[DT_DRBD8]
1968

    
1969
DISK_DT_DEFAULTS = {
1970
  DT_PLAIN: {
1971
    LV_STRIPES: DISK_LD_DEFAULTS[DT_PLAIN][LDP_STRIPES],
1972
    },
1973
  DT_DRBD8: {
1974
    DRBD_RESYNC_RATE: _DRBD_DEFAULTS[LDP_RESYNC_RATE],
1975
    DRBD_DATA_STRIPES: _LV_DEFAULTS[LDP_STRIPES],
1976
    DRBD_META_STRIPES: _LV_DEFAULTS[LDP_STRIPES],
1977
    DRBD_DISK_BARRIERS: _DRBD_DEFAULTS[LDP_BARRIERS],
1978
    DRBD_META_BARRIERS: _DRBD_DEFAULTS[LDP_NO_META_FLUSH],
1979
    DRBD_DEFAULT_METAVG: _DRBD_DEFAULTS[LDP_DEFAULT_METAVG],
1980
    DRBD_DISK_CUSTOM: _DRBD_DEFAULTS[LDP_DISK_CUSTOM],
1981
    DRBD_NET_CUSTOM: _DRBD_DEFAULTS[LDP_NET_CUSTOM],
1982
    DRBD_PROTOCOL: _DRBD_DEFAULTS[LDP_PROTOCOL],
1983
    DRBD_DYNAMIC_RESYNC: _DRBD_DEFAULTS[LDP_DYNAMIC_RESYNC],
1984
    DRBD_PLAN_AHEAD: _DRBD_DEFAULTS[LDP_PLAN_AHEAD],
1985
    DRBD_FILL_TARGET: _DRBD_DEFAULTS[LDP_FILL_TARGET],
1986
    DRBD_DELAY_TARGET: _DRBD_DEFAULTS[LDP_DELAY_TARGET],
1987
    DRBD_MAX_RATE: _DRBD_DEFAULTS[LDP_MAX_RATE],
1988
    DRBD_MIN_RATE: _DRBD_DEFAULTS[LDP_MIN_RATE],
1989
    },
1990
  DT_DISKLESS: {},
1991
  DT_FILE: {},
1992
  DT_SHARED_FILE: {},
1993
  DT_BLOCK: {},
1994
  DT_RBD: {
1995
    RBD_POOL: DISK_LD_DEFAULTS[DT_RBD][LDP_POOL],
1996
    RBD_ACCESS: DISK_LD_DEFAULTS[DT_RBD][LDP_ACCESS],
1997
    },
1998
  DT_EXT: {},
1999
  }
2000

    
2001
# we don't want to export the shortcuts
2002
del _LV_DEFAULTS, _DRBD_DEFAULTS
2003

    
2004
NICC_DEFAULTS = {
2005
  NIC_MODE: NIC_MODE_BRIDGED,
2006
  NIC_LINK: DEFAULT_BRIDGE,
2007
  NIC_VLAN: VALUE_HS_NOTHING,
2008
  }
2009

    
2010
# All of the following values are quite arbitrarily - there are no
2011
# "good" defaults, these must be customised per-site
2012
ISPECS_MINMAX_DEFAULTS = {
2013
  ISPECS_MIN: {
2014
    ISPEC_MEM_SIZE: 128,
2015
    ISPEC_CPU_COUNT: 1,
2016
    ISPEC_DISK_COUNT: 1,
2017
    ISPEC_DISK_SIZE: 1024,
2018
    ISPEC_NIC_COUNT: 1,
2019
    ISPEC_SPINDLE_USE: 1,
2020
    },
2021
  ISPECS_MAX: {
2022
    ISPEC_MEM_SIZE: 32768,
2023
    ISPEC_CPU_COUNT: 8,
2024
    ISPEC_DISK_COUNT: MAX_DISKS,
2025
    ISPEC_DISK_SIZE: 1024 * 1024,
2026
    ISPEC_NIC_COUNT: MAX_NICS,
2027
    ISPEC_SPINDLE_USE: 12,
2028
    },
2029
  }
2030
IPOLICY_DEFAULTS = {
2031
  ISPECS_MINMAX: [ISPECS_MINMAX_DEFAULTS],
2032
  ISPECS_STD: {
2033
    ISPEC_MEM_SIZE: 128,
2034
    ISPEC_CPU_COUNT: 1,
2035
    ISPEC_DISK_COUNT: 1,
2036
    ISPEC_DISK_SIZE: 1024,
2037
    ISPEC_NIC_COUNT: 1,
2038
    ISPEC_SPINDLE_USE: 1,
2039
    },
2040
  IPOLICY_DTS: list(DISK_TEMPLATES),
2041
  IPOLICY_VCPU_RATIO: 4.0,
2042
  IPOLICY_SPINDLE_RATIO: 32.0,
2043
  }
2044

    
2045
MASTER_POOL_SIZE_DEFAULT = 10
2046

    
2047
# Exclusive storage:
2048
# Error margin used to compare physical disks
2049
PART_MARGIN = .01
2050
# Space reserved when creating instance disks
2051
PART_RESERVED = .02
2052

    
2053
CONFD_PROTOCOL_VERSION = _constants.CONFD_PROTOCOL_VERSION
2054

    
2055
CONFD_REQ_PING = _constants.CONFD_REQ_PING
2056
CONFD_REQ_NODE_ROLE_BYNAME = _constants.CONFD_REQ_NODE_ROLE_BYNAME
2057
CONFD_REQ_NODE_PIP_BY_INSTANCE_IP = _constants.CONFD_REQ_NODE_PIP_BY_INSTANCE_IP
2058
CONFD_REQ_CLUSTER_MASTER = _constants.CONFD_REQ_CLUSTER_MASTER
2059
CONFD_REQ_NODE_PIP_LIST = _constants.CONFD_REQ_NODE_PIP_LIST
2060
CONFD_REQ_MC_PIP_LIST = _constants.CONFD_REQ_MC_PIP_LIST
2061
CONFD_REQ_INSTANCES_IPS_LIST = _constants.CONFD_REQ_INSTANCES_IPS_LIST
2062
CONFD_REQ_NODE_DRBD = _constants.CONFD_REQ_NODE_DRBD
2063
CONFD_REQ_NODE_INSTANCES = _constants.CONFD_REQ_NODE_INSTANCES
2064
CONFD_REQS = _constants.CONFD_REQS
2065

    
2066
# Confd request query fields. These are used to narrow down queries.
2067
# These must be strings rather than integers, because json-encoding
2068
# converts them to strings anyway, as they're used as dict-keys.
2069
CONFD_REQQ_LINK = _constants.CONFD_REQQ_LINK
2070
CONFD_REQQ_IP = _constants.CONFD_REQQ_IP
2071
CONFD_REQQ_IPLIST = _constants.CONFD_REQQ_IPLIST
2072
CONFD_REQQ_FIELDS = _constants.CONFD_REQQ_FIELDS
2073

    
2074
# FIXME: perhaps update code that uses these constants to deal with
2075
# integers instead of strings
2076
CONFD_REQFIELD_NAME = str(_constants.CONFD_REQFIELD_NAME)
2077
CONFD_REQFIELD_IP = str(_constants.CONFD_REQFIELD_IP)
2078
CONFD_REQFIELD_MNODE_PIP = str(_constants.CONFD_REQFIELD_MNODE_PIP)
2079

    
2080
CONFD_REPL_STATUS_OK = _constants.CONFD_REPL_STATUS_OK
2081
CONFD_REPL_STATUS_ERROR = _constants.CONFD_REPL_STATUS_ERROR
2082
CONFD_REPL_STATUS_NOTIMPLEMENTED = _constants.CONFD_REPL_STATUS_NOTIMPLEMENTED
2083
CONFD_REPL_STATUSES = _constants.CONFD_REPL_STATUSES
2084

    
2085
CONFD_NODE_ROLE_MASTER = _constants.CONFD_NODE_ROLE_MASTER
2086
CONFD_NODE_ROLE_CANDIDATE = _constants.CONFD_NODE_ROLE_CANDIDATE
2087
CONFD_NODE_ROLE_OFFLINE = _constants.CONFD_NODE_ROLE_OFFLINE
2088
CONFD_NODE_ROLE_DRAINED = _constants.CONFD_NODE_ROLE_DRAINED
2089
CONFD_NODE_ROLE_REGULAR = _constants.CONFD_NODE_ROLE_REGULAR
2090

    
2091
CONFD_ERROR_UNKNOWN_ENTRY = _constants.CONFD_ERROR_UNKNOWN_ENTRY
2092
CONFD_ERROR_INTERNAL = _constants.CONFD_ERROR_INTERNAL
2093
CONFD_ERROR_ARGUMENT = _constants.CONFD_ERROR_ARGUMENT
2094

    
2095
# Each request is "salted" by the current timestamp.
2096
# This constants decides how many seconds of skew to accept.
2097
# TODO: make this a default and allow the value to be more configurable
2098
CONFD_MAX_CLOCK_SKEW = _constants.CONFD_MAX_CLOCK_SKEW
2099

    
2100
# When we haven't reloaded the config for more than this amount of
2101
# seconds, we force a test to see if inotify is betraying us. Using a
2102
# prime number to ensure we get less chance of 'same wakeup' with
2103
# other processes.
2104
CONFD_CONFIG_RELOAD_TIMEOUT = _constants.CONFD_CONFIG_RELOAD_TIMEOUT
2105

    
2106
# If we receive more than one update in this amount of microseconds,
2107
# we move to polling every RATELIMIT seconds, rather than relying on
2108
# inotify, to be able to serve more requests.
2109
CONFD_CONFIG_RELOAD_RATELIMIT = _constants.CONFD_CONFIG_RELOAD_RATELIMIT
2110

    
2111
# Magic number prepended to all confd queries.
2112
# This allows us to distinguish different types of confd protocols and handle
2113
# them. For example by changing this we can move the whole payload to be
2114
# compressed, or move away from json.
2115
CONFD_MAGIC_FOURCC = _constants.CONFD_MAGIC_FOURCC
2116

    
2117
# By default a confd request is sent to the minimum between this number and all
2118
# MCs. 6 was chosen because even in the case of a disastrous 50% response rate,
2119
# we should have enough answers to be able to compare more than one.
2120
CONFD_DEFAULT_REQ_COVERAGE = _constants.CONFD_DEFAULT_REQ_COVERAGE
2121

    
2122
# Timeout in seconds to expire pending query request in the confd client
2123
# library. We don't actually expect any answer more than 10 seconds after we
2124
# sent a request.
2125
CONFD_CLIENT_EXPIRE_TIMEOUT = _constants.CONFD_CLIENT_EXPIRE_TIMEOUT
2126

    
2127
# Maximum UDP datagram size.
2128
# On IPv4: 64K - 20 (ip header size) - 8 (udp header size) = 65507
2129
# On IPv6: 64K - 40 (ip6 header size) - 8 (udp header size) = 65487
2130
#   (assuming we can't use jumbo frames)
2131
# We just set this to 60K, which should be enough
2132
MAX_UDP_DATA_SIZE = 61440
2133

    
2134
# User-id pool minimum/maximum acceptable user-ids.
2135
UIDPOOL_UID_MIN = 0
2136
UIDPOOL_UID_MAX = 2 ** 32 - 1 # Assuming 32 bit user-ids
2137

    
2138
# Name or path of the pgrep command
2139
PGREP = "pgrep"
2140

    
2141
# Name of the node group that gets created at cluster init or upgrade
2142
INITIAL_NODE_GROUP_NAME = "default"
2143

    
2144
# Possible values for NodeGroup.alloc_policy
2145
ALLOC_POLICY_PREFERRED = _constants.ALLOC_POLICY_PREFERRED
2146
ALLOC_POLICY_LAST_RESORT = _constants.ALLOC_POLICY_LAST_RESORT
2147
ALLOC_POLICY_UNALLOCABLE = _constants.ALLOC_POLICY_UNALLOCABLE
2148
VALID_ALLOC_POLICIES = _constants.VALID_ALLOC_POLICIES
2149

    
2150
# Temporary external/shared storage parameters
2151
BLOCKDEV_DRIVER_MANUAL = _constants.BLOCKDEV_DRIVER_MANUAL
2152

    
2153
# qemu-img path, required for ovfconverter
2154
QEMUIMG_PATH = _constants.QEMUIMG_PATH
2155

    
2156
# Whether htools was enabled at compilation time
2157
HTOOLS = _constants.HTOOLS
2158
# The hail iallocator
2159
IALLOC_HAIL = "hail"
2160

    
2161
# Fake opcodes for functions that have hooks attached to them via
2162
# backend.RunLocalHooks
2163
FAKE_OP_MASTER_TURNUP = "OP_CLUSTER_IP_TURNUP"
2164
FAKE_OP_MASTER_TURNDOWN = "OP_CLUSTER_IP_TURNDOWN"
2165

    
2166
# SSH key types
2167
SSHK_RSA = "rsa"
2168
SSHK_DSA = "dsa"
2169
SSHK_ALL = compat.UniqueFrozenset([SSHK_RSA, SSHK_DSA])
2170

    
2171
# SSH authorized key types
2172
SSHAK_RSA = "ssh-rsa"
2173
SSHAK_DSS = "ssh-dss"
2174
SSHAK_ALL = compat.UniqueFrozenset([SSHAK_RSA, SSHAK_DSS])
2175

    
2176
# SSH setup
2177
SSHS_CLUSTER_NAME = "cluster_name"
2178
SSHS_SSH_HOST_KEY = "ssh_host_key"
2179
SSHS_SSH_ROOT_KEY = "ssh_root_key"
2180
SSHS_NODE_DAEMON_CERTIFICATE = "node_daemon_certificate"
2181

    
2182
#: Key files for SSH daemon
2183
SSH_DAEMON_KEYFILES = {
2184
  SSHK_RSA: (pathutils.SSH_HOST_RSA_PRIV, pathutils.SSH_HOST_RSA_PUB),
2185
  SSHK_DSA: (pathutils.SSH_HOST_DSA_PRIV, pathutils.SSH_HOST_DSA_PUB),
2186
  }
2187

    
2188
# Node daemon setup
2189
NDS_CLUSTER_NAME = "cluster_name"
2190
NDS_NODE_DAEMON_CERTIFICATE = "node_daemon_certificate"
2191
NDS_SSCONF = "ssconf"
2192
NDS_START_NODE_DAEMON = "start_node_daemon"
2193

    
2194
# Path generating random UUID
2195
RANDOM_UUID_FILE = _constants.RANDOM_UUID_FILE
2196

    
2197
# Regex string for verifying a UUID
2198
UUID_REGEX = "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
2199

    
2200
# Auto-repair tag prefixes
2201
AUTO_REPAIR_TAG_PREFIX = _constants.AUTO_REPAIR_TAG_PREFIX
2202
AUTO_REPAIR_TAG_ENABLED = _constants.AUTO_REPAIR_TAG_ENABLED
2203
AUTO_REPAIR_TAG_SUSPENDED = _constants.AUTO_REPAIR_TAG_SUSPENDED
2204
AUTO_REPAIR_TAG_PENDING = _constants.AUTO_REPAIR_TAG_PENDING
2205
AUTO_REPAIR_TAG_RESULT = _constants.AUTO_REPAIR_TAG_RESULT
2206

    
2207
# Auto-repair levels
2208
AUTO_REPAIR_FIX_STORAGE = _constants.AUTO_REPAIR_FIX_STORAGE
2209
AUTO_REPAIR_MIGRATE = _constants.AUTO_REPAIR_MIGRATE
2210
AUTO_REPAIR_FAILOVER = _constants.AUTO_REPAIR_FAILOVER
2211
AUTO_REPAIR_REINSTALL = _constants.AUTO_REPAIR_REINSTALL
2212
AUTO_REPAIR_ALL_TYPES = _constants.AUTO_REPAIR_ALL_TYPES
2213

    
2214
# Auto-repair results
2215
AUTO_REPAIR_SUCCESS = _constants.AUTO_REPAIR_SUCCESS
2216
AUTO_REPAIR_FAILURE = _constants.AUTO_REPAIR_FAILURE
2217
AUTO_REPAIR_ENOPERM = _constants.AUTO_REPAIR_ENOPERM
2218
AUTO_REPAIR_ALL_RESULTS = _constants.AUTO_REPAIR_ALL_RESULTS
2219

    
2220
# The version identifier for builtin data collectors
2221
BUILTIN_DATA_COLLECTOR_VERSION = _constants.BUILTIN_DATA_COLLECTOR_VERSION
2222

    
2223
# The reason trail opcode parameter name
2224
OPCODE_REASON = _constants.OPCODE_REASON
2225

    
2226
# The source reasons for the execution of an OpCode
2227
OPCODE_REASON_SRC_CLIENT = "gnt:client"
2228
OPCODE_REASON_SRC_NODED = "gnt:daemon:noded"
2229
OPCODE_REASON_SRC_OPCODE = "gnt:opcode"
2230
OPCODE_REASON_SRC_RLIB2 = "gnt:library:rlib2"
2231
OPCODE_REASON_SRC_USER = "gnt:user"
2232

    
2233
OPCODE_REASON_SOURCES = compat.UniqueFrozenset([
2234
  OPCODE_REASON_SRC_CLIENT,
2235
  OPCODE_REASON_SRC_NODED,
2236
  OPCODE_REASON_SRC_OPCODE,
2237
  OPCODE_REASON_SRC_RLIB2,
2238
  OPCODE_REASON_SRC_USER,
2239
  ])
2240

    
2241
DISKSTATS_FILE = _constants.DISKSTATS_FILE
2242

    
2243
# CPU load collector variables
2244
STAT_FILE = _constants.STAT_FILE
2245
CPUAVGLOAD_BUFFER_SIZE = _constants.CPUAVGLOAD_BUFFER_SIZE
2246
CPUAVGLOAD_WINDOW_SIZE = _constants.CPUAVGLOAD_WINDOW_SIZE
2247

    
2248
# Mond's variable for periodical data collection
2249
MOND_TIME_INTERVAL = _constants.MOND_TIME_INTERVAL
2250

    
2251
# MonD's latest API version
2252
MOND_LATEST_API_VERSION = 1
2253

    
2254
# Timeouts for upgrades
2255

    
2256
UPGRADE_QUEUE_DRAIN_TIMEOUT = _constants.UPGRADE_QUEUE_DRAIN_TIMEOUT
2257
UPGRADE_QUEUE_POLL_INTERVAL = _constants.UPGRADE_QUEUE_POLL_INTERVAL
2258

    
2259
# Do not re-export imported modules
2260
del re, _vcsversion, _constants, socket, pathutils, compat
2261

    
2262

    
2263
ALLOCATABLE_KEY = "allocatable"
2264
FAILED_KEY = "failed"