constants.py 20.2 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
168
169
SOCAT_ESCAPE = _autoconf.SOCAT_ESCAPE
SOCAT_ESCAPE_CODE = "0x1d"
170

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

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

# 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

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

# Storage fields
200
201
202
203
# 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
204
205
206
207
208
209
SF_NAME = "name"
SF_SIZE = "size"
SF_FREE = "free"
SF_USED = "used"
SF_ALLOCATABLE = "allocatable"

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

213
# Available fields per storage type
214
215
216
217
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
218

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

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

227
228
229
230
231
232
# 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
233
234
235
# disk template types
DT_DISKLESS = "diskless"
DT_PLAIN = "plain"
236
DT_DRBD8 = "drbd"
237
DT_FILE = "file"
238
239

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

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

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

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

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

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

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

267
# disk replacement mode
268
269
270
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
271
REPLACE_DISK_AUTO = "replace_auto"
272

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

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

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

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

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

290
291
292
293
294
# dynamic device modification

DDM_ADD = 'add'
DDM_REMOVE = 'remove'

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

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

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

325

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

330
331
332
333
334
# 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
335
OS_SCRIPTS = frozenset([OS_SCRIPT_CREATE, OS_SCRIPT_IMPORT,
336
                        OS_SCRIPT_EXPORT, OS_SCRIPT_RENAME])
337

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

341
# ssh constants
342
SSH_INITD_SCRIPT = _autoconf.SSH_INITD_SCRIPT
343
344
345
346
347
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"
348
349
SSH = "ssh"
SCP = "scp"
350
351
352
353
354

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

356
357
358
359
REBOOT_TYPES = frozenset([INSTANCE_REBOOT_SOFT,
                          INSTANCE_REBOOT_HARD,
                          INSTANCE_REBOOT_FULL])

360
361
362
363
364
365
366
367
368
369
370
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,
                      ])

371
372
373
374
375
376
# 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"
377
HV_VNC_PASSWORD_FILE = "vnc_password_file"
378
379
380
HV_VNC_TLS = "vnc_tls"
HV_VNC_X509 = "vnc_x509_path"
HV_VNC_X509_VERIFY = "vnc_x509_verify"
381
382
HV_ACPI = "acpi"
HV_PAE = "pae"
383
384
385
HV_USE_BOOTLOADER = "use_bootloader"
HV_BOOTLOADER_ARGS = "bootloader_args"
HV_BOOTLOADER_PATH = "bootloader_path"
386
HV_KERNEL_ARGS = "kernel_args"
387
388
HV_KERNEL_PATH = "kernel_path"
HV_INITRD_PATH = "initrd_path"
389
HV_ROOT_PATH = "root_path"
390
HV_SERIAL_CONSOLE = "serial_console"
391
HV_USB_MOUSE = "usb_mouse"
392
HV_DEVICE_MODEL = "device_model"
393
HV_INIT_SCRIPT = "init_script"
394
HV_MIGRATION_PORT = "migration_port"
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
421
422
  }

HVS_PARAMETERS = frozenset(HVS_PARAMETER_TYPES.keys())
423

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

429
430
431
432
433
434
435
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
436

437
438
# Instance Parameters Profile
PP_DEFAULT = "default"
439

Guido Trotter's avatar
Guido Trotter committed
440
441
442
443
444
445
446
447
448
449
450
451
452
453
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())
454

455
# Hypervisor constants
Iustin Pop's avatar
Iustin Pop committed
456
HT_XEN_PVM = "xen-pvm"
457
HT_FAKE = "fake"
Iustin Pop's avatar
Iustin Pop committed
458
HT_XEN_HVM = "xen-hvm"
Guido Trotter's avatar
Guido Trotter committed
459
HT_KVM = "kvm"
460
461
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
462
HTS_REQ_PORT = frozenset([HT_XEN_HVM, HT_KVM])
463

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

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

479
480
HT_HVM_VALID_NIC_TYPES = frozenset([HT_NIC_RTL8139, HT_NIC_NE2K_PCI,
                                    HT_NIC_NE2K_ISA, HT_NIC_PARAVIRTUAL])
481
482
483
484
485
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])
486
487
488
489
490
491
492
493
494
# 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])
495
496
497
HT_KVM_VALID_DISK_TYPES = frozenset([HT_DISK_PARAVIRTUAL, HT_DISK_IDE,
                                     HT_DISK_SCSI, HT_DISK_SD, HT_DISK_MTD,
                                     HT_DISK_PFLASH])
498

499
500
501
502
503
504
505
506
507
508
509
510
511
# 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])

512
513
514
515
# Cluster Verify steps
VERIFY_NPLUSONE_MEM = 'nplusone_mem'
VERIFY_OPTIONAL_CHECKS = frozenset([VERIFY_NPLUSONE_MEM])

