constants.py 19.5 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
ETC_HOSTS = "/etc/hosts"
108
DEFAULT_FILE_STORAGE_DIR = _autoconf.FILE_STORAGE_DIR
109
SYSCONFDIR = _autoconf.SYSCONFDIR
110
TOOLSDIR = _autoconf.TOOLSDIR
111
CONF_DIR = SYSCONFDIR + "/ganeti"
112

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

115
NODE_INITD_SCRIPT = SYSCONFDIR + "/init.d/ganeti"
116
117

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

122
123
MULTITHREADED_DAEMONS = frozenset([MASTERD])

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

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

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

144
LOG_DIR = _autoconf.LOCALSTATEDIR + "/log/ganeti/"
145
DAEMONS_LOGFILES = {
Michael Hanselmann's avatar
Michael Hanselmann committed
146
147
148
149
150
151
  # "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",
  }
152
153
154
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
155
LOG_BURNIN = LOG_DIR + "burnin.log"
Iustin Pop's avatar
Iustin Pop committed
156

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

EXPORT_CONF_FILE = "config.ini"

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

166
KVM_PATH = _autoconf.KVM_PATH
Guido Trotter's avatar
Guido Trotter committed
167
SOCAT_PATH = _autoconf.SOCAT_PATH
Guido Trotter's avatar
Guido Trotter committed
168
KVM_MIGRATION_PORT = _autoconf.KVM_MIGRATION_PORT
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
199
200
201
202
203
204

# Storage fields
SF_NAME = "name"
SF_SIZE = "size"
SF_FREE = "free"
SF_USED = "used"
SF_ALLOCATABLE = "allocatable"

205
206
207
# Storage operations
SO_FIX_CONSISTENCY = "fix-consistency"

208
209
210
211
212
213
# Available fields per storage type
VALID_STORAGE_FIELDS = {
  ST_FILE: frozenset([SF_NAME, SF_USED, SF_FREE]),
  ST_LVM_PV: frozenset([SF_NAME, SF_SIZE, SF_USED, SF_FREE, SF_ALLOCATABLE]),
  ST_LVM_VG: frozenset([SF_NAME, SF_SIZE]),
  }
Iustin Pop's avatar
Iustin Pop committed
214

215
216
217
218
MODIFIABLE_STORAGE_FIELDS = {
  ST_LVM_PV: frozenset([SF_ALLOCATABLE]),
  }

219
VALID_STORAGE_OPERATIONS = {
220
  ST_LVM_VG: frozenset([SO_FIX_CONSISTENCY]),
221
222
  }

223
224
225
226
227
228
# 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
229
230
231
# disk template types
DT_DISKLESS = "diskless"
DT_PLAIN = "plain"
232
DT_DRBD8 = "drbd"
233
DT_FILE = "file"
234
235

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

238
239
240
# the set of non-lvm-based disk templates
DTS_NOT_LVM = frozenset([DT_DISKLESS, DT_FILE])

241
242
# logical disk types
LD_LV = "lvm"
243
LD_DRBD8 = "drbd8"
244
LD_FILE = "file"
245
LDS_BLOCK = frozenset([LD_LV, LD_DRBD8])
246

Iustin Pop's avatar
Iustin Pop committed
247
248
# drbd constants
DRBD_HMAC_ALG = "md5"
249
DRBD_NET_PROTOCOL = "C"
Iustin Pop's avatar
Iustin Pop committed
250

251
252
253
# file backend driver
FD_LOOP = "loop"
FD_BLKTAP = "blktap"
254
255

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

258
# disk access mode
259
260
DISK_RDONLY = "ro"
DISK_RDWR = "rw"
261
262
DISK_ACCESS_SET = frozenset([DISK_RDONLY, DISK_RDWR])

263
# disk replacement mode
264
265
266
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
267
REPLACE_DISK_AUTO = "replace_auto"
268

269
270
# lock recalculate mode
LOCKS_REPLACE = 'replace'
271
LOCKS_APPEND = 'append'
272

273
# instance creation modes
Iustin Pop's avatar
Iustin Pop committed
274
275
276
277
INSTANCE_CREATE = "create"
INSTANCE_IMPORT = "import"

DISK_TEMPLATES = frozenset([DT_DISKLESS, DT_PLAIN,
278
279
280
                            DT_DRBD8, DT_FILE])

