constants.py 20.8 KB
Newer Older
Iustin Pop's avatar
Iustin Pop committed
1
#
Iustin Pop's avatar
Iustin Pop committed
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
#

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


"""Module holding different constants."""

24
from ganeti import _autoconf
25

Iustin Pop's avatar
Iustin Pop committed
26
# various versions
27
PROTOCOL_VERSION = 20
28
RELEASE_VERSION = _autoconf.PACKAGE_VERSION
Guido Trotter's avatar
Guido Trotter committed
29
30
31
OS_API_V10 = 10
OS_API_V15 = 15
OS_API_VERSIONS = frozenset([OS_API_V10, OS_API_V15])
Iustin Pop's avatar
Iustin Pop committed
32
EXPORT_VERSION = 0
33
RAPI_VERSION = 2
Iustin Pop's avatar
Iustin Pop committed
34

35

36
37
38
39
40
41
42
43
# Format for CONFIG_VERSION:
#   01 03 0123 = 01030123
#   ^^ ^^ ^^^^
#   |  |  + Configuration version/revision
#   |  + Minor version
#   + Major version
#
# It stored as an integer. Make sure not to write an octal number.
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

# BuildVersion and SplitVersion must be in here because we can't import other
# modules. The cfgupgrade tool must be able to read and write version numbers
# and thus requires these functions. To avoid code duplication, they're kept in
# here.

def BuildVersion(major, minor, revision):
  """Calculates int version number from major, minor and revision numbers.

  Returns: int representing version number

  """
  assert isinstance(major, int)
  assert isinstance(minor, int)
  assert isinstance(revision, int)
  return (1000000 * major +
            10000 * minor +
                1 * revision)


def SplitVersion(version):
  """Splits version number stored in an int.

  Returns: tuple; (major, minor, revision)

  """
  assert isinstance(version, int)

  (major, remainder) = divmod(version, 1000000)
  (minor, revision) = divmod(remainder, 10000)

  return (major, minor, revision)


78
79
80
CONFIG_MAJOR = int(_autoconf.VERSION_MAJOR)
CONFIG_MINOR = int(_autoconf.VERSION_MINOR)
CONFIG_REVISION = 0
81
CONFIG_VERSION = BuildVersion(CONFIG_MAJOR, CONFIG_MINOR, CONFIG_REVISION)
Iustin Pop's avatar
Iustin Pop committed
82
83

# file paths
84
DATA_DIR = _autoconf.LOCALSTATEDIR + "/lib/ganeti"
85
RUN_DIR = _autoconf.LOCALSTATEDIR + "/run"
86
RUN_GANETI_DIR = RUN_DIR + "/ganeti"
87
BDEV_CACHE_DIR = RUN_GANETI_DIR + "/bdev-cache"
88
DISK_LINKS_DIR = RUN_GANETI_DIR + "/instance-disks"
89
RUN_DIRS_MODE = 0755
Guido Trotter's avatar
Guido Trotter committed
90
SOCKET_DIR = RUN_GANETI_DIR + "/socket"
Guido Trotter's avatar
Guido Trotter committed
91
SOCKET_DIR_MODE = 0700
92
93
94
# keep RUN_GANETI_DIR first here, to make sure all get created when the node
# daemon is started (this takes care of RUN_DIR being tmpfs)
SUB_RUN_DIRS = [ RUN_GANETI_DIR, BDEV_CACHE_DIR, DISK_LINKS_DIR ]
Iustin Pop's avatar
Iustin Pop committed
95
LOCK_DIR = _autoconf.LOCALSTATEDIR + "/lock"
96
SSCONF_LOCK_FILE = LOCK_DIR + "/ganeti-ssconf.lock"
Iustin Pop's avatar
Iustin Pop committed
97
98
CLUSTER_CONF_FILE = DATA_DIR + "/config.data"
SSL_CERT_FILE = DATA_DIR + "/server.pem"
99
RAPI_CERT_FILE = DATA_DIR + "/rapi.pem"
100
HMAC_CLUSTER_KEY = DATA_DIR + "/hmac.key"
101
WATCHER_STATEFILE = DATA_DIR + "/watcher.data"
102
WATCHER_PAUSEFILE = DATA_DIR + "/watcher.pause"
103
INSTANCE_UPFILE = RUN_GANETI_DIR + "/instance-status"
Iustin Pop's avatar
Iustin Pop committed
104
SSH_KNOWN_HOSTS_FILE = DATA_DIR + "/known_hosts"
105
RAPI_USERS_FILE = DATA_DIR + "/rapi_users"
106
QUEUE_DIR = DATA_DIR + "/queue"
107
DAEMON_UTIL = _autoconf.PKGLIBDIR + "/daemon-util"
108
ETC_HOSTS = "/etc/hosts"
109
DEFAULT_FILE_STORAGE_DIR = _autoconf.FILE_STORAGE_DIR
110
SYSCONFDIR = _autoconf.SYSCONFDIR
111
TOOLSDIR = _autoconf.TOOLSDIR
112
CONF_DIR = SYSCONFDIR + "/ganeti"
113

