Statistics
| Branch: | Tag: | Revision:

root / lib / constants.py @ 690e509d

History | View | Annotate | Download (63.3 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 = 10
36
OS_API_V15 = 15
37
OS_API_V20 = 20
38
OS_API_VERSIONS = compat.UniqueFrozenset([
39
  OS_API_V10,
40
  OS_API_V15,
41
  OS_API_V20,
42
  ])
43
VCS_VERSION = _vcsversion.VCS_VERSION
44
EXPORT_VERSION = 0
45
RAPI_VERSION = 2
46

    
47
CONFIG_MAJOR = _constants.CONFIG_MAJOR
48
CONFIG_MINOR = _constants.CONFIG_MINOR
49
CONFIG_REVISION = _constants.CONFIG_REVISION
50
CONFIG_VERSION = _constants.CONFIG_VERSION
51

    
52
#: RPC protocol version
53
PROTOCOL_VERSION = _constants.PROTOCOL_VERSION
54

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

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

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

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

    
96
# Wipe
97
DD_CMD = "dd"
98
MAX_WIPE_CHUNK = 1024 # 1GB
99
MIN_WIPE_CHUNK_PERCENT = 10
100

    
101
RUN_DIRS_MODE = 0775
102
SECURE_DIR_MODE = 0700
103
SECURE_FILE_MODE = 0600
104
ADOPTABLE_BLOCKDEV_ROOT = "/dev/disk/"
105
ENABLE_CONFD = _constants.ENABLE_CONFD
106
ENABLE_MOND = _constants.ENABLE_MOND
107
ENABLE_SPLIT_QUERY = _constants.ENABLE_SPLIT_QUERY
108
ENABLE_RESTRICTED_COMMANDS = _constants.ENABLE_RESTRICTED_COMMANDS
109

    
110
# SSH constants
111
SSH = _constants.SSH
112
SCP = _constants.SCP
113

    
114
NODED = _constants.NODED
115
CONFD = _constants.CONFD
116
LUXID = _constants.LUXID
117
RAPI = _constants.RAPI
118
MASTERD = _constants.MASTERD
119
MOND = _constants.MOND
120

    
121
DAEMONS = _constants.DAEMONS
122

    
123
DAEMONS_PORTS = _constants.DAEMONS_PORTS
124

    
125
DEFAULT_NODED_PORT = _constants.DEFAULT_NODED_PORT
126
DEFAULT_CONFD_PORT = _constants.DEFAULT_CONFD_PORT
127
DEFAULT_MOND_PORT = _constants.DEFAULT_MOND_PORT
128
DEFAULT_RAPI_PORT = _constants.DEFAULT_RAPI_PORT
129

    
130
FIRST_DRBD_PORT = 11000
131
LAST_DRBD_PORT = 14999
132

    
133
DAEMONS_LOGBASE = _constants.DAEMONS_LOGBASE
134

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

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

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

    
147
VALID_EXTRA_LOGREASONS = compat.UniqueFrozenset([
148
  EXTRA_LOGREASON_ACCESS,
149
  EXTRA_LOGREASON_ERROR,
150
  ])
151

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

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

    
166
DEV_CONSOLE = _constants.DEV_CONSOLE
167

    
168
PROC_MOUNTS = "/proc/mounts"
169

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

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

    
185
EXPORT_CONF_FILE = "config.ini"
186

    
187
XEN_BOOTLOADER = _constants.XEN_BOOTLOADER
188
XEN_KERNEL = _constants.XEN_KERNEL
189
XEN_INITRD = _constants.XEN_INITRD
190
XEN_CMD_XM = _constants.XEN_CMD_XM
191
XEN_CMD_XL = _constants.XEN_CMD_XL
192
KNOWN_XEN_COMMANDS = _constants.KNOWN_XEN_COMMANDS
193

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

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

    
212
#: Console as SSH command
213
CONS_SSH = "ssh"
214

    
215
#: Console as VNC server
216
CONS_VNC = "vnc"
217

    
218
#: Console as SPICE server
219
CONS_SPICE = "spice"
220

    
221
#: Display a message for console access
222
CONS_MESSAGE = "msg"
223

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

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

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

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

    
248
# Default validity of certificates in days
249
X509_CERT_DEFAULT_VALIDITY = 365 * 5
250

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

    
254
X509_CERT_SIGNATURE_HEADER = "X-Ganeti-Signature"
255

    
256
# Import/export daemon mode
257
IEM_IMPORT = "import"
258
IEM_EXPORT = "export"
259

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

    
268
IE_CUSTOM_SIZE = "fd"
269

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

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

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

    
288

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

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

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

    
307
HKR_SKIP = 0
308
HKR_FAIL = 1
309
HKR_SUCCESS = 2
310

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

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

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

    
336
# Storage operations
337
SO_FIX_CONSISTENCY = "fix-consistency"
338

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

    
350
MODIFIABLE_STORAGE_FIELDS = {
351
  ST_LVM_PV: frozenset([SF_ALLOCATABLE]),
352
  }
353

    
354
VALID_STORAGE_OPERATIONS = {
355
  ST_LVM_VG: frozenset([SO_FIX_CONSISTENCY]),
356
  }
357

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    
487
#: Size of DRBD meta block device
488
DRBD_META_SIZE = 128
489

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

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

    
508
# rbd tool command
509
RBD_CMD = "rbd"
510

    
511
# file backend driver
512
FD_BLKTAP = _constants.FD_BLKTAP
513
FD_LOOP = _constants.FD_LOOP
514

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

    
518
# disk access mode
519
DISK_RDONLY = _constants.DISK_RDONLY
520
DISK_RDWR = _constants.DISK_RDWR
521
DISK_ACCESS_SET = _constants.DISK_ACCESS_SET
522

    
523
# disk replacement mode
524
REPLACE_DISK_PRI = "replace_on_primary"    # replace disks on primary
525
REPLACE_DISK_SEC = "replace_on_secondary"  # replace disks on secondary
526
REPLACE_DISK_CHG = "replace_new_secondary" # change secondary node
527
REPLACE_DISK_AUTO = "replace_auto"
528
REPLACE_MODES = compat.UniqueFrozenset([
529
  REPLACE_DISK_PRI,
530
  REPLACE_DISK_SEC,
531
  REPLACE_DISK_CHG,
532
  REPLACE_DISK_AUTO,
533
  ])
534

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    
601
MAX_TAG_LEN = _constants.MAX_TAG_LEN
602
MAX_TAGS_PER_OBJ = _constants.MAX_TAGS_PER_OBJ
603

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

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

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

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

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

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

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

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

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

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

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

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

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

    
709
ES_PARAMETERS_FILE = "parameters.list"
710

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

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

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

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

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

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

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

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

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

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

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

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

    
939
# KVM-specific statuses
940
HV_KVM_MIGRATION_VALID_STATUSES = HV_MIGRATION_VALID_STATUSES
941

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    
1164
DISK_DT_PARAMETERS = frozenset(DISK_DT_TYPES.keys())
1165

    
1166
# dynamic disk parameters
1167
DDP_LOCAL_IP = "local-ip"
1168
DDP_REMOTE_IP = "remote-ip"
1169
DDP_PORT = "port"
1170
DDP_LOCAL_MINOR = "local-minor"
1171
DDP_REMOTE_MINOR = "remote-minor"
1172

    
1173
# OOB supported commands
1174
OOB_POWER_ON = _constants.OOB_POWER_ON
1175
OOB_POWER_OFF = _constants.OOB_POWER_OFF
1176
OOB_POWER_CYCLE = _constants.OOB_POWER_CYCLE
1177
OOB_POWER_STATUS = _constants.OOB_POWER_STATUS
1178
OOB_HEALTH = _constants.OOB_HEALTH
1179
OOB_COMMANDS = _constants.OOB_COMMANDS
1180

    
1181
OOB_POWER_STATUS_POWERED = _constants.OOB_POWER_STATUS_POWERED
1182

    
1183
OOB_TIMEOUT = _constants.OOB_TIMEOUT
1184
OOB_POWER_DELAY = _constants.OOB_POWER_DELAY
1185

    
1186
OOB_STATUS_OK = _constants.OOB_STATUS_OK
1187
OOB_STATUS_WARNING = _constants.OOB_STATUS_WARNING
1188
OOB_STATUS_CRITICAL = _constants.OOB_STATUS_CRITICAL
1189
OOB_STATUS_UNKNOWN = _constants.OOB_STATUS_UNKNOWN
1190
OOB_STATUSES = _constants.OOB_STATUSES
1191

    
1192
# Instance Parameters Profile
1193
PP_DEFAULT = "default"
1194

    
1195
# NIC_* constants are used inside the ganeti config
1196
NIC_MODE = _constants.NIC_MODE
1197
NIC_LINK = _constants.NIC_LINK
1198
NIC_VLAN = _constants.NIC_VLAN
1199

    
1200
NIC_MODE_BRIDGED = _constants.NIC_MODE_BRIDGED
1201
NIC_MODE_ROUTED = _constants.NIC_MODE_ROUTED
1202
NIC_MODE_OVS = _constants.NIC_MODE_OVS
1203
NIC_IP_POOL = _constants.NIC_IP_POOL
1204
NIC_VALID_MODES = _constants.NIC_VALID_MODES
1205

    
1206
RESERVE_ACTION = "reserve"
1207
RELEASE_ACTION = "release"
1208

    
1209
NICS_PARAMETER_TYPES = {
1210
  NIC_MODE: VTYPE_STRING,
1211
  NIC_LINK: VTYPE_STRING,
1212
  NIC_VLAN: VTYPE_MAYBE_STRING,
1213
  }
1214

    
1215
NICS_PARAMETERS = frozenset(NICS_PARAMETER_TYPES.keys())
1216

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

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

    
1259
# Hypervisor constants
1260
HT_XEN_PVM = _constants.HT_XEN_PVM
1261
HT_FAKE = _constants.HT_FAKE
1262
HT_XEN_HVM = _constants.HT_XEN_HVM
1263
HT_KVM = _constants.HT_KVM
1264
HT_CHROOT = _constants.HT_CHROOT
1265
HT_LXC = _constants.HT_LXC
1266
HYPER_TYPES = _constants.HYPER_TYPES
1267
HTS_REQ_PORT = _constants.HTS_REQ_PORT
1268

    
1269
VNC_BASE_PORT = 5900
1270
VNC_DEFAULT_BIND_ADDRESS = IP4_ADDRESS_ANY
1271

    
1272
# NIC types
1273
HT_NIC_RTL8139 = "rtl8139"
1274
HT_NIC_NE2K_PCI = "ne2k_pci"
1275
HT_NIC_NE2K_ISA = "ne2k_isa"
1276
HT_NIC_I82551 = "i82551"
1277
HT_NIC_I85557B = "i82557b"
1278
HT_NIC_I8259ER = "i82559er"
1279
HT_NIC_PCNET = "pcnet"
1280
HT_NIC_E1000 = "e1000"
1281
HT_NIC_PARAVIRTUAL = HT_DISK_PARAVIRTUAL = "paravirtual"
1282

    
1283
HT_HVM_VALID_NIC_TYPES = compat.UniqueFrozenset([
1284
  HT_NIC_RTL8139,
1285
  HT_NIC_NE2K_PCI,
1286
  HT_NIC_E1000,
1287
  HT_NIC_NE2K_ISA,
1288
  HT_NIC_PARAVIRTUAL,
1289
  ])
1290
HT_KVM_VALID_NIC_TYPES = compat.UniqueFrozenset([
1291
  HT_NIC_RTL8139,
1292
  HT_NIC_NE2K_PCI,
1293
  HT_NIC_NE2K_ISA,
1294
  HT_NIC_I82551,
1295
  HT_NIC_I85557B,
1296
  HT_NIC_I8259ER,
1297
  HT_NIC_PCNET,
1298
  HT_NIC_E1000,
1299
  HT_NIC_PARAVIRTUAL,
1300
  ])
1301

    
1302
# Vif types
1303
# default vif type in xen-hvm
1304
HT_HVM_VIF_IOEMU = "ioemu"
1305
HT_HVM_VIF_VIF = "vif"
1306
HT_HVM_VALID_VIF_TYPES = compat.UniqueFrozenset([
1307
  HT_HVM_VIF_IOEMU,
1308
  HT_HVM_VIF_VIF,
1309
  ])
1310

    
1311
# Disk types
1312
HT_DISK_IOEMU = "ioemu"
1313
HT_DISK_IDE = "ide"
1314
HT_DISK_SCSI = "scsi"
1315
HT_DISK_SD = "sd"
1316
HT_DISK_MTD = "mtd"
1317
HT_DISK_PFLASH = "pflash"
1318

    
1319
HT_CACHE_DEFAULT = "default"
1320
HT_CACHE_NONE = "none"
1321
HT_CACHE_WTHROUGH = "writethrough"
1322
HT_CACHE_WBACK = "writeback"
1323
HT_VALID_CACHE_TYPES = compat.UniqueFrozenset([
1324
  HT_CACHE_DEFAULT,
1325
  HT_CACHE_NONE,
1326
  HT_CACHE_WTHROUGH,
1327
  HT_CACHE_WBACK,
1328
  ])
1329

    
1330
HT_HVM_VALID_DISK_TYPES = compat.UniqueFrozenset([
1331
  HT_DISK_PARAVIRTUAL,
1332
  HT_DISK_IOEMU,
1333
  ])
1334
HT_KVM_VALID_DISK_TYPES = compat.UniqueFrozenset([
1335
  HT_DISK_PARAVIRTUAL,
1336
  HT_DISK_IDE,
1337
  HT_DISK_SCSI,
1338
  HT_DISK_SD,
1339
  HT_DISK_MTD,
1340
  HT_DISK_PFLASH,
1341
  ])
1342

    
1343
# Mouse types:
1344
HT_MOUSE_MOUSE = "mouse"
1345
HT_MOUSE_TABLET = "tablet"
1346

    
1347
HT_KVM_VALID_MOUSE_TYPES = compat.UniqueFrozenset([
1348
  HT_MOUSE_MOUSE,
1349
  HT_MOUSE_TABLET,
1350
  ])
1351

    
1352
# Boot order
1353
HT_BO_FLOPPY = "floppy"
1354
HT_BO_CDROM = "cdrom"
1355
HT_BO_DISK = "disk"
1356
HT_BO_NETWORK = "network"
1357

    
1358
HT_KVM_VALID_BO_TYPES = compat.UniqueFrozenset([
1359
  HT_BO_FLOPPY,
1360
  HT_BO_CDROM,
1361
  HT_BO_DISK,
1362
  HT_BO_NETWORK,
1363
  ])
1364

    
1365
# SPICE lossless image compression options
1366
HT_KVM_SPICE_LOSSLESS_IMG_COMPR_AUTO_GLZ = "auto_glz"
1367
HT_KVM_SPICE_LOSSLESS_IMG_COMPR_AUTO_LZ = "auto_lz"
1368
HT_KVM_SPICE_LOSSLESS_IMG_COMPR_QUIC = "quic"
1369
HT_KVM_SPICE_LOSSLESS_IMG_COMPR_GLZ = "glz"
1370
HT_KVM_SPICE_LOSSLESS_IMG_COMPR_LZ = "lz"
1371
HT_KVM_SPICE_LOSSLESS_IMG_COMPR_OFF = "off"
1372

    
1373
HT_KVM_SPICE_VALID_LOSSLESS_IMG_COMPR_OPTIONS = compat.UniqueFrozenset([
1374
  HT_KVM_SPICE_LOSSLESS_IMG_COMPR_AUTO_GLZ,
1375
  HT_KVM_SPICE_LOSSLESS_IMG_COMPR_AUTO_LZ,
1376
  HT_KVM_SPICE_LOSSLESS_IMG_COMPR_QUIC,
1377
  HT_KVM_SPICE_LOSSLESS_IMG_COMPR_GLZ,
1378
  HT_KVM_SPICE_LOSSLESS_IMG_COMPR_LZ,
1379
  HT_KVM_SPICE_LOSSLESS_IMG_COMPR_OFF,
1380
  ])
1381

    
1382
# SPICE lossy image compression options (valid for both jpeg and zlib-glz)
1383
HT_KVM_SPICE_LOSSY_IMG_COMPR_AUTO = "auto"
1384
HT_KVM_SPICE_LOSSY_IMG_COMPR_NEVER = "never"
1385
HT_KVM_SPICE_LOSSY_IMG_COMPR_ALWAYS = "always"
1386

    
1387
HT_KVM_SPICE_VALID_LOSSY_IMG_COMPR_OPTIONS = compat.UniqueFrozenset([
1388
  HT_KVM_SPICE_LOSSY_IMG_COMPR_AUTO,
1389
  HT_KVM_SPICE_LOSSY_IMG_COMPR_NEVER,
1390
  HT_KVM_SPICE_LOSSY_IMG_COMPR_ALWAYS,
1391
  ])
1392

    
1393
# SPICE video stream detection
1394
HT_KVM_SPICE_VIDEO_STREAM_DETECTION_OFF = "off"
1395
HT_KVM_SPICE_VIDEO_STREAM_DETECTION_ALL = "all"
1396
HT_KVM_SPICE_VIDEO_STREAM_DETECTION_FILTER = "filter"
1397

    
1398
HT_KVM_SPICE_VALID_VIDEO_STREAM_DETECTION_OPTIONS = compat.UniqueFrozenset([
1399
  HT_KVM_SPICE_VIDEO_STREAM_DETECTION_OFF,
1400
  HT_KVM_SPICE_VIDEO_STREAM_DETECTION_ALL,
1401
  HT_KVM_SPICE_VIDEO_STREAM_DETECTION_FILTER,
1402
  ])
1403

    
1404
# Security models
1405
HT_SM_NONE = "none"
1406
HT_SM_USER = "user"
1407
HT_SM_POOL = "pool"
1408

    
1409
HT_KVM_VALID_SM_TYPES = compat.UniqueFrozenset([
1410
  HT_SM_NONE,
1411
  HT_SM_USER,
1412
  HT_SM_POOL,
1413
  ])
1414

    
1415
# Kvm flag values
1416
HT_KVM_ENABLED = "enabled"
1417
HT_KVM_DISABLED = "disabled"
1418

    
1419
HT_KVM_FLAG_VALUES = compat.UniqueFrozenset([HT_KVM_ENABLED, HT_KVM_DISABLED])
1420

    
1421
# Migration type
1422
HT_MIGRATION_LIVE = _constants.HT_MIGRATION_LIVE
1423
HT_MIGRATION_NONLIVE = _constants.HT_MIGRATION_NONLIVE
1424
HT_MIGRATION_MODES = _constants.HT_MIGRATION_MODES
1425

    
1426
# Cluster Verify steps
1427
VERIFY_NPLUSONE_MEM = _constants.VERIFY_NPLUSONE_MEM
1428
VERIFY_OPTIONAL_CHECKS = _constants.VERIFY_OPTIONAL_CHECKS
1429

    
1430
# Cluster Verify error classes
1431
CV_TCLUSTER = _constants.CV_TCLUSTER
1432
CV_TGROUP = _constants.CV_TGROUP
1433
CV_TNODE = _constants.CV_TNODE
1434
CV_TINSTANCE = _constants.CV_TINSTANCE
1435

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

    
1477
CV_ALL_ECODES = _constants.CV_ALL_ECODES
1478
CV_ALL_ECODES_STRINGS = _constants.CV_ALL_ECODES_STRINGS
1479

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

    
1508
# Instance status
1509
INSTST_RUNNING = _constants.INSTST_RUNNING
1510
INSTST_ADMINDOWN = _constants.INSTST_ADMINDOWN
1511
INSTST_ADMINOFFLINE = _constants.INSTST_ADMINOFFLINE
1512
INSTST_NODEOFFLINE = _constants.INSTST_NODEOFFLINE
1513
INSTST_NODEDOWN = _constants.INSTST_NODEDOWN
1514
INSTST_WRONGNODE = _constants.INSTST_WRONGNODE
1515
INSTST_ERRORUP = _constants.INSTST_ERRORUP
1516
INSTST_ERRORDOWN = _constants.INSTST_ERRORDOWN
1517
INSTST_ALL = _constants.INSTST_ALL
1518

    
1519
# Admin states
1520
ADMINST_UP = _constants.ADMINST_UP
1521
ADMINST_DOWN = _constants.ADMINST_DOWN
1522
ADMINST_OFFLINE = _constants.ADMINST_OFFLINE
1523
ADMINST_ALL = _constants.ADMINST_ALL
1524

    
1525
# Node roles
1526
NR_REGULAR = _constants.NR_REGULAR
1527
NR_MASTER = _constants.NR_MASTER
1528
NR_MCANDIDATE = _constants.NR_MCANDIDATE
1529
NR_DRAINED = _constants.NR_DRAINED
1530
NR_OFFLINE = _constants.NR_OFFLINE
1531
NR_ALL = _constants.NR_ALL
1532

    
1533
# SSL certificate check constants (in days)
1534
SSL_CERT_EXPIRATION_WARN = 30
1535
SSL_CERT_EXPIRATION_ERROR = 7
1536

    
1537
# Allocator framework constants
1538
IALLOCATOR_VERSION = _constants.IALLOCATOR_VERSION
1539
IALLOCATOR_DIR_IN = _constants.IALLOCATOR_DIR_IN
1540
IALLOCATOR_DIR_OUT = _constants.IALLOCATOR_DIR_OUT
1541
VALID_IALLOCATOR_DIRECTIONS = _constants.VALID_IALLOCATOR_DIRECTIONS
1542

    
1543
IALLOCATOR_MODE_ALLOC = _constants.IALLOCATOR_MODE_ALLOC
1544
IALLOCATOR_MODE_RELOC = _constants.IALLOCATOR_MODE_RELOC
1545
IALLOCATOR_MODE_CHG_GROUP = _constants.IALLOCATOR_MODE_CHG_GROUP
1546
IALLOCATOR_MODE_NODE_EVAC = _constants.IALLOCATOR_MODE_NODE_EVAC
1547
IALLOCATOR_MODE_MULTI_ALLOC = _constants.IALLOCATOR_MODE_MULTI_ALLOC
1548
VALID_IALLOCATOR_MODES = _constants.VALID_IALLOCATOR_MODES
1549

    
1550
IALLOCATOR_SEARCH_PATH = _constants.IALLOCATOR_SEARCH_PATH
1551
DEFAULT_IALLOCATOR_SHORTCUT = _constants.DEFAULT_IALLOCATOR_SHORTCUT
1552

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

    
1897
HVC_GLOBALS = compat.UniqueFrozenset([
1898
  HV_MIGRATION_PORT,
1899
  HV_MIGRATION_BANDWIDTH,
1900
  HV_MIGRATION_MODE,
1901
  HV_XEN_CMD,
1902
  ])
1903

    
1904
BEC_DEFAULTS = {
1905
  BE_MINMEM: 128,
1906
  BE_MAXMEM: 128,
1907
  BE_VCPUS: 1,
1908
  BE_AUTO_BALANCE: True,
1909
  BE_ALWAYS_FAILOVER: False,
1910
  BE_SPINDLE_USE: 1,
1911
  }
1912

    
1913
NDC_DEFAULTS = {
1914
  ND_OOB_PROGRAM: "",
1915
  ND_SPINDLE_COUNT: 1,
1916
  ND_EXCLUSIVE_STORAGE: False,
1917
  ND_OVS: False,
1918
  ND_OVS_NAME: DEFAULT_OVS,
1919
  ND_OVS_LINK: ""
1920
  }
1921

    
1922
NDC_GLOBALS = compat.UniqueFrozenset([
1923
  ND_EXCLUSIVE_STORAGE,
1924
  ])
1925

    
1926
DISK_LD_DEFAULTS = {
1927
  DT_DRBD8: {
1928
    LDP_RESYNC_RATE: CLASSIC_DRBD_SYNC_SPEED,
1929
    LDP_BARRIERS: _constants.DRBD_BARRIERS,
1930
    LDP_NO_META_FLUSH: _constants.DRBD_NO_META_FLUSH,
1931
    LDP_DEFAULT_METAVG: DEFAULT_VG,
1932
    LDP_DISK_CUSTOM: "",
1933
    LDP_NET_CUSTOM: "",
1934
    LDP_PROTOCOL: DRBD_DEFAULT_NET_PROTOCOL,
1935
    LDP_DYNAMIC_RESYNC: False,
1936

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

    
1960
# readability shortcuts
1961
_LV_DEFAULTS = DISK_LD_DEFAULTS[DT_PLAIN]
1962
_DRBD_DEFAULTS = DISK_LD_DEFAULTS[DT_DRBD8]
1963

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

    
1995
# we don't want to export the shortcuts
1996
del _LV_DEFAULTS, _DRBD_DEFAULTS
1997

    
1998
NICC_DEFAULTS = {
1999
  NIC_MODE: NIC_MODE_BRIDGED,
2000
  NIC_LINK: DEFAULT_BRIDGE,
2001
  NIC_VLAN: VALUE_HS_NOTHING,
2002
  }
2003

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

    
2039
MASTER_POOL_SIZE_DEFAULT = 10
2040

    
2041
# Exclusive storage:
2042
# Error margin used to compare physical disks
2043
PART_MARGIN = .01
2044
# Space reserved when creating instance disks
2045
PART_RESERVED = .02
2046

    
2047
CONFD_PROTOCOL_VERSION = 1
2048

    
2049
CONFD_REQ_PING = 0
2050
CONFD_REQ_NODE_ROLE_BYNAME = 1
2051
CONFD_REQ_NODE_PIP_BY_INSTANCE_IP = 2
2052
CONFD_REQ_CLUSTER_MASTER = 3
2053
CONFD_REQ_NODE_PIP_LIST = 4
2054
CONFD_REQ_MC_PIP_LIST = 5
2055
CONFD_REQ_INSTANCES_IPS_LIST = 6
2056
CONFD_REQ_NODE_DRBD = 7
2057
CONFD_REQ_NODE_INSTANCES = 8
2058

    
2059
# Confd request query fields. These are used to narrow down queries.
2060
# These must be strings rather than integers, because json-encoding
2061
# converts them to strings anyway, as they're used as dict-keys.
2062
CONFD_REQQ_LINK = "0"
2063
CONFD_REQQ_IP = "1"
2064
CONFD_REQQ_IPLIST = "2"
2065
CONFD_REQQ_FIELDS = "3"
2066

    
2067
CONFD_REQFIELD_NAME = "0"
2068
CONFD_REQFIELD_IP = "1"
2069
CONFD_REQFIELD_MNODE_PIP = "2"
2070

    
2071
CONFD_REQS = compat.UniqueFrozenset([
2072
  CONFD_REQ_PING,
2073
  CONFD_REQ_NODE_ROLE_BYNAME,
2074
  CONFD_REQ_NODE_PIP_BY_INSTANCE_IP,
2075
  CONFD_REQ_CLUSTER_MASTER,
2076
  CONFD_REQ_NODE_PIP_LIST,
2077
  CONFD_REQ_MC_PIP_LIST,
2078
  CONFD_REQ_INSTANCES_IPS_LIST,
2079
  CONFD_REQ_NODE_DRBD,
2080
  ])
2081

    
2082
CONFD_REPL_STATUS_OK = 0
2083
CONFD_REPL_STATUS_ERROR = 1
2084
CONFD_REPL_STATUS_NOTIMPLEMENTED = 2
2085

    
2086
CONFD_REPL_STATUSES = compat.UniqueFrozenset([
2087
  CONFD_REPL_STATUS_OK,
2088
  CONFD_REPL_STATUS_ERROR,
2089
  CONFD_REPL_STATUS_NOTIMPLEMENTED,
2090
  ])
2091

    
2092
(CONFD_NODE_ROLE_MASTER,
2093
 CONFD_NODE_ROLE_CANDIDATE,
2094
 CONFD_NODE_ROLE_OFFLINE,
2095
 CONFD_NODE_ROLE_DRAINED,
2096
 CONFD_NODE_ROLE_REGULAR,
2097
 ) = range(5)
2098

    
2099
# A few common errors for confd
2100
CONFD_ERROR_UNKNOWN_ENTRY = _constants.CONFD_ERROR_UNKNOWN_ENTRY
2101
CONFD_ERROR_INTERNAL = _constants.CONFD_ERROR_INTERNAL
2102
CONFD_ERROR_ARGUMENT = _constants.CONFD_ERROR_ARGUMENT
2103

    
2104
# Each request is "salted" by the current timestamp.
2105
# This constants decides how many seconds of skew to accept.
2106
# TODO: make this a default and allow the value to be more configurable
2107
CONFD_MAX_CLOCK_SKEW = _constants.CONFD_MAX_CLOCK_SKEW
2108

    
2109
# When we haven't reloaded the config for more than this amount of
2110
# seconds, we force a test to see if inotify is betraying us. Using a
2111
# prime number to ensure we get less chance of 'same wakeup' with
2112
# other processes.
2113
CONFD_CONFIG_RELOAD_TIMEOUT = _constants.CONFD_CONFIG_RELOAD_TIMEOUT
2114

    
2115
# If we receive more than one update in this amount of microseconds,
2116
# we move to polling every RATELIMIT seconds, rather than relying on
2117
# inotify, to be able to serve more requests.
2118
CONFD_CONFIG_RELOAD_RATELIMIT = _constants.CONFD_CONFIG_RELOAD_RATELIMIT
2119

    
2120
# Magic number prepended to all confd queries.
2121
# This allows us to distinguish different types of confd protocols and handle
2122
# them. For example by changing this we can move the whole payload to be
2123
# compressed, or move away from json.
2124
CONFD_MAGIC_FOURCC = _constants.CONFD_MAGIC_FOURCC
2125

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

    
2131
# Timeout in seconds to expire pending query request in the confd client
2132
# library. We don't actually expect any answer more than 10 seconds after we
2133
# sent a request.
2134
CONFD_CLIENT_EXPIRE_TIMEOUT = _constants.CONFD_CLIENT_EXPIRE_TIMEOUT
2135

    
2136
# Maximum UDP datagram size.
2137
# On IPv4: 64K - 20 (ip header size) - 8 (udp header size) = 65507
2138
# On IPv6: 64K - 40 (ip6 header size) - 8 (udp header size) = 65487
2139
#   (assuming we can't use jumbo frames)
2140
# We just set this to 60K, which should be enough
2141
MAX_UDP_DATA_SIZE = 61440
2142

    
2143
# User-id pool minimum/maximum acceptable user-ids.
2144
UIDPOOL_UID_MIN = 0
2145
UIDPOOL_UID_MAX = 2 ** 32 - 1 # Assuming 32 bit user-ids
2146

    
2147
# Name or path of the pgrep command
2148
PGREP = "pgrep"
2149

    
2150
# Name of the node group that gets created at cluster init or upgrade
2151
INITIAL_NODE_GROUP_NAME = "default"
2152

    
2153
# Possible values for NodeGroup.alloc_policy
2154
ALLOC_POLICY_PREFERRED = _constants.ALLOC_POLICY_PREFERRED
2155
ALLOC_POLICY_LAST_RESORT = _constants.ALLOC_POLICY_LAST_RESORT
2156
ALLOC_POLICY_UNALLOCABLE = _constants.ALLOC_POLICY_UNALLOCABLE
2157
VALID_ALLOC_POLICIES = _constants.VALID_ALLOC_POLICIES
2158

    
2159
# Temporary external/shared storage parameters
2160
BLOCKDEV_DRIVER_MANUAL = _constants.BLOCKDEV_DRIVER_MANUAL
2161

    
2162
# qemu-img path, required for ovfconverter
2163
QEMUIMG_PATH = _constants.QEMUIMG_PATH
2164

    
2165
# Whether htools was enabled at compilation time
2166
HTOOLS = _constants.HTOOLS
2167
# The hail iallocator
2168
IALLOC_HAIL = "hail"
2169

    
2170
# Fake opcodes for functions that have hooks attached to them via
2171
# backend.RunLocalHooks
2172
FAKE_OP_MASTER_TURNUP = "OP_CLUSTER_IP_TURNUP"
2173
FAKE_OP_MASTER_TURNDOWN = "OP_CLUSTER_IP_TURNDOWN"
2174

    
2175
# SSH key types
2176
SSHK_RSA = "rsa"
2177
SSHK_DSA = "dsa"
2178
SSHK_ALL = compat.UniqueFrozenset([SSHK_RSA, SSHK_DSA])
2179

    
2180
# SSH authorized key types
2181
SSHAK_RSA = "ssh-rsa"
2182
SSHAK_DSS = "ssh-dss"
2183
SSHAK_ALL = compat.UniqueFrozenset([SSHAK_RSA, SSHAK_DSS])
2184

    
2185
# SSH setup
2186
SSHS_CLUSTER_NAME = "cluster_name"
2187
SSHS_SSH_HOST_KEY = "ssh_host_key"
2188
SSHS_SSH_ROOT_KEY = "ssh_root_key"
2189
SSHS_NODE_DAEMON_CERTIFICATE = "node_daemon_certificate"
2190

    
2191
#: Key files for SSH daemon
2192
SSH_DAEMON_KEYFILES = {
2193
  SSHK_RSA: (pathutils.SSH_HOST_RSA_PRIV, pathutils.SSH_HOST_RSA_PUB),
2194
  SSHK_DSA: (pathutils.SSH_HOST_DSA_PRIV, pathutils.SSH_HOST_DSA_PUB),
2195
  }
2196

    
2197
# Node daemon setup
2198
NDS_CLUSTER_NAME = "cluster_name"
2199
NDS_NODE_DAEMON_CERTIFICATE = "node_daemon_certificate"
2200
NDS_SSCONF = "ssconf"
2201
NDS_START_NODE_DAEMON = "start_node_daemon"
2202

    
2203
# Path generating random UUID
2204
RANDOM_UUID_FILE = _constants.RANDOM_UUID_FILE
2205

    
2206
# Regex string for verifying a UUID
2207
UUID_REGEX = "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
2208

    
2209
# Auto-repair tag prefixes
2210
AUTO_REPAIR_TAG_PREFIX = _constants.AUTO_REPAIR_TAG_PREFIX
2211
AUTO_REPAIR_TAG_ENABLED = _constants.AUTO_REPAIR_TAG_ENABLED
2212
AUTO_REPAIR_TAG_SUSPENDED = _constants.AUTO_REPAIR_TAG_SUSPENDED
2213
AUTO_REPAIR_TAG_PENDING = _constants.AUTO_REPAIR_TAG_PENDING
2214
AUTO_REPAIR_TAG_RESULT = _constants.AUTO_REPAIR_TAG_RESULT
2215

    
2216
# Auto-repair levels
2217
AUTO_REPAIR_FIX_STORAGE = _constants.AUTO_REPAIR_FIX_STORAGE
2218
AUTO_REPAIR_MIGRATE = _constants.AUTO_REPAIR_MIGRATE
2219
AUTO_REPAIR_FAILOVER = _constants.AUTO_REPAIR_FAILOVER
2220
AUTO_REPAIR_REINSTALL = _constants.AUTO_REPAIR_REINSTALL
2221
AUTO_REPAIR_ALL_TYPES = _constants.AUTO_REPAIR_ALL_TYPES
2222

    
2223
# Auto-repair results
2224
AUTO_REPAIR_SUCCESS = _constants.AUTO_REPAIR_SUCCESS
2225
AUTO_REPAIR_FAILURE = _constants.AUTO_REPAIR_FAILURE
2226
AUTO_REPAIR_ENOPERM = _constants.AUTO_REPAIR_ENOPERM
2227
AUTO_REPAIR_ALL_RESULTS = _constants.AUTO_REPAIR_ALL_RESULTS
2228

    
2229
# The version identifier for builtin data collectors
2230
BUILTIN_DATA_COLLECTOR_VERSION = _constants.BUILTIN_DATA_COLLECTOR_VERSION
2231

    
2232
# The reason trail opcode parameter name
2233
OPCODE_REASON = _constants.OPCODE_REASON
2234

    
2235
# The source reasons for the execution of an OpCode
2236
OPCODE_REASON_SRC_CLIENT = "gnt:client"
2237
OPCODE_REASON_SRC_NODED = "gnt:daemon:noded"
2238
OPCODE_REASON_SRC_OPCODE = "gnt:opcode"
2239
OPCODE_REASON_SRC_RLIB2 = "gnt:library:rlib2"
2240
OPCODE_REASON_SRC_USER = "gnt:user"
2241

    
2242
OPCODE_REASON_SOURCES = compat.UniqueFrozenset([
2243
  OPCODE_REASON_SRC_CLIENT,
2244
  OPCODE_REASON_SRC_NODED,
2245
  OPCODE_REASON_SRC_OPCODE,
2246
  OPCODE_REASON_SRC_RLIB2,
2247
  OPCODE_REASON_SRC_USER,
2248
  ])
2249

    
2250
DISKSTATS_FILE = _constants.DISKSTATS_FILE
2251

    
2252
# CPU load collector variables
2253
STAT_FILE = _constants.STAT_FILE
2254
CPUAVGLOAD_BUFFER_SIZE = 150
2255
CPUAVGLOAD_WINDOW_SIZE = 600
2256

    
2257
# Mond's variable for periodical data collection
2258
MOND_TIME_INTERVAL = _constants.MOND_TIME_INTERVAL
2259

    
2260
# MonD's latest API version
2261
MOND_LATEST_API_VERSION = 1
2262

    
2263
# Do not re-export imported modules
2264
del re, _vcsversion, _constants, socket, pathutils, compat
2265

    
2266

    
2267
ALLOCATABLE_KEY = "allocatable"
2268
FAILED_KEY = "failed"