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
VALUE_DEFAULT = "default"
170
171
VALUE_AUTO = "auto"
VALUE_GENERATE = "generate"
172
VALUE_NONE = "none"
173
174
VALUE_TRUE = "true"
VALUE_FALSE = "false"
175

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

# 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

288
289
290
291
292
# dynamic device modification

DDM_ADD = 'add'
DDM_REMOVE = 'remove'

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

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

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

323

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

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

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

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

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

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

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

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

394
395
396
397
398
HVS_PARAMETER_TYPES = {
  HV_BOOT_ORDER: VTYPE_STRING,
  HV_CDROM_IMAGE_PATH: VTYPE_STRING,
  HV_NIC_TYPE: VTYPE_STRING,
  HV_DISK_TYPE: VTYPE_STRING,
399
  HV_VNC_PASSWORD_FILE: VTYPE_STRING,
400
401
402
403
404
405
  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,
406
407
408
  HV_USE_BOOTLOADER: VTYPE_BOOL,
  HV_BOOTLOADER_PATH: VTYPE_STRING,
  HV_BOOTLOADER_ARGS: VTYPE_STRING,
409
  HV_KERNEL_PATH: VTYPE_STRING,
410
  HV_KERNEL_ARGS: VTYPE_STRING,
411
412
413
414
  HV_INITRD_PATH: VTYPE_STRING,
  HV_ROOT_PATH: VTYPE_STRING,
  HV_SERIAL_CONSOLE: VTYPE_BOOL,
  HV_USB_MOUSE: VTYPE_STRING,
415
  HV_DEVICE_MODEL: VTYPE_STRING,
416
  HV_INIT_SCRIPT: VTYPE_STRING,
417
  HV_MIGRATION_PORT: VTYPE_INT,
418
419
420
  }

HVS_PARAMETERS = frozenset(HVS_PARAMETER_TYPES.keys())
421

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

427
428
429
430
431
432
433
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
434

435
436
# Instance Parameters Profile
PP_DEFAULT = "default"
437

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

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

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

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

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

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

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

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

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

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

546
547
JOB_ID_TEMPLATE = r"\d+"

548
549
550
# unchanged job return
JOB_NOTCHANGED = "nochange"

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

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

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

578
# max dynamic devices
579
580
581
MAX_NICS = 8
MAX_DISKS = 16

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

599
600
601
602
# cluster wide default parameters
DEFAULT_ENABLED_HYPERVISOR = HT_XEN_PVM

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

BEC_DEFAULTS = {
653
654
655
656
  BE_MEMORY: 128,
  BE_VCPUS: 1,
  BE_AUTO_BALANCE: True,
  }
657

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

663
MASTER_POOL_SIZE_DEFAULT = 10
Guido Trotter's avatar
Guido Trotter committed
664
665
666

CONFD_PROTOCOL_VERSION = 1

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

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

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

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

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

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

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

744
745
746
747
748
749
# 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