constants.py 21.7 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"
Guido Trotter's avatar
Guido Trotter committed
122
123
# used in the ganeti-nbma project
NLD = "ganeti-nld"
124

125
126
MULTITHREADED_DAEMONS = frozenset([MASTERD])

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

133
134
135
DAEMONS_PORTS = {
  # daemon-name: ("proto", "default-port")
  NODED: ("tcp", 1811),
Guido Trotter's avatar
Guido Trotter committed
136
  CONFD: ("udp", 1814),
Guido Trotter's avatar
Guido Trotter committed
137
  RAPI: ("tcp", 5080),
Guido Trotter's avatar
Guido Trotter committed
138
139
  # used in the ganeti-nbma project
  NLD: ("udp", 1816),
140
141
}
DEFAULT_NODED_PORT = DAEMONS_PORTS[NODED][1]
Guido Trotter's avatar
Guido Trotter committed
142
DEFAULT_CONFD_PORT = DAEMONS_PORTS[CONFD][1]
Guido Trotter's avatar
Guido Trotter committed
143
DEFAULT_RAPI_PORT = DAEMONS_PORTS[RAPI][1]
Guido Trotter's avatar
Guido Trotter committed
144
145
# used in the ganeti-nbma project
DEFAULT_NLD_PORT = DAEMONS_PORTS[NLD][1]
146

Iustin Pop's avatar
Iustin Pop committed
147
148
FIRST_DRBD_PORT = 11000
LAST_DRBD_PORT = 14999
149
MASTER_SCRIPT = "ganeti-master"
Iustin Pop's avatar
Iustin Pop committed
150

151
LOG_DIR = _autoconf.LOCALSTATEDIR + "/log/ganeti/"
152
DAEMONS_LOGFILES = {
Michael Hanselmann's avatar
Michael Hanselmann committed
153
154
155
156
157
  # "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",
Guido Trotter's avatar
Guido Trotter committed
158
159
  # used in the ganeti-nbma project
  NLD: LOG_DIR + "nl-daemon.log",
Michael Hanselmann's avatar
Michael Hanselmann committed
160
  }
161
162
163
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
164
LOG_BURNIN = LOG_DIR + "burnin.log"
Iustin Pop's avatar
Iustin Pop committed
165

166
167
168
169
170
171
172
# one of 'no', 'yes', 'only'
SYSLOG_USAGE = _autoconf.SYSLOG_USAGE
SYSLOG_NO = "no"
SYSLOG_YES = "yes"
SYSLOG_ONLY = "only"
SYSLOG_SOCKET = "/dev/log"

173
OS_SEARCH_PATH = _autoconf.OS_SEARCH_PATH
174
EXPORT_DIR = _autoconf.EXPORT_DIR
Iustin Pop's avatar
Iustin Pop committed
175
176
177

EXPORT_CONF_FILE = "config.ini"

178
XEN_BOOTLOADER = _autoconf.XEN_BOOTLOADER
179
180
181
XEN_KERNEL = _autoconf.XEN_KERNEL
XEN_INITRD = _autoconf.XEN_INITRD

182
KVM_PATH = _autoconf.KVM_PATH
Guido Trotter's avatar
Guido Trotter committed
183
SOCAT_PATH = _autoconf.SOCAT_PATH
184
SOCAT_USE_ESCAPE = _autoconf.SOCAT_USE_ESCAPE
185
SOCAT_ESCAPE_CODE = "0x1d"
186

187
VALUE_DEFAULT = "default"
188
189
VALUE_AUTO = "auto"
VALUE_GENERATE = "generate"
190
VALUE_NONE = "none"
191
192
VALUE_TRUE = "true"
VALUE_FALSE = "false"
193

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

Iustin Pop's avatar
Iustin Pop committed
197
# hooks-related constants
198
HOOKS_BASE_DIR = CONF_DIR + "/hooks"
Iustin Pop's avatar
Iustin Pop committed
199
200
HOOKS_PHASE_PRE = "pre"
HOOKS_PHASE_POST = "post"
201
HOOKS_NAME_CFGUPDATE = "config-update"
Guido Trotter's avatar
Guido Trotter committed
202
HOOKS_NAME_WATCHER = "watcher"
203
HOOKS_VERSION = 2
Iustin Pop's avatar
Iustin Pop committed
204
205
206
207
208
209
210
211
212
213

# 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

214
215
216
217
# Storage types
ST_FILE = "file"
ST_LVM_PV = "lvm-pv"
ST_LVM_VG = "lvm-vg"
218
219