114
MASTER_SOCKET = SOCKET_DIR + "/ganeti-master"
Iustin Pop's avatar
Iustin Pop committed
115

116
NODED = "ganeti-noded"
Guido Trotter's avatar
Guido Trotter committed
117
CONFD = "ganeti-confd"
Guido Trotter's avatar
Guido Trotter committed
118
RAPI = "ganeti-rapi"
119
MASTERD = "ganeti-masterd"
120

121
122
MULTITHREADED_DAEMONS = frozenset([MASTERD])

123
124
125
126
127
128
DAEMONS_SSL = {
  # daemon-name: (default-cert-path, default-key-path)
  NODED: (SSL_CERT_FILE, SSL_CERT_FILE),
  RAPI: (RAPI_CERT_FILE, RAPI_CERT_FILE),
}

129
130
131
DAEMONS_PORTS = {
  # daemon-name: ("proto", "default-port")
  NODED: ("tcp", 1811),
Guido Trotter's avatar
Guido Trotter committed
132
  CONFD: ("udp", 1814),
Guido Trotter's avatar
Guido Trotter committed
133
  RAPI: ("tcp", 5080),
134
135
}
DEFAULT_NODED_PORT = DAEMONS_PORTS[NODED][1]
Guido Trotter's avatar
Guido Trotter committed
136
DEFAULT_CONFD_PORT = DAEMONS_PORTS[CONFD][1]
Guido Trotter's avatar
Guido Trotter committed
137
DEFAULT_RAPI_PORT = DAEMONS_PORTS[RAPI][1]
138

Iustin Pop's avatar
Iustin Pop committed
139
140
FIRST_DRBD_PORT = 11000
LAST_DRBD_PORT = 14999
141
MASTER_SCRIPT = "ganeti-master"
Iustin Pop's avatar
Iustin Pop committed
142

143
LOG_DIR = _autoconf.LOCALSTATEDIR + "/log/ganeti/"
144
DAEMONS_LOGFILES = {
Michael Hanselmann's avatar
Michael Hanselmann committed
145
146
147
148
149
150
  # "daemon-name": "logfile"
  NODED: LOG_DIR + "node-daemon.log",
  CONFD: LOG_DIR + "conf-daemon.log",
  RAPI: LOG_DIR + "rapi-daemon.log",
  MASTERD: LOG_DIR + "master-daemon.log",
  }
151
152
153
LOG_OS_DIR = LOG_DIR + "os"
LOG_WATCHER = LOG_DIR + "watcher.log"
LOG_COMMANDS = LOG_DIR + "commands.log"
Iustin Pop's avatar
Iustin Pop committed
154
LOG_BURNIN = LOG_DIR + "burnin.log"
Iustin Pop's avatar
Iustin Pop committed
155

156
OS_SEARCH_PATH = _autoconf.OS_SEARCH_PATH
157
EXPORT_DIR = _autoconf.EXPORT_DIR
Iustin Pop's avatar
Iustin Pop committed
158
159
160

EXPORT_CONF_FILE = "config.ini"

161
XEN_BOOTLOADER = _autoconf.XEN_BOOTLOADER
162
163
164
XEN_KERNEL = _autoconf.XEN_KERNEL
XEN_INITRD = _autoconf.XEN_INITRD

165
KVM_PATH = _autoconf.KVM_PATH
Guido Trotter's avatar
Guido Trotter committed
166
SOCAT_PATH = _autoconf.SOCAT_PATH
167
SOCAT_USE_ESCAPE = _autoconf.SOCAT_USE_ESCAPE
168
SOCAT_ESCAPE_CODE = "0x1d"
169

170
VALUE_DEFAULT = "default"
171
172
VALUE_AUTO = "auto"
VALUE_GENERATE = "generate"
173
VALUE_NONE = "none"
174
175
VALUE_TRUE = "true"
VALUE_FALSE = "false"
176

Iustin Pop's avatar
Iustin Pop committed
177
# hooks-related constants
178
HOOKS_BASE_DIR = CONF_DIR + "/hooks"
Iustin Pop's avatar
Iustin Pop committed
179
180
HOOKS_PHASE_PRE = "pre"
HOOKS_PHASE_POST = "post"
181
HOOKS_NAME_CFGUPDATE = "config-update"
182
HOOKS_VERSION = 2
Iustin Pop's avatar
Iustin Pop committed
183
184
185
186
187
188
189
190
191
192

# hooks subject type (what object type does the LU deal with)
HTYPE_CLUSTER = "CLUSTER"
HTYPE_NODE = "NODE"
HTYPE_INSTANCE = "INSTANCE"

HKR_SKIP = 0
HKR_FAIL = 1
HKR_SUCCESS = 2

193
194
195
196
# Storage types
ST_FILE = "file"
ST_LVM_PV = "lvm-pv"
ST_LVM_VG = "lvm-vg"
197
198

