constants.py 21 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
25
import re

26
from ganeti import _autoconf
27

Iustin Pop's avatar
Iustin Pop committed
28
# various versions
29
PROTOCOL_VERSION = 30
30
RELEASE_VERSION = _autoconf.PACKAGE_VERSION
Guido Trotter's avatar
Guido Trotter committed
31
32
33
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
34
EXPORT_VERSION = 0
35
RAPI_VERSION = 2
Iustin Pop's avatar
Iustin Pop committed
36

37

38
39
40
41
42
43
44
45
# 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.
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
78
79

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


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

# file paths
86
DATA_DIR = _autoconf.LOCALSTATEDIR + "/lib/ganeti"
87
RUN_DIR = _autoconf.LOCALSTATEDIR + "/run"
88
RUN_GANETI_DIR = RUN_DIR + "/ganeti"
89
BDEV_CACHE_DIR = RUN_GANETI_DIR + "/bdev-cache"
90
DISK_LINKS_DIR = RUN_GANETI_DIR + "/instance-disks"
91
RUN_DIRS_MODE = 0755
Guido Trotter's avatar
Guido Trotter committed
92
SOCKET_DIR = RUN_GANETI_DIR + "/socket"
Guido Trotter's avatar
Guido Trotter committed
93
SOCKET_DIR_MODE = 0700
94
95
96
# 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
97
LOCK_DIR = _autoconf.LOCALSTATEDIR + "/lock"
98
SSCONF_LOCK_FILE = LOCK_DIR + "/ganeti-ssconf.lock"
Iustin Pop's avatar
Iustin Pop committed
99
100
CLUSTER_CONF_FILE = DATA_DIR + "/config.data"
SSL_CERT_FILE = DATA_DIR + "/server.pem"
101
RAPI_CERT_FILE = DATA_DIR + "/rapi.pem"
102
HMAC_CLUSTER_KEY = DATA_DIR + "/hmac.key"
103
WATCHER_STATEFILE = DATA_DIR + "/watcher.data"
104
WATCHER_PAUSEFILE = DATA_DIR + "/watcher.pause"
105
INSTANCE_UPFILE = RUN_GANETI_DIR + "/instance-status"
Iustin Pop's avatar
Iustin Pop committed
106
SSH_KNOWN_HOSTS_FILE = DATA_DIR + "/known_hosts"
107
RAPI_USERS_FILE = DATA_DIR + "/rapi_users"
108
QUEUE_DIR = DATA_DIR + "/queue"
109
DAEMON_UTIL = _autoconf.PKGLIBDIR + "/daemon-util"
110
ETC_HOSTS = "/etc/hosts"
111
DEFAULT_FILE_STORAGE_DIR = _autoconf.FILE_STORAGE_DIR
112
SYSCONFDIR = _autoconf.SYSCONFDIR
113
TOOLSDIR = _autoconf.TOOLSDIR
114
CONF_DIR = SYSCONFDIR + "/ganeti"
115

116
MASTER_SOCKET = SOCKET_DIR + "/ganeti-master"
Iustin Pop's avatar
Iustin Pop committed
117

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

123
124
MULTITHREADED_DAEMONS = frozenset([MASTERD])

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

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

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

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

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

EXPORT_CONF_FILE = "config.ini"

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

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

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

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

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

# 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

198
199
200
201
# Storage types
ST_FILE = "file"
ST_LVM_PV = "lvm-pv"
ST_LVM_VG = "lvm-vg"
202
203

# Storage fields
204
205
206
207
# 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
208
209
210
211
212
213
SF_NAME = "name"
SF_SIZE = "size"
SF_FREE = "free"
SF_USED = "used"
SF_ALLOCATABLE = "allocatable"

214
215
216
# Storage operations
SO_FIX_CONSISTENCY = "fix-consistency"

217
# Available fields per storage type
218
219
220
221
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
222

223
224
225
226
MODIFIABLE_STORAGE_FIELDS = {
  ST_LVM_PV: frozenset([SF_ALLOCATABLE]),
  }

227
VALID_STORAGE_OPERATIONS = {
228
  ST_LVM_VG: frozenset([SO_FIX_CONSISTENCY]),
229
230
  }

231
232
233
234
235
236
# 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
237
238
239
# disk template types
DT_DISKLESS = "diskless"
DT_PLAIN = "plain"
240
DT_DRBD8 = "drbd"
241
DT_FILE = "file"
242
243

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

246
247
248
# the set of non-lvm-based disk templates
DTS_NOT_LVM = frozenset([DT_DISKLESS, DT_FILE])