FILE_DRIVER = frozenset([FD_LOOP, FD_BLKTAP])
Iustin Pop's avatar
Iustin Pop committed
281
282
283
284

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

286
287
288
289
290
# dynamic device modification

DDM_ADD = 'add'
DDM_REMOVE = 'remove'

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

300
301
302
303
304
305
306
# tags
TAG_CLUSTER = "cluster"
TAG_NODE = "node"
TAG_INSTANCE = "instance"
MAX_TAG_LEN = 128
MAX_TAGS_PER_OBJ = 4096

307
308
# others
DEFAULT_BRIDGE = "xen-br0"
Iustin Pop's avatar
Iustin Pop committed
309
SYNC_SPEED = 60 * 1024
Iustin Pop's avatar
Iustin Pop committed
310
LOCALHOST_IP_ADDRESS = "127.0.0.1"
311
TCP_PING_TIMEOUT = 10
312
GANETI_RUNAS = "root"
313
DEFAULT_VG = "xenvg"
314
BIND_ADDRESS_GLOBAL = "0.0.0.0"
315
MIN_VG_SIZE = 20480
316
DEFAULT_MAC_PREFIX = "aa:00:00"
317
LVM_STRIPECOUNT = _autoconf.LVM_STRIPECOUNT
318

319
320
321
322
# RPC constants
(RPC_ENCODING_NONE,
 RPC_ENCODING_ZLIB_BASE64) = range(2)

323
324
325
326
327
# 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
328
OS_SCRIPTS = frozenset([OS_SCRIPT_CREATE, OS_SCRIPT_IMPORT,
329
                        OS_SCRIPT_EXPORT, OS_SCRIPT_RENAME])
330

331
OS_API_FILE = 'ganeti_api_version'
332
OS_VARIANTS_FILE = 'variants.list'
333

334
# ssh constants
335
SSH_INITD_SCRIPT = _autoconf.SSH_INITD_SCRIPT
336
337
338
339
340
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"
341
342
SSH = "ssh"
SCP = "scp"
343
344
345
346
347

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

349
350
351
352
REBOOT_TYPES = frozenset([INSTANCE_REBOOT_SOFT,
                          INSTANCE_REBOOT_HARD,
                          INSTANCE_REBOOT_FULL])

353
354
355
356
357
358
359
360
361
362
363
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,
                      ])

364
365
366
367
368
369
# 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"
370
HV_VNC_PASSWORD_FILE = "vnc_password_file"
371
372
373
HV_VNC_TLS = "vnc_tls"
HV_VNC_X509 = "vnc_x509_path"
HV_VNC_X509_VERIFY = "vnc_x509_verify"
374
375
HV_ACPI = "acpi"
HV_PAE = "pae"
376
377
378
HV_USE_BOOTLOADER = "use_bootloader"
HV_BOOTLOADER_ARGS = "bootloader_args"
HV_BOOTLOADER_PATH = "bootloader_path"
379
HV_KERNEL_ARGS = "kernel_args"
380
381
HV_KERNEL_PATH = "kernel_path"
HV_INITRD_PATH = "initrd_path"
382
HV_ROOT_PATH = "root_path"
383
HV_SERIAL_CONSOLE = "serial_console"
384
HV_USB_MOUSE = "usb_mouse"
385
HV_DEVICE_MODEL = "device_model"
386
HV_INIT_SCRIPT = "init_script"
387

388
389
390
391
392
HVS_PARAMETER_TYPES = {
  HV_BOOT_ORDER: VTYPE_STRING,
  HV_CDROM_IMAGE_PATH: VTYPE_STRING,
  HV_NIC_TYPE: VTYPE_STRING,
  HV_DISK_TYPE: VTYPE_STRING,
393
  HV_VNC_PASSWORD_FILE: VTYPE_STRING,
394
395
396
397
398
399
  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,
400
401
402
  HV_USE_BOOTLOADER: VTYPE_BOOL,
  HV_BOOTLOADER_PATH: VTYPE_STRING,
  HV_BOOTLOADER_ARGS: VTYPE_STRING,
403
  HV_KERNEL_PATH: VTYPE_STRING,
404
  HV_KERNEL_ARGS: VTYPE_STRING,
405
406
407
408
  HV_INITRD_PATH: VTYPE_STRING,
  HV_ROOT_PATH: VTYPE_STRING,
  HV_SERIAL_CONSOLE: VTYPE_BOOL,
  HV_USB_MOUSE: VTYPE_STRING,
409
  HV_DEVICE_MODEL: VTYPE_STRING,
410
  HV_INIT_SCRIPT: VTYPE_STRING,
411
412
413
  }