# Storage fields
199
200
201
202
# first two are valid in LU context only, not passed to backend
SF_NODE = "node"
SF_TYPE = "type"
# and the rest are valid in backend
203
204
205
206
207
208
SF_NAME = "name"
SF_SIZE = "size"
SF_FREE = "free"
SF_USED = "used"
SF_ALLOCATABLE = "allocatable"

209
210
211
# Storage operations
SO_FIX_CONSISTENCY = "fix-consistency"

212
# Available fields per storage type
213
214
215
216
VALID_STORAGE_FIELDS = frozenset([SF_NAME, SF_TYPE, SF_SIZE,
                                  SF_USED, SF_FREE, SF_ALLOCATABLE])

VALID_STORAGE_TYPES = frozenset([ST_FILE, ST_LVM_PV, ST_LVM_VG])
Iustin Pop's avatar
Iustin Pop committed
217

218
219
220
221
MODIFIABLE_STORAGE_FIELDS = {
  ST_LVM_PV: frozenset([SF_ALLOCATABLE]),
  }

222
VALID_STORAGE_OPERATIONS = {
223
  ST_LVM_VG: frozenset([SO_FIX_CONSISTENCY]),
224
225
  }

226
227
228
229
230
231
# Local disk status
# Note: Code depends on LDS_OKAY < LDS_UNKNOWN < LDS_FAULTY
(LDS_OKAY,
 LDS_UNKNOWN,
 LDS_FAULTY) = range(1, 4)

Iustin Pop's avatar
Iustin Pop committed
232
233
234
# disk template types
DT_DISKLESS = "diskless"
DT_PLAIN = "plain"
235
DT_DRBD8 = "drbd"
236
DT_FILE = "file"
237
238

# the set of network-mirrored disk templates
239
DTS_NET_MIRROR = frozenset([DT_DRBD8])
Iustin Pop's avatar
Iustin Pop committed
240

241
242
243
# the set of non-lvm-based disk templates
DTS_NOT_LVM = frozenset([DT_DISKLESS, DT_FILE])

244
245
# logical disk types
LD_LV = "lvm"
246
LD_DRBD8 = "drbd8"
247
LD_FILE = "file"
248
LDS_BLOCK = frozenset([LD_LV, LD_DRBD8])
249

Iustin Pop's avatar
Iustin Pop committed
250
251
# drbd constants
DRBD_HMAC_ALG = "md5"
252
DRBD_NET_PROTOCOL = "C"
Iustin Pop's avatar
Iustin Pop committed
253

254
255
256
# file backend driver
FD_LOOP = "loop"
FD_BLKTAP = "blktap"
257
258

# the set of drbd-like disk types
259
LDS_DRBD = frozenset([LD_DRBD8])
260

261
# disk access mode
262
263
DISK_RDONLY = "ro"
DISK_RDWR = "rw"
264
265
DISK_ACCESS_SET = frozenset([DISK_RDONLY, DISK_RDWR])

266
# disk replacement mode
267
268
269
REPLACE_DISK_PRI = "replace_on_primary"    # replace disks on primary
REPLACE_DISK_SEC = "replace_on_secondary"  # replace disks on secondary
REPLACE_DISK_CHG = "replace_new_secondary" # change secondary node
270
REPLACE_DISK_AUTO = "replace_auto"
271

272
273
# lock recalculate mode
LOCKS_REPLACE = 'replace'
274
LOCKS_APPEND = 'append'
275

276
# instance creation modes
Iustin Pop's avatar
Iustin Pop committed
277
278
279
280
INSTANCE_CREATE = "create"
INSTANCE_IMPORT = "import"

DISK_TEMPLATES = frozenset([DT_DISKLESS, DT_PLAIN,
281
282
283
                            DT_DRBD8, DT_FILE])

FILE_DRIVER = frozenset([FD_LOOP, FD_BLKTAP])
Iustin Pop's avatar
Iustin Pop committed
284
285
286
287

# import/export config options
INISECT_EXP = "export"
INISECT_INS = "instance"
288

289
290
291
292
293
# dynamic device modification

DDM_ADD = 'add'
DDM_REMOVE = 'remove'

294
# common exit codes
Iustin Pop's avatar
Iustin Pop committed
295
EXIT_SUCCESS = 0
296
EXIT_FAILURE = 1
297
EXIT_NOTCLUSTER = 5
298
EXIT_NOTMASTER = 11
299
EXIT_NODESETUP_ERROR = 12
Iustin Pop's avatar
Iustin Pop committed
300
EXIT_CONFIRMATION = 13 # need user confirmation
Guido Trotter's avatar
Guido Trotter committed
301
EXIT_NOTCANDIDATE = 14
302

303
304
305
306
307
308
309
# tags
TAG_CLUSTER = "cluster"
TAG_NODE = "node"
TAG_INSTANCE = "instance"
MAX_TAG_LEN = 128
MAX_TAGS_PER_OBJ = 4096