# Storage fields
220
221
222
223
# 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
224
225
226
227
228
229
SF_NAME = "name"
SF_SIZE = "size"
SF_FREE = "free"
SF_USED = "used"
SF_ALLOCATABLE = "allocatable"

230
231
232
# Storage operations
SO_FIX_CONSISTENCY = "fix-consistency"

233
# Available fields per storage type
234
235
236
237
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
238

239
240
241
242
MODIFIABLE_STORAGE_FIELDS = {
  ST_LVM_PV: frozenset([SF_ALLOCATABLE]),
  }

243
VALID_STORAGE_OPERATIONS = {
244
  ST_LVM_VG: frozenset([SO_FIX_CONSISTENCY]),
245
246
  }

247
248
249
250
251
252
# 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
253
254
255
# disk template types
DT_DISKLESS = "diskless"
DT_PLAIN = "plain"
256
DT_DRBD8 = "drbd"
257
DT_FILE = "file"
258
259

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

262
263
264
# the set of non-lvm-based disk templates
DTS_NOT_LVM = frozenset([DT_DISKLESS, DT_FILE])

265
266
# logical disk types
LD_LV = "lvm"
267
LD_DRBD8 = "drbd8"
268
LD_FILE = "file"
269
LDS_BLOCK = frozenset([LD_LV, LD_DRBD8])
270

Iustin Pop's avatar
Iustin Pop committed
271
272
# drbd constants
DRBD_HMAC_ALG = "md5"
273
DRBD_NET_PROTOCOL = "C"
274
DRBD_BARRIERS = _autoconf.DRBD_BARRIERS
Iustin Pop's avatar
Iustin Pop committed
275

276
277
278
# file backend driver
FD_LOOP = "loop"
FD_BLKTAP = "blktap"
279
280

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

283
# disk access mode
284
285
DISK_RDONLY = "ro"
DISK_RDWR = "rw"
286
287
DISK_ACCESS_SET = frozenset([DISK_RDONLY, DISK_RDWR])

288
# disk replacement mode
289
290
291
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
292
REPLACE_DISK_AUTO = "replace_auto"
293

294
295
# lock recalculate mode
LOCKS_REPLACE = 'replace'
296
LOCKS_APPEND = 'append'
297

298
# instance creation modes
Iustin Pop's avatar
Iustin Pop committed
299
300
301
302
INSTANCE_CREATE = "create"
INSTANCE_IMPORT = "import"

DISK_TEMPLATES = frozenset([DT_DISKLESS, DT_PLAIN,
303
304
305
                            DT_DRBD8, DT_FILE])

FILE_DRIVER = frozenset([FD_LOOP, FD_BLKTAP])
Iustin Pop's avatar
Iustin Pop committed
306
307
308
309

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

311
312
313
314
315
# dynamic device modification

DDM_ADD = 'add'
DDM_REMOVE = 'remove'

316
# common exit codes
Iustin Pop's avatar
Iustin Pop committed
317
EXIT_SUCCESS = 0
318
EXIT_FAILURE = 1
319
EXIT_NOTCLUSTER = 5
320
EXIT_NOTMASTER = 11
321
EXIT_NODESETUP_ERROR = 12
Iustin Pop's avatar
Iustin Pop committed
322
EXIT_CONFIRMATION = 13 # need user confirmation
Guido Trotter's avatar
Guido Trotter committed
323
EXIT_NOTCANDIDATE = 14
324

325
326
327
328
329
330
331
# tags
TAG_CLUSTER = "cluster"
TAG_NODE = "node"
TAG_INSTANCE = "instance"
MAX_TAG_LEN = 128
MAX_TAGS_PER_OBJ = 4096

332
333
# others
DEFAULT_BRIDGE = "xen-br0"
Iustin Pop's avatar
Iustin Pop committed
334
SYNC_SPEED = 60 * 1024
Iustin Pop's avatar
Iustin Pop committed
335
LOCALHOST_IP_ADDRESS = "127.0.0.1"
336
TCP_PING_TIMEOUT = 10
337
GANETI_RUNAS = "root"
338
DEFAULT_VG = "xenvg"
339
BIND_ADDRESS_GLOBAL = "0.0.0.0"
340
MIN_VG_SIZE = 20480
341
DEFAULT_MAC_PREFIX = "aa:00:00"
342
LVM_STRIPECOUNT = _autoconf.LVM_STRIPECOUNT
343
344
# default maximum instance wait time, in seconds.
DEFAULT_SHUTDOWN_TIMEOUT = 120
345
NODE_MAX_CLOCK_SKEW = 150
346