HVS_PARAMETERS = frozenset(HVS_PARAMETER_TYPES.keys())
414

415
# BE parameter names
Iustin Pop's avatar
Iustin Pop committed
416
BE_MEMORY = "memory"
417
BE_VCPUS = "vcpus"
418
BE_AUTO_BALANCE = "auto_balance"
419

420
421
422
423
424
425
426
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
427

428
429
# Instance Parameters Profile
PP_DEFAULT = "default"
430

Guido Trotter's avatar
Guido Trotter committed
431
432
433
434
435
436
437
438
439
440
441
442
443
444
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())
445

446
# Hypervisor constants
Iustin Pop's avatar
Iustin Pop committed
447
HT_XEN_PVM = "xen-pvm"
448
HT_FAKE = "fake"
Iustin Pop's avatar
Iustin Pop committed
449
HT_XEN_HVM = "xen-hvm"
Guido Trotter's avatar
Guido Trotter committed
450
HT_KVM = "kvm"
451
452
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
453
HTS_REQ_PORT = frozenset([HT_XEN_HVM, HT_KVM])
454

455
VNC_BASE_PORT = 5900
456
VNC_PASSWORD_FILE = CONF_DIR + "/vnc-cluster-password"
457
VNC_DEFAULT_BIND_ADDRESS = '0.0.0.0'
458

459
# NIC types
460
461
462
HT_NIC_RTL8139 = "rtl8139"
HT_NIC_NE2K_PCI = "ne2k_pci"
HT_NIC_NE2K_ISA = "ne2k_isa"
463
464
465
466
467
HT_NIC_I82551 = "i82551"
HT_NIC_I85557B = "i82557b"
HT_NIC_I8259ER = "i82559er"
HT_NIC_PCNET = "pcnet"
HT_NIC_E1000 = "e1000"
468
HT_NIC_PARAVIRTUAL = HT_DISK_PARAVIRTUAL = "paravirtual"
469

470
471
HT_HVM_VALID_NIC_TYPES = frozenset([HT_NIC_RTL8139, HT_NIC_NE2K_PCI,
                                    HT_NIC_NE2K_ISA, HT_NIC_PARAVIRTUAL])
472
473
474
475
476
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])
477
478
479
480
481
482
483
484
485
# 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"

HT_HVM_VALID_DISK_TYPES = frozenset([HT_DISK_PARAVIRTUAL, HT_DISK_IOEMU])
486
487
488
HT_KVM_VALID_DISK_TYPES = frozenset([HT_DISK_PARAVIRTUAL, HT_DISK_IDE,
                                     HT_DISK_SCSI, HT_DISK_SD, HT_DISK_MTD,
                                     HT_DISK_PFLASH])
489

490
491
492
493
494
495
496
497
498
499
500
501
502
# 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])

503
504
505
506
# Cluster Verify steps
VERIFY_NPLUSONE_MEM = 'nplusone_mem'
VERIFY_OPTIONAL_CHECKS = frozenset([VERIFY_NPLUSONE_MEM])

507
508
509
510
511
512
513
514
515
516
# Node verify constants
NV_FILELIST = "filelist"
NV_HVINFO = "hvinfo"
NV_HYPERVISOR = "hypervisor"
NV_INSTANCELIST = "instancelist"
NV_LVLIST = "lvlist"
NV_NODELIST = "nodelist"
NV_NODENETTEST = "node-net-test"
NV_VERSION = "version"
NV_VGLIST = "vglist"
517
NV_DRBDLIST = "drbd-list"
518

519
# Allocator framework constants
520
IALLOCATOR_VERSION = 2
521
522
523
524
525
IALLOCATOR_DIR_IN = "in"
IALLOCATOR_DIR_OUT = "out"
IALLOCATOR_MODE_ALLOC = "allocate"
IALLOCATOR_MODE_RELOC = "relocate"
IALLOCATOR_SEARCH_PATH = _autoconf.IALLOCATOR_SEARCH_PATH
526

