X-Git-Url: https://code.grnet.gr/git/ganeti-local/blobdiff_plain/59525e1f64e526c439bd358b17fb461aaa77f2da..8a53b55f3a83f3bdf3b231f90e766fc15ec51895:/lib/constants.py diff --git a/lib/constants.py b/lib/constants.py index a04dbad..1c91e15 100644 --- a/lib/constants.py +++ b/lib/constants.py @@ -1,7 +1,7 @@ # # -# Copyright (C) 2006, 2007, 2008, 2009, 2010 Google Inc. +# Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011 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 @@ -26,7 +26,6 @@ import re from ganeti import _autoconf # various versions -PROTOCOL_VERSION = 40 RELEASE_VERSION = _autoconf.PACKAGE_VERSION OS_API_V10 = 10 OS_API_V15 = 15 @@ -84,10 +83,27 @@ CONFIG_MINOR = int(_autoconf.VERSION_MINOR) CONFIG_REVISION = 0 CONFIG_VERSION = BuildVersion(CONFIG_MAJOR, CONFIG_MINOR, CONFIG_REVISION) +#: RPC protocol version +PROTOCOL_VERSION = BuildVersion(CONFIG_MAJOR, CONFIG_MINOR, 0) + # user separation DAEMONS_GROUP = _autoconf.DAEMONS_GROUP +ADMIN_GROUP = _autoconf.ADMIN_GROUP MASTERD_USER = _autoconf.MASTERD_USER +MASTERD_GROUP = _autoconf.MASTERD_GROUP RAPI_USER = _autoconf.RAPI_USER +RAPI_GROUP = _autoconf.RAPI_GROUP +CONFD_USER = _autoconf.CONFD_USER +CONFD_GROUP = _autoconf.CONFD_GROUP +NODED_USER = _autoconf.NODED_USER + + +# Wipe +DD_CMD = "dd" +WIPE_BLOCK_SIZE = 1024**2 +MAX_WIPE_CHUNK = 1024 # 1GB +MIN_WIPE_CHUNK_PERCENT = 10 + # file paths DATA_DIR = _autoconf.LOCALSTATEDIR + "/lib/ganeti" @@ -121,9 +137,11 @@ WATCHER_STATEFILE = DATA_DIR + "/watcher.data" WATCHER_PAUSEFILE = DATA_DIR + "/watcher.pause" INSTANCE_UPFILE = RUN_GANETI_DIR + "/instance-status" SSH_KNOWN_HOSTS_FILE = DATA_DIR + "/known_hosts" -RAPI_USERS_FILE = DATA_DIR + "/rapi_users" +RAPI_USERS_FILE = DATA_DIR + "/rapi/users" QUEUE_DIR = DATA_DIR + "/queue" DAEMON_UTIL = _autoconf.PKGLIBDIR + "/daemon-util" +SETUP_SSH = _autoconf.TOOLSDIR + "/setup-ssh" +KVM_IFUP = _autoconf.PKGLIBDIR + "/kvm-ifup" ETC_HOSTS = "/etc/hosts" DEFAULT_FILE_STORAGE_DIR = _autoconf.FILE_STORAGE_DIR ENABLE_FILE_STORAGE = _autoconf.ENABLE_FILE_STORAGE @@ -184,6 +202,7 @@ PROC_MOUNTS = "/proc/mounts" # luxi related constants LUXI_EOM = "\3" +LUXI_VERSION = CONFIG_VERSION # one of 'no', 'yes', 'only' SYSLOG_USAGE = _autoconf.SYSLOG_USAGE @@ -204,8 +223,21 @@ XEN_INITRD = _autoconf.XEN_INITRD KVM_PATH = _autoconf.KVM_PATH SOCAT_PATH = _autoconf.SOCAT_PATH SOCAT_USE_ESCAPE = _autoconf.SOCAT_USE_ESCAPE +SOCAT_USE_COMPRESS = _autoconf.SOCAT_USE_COMPRESS SOCAT_ESCAPE_CODE = "0x1d" +#: Console as SSH command +CONS_SSH = "ssh" + +#: Console as VNC server +CONS_VNC = "vnc" + +#: Display a message for console access +CONS_MESSAGE = "msg" + +#: All console types +CONS_ALL = frozenset([CONS_SSH, CONS_VNC, CONS_MESSAGE]) + # For RSA keys more bits are better, but they also make operations more # expensive. NIST SP 800-131 recommends a minimum of 2048 bits from the year # 2010 on. @@ -214,7 +246,7 @@ RSA_KEY_BITS = 2048 # Ciphers allowed for SSL connections. For the format, see ciphers(1). A better # way to disable ciphers would be to use the exclamation mark (!), but socat # versions below 1.5 can't parse exclamation marks in options properly. When -# modifying the ciphers, ensure to not accidentially add something after it's +# modifying the ciphers, ensure not to accidentially add something after it's # been removed. Use the "openssl" utility to check the allowed ciphers, e.g. # "openssl ciphers -v HIGH:-DES". OPENSSL_CIPHERS = "HIGH:-DES:-3DES:-EXPORT:-ADH" @@ -277,6 +309,7 @@ HOOKS_VERSION = 2 # hooks subject type (what object type does the LU deal with) HTYPE_CLUSTER = "CLUSTER" HTYPE_NODE = "NODE" +HTYPE_GROUP = "GROUP" HTYPE_INSTANCE = "INSTANCE" HKR_SKIP = 0 @@ -404,8 +437,17 @@ RIE_HANDSHAKE = "Hi, I'm Ganeti" # Remote import/export certificate validity in seconds RIE_CERT_VALIDITY = 24 * 60 * 60 -# Remote import/export connect timeout for socat -RIE_CONNECT_TIMEOUT = 60 +# Overall timeout for establishing connection +RIE_CONNECT_TIMEOUT = 180 + +# Export only: how long to wait per connection attempt (seconds) +RIE_CONNECT_ATTEMPT_TIMEOUT = 20 + +# Export only: number of attempts to connect +RIE_CONNECT_RETRIES = 10 + +#: Give child process up to 5 seconds to exit after sending a signal +CHILD_LINGER_TIMEOUT = 5.0 DISK_TEMPLATES = frozenset([DT_DISKLESS, DT_PLAIN, DT_DRBD8, DT_FILE]) @@ -420,8 +462,9 @@ INISECT_BEP = "backend" INISECT_OSP = "os" # dynamic device modification -DDM_ADD = 'add' -DDM_REMOVE = 'remove' +DDM_ADD = "add" +DDM_REMOVE = "remove" +DDMS_VALUES = frozenset([DDM_ADD, DDM_REMOVE]) # common exit codes EXIT_SUCCESS = 0 @@ -431,6 +474,9 @@ EXIT_NOTMASTER = 11 EXIT_NODESETUP_ERROR = 12 EXIT_CONFIRMATION = 13 # need user confirmation +#: Exit code for query operations with unknown fields +EXIT_UNKNOWN_FIELD = 14 + # tags TAG_CLUSTER = "cluster" TAG_NODE = "node" @@ -450,6 +496,8 @@ IP4_ADDRESS_LOCALHOST = "127.0.0.1" IP4_ADDRESS_ANY = "0.0.0.0" IP6_ADDRESS_LOCALHOST = "::1" IP6_ADDRESS_ANY = "::" +IP4_VERSION = 4 +IP6_VERSION = 6 TCP_PING_TIMEOUT = 10 GANETI_RUNAS = "root" DEFAULT_VG = "xenvg" @@ -462,6 +510,8 @@ DEFAULT_SHUTDOWN_TIMEOUT = 120 NODE_MAX_CLOCK_SKEW = 150 # Time for an intra-cluster disk transfer to wait for a connection DISK_TRANSFER_CONNECT_TIMEOUT = 30 +# Disk index separator +DISK_SEPARATOR = _autoconf.DISK_SEPARATOR # runparts results (RUNPARTS_SKIP, @@ -557,6 +607,8 @@ HV_KVM_FLAG = "kvm_flag" HV_VHOST_NET = "vhost_net" HV_KVM_USE_CHROOT = "use_chroot" HV_CPU_MASK = "cpu_mask" +HV_MEM_PATH = "mem_path" +HV_BLOCKDEV_PREFIX = "blockdev_prefix" HVS_PARAMETER_TYPES = { HV_BOOT_ORDER: VTYPE_STRING, @@ -593,6 +645,8 @@ HVS_PARAMETER_TYPES = { HV_VHOST_NET: VTYPE_BOOL, HV_KVM_USE_CHROOT: VTYPE_BOOL, HV_CPU_MASK: VTYPE_STRING, + HV_MEM_PATH: VTYPE_STRING, + HV_BLOCKDEV_PREFIX: VTYPE_STRING, } HVS_PARAMETERS = frozenset(HVS_PARAMETER_TYPES.keys()) @@ -610,6 +664,41 @@ BES_PARAMETER_TYPES = { BES_PARAMETERS = frozenset(BES_PARAMETER_TYPES.keys()) +# Node parameter names +ND_OOB_PROGRAM = "oob_program" + +NDS_PARAMETER_TYPES = { + ND_OOB_PROGRAM: VTYPE_MAYBE_STRING, + } + +NDS_PARAMETERS = frozenset(NDS_PARAMETER_TYPES.keys()) + +# OOB supported commands +OOB_POWER_ON = "power-on" +OOB_POWER_OFF = "power-off" +OOB_POWER_CYCLE = "power-cycle" +OOB_POWER_STATUS = "power-status" +OOB_HEALTH = "health" + +OOB_COMMANDS = frozenset([OOB_POWER_ON, OOB_POWER_OFF, OOB_POWER_CYCLE, + OOB_POWER_STATUS, OOB_HEALTH]) + +OOB_POWER_STATUS_POWERED = "powered" + +OOB_TIMEOUT = 60 # 60 seconds + +OOB_STATUS_OK = "OK" +OOB_STATUS_WARNING = "WARNING" +OOB_STATUS_CRITICAL = "CRITICAL" +OOB_STATUS_UNKNOWN = "UNKNOWN" + +OOB_STATUSES = frozenset([ + OOB_STATUS_OK, + OOB_STATUS_WARNING, + OOB_STATUS_CRITICAL, + OOB_STATUS_UNKNOWN, + ]) + # Instance Parameters Profile PP_DEFAULT = "default" @@ -631,19 +720,28 @@ NICS_PARAMETERS = frozenset(NICS_PARAMETER_TYPES.keys()) IDISK_SIZE = "size" IDISK_MODE = "mode" IDISK_ADOPT = "adopt" -IDISK_PARAMS = frozenset([IDISK_SIZE, IDISK_MODE, IDISK_ADOPT]) +IDISK_VG = "vg" IDISK_PARAMS_TYPES = { IDISK_SIZE: VTYPE_SIZE, IDISK_MODE: VTYPE_STRING, IDISK_ADOPT: VTYPE_STRING, + IDISK_VG: VTYPE_STRING, } +IDISK_PARAMS = frozenset(IDISK_PARAMS_TYPES.keys()) + INIC_MAC = "mac" INIC_IP = "ip" INIC_MODE = "mode" INIC_LINK = "link" INIC_BRIDGE = "bridge" -INIC_PARAMS = frozenset([INIC_MAC, INIC_IP, INIC_MODE, INIC_LINK, INIC_BRIDGE]) -INIC_PARAMS_TYPES = dict([(name, VTYPE_STRING) for name in INIC_PARAMS]) +INIC_PARAMS_TYPES = { + INIC_BRIDGE: VTYPE_STRING, + INIC_IP: VTYPE_MAYBE_STRING, + INIC_LINK: VTYPE_STRING, + INIC_MAC: VTYPE_STRING, + INIC_MODE: VTYPE_STRING, + } +INIC_PARAMS = frozenset(INIC_PARAMS_TYPES.keys()) # Hypervisor constants HT_XEN_PVM = "xen-pvm" @@ -678,7 +776,8 @@ HT_NIC_E1000 = "e1000" HT_NIC_PARAVIRTUAL = HT_DISK_PARAVIRTUAL = "paravirtual" HT_HVM_VALID_NIC_TYPES = frozenset([HT_NIC_RTL8139, HT_NIC_NE2K_PCI, - HT_NIC_NE2K_ISA, HT_NIC_PARAVIRTUAL]) + HT_NIC_E1000, HT_NIC_NE2K_ISA, + HT_NIC_PARAVIRTUAL]) 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, @@ -747,6 +846,7 @@ NV_DRBDLIST = "drbd-list" NV_FILELIST = "filelist" NV_HVINFO = "hvinfo" NV_HYPERVISOR = "hypervisor" +NV_HVPARAMS = "hvparms" NV_INSTANCELIST = "instancelist" NV_LVLIST = "lvlist" NV_MASTERIP = "master-ip" @@ -758,6 +858,8 @@ NV_PVLIST = "pvlist" NV_TIME = "time" NV_VERSION = "version" NV_VGLIST = "vglist" +NV_VMNODES = "vmnodes" +NV_OOB_PATHS = "oob-paths" # SSL certificate check constants (in days) SSL_CERT_EXPIRATION_WARN = 30 @@ -810,6 +912,12 @@ JOBS_FINALIZED = frozenset([ JOB_STATUS_SUCCESS, JOB_STATUS_ERROR, ]) +JOB_STATUS_ALL = frozenset([ + JOB_STATUS_QUEUED, + JOB_STATUS_WAITLOCK, + JOB_STATUS_CANCELING, + JOB_STATUS_RUNNING, + ]) | JOBS_FINALIZED # OpCode status # not yet finalized @@ -825,21 +933,100 @@ OPS_FINALIZED = frozenset([OP_STATUS_CANCELED, OP_STATUS_SUCCESS, OP_STATUS_ERROR]) +# OpCode priority +OP_PRIO_LOWEST = +19 +OP_PRIO_HIGHEST = -20 + +OP_PRIO_LOW = +10 +OP_PRIO_NORMAL = 0 +OP_PRIO_HIGH = -10 + +OP_PRIO_SUBMIT_VALID = frozenset([ + OP_PRIO_LOW, + OP_PRIO_NORMAL, + OP_PRIO_HIGH, + ]) + +OP_PRIO_DEFAULT = OP_PRIO_NORMAL + # Execution log types ELOG_MESSAGE = "message" ELOG_PROGRESS = "progress" ELOG_REMOTE_IMPORT = "remote-import" ELOG_JQUEUE_TEST = "jqueue-test" +# /etc/hosts modification +ETC_HOSTS_ADD = "add" +ETC_HOSTS_REMOVE = "remove" + # Job queue test JQT_MSGPREFIX = "TESTMSG=" JQT_EXPANDNAMES = "expandnames" JQT_EXEC = "exec" JQT_LOGMSG = "logmsg" +JQT_STARTMSG = "startmsg" JQT_ALL = frozenset([ JQT_EXPANDNAMES, JQT_EXEC, JQT_LOGMSG, + JQT_STARTMSG, + ]) + +# Query resources +QR_INSTANCE = "instance" +QR_NODE = "node" +QR_LOCK = "lock" +QR_GROUP = "group" + +#: List of resources which can be queried using L{opcodes.OpQuery} +QR_OP_QUERY = frozenset([QR_INSTANCE, QR_NODE, QR_GROUP]) + +#: List of resources which can be queried using LUXI +QR_OP_LUXI = QR_OP_QUERY.union([ + QR_LOCK, + ]) + +# Query field types +QFT_UNKNOWN = "unknown" +QFT_TEXT = "text" +QFT_BOOL = "bool" +QFT_NUMBER = "number" +QFT_UNIT = "unit" +QFT_TIMESTAMP = "timestamp" +QFT_OTHER = "other" + +#: All query field types +QFT_ALL = frozenset([ + QFT_UNKNOWN, + QFT_TEXT, + QFT_BOOL, + QFT_NUMBER, + QFT_UNIT, + QFT_TIMESTAMP, + QFT_OTHER, + ]) + +# Query result field status (don't change or reuse values as they're used by +# clients) +#: Normal field status +RS_NORMAL = 0 +#: Unknown field +RS_UNKNOWN = 1 +#: No data (e.g. RPC error), can be used instead of L{RS_OFFLINE} +RS_NODATA = 2 +#: Value unavailable/unsupported for item; if this field is supported +#: but we cannot get the data for the moment, RS_NODATA or +#: RS_OFFLINE should be used +RS_UNAVAIL = 3 +#: Resource marked offline +RS_OFFLINE = 4 + +RS_ALL = frozenset([ + RS_NORMAL, + RS_UNKNOWN, + RS_NODATA, + RS_UNAVAIL, + RS_OFFLINE, ]) # max dynamic devices @@ -860,11 +1047,13 @@ SS_NODE_PRIMARY_IPS = "node_primary_ips" SS_NODE_SECONDARY_IPS = "node_secondary_ips" SS_OFFLINE_NODES = "offline_nodes" SS_ONLINE_NODES = "online_nodes" +SS_PRIMARY_IP_FAMILY = "primary_ip_family" SS_INSTANCE_LIST = "instance_list" SS_RELEASE_VERSION = "release_version" SS_HYPERVISOR_LIST = "hypervisor_list" SS_MAINTAIN_NODE_HEALTH = "maintain_node_health" SS_UID_POOL = "uid_pool" +SS_NODEGROUPS = "nodegroups" # cluster wide default parameters DEFAULT_ENABLED_HYPERVISOR = HT_XEN_PVM @@ -880,6 +1069,7 @@ HVC_DEFAULTS = { HV_KERNEL_ARGS: 'ro', HV_MIGRATION_PORT: 8002, HV_MIGRATION_MODE: HT_MIGRATION_LIVE, + HV_BLOCKDEV_PREFIX: "sd", }, HT_XEN_HVM: { HV_BOOT_ORDER: "cd", @@ -895,6 +1085,7 @@ HVC_DEFAULTS = { HV_MIGRATION_PORT: 8002, HV_MIGRATION_MODE: HT_MIGRATION_NONLIVE, HV_USE_LOCALTIME: False, + HV_BLOCKDEV_PREFIX: "hd", }, HT_KVM: { HV_KERNEL_PATH: "/boot/vmlinuz-2.6-kvmU", @@ -924,6 +1115,7 @@ HVC_DEFAULTS = { HV_KVM_FLAG: "", HV_VHOST_NET: False, HV_KVM_USE_CHROOT: False, + HV_MEM_PATH: "", }, HT_FAKE: { }, @@ -947,6 +1139,10 @@ BEC_DEFAULTS = { BE_AUTO_BALANCE: True, } +NDC_DEFAULTS = { + ND_OOB_PROGRAM: None, + } + NICC_DEFAULTS = { NIC_MODE: NIC_MODE_BRIDGED, NIC_LINK: DEFAULT_BRIDGE, @@ -1051,3 +1247,16 @@ UIDPOOL_UID_MAX = 2**32-1 # Assuming 32 bit user-ids # Name or path of the pgrep command PGREP = "pgrep" + +# Name of the node group that gets created at cluster init or upgrade +INITIAL_NODE_GROUP_NAME = "default" + +# Possible values for NodeGroup.alloc_policy +ALLOC_POLICY_PREFERRED = "preferred" +ALLOC_POLICY_LAST_RESORT = "last_resort" +ALLOC_POLICY_UNALLOCABLE = "unallocable" +VALID_ALLOC_POLICIES = [ + ALLOC_POLICY_PREFERRED, + ALLOC_POLICY_LAST_RESORT, + ALLOC_POLICY_UNALLOCABLE, + ]