249
250
# logical disk types
LD_LV = "lvm"
251
LD_DRBD8 = "drbd8"
252
LD_FILE = "file"
253
LDS_BLOCK = frozenset([LD_LV, LD_DRBD8])
254

Iustin Pop's avatar
Iustin Pop committed
255
256
# drbd constants
DRBD_HMAC_ALG = "md5"
257
DRBD_NET_PROTOCOL = "C"
Iustin Pop's avatar
Iustin Pop committed
258

259
260
261
# file backend driver
FD_LOOP = "loop"
FD_BLKTAP = "blktap"
262
263

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

266
# disk access mode
267
268
DISK_RDONLY = "ro"
DISK_RDWR = "rw"
269
270
DISK_ACCESS_SET = frozenset([DISK_RDONLY, DISK_RDWR])

271
# disk replacement mode
272
273
274
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
275
REPLACE_DISK_AUTO = "replace_auto"
276

277
278
# lock recalculate mode
LOCKS_REPLACE = 'replace'
279
LOCKS_APPEND = 'append'
280

281
# instance creation modes
Iustin Pop's avatar
Iustin Pop committed
282
283
284
285
INSTANCE_CREATE = "create"
INSTANCE_IMPORT = "import"

DISK_TEMPLATES = frozenset([DT_DISKLESS, DT_PLAIN,
286
287
288
                            DT_DRBD8, DT_FILE])

FILE_DRIVER = frozenset([FD_LOOP, FD_BLKTAP])
Iustin Pop's avatar
Iustin Pop committed
289
290
291
292

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

294
295
296
297
298
# dynamic device modification

DDM_ADD = 'add'
DDM_REMOVE = 'remove'

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

308
309
310
311
312
313
314
# tags
TAG_CLUSTER = "cluster"
TAG_NODE = "node"
TAG_INSTANCE = "instance"
MAX_TAG_LEN = 128
MAX_TAGS_PER_OBJ = 4096

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

330
331
332
333
# RPC constants
(RPC_ENCODING_NONE,
 RPC_ENCODING_ZLIB_BASE64) = range(2)

334
335
336
337
338
# 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
339
OS_SCRIPTS = frozenset([OS_SCRIPT_CREATE, OS_SCRIPT_IMPORT,
340
                        OS_SCRIPT_EXPORT, OS_SCRIPT_RENAME])
341

342
OS_API_FILE = 'ganeti_api_version'
343
OS_VARIANTS_FILE = 'variants.list'
344

345
346
347
348
349
350
# 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"
351
352
SSH = "ssh"
SCP = "scp"
353
354
355
356
357

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

359
360
361
362
REBOOT_TYPES = frozenset([INSTANCE_REBOOT_SOFT,
                          INSTANCE_REBOOT_HARD,
                          INSTANCE_REBOOT_FULL])

363
364
365
366
367
368
369
370
371
372
373
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,
                      ])

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

401
402
403
404
405
HVS_PARAMETER_TYPES = {
  HV_BOOT_ORDER: VTYPE_STRING,
  HV_CDROM_IMAGE_PATH: VTYPE_STRING,
  HV_NIC_TYPE: VTYPE_STRING,
  HV_DISK_TYPE: VTYPE_STRING,
406
  HV_VNC_PASSWORD_FILE: VTYPE_STRING,
407
408
409
410
411
412
  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,
413
414
415
  HV_USE_BOOTLOADER: VTYPE_BOOL,
  HV_BOOTLOADER_PATH: VTYPE_STRING,
  HV_BOOTLOADER_ARGS: VTYPE_STRING,
416
  HV_KERNEL_PATH: VTYPE_STRING,
417
  HV_KERNEL_ARGS: VTYPE_STRING,
418
419
420
421
  HV_INITRD_PATH: VTYPE_STRING,
  HV_ROOT_PATH: VTYPE_STRING,
  HV_SERIAL_CONSOLE: VTYPE_BOOL,
  HV_USB_MOUSE: VTYPE_STRING,
422
  HV_DEVICE_MODEL: VTYPE_STRING,
423
  HV_INIT_SCRIPT: VTYPE_STRING,
424
  HV_MIGRATION_PORT: VTYPE_INT,
425
  HV_USE_LOCALTIME: VTYPE_BOOL,
426
  HV_DISK_CACHE: VTYPE_STRING,
427
428
429
  }

HVS_PARAMETERS = frozenset(HVS_PARAMETER_TYPES.keys())
430