527
528
529
530
531
# 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"
532
JOB_QUEUE_ARCHIVE_DIR = QUEUE_DIR + "/archive"
533
JOB_QUEUE_DRAIN_FILE = QUEUE_DIR + "/drain"
Michael Hanselmann's avatar
Michael Hanselmann committed
534
535
JOB_QUEUE_SIZE_HARD_LIMIT = 5000
JOB_QUEUE_SIZE_SOFT_LIMIT = JOB_QUEUE_SIZE_HARD_LIMIT * 0.8
536

537
538
JOB_ID_TEMPLATE = r"\d+"

539
540
541
# unchanged job return
JOB_NOTCHANGED = "nochange"

542
543
# Job status
JOB_STATUS_QUEUED = "queued"
Iustin Pop's avatar
Iustin Pop committed
544
JOB_STATUS_WAITLOCK = "waiting"
545
JOB_STATUS_CANCELING = "canceling"
546
547
548
549
550
JOB_STATUS_RUNNING = "running"
JOB_STATUS_CANCELED = "canceled"
JOB_STATUS_SUCCESS = "success"
JOB_STATUS_ERROR = "error"

551
552
# OpCode status
# not yet finalized
553
OP_STATUS_QUEUED = "queued"
Iustin Pop's avatar
Iustin Pop committed
554
OP_STATUS_WAITLOCK = "waiting"
555
OP_STATUS_CANCELING = "canceling"
556
OP_STATUS_RUNNING = "running"
557
# finalized
558
OP_STATUS_CANCELED = "canceled"
559
560
OP_STATUS_SUCCESS = "success"
OP_STATUS_ERROR = "error"
561
562
563
OPS_FINALIZED = frozenset([OP_STATUS_CANCELED,
                           OP_STATUS_SUCCESS,
                           OP_STATUS_ERROR])
564
565
566
567

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

569
# max dynamic devices
570
571
572
MAX_NICS = 8
MAX_DISKS = 16

Iustin Pop's avatar
Iustin Pop committed
573
574
# SSCONF keys
SS_CLUSTER_NAME = "cluster_name"
575
SS_CLUSTER_TAGS = "cluster_tags"
Iustin Pop's avatar
Iustin Pop committed
576
SS_FILE_STORAGE_DIR = "file_storage_dir"
577
SS_MASTER_CANDIDATES = "master_candidates"
578
SS_MASTER_CANDIDATES_IPS = "master_candidates_ips"
Iustin Pop's avatar
Iustin Pop committed
579
580
581
582
SS_MASTER_IP = "master_ip"
SS_MASTER_NETDEV = "master_netdev"
SS_MASTER_NODE = "master_node"
SS_NODE_LIST = "node_list"
583
584
SS_NODE_PRIMARY_IPS = "node_primary_ips"
SS_NODE_SECONDARY_IPS = "node_secondary_ips"
585
SS_OFFLINE_NODES = "offline_nodes"
586
587
SS_ONLINE_NODES = "online_nodes"
SS_INSTANCE_LIST = "instance_list"
588
SS_RELEASE_VERSION = "release_version"
Iustin Pop's avatar
Iustin Pop committed
589

590
591
592
593
# cluster wide default parameters
DEFAULT_ENABLED_HYPERVISOR = HT_XEN_PVM