310
311
# others
DEFAULT_BRIDGE = "xen-br0"
Iustin Pop's avatar
Iustin Pop committed
312
SYNC_SPEED = 60 * 1024
Iustin Pop's avatar
Iustin Pop committed
313
LOCALHOST_IP_ADDRESS = "127.0.0.1"
314
TCP_PING_TIMEOUT = 10
315
GANETI_RUNAS = "root"
316
DEFAULT_VG = "xenvg"
317
BIND_ADDRESS_GLOBAL = "0.0.0.0"
318
MIN_VG_SIZE = 20480
319
DEFAULT_MAC_PREFIX = "aa:00:00"
320
LVM_STRIPECOUNT = _autoconf.LVM_STRIPECOUNT
321
322
323
# default maximum instance wait time, in seconds.
DEFAULT_SHUTDOWN_TIMEOUT = 120

324

325
326
327
328
# RPC constants
(RPC_ENCODING_NONE,
 RPC_ENCODING_ZLIB_BASE64) = range(2)

329
330
331
332
333
# os related constants
OS_SCRIPT_CREATE = 'create'
OS_SCRIPT_IMPORT = 'import'
OS_SCRIPT_EXPORT = 'export'
OS_SCRIPT_RENAME = 'rename'
Iustin Pop's avatar
Iustin Pop committed
334
OS_SCRIPTS = frozenset([OS_SCRIPT_CREATE, OS_SCRIPT_IMPORT,
335
                        OS_SCRIPT_EXPORT, OS_SCRIPT_RENAME])
336

337
OS_API_FILE = 'ganeti_api_version'
338
OS_VARIANTS_FILE = 'variants.list'
339

340
341
342
343
344
345
# ssh constants
SSH_CONFIG_DIR = "/etc/ssh/"
SSH_HOST_DSA_PRIV = SSH_CONFIG_DIR + "ssh_host_dsa_key"
SSH_HOST_DSA_PUB = SSH_HOST_DSA_PRIV + ".pub"
SSH_HOST_RSA_PRIV = SSH_CONFIG_DIR + "ssh_host_rsa_key"
SSH_HOST_RSA_PUB = SSH_HOST_RSA_PRIV + ".pub"
346
347
SSH = "ssh"
SCP = "scp"
348
349
350
351
352

# reboot types
INSTANCE_REBOOT_SOFT = "soft"
INSTANCE_REBOOT_HARD = "hard"
INSTANCE_REBOOT_FULL = "full"
353

354
355
356
357
REBOOT_TYPES = frozenset([INSTANCE_REBOOT_SOFT,
                          INSTANCE_REBOOT_HARD,
                          INSTANCE_REBOOT_FULL])

358
359
360
361
362
363
364
365
366
367
368
VTYPE_STRING = 'string'
VTYPE_BOOL = 'bool'
VTYPE_SIZE = 'size' # size, in MiBs
VTYPE_INT = 'int'
ENFORCEABLE_TYPES = frozenset([
                      VTYPE_STRING,
                      VTYPE_BOOL,
                      VTYPE_SIZE,
                      VTYPE_INT,
                      ])

369
370
371
372
373
374
# HV parameter names (global namespace)
HV_BOOT_ORDER = "boot_order"
HV_CDROM_IMAGE_PATH = "cdrom_image_path"
HV_NIC_TYPE = "nic_type"
HV_DISK_TYPE = "disk_type"
HV_VNC_BIND_ADDRESS = "vnc_bind_address"
375
HV_VNC_PASSWORD_FILE = "vnc_password_file"
376
377
378
HV_VNC_TLS = "vnc_tls"
HV_VNC_X509 = "vnc_x509_path"
HV_VNC_X509_VERIFY = "vnc_x509_verify"
379
380
HV_ACPI = "acpi"
HV_PAE = "pae"
381
382
383
HV_USE_BOOTLOADER = "use_bootloader"
HV_BOOTLOADER_ARGS = "bootloader_args"
HV_BOOTLOADER_PATH = "bootloader_path"
384
HV_KERNEL_ARGS = "kernel_args"
385
386
HV_KERNEL_PATH = "kernel_path"
HV_INITRD_PATH = "initrd_path"
387
HV_ROOT_PATH = "root_path"
388
HV_SERIAL_CONSOLE = "serial_console"
389
HV_USB_MOUSE = "usb_mouse"
390
HV_DEVICE_MODEL = "device_model"
391
HV_INIT_SCRIPT = "init_script"
392
HV_MIGRATION_PORT = "migration_port"
393
HV_USE_LOCALTIME = "use_localtime"
394
HV_DISK_CACHE = "disk_cache"
395