431
# BE parameter names
Iustin Pop's avatar
Iustin Pop committed
432
BE_MEMORY = "memory"
433
BE_VCPUS = "vcpus"
434
BE_AUTO_BALANCE = "auto_balance"
435

436
437
438
439
440
441
442
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
443

444
445
# Instance Parameters Profile
PP_DEFAULT = "default"
446

Guido Trotter's avatar
Guido Trotter committed
447
448
449
450
451
452
453
454
455
456
457
458
459
460
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())
461

462
# Hypervisor constants
Iustin Pop's avatar
Iustin Pop committed
463
HT_XEN_PVM = "xen-pvm"
464
HT_FAKE = "fake"
Iustin Pop's avatar
Iustin Pop committed
465
HT_XEN_HVM = "xen-hvm"
Guido Trotter's avatar
Guido Trotter committed
466
HT_KVM = "kvm"
467
468
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
469
HTS_REQ_PORT = frozenset([HT_XEN_HVM, HT_KVM])
470

471
VNC_BASE_PORT = 5900
472
VNC_PASSWORD_FILE = CONF_DIR + "/vnc-cluster-password"
473
VNC_DEFAULT_BIND_ADDRESS = '0.0.0.0'
474

475
# NIC types
476
477
478
HT_NIC_RTL8139 = "rtl8139"
HT_NIC_NE2K_PCI = "ne2k_pci"
HT_NIC_NE2K_ISA = "ne2k_isa"
479
480
481
482
483
HT_NIC_I82551 = "i82551"
HT_NIC_I85557B = "i82557b"
HT_NIC_I8259ER = "i82559er"
HT_NIC_PCNET = "pcnet"
HT_NIC_E1000 = "e1000"
484
HT_NIC_PARAVIRTUAL = HT_DISK_PARAVIRTUAL = "paravirtual"
485

486
487
HT_HVM_VALID_NIC_TYPES = frozenset([HT_NIC_RTL8139, HT_NIC_NE2K_PCI,
                                    HT_NIC_NE2K_ISA, HT_NIC_PARAVIRTUAL])
488
489
490
491
492
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])
493
494
495
496
497
498
499
500
# 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"

501
502
503
504
505
506
507
508
509
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])

510
HT_HVM_VALID_DISK_TYPES = frozenset([HT_DISK_PARAVIRTUAL, HT_DISK_IOEMU])
511
512
513
HT_KVM_VALID_DISK_TYPES = frozenset([HT_DISK_PARAVIRTUAL, HT_DISK_IDE,
                                     HT_DISK_SCSI, HT_DISK_SD, HT_DISK_MTD,
                                     HT_DISK_PFLASH])
514

515
516
517
518
519
520
521
522
523
524
525
526
527
# 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])

528
529
530
531
# Cluster Verify steps
VERIFY_NPLUSONE_MEM = 'nplusone_mem'
VERIFY_OPTIONAL_CHECKS = frozenset([VERIFY_NPLUSONE_MEM])

532
533
534
535
536
537
538
539
540
# 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"
541
542
NV_LVLIST = "lvlist"
NV_PVLIST = "pvlist"
543
NV_DRBDLIST = "drbd-list"
544
NV_NODESETUP = "nodesetup"
545
NV_TIME = "time"
546

547
# Allocator framework constants
548
IALLOCATOR_VERSION = 2
549
550
551
552
553
IALLOCATOR_DIR_IN = "in"
IALLOCATOR_DIR_OUT = "out"
IALLOCATOR_MODE_ALLOC = "allocate"
IALLOCATOR_MODE_RELOC = "relocate"
IALLOCATOR_SEARCH_PATH = _autoconf.IALLOCATOR_SEARCH_PATH
554

555
556
557
558
559
# 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"
560
JOB_QUEUE_ARCHIVE_DIR = QUEUE_DIR + "/archive"
561
JOB_QUEUE_DRAIN_FILE = QUEUE_DIR + "/drain"
Michael Hanselmann's avatar
Michael Hanselmann committed
562
563
JOB_QUEUE_SIZE_HARD_LIMIT = 5000
JOB_QUEUE_SIZE_SOFT_LIMIT = JOB_QUEUE_SIZE_HARD_LIMIT * 0.8
564

565
566
JOB_ID_TEMPLATE = r"\d+"

567
568
569
# unchanged job return
JOB_NOTCHANGED = "nochange"

570
571
# Job status
JOB_STATUS_QUEUED = "queued"
Iustin Pop's avatar
Iustin Pop committed
572
JOB_STATUS_WAITLOCK = "waiting"
573
JOB_STATUS_CANCELING = "canceling"
574
575
576
577
578
JOB_STATUS_RUNNING = "running"
JOB_STATUS_CANCELED = "canceled"
JOB_STATUS_SUCCESS = "success"
JOB_STATUS_ERROR = "error"