HVC_DEFAULTS = {
594
  HT_XEN_PVM: {
595
596
597
    HV_USE_BOOTLOADER: False,
    HV_BOOTLOADER_PATH: XEN_BOOTLOADER,
    HV_BOOTLOADER_ARGS: '',
598
    HV_KERNEL_PATH: "/boot/vmlinuz-2.6-xenU",
599
    HV_INITRD_PATH: '',
600
    HV_ROOT_PATH: '/dev/sda1',
601
    HV_KERNEL_ARGS: 'ro',
602
603
604
    },
  HT_XEN_HVM: {
    HV_BOOT_ORDER: "cd",
605
    HV_CDROM_IMAGE_PATH: '',
606
    HV_NIC_TYPE: HT_NIC_RTL8139,
607
    HV_DISK_TYPE: HT_DISK_PARAVIRTUAL,
608
    HV_VNC_BIND_ADDRESS: '0.0.0.0',
609
    HV_VNC_PASSWORD_FILE: VNC_PASSWORD_FILE,
610
611
    HV_ACPI: True,
    HV_PAE: True,
612
    HV_KERNEL_PATH: "/usr/lib/xen/boot/hvmloader",
613
    HV_DEVICE_MODEL: "/usr/lib/xen/bin/qemu-dm",
614
615
616
    },
  HT_KVM: {
    HV_KERNEL_PATH: "/boot/vmlinuz-2.6-kvmU",
617
    HV_INITRD_PATH: '',
618
    HV_KERNEL_ARGS: 'ro',
619
    HV_ROOT_PATH: '/dev/vda1',
620
621
    HV_ACPI: True,
    HV_SERIAL_CONSOLE: True,
622
    HV_VNC_BIND_ADDRESS: '',
623
624
625
    HV_VNC_TLS: False,
    HV_VNC_X509: '',
    HV_VNC_X509_VERIFY: False,
626
    HV_VNC_PASSWORD_FILE: '',
627
    HV_CDROM_IMAGE_PATH: '',
628
    HV_BOOT_ORDER: HT_BO_DISK,
629
630
    HV_NIC_TYPE: HT_NIC_PARAVIRTUAL,
    HV_DISK_TYPE: HT_DISK_PARAVIRTUAL,
631
    HV_USB_MOUSE: '',
632
633
634
    },
  HT_FAKE: {
    },
635
636
637
  HT_CHROOT: {
    HV_INIT_SCRIPT: "/ganeti-chroot",
    },
638
  }
639
640

BEC_DEFAULTS = {
641
642
643
644
  BE_MEMORY: 128,
  BE_VCPUS: 1,
  BE_AUTO_BALANCE: True,
  }
645

Guido Trotter's avatar
Guido Trotter committed
646
647
648
649
650
NICC_DEFAULTS = {
  NIC_MODE: NIC_MODE_BRIDGED,
  NIC_LINK: DEFAULT_BRIDGE,
  }

651
MASTER_POOL_SIZE_DEFAULT = 10
Guido Trotter's avatar
Guido Trotter committed
652
653
654

CONFD_PROTOCOL_VERSION = 1

655
CONFD_REQ_PING = 0
Guido Trotter's avatar
Guido Trotter committed
656
657
CONFD_REQ_NODE_ROLE_BYNAME = 1
CONFD_REQ_NODE_PIP_BY_INSTANCE_IP = 2
658
CONFD_REQ_CLUSTER_MASTER = 3
659
660
CONFD_REQ_NODE_PIP_LIST = 4
CONFD_REQ_MC_PIP_LIST = 5
661
CONFD_REQ_INSTANCES_IPS_LIST = 6
Guido Trotter's avatar
Guido Trotter committed
662
663

CONFD_REQS = frozenset([
664
  CONFD_REQ_PING,
Guido Trotter's avatar
Guido Trotter committed
665
666
  CONFD_REQ_NODE_ROLE_BYNAME,
  CONFD_REQ_NODE_PIP_BY_INSTANCE_IP,
667
  CONFD_REQ_CLUSTER_MASTER,
668
669
  CONFD_REQ_NODE_PIP_LIST,
  CONFD_REQ_MC_PIP_LIST,
670
  CONFD_REQ_INSTANCES_IPS_LIST,
Guido Trotter's avatar
Guido Trotter committed
671
672
  ])

673
674
675
676
677
678
679
680
681
682
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
683
684
685
(CONFD_NODE_ROLE_MASTER,
 CONFD_NODE_ROLE_CANDIDATE,
 CONFD_NODE_ROLE_OFFLINE,
Guido Trotter's avatar
Guido Trotter committed
686
687
688
 CONFD_NODE_ROLE_DRAINED,
 CONFD_NODE_ROLE_REGULAR,
 ) = range(5)
Guido Trotter's avatar
Guido Trotter committed
689

690
691
# A few common errors for confd
CONFD_ERROR_UNKNOWN_ENTRY = 1
692
CONFD_ERROR_INTERNAL = 2
693

Guido Trotter's avatar
Guido Trotter committed
694
695
696
697
# 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
698
699
700
701
702
703
704
705
706

# 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
707

708
709
710
711
712
713
# 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
714
715
716
717
718
719
720
721
722
723
# 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

724
725
726
727
728
729
# 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