347
348
349
350
351
352
353
# runparts results
(RUNPARTS_SKIP,
 RUNPARTS_RUN,
 RUNPARTS_ERR) = range(3)

RUNPARTS_STATUS = frozenset([RUNPARTS_SKIP, RUNPARTS_RUN, RUNPARTS_ERR])

354
355
356
357
# RPC constants
(RPC_ENCODING_NONE,
 RPC_ENCODING_ZLIB_BASE64) = range(2)

358
359
360
361
362
# 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
363
OS_SCRIPTS = frozenset([OS_SCRIPT_CREATE, OS_SCRIPT_IMPORT,
364
                        OS_SCRIPT_EXPORT, OS_SCRIPT_RENAME])
365

366
OS_API_FILE = 'ganeti_api_version'
367
OS_VARIANTS_FILE = 'variants.list'
368

369
# ssh constants
370
371
SSH_CONFIG_DIR = _autoconf.SSH_CONFIG_DIR
SSH_HOST_DSA_PRIV = SSH_CONFIG_DIR + "/ssh_host_dsa_key"
372
SSH_HOST_DSA_PUB = SSH_HOST_DSA_PRIV + ".pub"
373
SSH_HOST_RSA_PRIV = SSH_CONFIG_DIR + "/ssh_host_rsa_key"
374
SSH_HOST_RSA_PUB = SSH_HOST_RSA_PRIV + ".pub"
375
376
SSH = "ssh"
SCP = "scp"
377
378
379
380
381

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

383
384
385
386
REBOOT_TYPES = frozenset([INSTANCE_REBOOT_SOFT,
                          INSTANCE_REBOOT_HARD,
                          INSTANCE_REBOOT_FULL])

387
388
389
390
391
392
393
394
395
396
397
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,
                      ])

398
399
400
401
402
403
# 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"
404
HV_VNC_PASSWORD_FILE = "vnc_password_file"
405
406
407
HV_VNC_TLS = "vnc_tls"
HV_VNC_X509 = "vnc_x509_path"
HV_VNC_X509_VERIFY = "vnc_x509_verify"
408
409
HV_ACPI = "acpi"
HV_PAE = "pae"
410
411
412
HV_USE_BOOTLOADER = "use_bootloader"
HV_BOOTLOADER_ARGS = "bootloader_args"
HV_BOOTLOADER_PATH = "bootloader_path"
413
HV_KERNEL_ARGS = "kernel_args"
414
415
HV_KERNEL_PATH = "kernel_path"
HV_INITRD_PATH = "initrd_path"
416
HV_ROOT_PATH = "root_path"
417
HV_SERIAL_CONSOLE = "serial_console"
418
HV_USB_MOUSE = "usb_mouse"
419
HV_DEVICE_MODEL = "device_model"
420
HV_INIT_SCRIPT = "init_script"
421
HV_MIGRATION_PORT = "migration_port"
422
HV_USE_LOCALTIME = "use_localtime"
423
HV_DISK_CACHE = "disk_cache"
424

425
426
427
428
429
HVS_PARAMETER_TYPES = {
  HV_BOOT_ORDER: VTYPE_STRING,
  HV_CDROM_IMAGE_PATH: VTYPE_STRING,
  HV_NIC_TYPE: VTYPE_STRING,
  HV_DISK_TYPE: VTYPE_STRING,
430
  HV_VNC_PASSWORD_FILE: VTYPE_STRING,
431
432
433
434
435
436
  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,
437
438
439
  HV_USE_BOOTLOADER: VTYPE_BOOL,
  HV_BOOTLOADER_PATH: VTYPE_STRING,
  HV_BOOTLOADER_ARGS: VTYPE_STRING,
440
  HV_KERNEL_PATH: VTYPE_STRING,
441
  HV_KERNEL_ARGS: VTYPE_STRING,
442
443
444
445
  HV_INITRD_PATH: VTYPE_STRING,
  HV_ROOT_PATH: VTYPE_STRING,
  HV_SERIAL_CONSOLE: VTYPE_BOOL,
  HV_USB_MOUSE: VTYPE_STRING,
446
  HV_DEVICE_MODEL: VTYPE_STRING,
447
  HV_INIT_SCRIPT: VTYPE_STRING,
448
  HV_MIGRATION_PORT: VTYPE_INT,
449
  HV_USE_LOCALTIME: VTYPE_BOOL,
450
  HV_DISK_CACHE: VTYPE_STRING,
451
452
453
  }