396
397
398
399
400
HVS_PARAMETER_TYPES = {
  HV_BOOT_ORDER: VTYPE_STRING,
  HV_CDROM_IMAGE_PATH: VTYPE_STRING,
  HV_NIC_TYPE: VTYPE_STRING,
  HV_DISK_TYPE: VTYPE_STRING,
401
  HV_VNC_PASSWORD_FILE: VTYPE_STRING,
402
403
404
405
406
407
  HV_VNC_BIND_ADDRESS: VTYPE_STRING,
  HV_VNC_TLS: VTYPE_BOOL,
  HV_VNC_X509: VTYPE_STRING,
  HV_VNC_X509_VERIFY: VTYPE_BOOL,
  HV_ACPI: VTYPE_BOOL,
  HV_PAE: VTYPE_BOOL,
408
409
410
  HV_USE_BOOTLOADER: VTYPE_BOOL,
  HV_BOOTLOADER_PATH: VTYPE_STRING,
  HV_BOOTLOADER_ARGS: VTYPE_STRING,
411
  HV_KERNEL_PATH: VTYPE_STRING,
412
  HV_KERNEL_ARGS: VTYPE_STRING,
413
414
415
416
  HV_INITRD_PATH: VTYPE_STRING,
  HV_ROOT_PATH: VTYPE_STRING,
  HV_SERIAL_CONSOLE: VTYPE_BOOL,
  HV_USB_MOUSE: VTYPE_STRING,
417
  HV_DEVICE_MODEL: VTYPE_STRING,
418
  HV_INIT_SCRIPT: VTYPE_STRING,
419
  HV_MIGRATION_PORT: VTYPE_INT,
420
  HV_USE_LOCALTIME: VTYPE_BOOL,
421
  HV_DISK_CACHE: VTYPE_STRING,
422
423
424
  }

HVS_PARAMETERS = frozenset(HVS_PARAMETER_TYPES.keys())
425

426
# BE parameter names
Iustin Pop's avatar
Iustin Pop committed
427
BE_MEMORY = "memory"
428
BE_VCPUS = "vcpus"
429
BE_AUTO_BALANCE = "auto_balance"
430

431
432
433
434
435
436
437
BES_PARAMETER_TYPES = {
    BE_MEMORY: VTYPE_SIZE,
    BE_VCPUS: VTYPE_INT,
    BE_AUTO_BALANCE: VTYPE_BOOL,
    }

BES_PARAMETERS = frozenset(BES_PARAMETER_TYPES.keys())
Iustin Pop's avatar
Iustin Pop committed
438

439
440
# Instance Parameters Profile
PP_DEFAULT = "default"
441

Guido Trotter's avatar
Guido Trotter committed
442
443
444
445
446
447
448
449
450
451
452
453
454
455
NIC_MODE = "mode"
NIC_LINK = "link"

NIC_MODE_BRIDGED = "bridged"
NIC_MODE_ROUTED = "routed"

NIC_VALID_MODES = frozenset([NIC_MODE_BRIDGED, NIC_MODE_ROUTED])

NICS_PARAMETER_TYPES = {
    NIC_MODE: VTYPE_STRING,
    NIC_LINK: VTYPE_STRING,
    }

NICS_PARAMETERS = frozenset(NICS_PARAMETER_TYPES.keys())
456

457
# Hypervisor constants
Iustin Pop's avatar
Iustin Pop committed
458
HT_XEN_PVM = "xen-pvm"
459
HT_FAKE = "fake"
Iustin Pop's avatar
Iustin Pop committed
460
HT_XEN_HVM = "xen-hvm"
Guido Trotter's avatar
Guido Trotter committed
461
HT_KVM = "kvm"
462
463
HT_CHROOT = "chroot"
HYPER_TYPES = frozenset([HT_XEN_PVM, HT_FAKE, HT_XEN_HVM, HT_KVM, HT_CHROOT])
Guido Trotter's avatar
Guido Trotter committed
464
HTS_REQ_PORT = frozenset([HT_XEN_HVM, HT_KVM])
465

466
VNC_BASE_PORT = 5900
467
VNC_PASSWORD_FILE = CONF_DIR + "/vnc-cluster-password"
468
VNC_DEFAULT_BIND_ADDRESS = '0.0.0.0'
469

470
# NIC types
471
472
473
HT_NIC_RTL8139 = "rtl8139"
HT_NIC_NE2K_PCI = "ne2k_pci"
HT_NIC_NE2K_ISA = "ne2k_isa"
474
475
476
477
478
HT_NIC_I82551 = "i82551"
HT_NIC_I85557B = "i82557b"
HT_NIC_I8259ER = "i82559er"
HT_NIC_PCNET = "pcnet"
HT_NIC_E1000 = "e1000"
479
HT_NIC_PARAVIRTUAL = HT_DISK_PARAVIRTUAL = "paravirtual"
480

481
482
HT_HVM_VALID_NIC_TYPES = frozenset([HT_NIC_RTL8139, HT_NIC_NE2K_PCI,
                                    HT_NIC_NE2K_ISA, HT_NIC_PARAVIRTUAL])
483
484
485
486
487
HT_KVM_VALID_NIC_TYPES = frozenset([HT_NIC_RTL8139, HT_NIC_NE2K_PCI,
                                    HT_NIC_NE2K_ISA, HT_NIC_I82551,
                                    HT_NIC_I85557B, HT_NIC_I8259ER,
                                    HT_NIC_PCNET, HT_NIC_E1000,
                                    HT_NIC_PARAVIRTUAL])