579
580
# OpCode status
# not yet finalized
581
OP_STATUS_QUEUED = "queued"
Iustin Pop's avatar
Iustin Pop committed
582
OP_STATUS_WAITLOCK = "waiting"
583
OP_STATUS_CANCELING = "canceling"
584
OP_STATUS_RUNNING = "running"
585
# finalized
586
OP_STATUS_CANCELED = "canceled"
587
588
OP_STATUS_SUCCESS = "success"
OP_STATUS_ERROR = "error"
589
590
591
OPS_FINALIZED = frozenset([OP_STATUS_CANCELED,
                           OP_STATUS_SUCCESS,
                           OP_STATUS_ERROR])
592
593
594
595

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

597
# max dynamic devices
598
599
600
MAX_NICS = 8
MAX_DISKS = 16

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

618
619
620
621
# cluster wide default parameters
DEFAULT_ENABLED_HYPERVISOR = HT_XEN_PVM

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

674
675
676
677
HVC_GLOBALS = frozenset([
  HV_MIGRATION_PORT,
  ])

678
BEC_DEFAULTS = {
679
680
681
682
  BE_MEMORY: 128,
  BE_VCPUS: 1,
  BE_AUTO_BALANCE: True,
  }
683

Guido Trotter's avatar
Guido Trotter committed
684
685
686
687
688
NICC_DEFAULTS = {
  NIC_MODE: NIC_MODE_BRIDGED,
  NIC_LINK: DEFAULT_BRIDGE,
  }

689
MASTER_POOL_SIZE_DEFAULT = 10
Guido Trotter's avatar
Guido Trotter committed
690
691
692

CONFD_PROTOCOL_VERSION = 1

693
CONFD_REQ_PING = 0
Guido Trotter's avatar
Guido Trotter committed
694
695
CONFD_REQ_NODE_ROLE_BYNAME = 1
CONFD_REQ_NODE_PIP_BY_INSTANCE_IP = 2
696
CONFD_REQ_CLUSTER_MASTER = 3
697
698
CONFD_REQ_NODE_PIP_LIST = 4
CONFD_REQ_MC_PIP_LIST = 5
699
CONFD_REQ_INSTANCES_IPS_LIST = 6
Guido Trotter's avatar
Guido Trotter committed
700

701
702
703
704
705
706
# 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"
707
708
709
710
CONFD_REQQ_FIELDS = "3"

CONFD_REQFIELD_NAME = "0"
CONFD_REQFIELD_IP = "1"
711
CONFD_REQFIELD_MNODE_PIP = "2"
712

Guido Trotter's avatar
Guido Trotter committed
713
CONFD_REQS = frozenset([
714
  CONFD_REQ_PING,
Guido Trotter's avatar
Guido Trotter committed
715
716
  CONFD_REQ_NODE_ROLE_BYNAME,
  CONFD_REQ_NODE_PIP_BY_INSTANCE_IP,
717
  CONFD_REQ_CLUSTER_MASTER,
718
719
  CONFD_REQ_NODE_PIP_LIST,
  CONFD_REQ_MC_PIP_LIST,
720
  CONFD_REQ_INSTANCES_IPS_LIST,
Guido Trotter's avatar
Guido Trotter committed
721
722
  ])

723
724
725
726
727
728
729
730
731
732
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
733
734
735
(CONFD_NODE_ROLE_MASTER,
 CONFD_NODE_ROLE_CANDIDATE,
 CONFD_NODE_ROLE_OFFLINE,
Guido Trotter's avatar
Guido Trotter committed
736
737
738
 CONFD_NODE_ROLE_DRAINED,
 CONFD_NODE_ROLE_REGULAR,
 ) = range(5)
Guido Trotter's avatar
Guido Trotter committed
739

740
741
# A few common errors for confd
CONFD_ERROR_UNKNOWN_ENTRY = 1
742
CONFD_ERROR_INTERNAL = 2
743
CONFD_ERROR_ARGUMENT = 3
744

Guido Trotter's avatar
Guido Trotter committed
745
746
747
# 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
748
CONFD_MAX_CLOCK_SKEW = 2 * NODE_MAX_CLOCK_SKEW
749
750
751
752
753
754
755
756
757

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

759
760
761
762
763
764
# 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
765
766
767
768
769
770
771
772
773
774
# 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

775
776
777
778
779
780
# 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