HVS_PARAMETERS = frozenset(HVS_PARAMETER_TYPES.keys())
454

455
# BE parameter names
Iustin Pop's avatar
Iustin Pop committed
456
BE_MEMORY = "memory"
457
BE_VCPUS = "vcpus"
458
BE_AUTO_BALANCE = "auto_balance"
459

460
461
462
463
464
465
466
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
467

468
469
# Instance Parameters Profile
PP_DEFAULT = "default"
470

Guido Trotter's avatar
Guido Trotter committed
471
472
473
474
475
476
477
478
479
480
481
482
483
484
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())
485

486
# Hypervisor constants
Iustin Pop's avatar
Iustin Pop committed
487
HT_XEN_PVM = "xen-pvm"
488
HT_FAKE = "fake"
Iustin Pop's avatar
Iustin Pop committed
489
HT_XEN_HVM = "xen-hvm"
Guido Trotter's avatar
Guido Trotter committed
490
HT_KVM = "kvm"
491
492
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
493
HTS_REQ_PORT = frozenset([HT_XEN_HVM, HT_KVM])
494

495
VNC_BASE_PORT = 5900
496
VNC_PASSWORD_FILE = CONF_DIR + "/vnc-cluster-password"
497
VNC_DEFAULT_BIND_ADDRESS = '0.0.0.0'
498

499
# NIC types
500
501
502
HT_NIC_RTL8139 = "rtl8139"
HT_NIC_NE2K_PCI = "ne2k_pci"
HT_NIC_NE2K_ISA = "ne2k_isa"
503
504
505
506
507
HT_NIC_I82551 = "i82551"
HT_NIC_I85557B = "i82557b"
HT_NIC_I8259ER = "i82559er"
HT_NIC_PCNET = "pcnet"
HT_NIC_E1000 = "e1000"
508
HT_NIC_PARAVIRTUAL = HT_DISK_PARAVIRTUAL = "paravirtual"
509

510
511
HT_HVM_VALID_NIC_TYPES = frozenset([HT_NIC_RTL8139, HT_NIC_NE2K_PCI,
                                    HT_NIC_NE2K_ISA, HT_NIC_PARAVIRTUAL])
512
513
514
515
516
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])
517
518
519
520
521
522
523
524
# 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"

525
526
527
528
529
530
531
532
533
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])

534
HT_HVM_VALID_DISK_TYPES = frozenset([HT_DISK_PARAVIRTUAL, HT_DISK_IOEMU])
535
536
537
HT_KVM_VALID_DISK_TYPES = frozenset([HT_DISK_PARAVIRTUAL, HT_DISK_IDE,
                                     HT_DISK_SCSI, HT_DISK_SD, HT_DISK_MTD,
                                     HT_DISK_PFLASH])
538

539
540
541
542
543
544
545
546
547
548
549
550
551
# 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])

552
553
554
555
# Cluster Verify steps
VERIFY_NPLUSONE_MEM = 'nplusone_mem'
VERIFY_OPTIONAL_CHECKS = frozenset([VERIFY_NPLUSONE_MEM])

556
557
558
559
560
561
562
563
564
# 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"
565
566
NV_LVLIST = "lvlist"
NV_PVLIST = "pvlist"
567
NV_DRBDLIST = "drbd-list"
568
NV_NODESETUP = "nodesetup"
569
NV_TIME = "time"
570

571
# Allocator framework constants
572
IALLOCATOR_VERSION = 2
573
574
575
576
IALLOCATOR_DIR_IN = "in"
IALLOCATOR_DIR_OUT = "out"
IALLOCATOR_MODE_ALLOC = "allocate"
IALLOCATOR_MODE_RELOC = "relocate"
577
IALLOCATOR_MODE_MEVAC = "multi-evacuate"
578
IALLOCATOR_SEARCH_PATH = _autoconf.IALLOCATOR_SEARCH_PATH
579

580
581
582
583
584
# 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"
585
JOB_QUEUE_ARCHIVE_DIR = QUEUE_DIR + "/archive"
586
JOB_QUEUE_DRAIN_FILE = QUEUE_DIR + "/drain"
Michael Hanselmann's avatar
Michael Hanselmann committed
587
588
JOB_QUEUE_SIZE_HARD_LIMIT = 5000
JOB_QUEUE_SIZE_SOFT_LIMIT = JOB_QUEUE_SIZE_HARD_LIMIT * 0.8
589