488
489
490
491
492
493
494
495
# Disk types
HT_DISK_IOEMU = "ioemu"
HT_DISK_IDE = "ide"
HT_DISK_SCSI = "scsi"
HT_DISK_SD = "sd"
HT_DISK_MTD = "mtd"
HT_DISK_PFLASH = "pflash"

496
497
498
499
500
501
502
503
504
HT_CACHE_DEFAULT = "default"
HT_CACHE_NONE = "none"
HT_CACHE_WTHROUGH = "writethrough"
HT_CACHE_WBACK = "writeback"
HT_VALID_CACHE_TYPES = frozenset([HT_CACHE_DEFAULT,
                                  HT_CACHE_NONE,
                                  HT_CACHE_WTHROUGH,
                                  HT_CACHE_WBACK])

505
HT_HVM_VALID_DISK_TYPES = frozenset([HT_DISK_PARAVIRTUAL, HT_DISK_IOEMU])
506
507
508
HT_KVM_VALID_DISK_TYPES = frozenset([HT_DISK_PARAVIRTUAL, HT_DISK_IDE,
                                     HT_DISK_SCSI, HT_DISK_SD, HT_DISK_MTD,
                                     HT_DISK_PFLASH])
509

510
511
512
513
514
515
516
517
518
519
520
521
522
# Mouse types:
HT_MOUSE_MOUSE = "mouse"
HT_MOUSE_TABLET = "tablet"

HT_KVM_VALID_MOUSE_TYPES = frozenset([HT_MOUSE_MOUSE, HT_MOUSE_TABLET])

# Boot order
HT_BO_CDROM = "cdrom"
HT_BO_DISK = "disk"
HT_BO_NETWORK = "network"

HT_KVM_VALID_BO_TYPES = frozenset([HT_BO_CDROM, HT_BO_DISK, HT_BO_NETWORK])

523
524
525
526
# Cluster Verify steps
VERIFY_NPLUSONE_MEM = 'nplusone_mem'
VERIFY_OPTIONAL_CHECKS = frozenset([VERIFY_NPLUSONE_MEM])

527
528
529
530
531
532
533
534
535
# Node verify constants
NV_FILELIST = "filelist"
NV_HVINFO = "hvinfo"
NV_HYPERVISOR = "hypervisor"
NV_INSTANCELIST = "instancelist"
NV_NODELIST = "nodelist"
NV_NODENETTEST = "node-net-test"
NV_VERSION = "version"
NV_VGLIST = "vglist"
536
537
NV_LVLIST = "lvlist"
NV_PVLIST = "pvlist"
538
NV_DRBDLIST = "drbd-list"
539
NV_NODESETUP = "nodesetup"
540

541
# Allocator framework constants
542
IALLOCATOR_VERSION = 2
543
544
545
546
547
IALLOCATOR_DIR_IN = "in"
IALLOCATOR_DIR_OUT = "out"
IALLOCATOR_MODE_ALLOC = "allocate"
IALLOCATOR_MODE_RELOC = "relocate"
IALLOCATOR_SEARCH_PATH = _autoconf.IALLOCATOR_SEARCH_PATH
548

549
550
551
552
553
# Job queue
JOB_QUEUE_VERSION = 1
JOB_QUEUE_LOCK_FILE = QUEUE_DIR + "/lock"
JOB_QUEUE_VERSION_FILE = QUEUE_DIR + "/version"
JOB_QUEUE_SERIAL_FILE = QUEUE_DIR + "/serial"
554
JOB_QUEUE_ARCHIVE_DIR = QUEUE_DIR + "/archive"
555
JOB_QUEUE_DRAIN_FILE = QUEUE_DIR + "/drain"
Michael Hanselmann's avatar
Michael Hanselmann committed
556
557
JOB_QUEUE_SIZE_HARD_LIMIT = 5000
JOB_QUEUE_SIZE_SOFT_LIMIT = JOB_QUEUE_SIZE_HARD_LIMIT * 0.8
558

559
560
JOB_ID_TEMPLATE = r"\d+"

561
562
563
# unchanged job return
JOB_NOTCHANGED = "nochange"

564
565
# Job status
JOB_STATUS_QUEUED = "queued"
Iustin Pop's avatar
Iustin Pop committed
566
JOB_STATUS_WAITLOCK = "waiting"
567
JOB_STATUS_CANCELING = "canceling"
568
569
570
571
572
JOB_STATUS_RUNNING = "running"
JOB_STATUS_CANCELED = "canceled"
JOB_STATUS_SUCCESS = "success"
JOB_STATUS_ERROR = "error"