516
517
518
519
520
521
522
523
524
# 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"
525
526
NV_LVLIST = "lvlist"
NV_PVLIST = "pvlist"
527
NV_DRBDLIST = "drbd-list"
528
NV_NODESETUP = "nodesetup"
529

530
# Allocator framework constants
531
IALLOCATOR_VERSION = 2
532
533
534
535
536
IALLOCATOR_DIR_IN = "in"
IALLOCATOR_DIR_OUT = "out"
IALLOCATOR_MODE_ALLOC = "allocate"
IALLOCATOR_MODE_RELOC = "relocate"
IALLOCATOR_SEARCH_PATH = _autoconf.IALLOCATOR_SEARCH_PATH
537

538
539
540
541
542
# 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"
543
JOB_QUEUE_ARCHIVE_DIR = QUEUE_DIR + "/archive"
544
JOB_QUEUE_DRAIN_FILE = QUEUE_DIR + "/drain"
Michael Hanselmann's avatar
Michael Hanselmann committed
545
546
JOB_QUEUE_SIZE_HARD_LIMIT = 5000
JOB_QUEUE_SIZE_SOFT_LIMIT = JOB_QUEUE_SIZE_HARD_LIMIT * 0.8
547

548
549
JOB_ID_TEMPLATE = r"\d+"

550
551
552
# unchanged job return
JOB_NOTCHANGED = "nochange"

553
554
# Job status
JOB_STATUS_QUEUED = "queued"
Iustin Pop's avatar
Iustin Pop committed
555
JOB_STATUS_WAITLOCK = "waiting"
556
JOB_STATUS_CANCELING = "canceling"
557
558
559
560
561
JOB_STATUS_RUNNING = "running"
JOB_STATUS_CANCELED = "canceled"
JOB_STATUS_SUCCESS = "success"
JOB_STATUS_ERROR = "error"

562
563
# OpCode status
# not yet finalized
564
OP_STATUS_QUEUED = "queued"
Iustin Pop's avatar
Iustin Pop committed
565
OP_STATUS_WAITLOCK = "waiting"
566
OP_STATUS_CANCELING = "canceling"
567
OP_STATUS_RUNNING = "running"
568
# finalized
569
OP_STATUS_CANCELED = "canceled"
570
571
OP_STATUS_SUCCESS = "success"
OP_STATUS_ERROR = "error"
572
573
574
OPS_FINALIZED = frozenset([OP_STATUS_CANCELED,
                           OP_STATUS_SUCCESS,
                           OP_STATUS_ERROR])
575
576
577
578

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

580
# max dynamic devices
581
582
583
MAX_NICS = 8
MAX_DISKS = 16

Iustin Pop's avatar
Iustin Pop committed
584
585
# SSCONF keys
SS_CLUSTER_NAME = "cluster_name"
586
SS_CLUSTER_TAGS = "cluster_tags"
Iustin Pop's avatar
Iustin Pop committed
587
SS_FILE_STORAGE_DIR = "file_storage_dir"
588
SS_MASTER_CANDIDATES = "master_candidates"
589
SS_MASTER_CANDIDATES_IPS = "master_candidates_ips"
Iustin Pop's avatar
Iustin Pop committed
590
591
592
593
SS_MASTER_IP = "master_ip"
SS_MASTER_NETDEV = "master_netdev"
SS_MASTER_NODE = "master_node"
SS_NODE_LIST = "node_list"
594
595
SS_NODE_PRIMARY_IPS = "node_primary_ips"
SS_NODE_SECONDARY_IPS = "node_secondary_ips"
596
SS_OFFLINE_NODES = "offline_nodes"
597
598
SS_ONLINE_NODES = "online_nodes"
SS_INSTANCE_LIST = "instance_list"
599
SS_RELEASE_VERSION = "release_version"
Iustin Pop's avatar
Iustin Pop committed
600

601
602
603
604
# cluster wide default parameters
DEFAULT_ENABLED_HYPERVISOR = HT_XEN_PVM