590
591
JOB_ID_TEMPLATE = r"\d+"

592
593
594
# unchanged job return
JOB_NOTCHANGED = "nochange"

595
596
# Job status
JOB_STATUS_QUEUED = "queued"
Iustin Pop's avatar
Iustin Pop committed
597
JOB_STATUS_WAITLOCK = "waiting"
598
JOB_STATUS_CANCELING = "canceling"
599
600
601
602
603
JOB_STATUS_RUNNING = "running"
JOB_STATUS_CANCELED = "canceled"
JOB_STATUS_SUCCESS = "success"
JOB_STATUS_ERROR = "error"

604
605
# OpCode status
# not yet finalized
606
OP_STATUS_QUEUED = "queued"
Iustin Pop's avatar
Iustin Pop committed
607
OP_STATUS_WAITLOCK = "waiting"
608
OP_STATUS_CANCELING = "canceling"
609
OP_STATUS_RUNNING = "running"
610
# finalized
611
OP_STATUS_CANCELED = "canceled"
612
613
OP_STATUS_SUCCESS = "success"
OP_STATUS_ERROR = "error"
614
615
616
OPS_FINALIZED = frozenset([OP_STATUS_CANCELED,
                           OP_STATUS_SUCCESS,
                           OP_STATUS_ERROR])
617
618
619
620

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

622
# max dynamic devices
623
624
625
MAX_NICS = 8
MAX_DISKS = 16

Iustin Pop's avatar
Iustin Pop committed
626
627
# SSCONF keys
SS_CLUSTER_NAME = "cluster_name"
628
SS_CLUSTER_TAGS = "cluster_tags"
Iustin Pop's avatar
Iustin Pop committed
629
SS_FILE_STORAGE_DIR = "file_storage_dir"
630
SS_MASTER_CANDIDATES = "master_candidates"
631
SS_MASTER_CANDIDATES_IPS = "master_candidates_ips"
Iustin Pop's avatar
Iustin Pop committed
632
633
634
635
SS_MASTER_IP = "master_ip"
SS_MASTER_NETDEV = "master_netdev"
SS_MASTER_NODE = "master_node"
SS_NODE_LIST = "node_list"
636
637
SS_NODE_PRIMARY_IPS = "node_primary_ips"
SS_NODE_SECONDARY_IPS = "node_secondary_ips"
638
SS_OFFLINE_NODES = "offline_nodes"
639
640
SS_ONLINE_NODES = "online_nodes"
SS_INSTANCE_LIST = "instance_list"
641
SS_RELEASE_VERSION = "release_version"
Iustin Pop's avatar
Iustin Pop committed
642

643
644
645
646
# cluster wide default parameters
DEFAULT_ENABLED_HYPERVISOR = HT_XEN_PVM

HVC_DEFAULTS = {
647
  HT_XEN_PVM: {
648
649
650
    HV_USE_BOOTLOADER: False,
    HV_BOOTLOADER_PATH: XEN_BOOTLOADER,
    HV_BOOTLOADER_ARGS: '',
651
    HV_KERNEL_PATH: "/boot/vmlinuz-2.6-xenU",
652
    HV_INITRD_PATH: '',
653
    HV_ROOT_PATH: '/dev/sda1',
654
    HV_KERNEL_ARGS: 'ro',
655
    HV_MIGRATION_PORT: 8002,
656
657
658
    },
  HT_XEN_HVM: {
    HV_BOOT_ORDER: "cd",
659
    HV_CDROM_IMAGE_PATH: '',
660
    HV_NIC_TYPE: HT_NIC_RTL8139,
661
    HV_DISK_TYPE: HT_DISK_PARAVIRTUAL,
662
    HV_VNC_BIND_ADDRESS: '0.0.0.0',
663
    HV_VNC_PASSWORD_FILE: VNC_PASSWORD_FILE,
664
665
    HV_ACPI: True,
    HV_PAE: True,
666
    HV_KERNEL_PATH: "/usr/lib/xen/boot/hvmloader",
667
    HV_DEVICE_MODEL: "/usr/lib/xen/bin/qemu-dm",
668
    HV_MIGRATION_PORT: 8002,
669
    HV_USE_LOCALTIME: False,
670
671
672
    },
  HT_KVM: {
    HV_KERNEL_PATH: "/boot/vmlinuz-2.6-kvmU",
673
    HV_INITRD_PATH: '',
674
    HV_KERNEL_ARGS: 'ro',
675
    HV_ROOT_PATH: '/dev/vda1',
676
677
    HV_ACPI: True,
    HV_SERIAL_CONSOLE: True,
678
    HV_VNC_BIND_ADDRESS: '',
679
680
681
    HV_VNC_TLS: False,
    HV_VNC_X509: '',
    HV_VNC_X509_VERIFY: False,
682
    HV_VNC_PASSWORD_FILE: '',
683
    HV_CDROM_IMAGE_PATH: '',
684
    HV_BOOT_ORDER: HT_BO_DISK,
685
686
    HV_NIC_TYPE: HT_NIC_PARAVIRTUAL,
    HV_DISK_TYPE: HT_DISK_PARAVIRTUAL,
687
    HV_USB_MOUSE: '',
688
    HV_MIGRATION_PORT: 8102,
689
    HV_USE_LOCALTIME: False,
690
    HV_DISK_CACHE: HT_CACHE_DEFAULT,
691
692
693
    },
  HT_FAKE: {
    },
694
695
696
  HT_CHROOT: {
    HV_INIT_SCRIPT: "/ganeti-chroot",
    },
697
  }