573
574
# OpCode status
# not yet finalized
575
OP_STATUS_QUEUED = "queued"
Iustin Pop's avatar
Iustin Pop committed
576
OP_STATUS_WAITLOCK = "waiting"
577
OP_STATUS_CANCELING = "canceling"
578
OP_STATUS_RUNNING = "running"
579
# finalized
580
OP_STATUS_CANCELED = "canceled"
581
582
OP_STATUS_SUCCESS = "success"
OP_STATUS_ERROR = "error"
583
584
585
OPS_FINALIZED = frozenset([OP_STATUS_CANCELED,
                           OP_STATUS_SUCCESS,
                           OP_STATUS_ERROR])
586
587
588
589

# Execution log types
ELOG_MESSAGE = "message"
ELOG_PROGRESS = "progress"
590

591
# max dynamic devices
592
593
594
MAX_NICS = 8
MAX_DISKS = 16

Iustin Pop's avatar
Iustin Pop committed
595
596
# SSCONF keys
SS_CLUSTER_NAME = "cluster_name"
597
SS_CLUSTER_TAGS = "cluster_tags"
Iustin Pop's avatar
Iustin Pop committed
598
SS_FILE_STORAGE_DIR = "file_storage_dir"
599
SS_MASTER_CANDIDATES = "master_candidates"
600
SS_MASTER_CANDIDATES_IPS = "master_candidates_ips"
Iustin Pop's avatar
Iustin Pop committed
601
602
603
604
SS_MASTER_IP = "master_ip"
SS_MASTER_NETDEV = "master_netdev"
SS_MASTER_NODE = "master_node"
SS_NODE_LIST = "node_list"
605
606
SS_NODE_PRIMARY_IPS = "node_primary_ips"
SS_NODE_SECONDARY_IPS = "node_secondary_ips"
607
SS_OFFLINE_NODES = "offline_nodes"
608
609
SS_ONLINE_NODES = "online_nodes"
SS_INSTANCE_LIST = "instance_list"
610
SS_RELEASE_VERSION = "release_version"
Iustin Pop's avatar
Iustin Pop committed
611

612
613
614
615
# cluster wide default parameters
DEFAULT_ENABLED_HYPERVISOR = HT_XEN_PVM

HVC_DEFAULTS = {
616
  HT_XEN_PVM: {
617
618
619
    HV_USE_BOOTLOADER: False,
    HV_BOOTLOADER_PATH: XEN_BOOTLOADER,
    HV_BOOTLOADER_ARGS: '',
620
    HV_KERNEL_PATH: "/boot/vmlinuz-2.6-xenU",
621
    HV_INITRD_PATH: '',
622
    HV_ROOT_PATH: '/dev/sda1',
623
    HV_KERNEL_ARGS: 'ro',
624
    HV_MIGRATION_PORT: 8002,
625
626
627
    },
  HT_XEN_HVM: {
    HV_BOOT_ORDER: "cd",
628
    HV_CDROM_IMAGE_PATH: '',
629
    HV_NIC_TYPE: HT_NIC_RTL8139,
630
    HV_DISK_TYPE: HT_DISK_PARAVIRTUAL,
631
    HV_VNC_BIND_ADDRESS: '0.0.0.0',
632
    HV_VNC_PASSWORD_FILE: VNC_PASSWORD_FILE,
633
634
    HV_ACPI: True,
    HV_PAE: True,
635
    HV_KERNEL_PATH: "/usr/lib/xen/boot/hvmloader",
636
    HV_DEVICE_MODEL: "/usr/lib/xen/bin/qemu-dm",
637
    HV_MIGRATION_PORT: 8002,
638
    HV_USE_LOCALTIME: False,
639
640
641
    },
  HT_KVM: {
    HV_KERNEL_PATH: "/boot/vmlinuz-2.6-kvmU",
642
    HV_INITRD_PATH: '',
643
    HV_KERNEL_ARGS: 'ro',
644
    HV_ROOT_PATH: '/dev/vda1',
645
646
    HV_ACPI: True,
    HV_SERIAL_CONSOLE: True,
647
    HV_VNC_BIND_ADDRESS: '',
648
649
650
    HV_VNC_TLS: False,
    HV_VNC_X509: '',
    HV_VNC_X509_VERIFY: False,
651
    HV_VNC_PASSWORD_FILE: '',
652
    HV_CDROM_IMAGE_PATH: '',
653
    HV_BOOT_ORDER: HT_BO_DISK,
654
655
    HV_NIC_TYPE: HT_NIC_PARAVIRTUAL,
    HV_DISK_TYPE: HT_DISK_PARAVIRTUAL,
656
    HV_USB_MOUSE: '',
657
    HV_MIGRATION_PORT: 8102,
658
    HV_USE_LOCALTIME: False,
659
    HV_DISK_CACHE: HT_CACHE_DEFAULT,
660
661
662
    },
  HT_FAKE: {
    },
663
664
665
  HT_CHROOT: {
    HV_INIT_SCRIPT: "/ganeti-chroot",
    },
666
  }
667

668
669
670
671
HVC_GLOBALS = frozenset([
  HV_MIGRATION_PORT,
  ])

672
BEC_DEFAULTS = {
673
674
675
676
  BE_MEMORY: 128,
  BE_VCPUS: 1,
  BE_AUTO_BALANCE: True,
  }