HVC_DEFAULTS = {
605
  HT_XEN_PVM: {
606
607
608
    HV_USE_BOOTLOADER: False,
    HV_BOOTLOADER_PATH: XEN_BOOTLOADER,
    HV_BOOTLOADER_ARGS: '',
609
    HV_KERNEL_PATH: "/boot/vmlinuz-2.6-xenU",
610
    HV_INITRD_PATH: '',
611
    HV_ROOT_PATH: '/dev/sda1',
612
    HV_KERNEL_ARGS: 'ro',
613
    HV_MIGRATION_PORT: 8002,
614
615
616
    },
  HT_XEN_HVM: {
    HV_BOOT_ORDER: "cd",
617
    HV_CDROM_IMAGE_PATH: '',
618
    HV_NIC_TYPE: HT_NIC_RTL8139,
619
    HV_DISK_TYPE: HT_DISK_PARAVIRTUAL,
620
    HV_VNC_BIND_ADDRESS: '0.0.0.0',
621
    HV_VNC_PASSWORD_FILE: VNC_PASSWORD_FILE,
622
623
    HV_ACPI: True,
    HV_PAE: True,
624
    HV_KERNEL_PATH: "/usr/lib/xen/boot/hvmloader",
625
    HV_DEVICE_MODEL: "/usr/lib/xen/bin/qemu-dm",
626
    HV_MIGRATION_PORT: 8002,
627
628
629
    },
  HT_KVM: {
    HV_KERNEL_PATH: "/boot/vmlinuz-2.6-kvmU",
630
    HV_INITRD_PATH: '',
631
    HV_KERNEL_ARGS: 'ro',
632
    HV_ROOT_PATH: '/dev/vda1',
633
634
    HV_ACPI: True,
    HV_SERIAL_CONSOLE: True,
635
    HV_VNC_BIND_ADDRESS: '',
636
637
638
    HV_VNC_TLS: False,
    HV_VNC_X509: '',
    HV_VNC_X509_VERIFY: False,
639
    HV_VNC_PASSWORD_FILE: '',
640
    HV_CDROM_IMAGE_PATH: '',
641
    HV_BOOT_ORDER: HT_BO_DISK,
642
643
    HV_NIC_TYPE: HT_NIC_PARAVIRTUAL,
    HV_DISK_TYPE: HT_DISK_PARAVIRTUAL,
644
    HV_USB_MOUSE: '',
645
    HV_MIGRATION_PORT: _autoconf.KVM_MIGRATION_PORT,
646
647
648
    },
  HT_FAKE: {
    },
649
650
651
  HT_CHROOT: {
    HV_INIT_SCRIPT: "/ganeti-chroot",
    },
652
  }
653
654

BEC_DEFAULTS = {
655
656
657
658
  BE_MEMORY: 128,
  BE_VCPUS: 1,
  BE_AUTO_BALANCE: True,
  }
659

Guido Trotter's avatar
Guido Trotter committed
660
661
662
663
664
NICC_DEFAULTS = {
  NIC_MODE: NIC_MODE_BRIDGED,
  NIC_LINK: DEFAULT_BRIDGE,
  }

665
MASTER_POOL_SIZE_DEFAULT = 10
Guido Trotter's avatar
Guido Trotter committed
666
667
668

CONFD_PROTOCOL_VERSION = 1

669
CONFD_REQ_PING = 0
Guido Trotter's avatar
Guido Trotter committed
670
671
CONFD_REQ_NODE_ROLE_BYNAME = 1
CONFD_REQ_NODE_PIP_BY_INSTANCE_IP = 2
672
CONFD_REQ_CLUSTER_MASTER = 3
673
674
CONFD_REQ_NODE_PIP_LIST = 4
CONFD_REQ_MC_PIP_LIST = 5
675
CONFD_REQ_INSTANCES_IPS_LIST = 6
Guido Trotter's avatar
Guido Trotter committed
676

677
678
679
680
681
682
683
# 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
684
CONFD_REQS = frozenset([
685
  CONFD_REQ_PING,
Guido Trotter's avatar
Guido Trotter committed
686
687
  CONFD_REQ_NODE_ROLE_BYNAME,
  CONFD_REQ_NODE_PIP_BY_INSTANCE_IP,
688
  CONFD_REQ_CLUSTER_MASTER,
689
690
  CONFD_REQ_NODE_PIP_LIST,
  CONFD_REQ_MC_PIP_LIST,
691
  CONFD_REQ_INSTANCES_IPS_LIST,
Guido Trotter's avatar
Guido Trotter committed
692
693
  ])

694
695
696
697
698
699
700
701
702
703
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
704
705
706
(CONFD_NODE_ROLE_MASTER,
 CONFD_NODE_ROLE_CANDIDATE,
 CONFD_NODE_ROLE_OFFLINE,
Guido Trotter's avatar
Guido Trotter committed
707
708
709
 CONFD_NODE_ROLE_DRAINED,
 CONFD_NODE_ROLE_REGULAR,
 ) = range(5)
Guido Trotter's avatar
Guido Trotter committed
710

711
712
# A few common errors for confd
CONFD_ERROR_UNKNOWN_ENTRY = 1
713
CONFD_ERROR_INTERNAL = 2
714
CONFD_ERROR_ARGUMENT = 3
715

Guido Trotter's avatar
Guido Trotter committed
716
717
718
719
# 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
720
721
722
723
724
725
726
727
728

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

730
731
732
733
734
735
# 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
736
737
738
739
740
741
742
743
744
745
# 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

746
747
748
749
750
751
# 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