698

699
700
701
702
HVC_GLOBALS = frozenset([
  HV_MIGRATION_PORT,
  ])

703
BEC_DEFAULTS = {
704
705
706
707
  BE_MEMORY: 128,
  BE_VCPUS: 1,
  BE_AUTO_BALANCE: True,
  }
708

Guido Trotter's avatar
Guido Trotter committed
709
710
711
712
713
NICC_DEFAULTS = {
  NIC_MODE: NIC_MODE_BRIDGED,
  NIC_LINK: DEFAULT_BRIDGE,
  }

714
MASTER_POOL_SIZE_DEFAULT = 10
Guido Trotter's avatar
Guido Trotter committed
715
716
717

CONFD_PROTOCOL_VERSION = 1

718
CONFD_REQ_PING = 0
Guido Trotter's avatar
Guido Trotter committed
719
720
CONFD_REQ_NODE_ROLE_BYNAME = 1
CONFD_REQ_NODE_PIP_BY_INSTANCE_IP = 2
721
CONFD_REQ_CLUSTER_MASTER = 3
722
723
CONFD_REQ_NODE_PIP_LIST = 4
CONFD_REQ_MC_PIP_LIST = 5
724
CONFD_REQ_INSTANCES_IPS_LIST = 6
Guido Trotter's avatar
Guido Trotter committed
725

726
727
728
729
730
731
# 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"
732
733
734
735
CONFD_REQQ_FIELDS = "3"

CONFD_REQFIELD_NAME = "0"
CONFD_REQFIELD_IP = "1"
736
CONFD_REQFIELD_MNODE_PIP = "2"
737

Guido Trotter's avatar
Guido Trotter committed
738
CONFD_REQS = frozenset([
739
  CONFD_REQ_PING,
Guido Trotter's avatar
Guido Trotter committed
740
741
  CONFD_REQ_NODE_ROLE_BYNAME,
  CONFD_REQ_NODE_PIP_BY_INSTANCE_IP,
742
  CONFD_REQ_CLUSTER_MASTER,
743
744
  CONFD_REQ_NODE_PIP_LIST,
  CONFD_REQ_MC_PIP_LIST,
745
  CONFD_REQ_INSTANCES_IPS_LIST,
Guido Trotter's avatar
Guido Trotter committed
746
747
  ])

748
749
750
751
752
753
754
755
756
757
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
758
759
760
(CONFD_NODE_ROLE_MASTER,
 CONFD_NODE_ROLE_CANDIDATE,
 CONFD_NODE_ROLE_OFFLINE,
Guido Trotter's avatar
Guido Trotter committed
761
762
763
 CONFD_NODE_ROLE_DRAINED,
 CONFD_NODE_ROLE_REGULAR,
 ) = range(5)
Guido Trotter's avatar
Guido Trotter committed
764

765
766
# A few common errors for confd
CONFD_ERROR_UNKNOWN_ENTRY = 1
767
CONFD_ERROR_INTERNAL = 2
768
CONFD_ERROR_ARGUMENT = 3
769

Guido Trotter's avatar
Guido Trotter committed
770
771
772
# 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
773
CONFD_MAX_CLOCK_SKEW = 2 * NODE_MAX_CLOCK_SKEW
774
775
776
777
778
779
780
781
782

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

784
785
786
787
788
789
# 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
790
791
792
793
794
795
796
797
798
799
# 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

800
801
802
803
804
805
# 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