677

Guido Trotter's avatar
Guido Trotter committed
678
679
680
681
682
NICC_DEFAULTS = {
  NIC_MODE: NIC_MODE_BRIDGED,
  NIC_LINK: DEFAULT_BRIDGE,
  }

683
MASTER_POOL_SIZE_DEFAULT = 10
Guido Trotter's avatar
Guido Trotter committed
684
685
686

CONFD_PROTOCOL_VERSION = 1

687
CONFD_REQ_PING = 0
Guido Trotter's avatar
Guido Trotter committed
688
689
CONFD_REQ_NODE_ROLE_BYNAME = 1
CONFD_REQ_NODE_PIP_BY_INSTANCE_IP = 2
690
CONFD_REQ_CLUSTER_MASTER = 3
691
692
CONFD_REQ_NODE_PIP_LIST = 4
CONFD_REQ_MC_PIP_LIST = 5
693
CONFD_REQ_INSTANCES_IPS_LIST = 6
Guido Trotter's avatar
Guido Trotter committed
694

695
696
697
698
699
700
701
# Confd request query fields. These are used to narrow down queries.
# These must be strings rather than integers, because json-encoding
# converts them to strings anyway, as they're used as dict-keys.
CONFD_REQQ_LINK = "0"
CONFD_REQQ_IP = "1"
CONFD_REQQ_IPLIST = "2"

Guido Trotter's avatar
Guido Trotter committed
702
CONFD_REQS = frozenset([
703
  CONFD_REQ_PING,
Guido Trotter's avatar
Guido Trotter committed
704
705
  CONFD_REQ_NODE_ROLE_BYNAME,
  CONFD_REQ_NODE_PIP_BY_INSTANCE_IP,
706
  CONFD_REQ_CLUSTER_MASTER,
707
708
  CONFD_REQ_NODE_PIP_LIST,
  CONFD_REQ_MC_PIP_LIST,
709
  CONFD_REQ_INSTANCES_IPS_LIST,
Guido Trotter's avatar
Guido Trotter committed
710
711
  ])

712
713
714
715
716
717
718
719
720
721
CONFD_REPL_STATUS_OK = 0
CONFD_REPL_STATUS_ERROR = 1
CONFD_REPL_STATUS_NOTIMPLEMENTED = 2

CONFD_REPL_STATUSES = frozenset([
  CONFD_REPL_STATUS_OK,
  CONFD_REPL_STATUS_ERROR,
  CONFD_REPL_STATUS_NOTIMPLEMENTED,
  ])

Guido Trotter's avatar
Guido Trotter committed
722
723
724
(CONFD_NODE_ROLE_MASTER,
 CONFD_NODE_ROLE_CANDIDATE,
 CONFD_NODE_ROLE_OFFLINE,
Guido Trotter's avatar
Guido Trotter committed
725
726
727
 CONFD_NODE_ROLE_DRAINED,
 CONFD_NODE_ROLE_REGULAR,
 ) = range(5)
Guido Trotter's avatar
Guido Trotter committed
728

729
730
# A few common errors for confd
CONFD_ERROR_UNKNOWN_ENTRY = 1
731
CONFD_ERROR_INTERNAL = 2
732
CONFD_ERROR_ARGUMENT = 3
733

Guido Trotter's avatar
Guido Trotter committed
734
735
736
737
# Each request is "salted" by the current timestamp.
# This constants decides how many seconds of skew to accept.
# TODO: make this a default and allow the value to be more configurable
CONFD_MAX_CLOCK_SKEW = 300
738
739
740
741
742
743
744
745
746

# When we haven't reloaded the config for more than this amount of seconds, we
# force a test to see if inotify is betraying us.
CONFD_CONFIG_RELOAD_TIMEOUT = 60

# If we receive more than one update in this amount of seconds, we move to
# polling every RATELIMIT seconds, rather than relying on inotify, to be able
# to serve more requests.
CONFD_CONFIG_RELOAD_RATELIMIT = 2
747

748
749
750
751
752
753
# Magic number prepended to all confd queries.
# This allows us to distinguish different types of confd protocols and handle
# them. For example by changing this we can move the whole payload to be
# compressed, or move away from json.
CONFD_MAGIC_FOURCC = 'plj0'

Guido Trotter's avatar
Guido Trotter committed
754
755
756
757
758
759
760
761
762
763
# By default a confd request is sent to the minimum between this number and all
# MCs. 6 was chosen because even in the case of a disastrous 50% response rate,
# we should have enough answers to be able to compare more than one.
CONFD_DEFAULT_REQ_COVERAGE = 6

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

764
765
766
767
768
769
# Maximum UDP datagram size.
# On IPv4: 64K - 20 (ip header size) - 8 (udp header size) = 65507
# On IPv6: 64K - 40 (ip6 header size) - 8 (udp header size) = 65487
#   (assuming we can't use jumbo frames)
# We just set this to 60K, which should be enough
MAX_UDP_DATA_SIZE = 61440