Use PEP-318 decorator to acquire locks in remote API code
[ganeti-local] / lib / constants.py
1 #
2 #
3
4 # Copyright (C) 2006, 2007 Google Inc.
5 #
6 # This program is free software; you can redistribute it and/or modify
7 # it under the terms of the GNU General Public License as published by
8 # the Free Software Foundation; either version 2 of the License, or
9 # (at your option) any later version.
10 #
11 # This program is distributed in the hope that it will be useful, but
12 # WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14 # General Public License for more details.
15 #
16 # You should have received a copy of the GNU General Public License
17 # along with this program; if not, write to the Free Software
18 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
19 # 02110-1301, USA.
20
21
22 """Module holding different constants."""
23
24 from ganeti import _autoconf
25
26 # various versions
27 CONFIG_VERSION = 3
28 PROTOCOL_VERSION = 12
29 RELEASE_VERSION = _autoconf.PACKAGE_VERSION
30 OS_API_VERSION = 5
31 EXPORT_VERSION = 0
32 RAPI_VERSION = 1
33
34
35 # file paths
36 DATA_DIR = _autoconf.LOCALSTATEDIR + "/lib/ganeti"
37 RUN_DIR = _autoconf.LOCALSTATEDIR + "/run"
38 BDEV_CACHE_DIR = RUN_DIR + "/ganeti"
39 LOCK_DIR = _autoconf.LOCALSTATEDIR + "/lock"
40 CLUSTER_CONF_FILE = DATA_DIR + "/config.data"
41 SSL_CERT_FILE = DATA_DIR + "/server.pem"
42 WATCHER_STATEFILE = DATA_DIR + "/watcher.data"
43 SSH_KNOWN_HOSTS_FILE = DATA_DIR + "/known_hosts"
44 ETC_HOSTS = "/etc/hosts"
45
46 NODE_INITD_SCRIPT = _autoconf.SYSCONFDIR + "/init.d/ganeti"
47 DEFAULT_NODED_PORT = 1811
48 FIRST_DRBD_PORT = 11000
49 LAST_DRBD_PORT = 14999
50 MASTER_SCRIPT = "ganeti-master"
51
52 LOG_DIR = _autoconf.LOCALSTATEDIR + "/log/ganeti"
53 LOG_OS_DIR = LOG_DIR + "/os"
54 LOG_NODESERVER = LOG_DIR + "/node-daemon.log"
55 LOG_RAPISERVER = LOG_DIR + "/rapi-daemon.log"
56 LOG_RAPIACCESS = LOG_DIR + "/rapi-access.log"
57 LOG_WATCHER = LOG_DIR + "/watcher.log"
58
59 OS_SEARCH_PATH = _autoconf.OS_SEARCH_PATH
60 EXPORT_DIR = _autoconf.EXPORT_DIR
61
62 EXPORT_CONF_FILE = "config.ini"
63
64 XEN_KERNEL = _autoconf.XEN_KERNEL
65 XEN_INITRD = _autoconf.XEN_INITRD
66
67 VALUE_DEFAULT = "default"
68 VALUE_NONE = "none"
69
70 # hooks-related constants
71 HOOKS_BASE_DIR = _autoconf.SYSCONFDIR + "/ganeti/hooks"
72 HOOKS_PHASE_PRE = "pre"
73 HOOKS_PHASE_POST = "post"
74 HOOKS_NAME_CFGUPDATE = "config-update"
75 HOOKS_VERSION = 1
76
77 # hooks subject type (what object type does the LU deal with)
78 HTYPE_CLUSTER = "CLUSTER"
79 HTYPE_NODE = "NODE"
80 HTYPE_INSTANCE = "INSTANCE"
81
82 HKR_SKIP = 0
83 HKR_FAIL = 1
84 HKR_SUCCESS = 2
85
86 # disk template types
87 DT_DISKLESS = "diskless"
88 DT_PLAIN = "plain"
89 DT_LOCAL_RAID1 = "local_raid1"
90 DT_REMOTE_RAID1 = "remote_raid1"
91 DT_DRBD8 = "drbd"
92
93 # the set of network-mirrored disk templates
94 DTS_NET_MIRROR = frozenset([DT_REMOTE_RAID1, DT_DRBD8])
95
96 # logical disk types
97 LD_LV = "lvm"
98 LD_MD_R1 = "md_raid1"
99 LD_DRBD7 = "drbd"
100 LD_DRBD8 = "drbd8"
101
102 # the set of drbd-like disk types
103 LDS_DRBD = frozenset([LD_DRBD7, LD_DRBD8])
104
105 # disk replacement mode
106 REPLACE_DISK_PRI = "replace_primary"
107 REPLACE_DISK_SEC = "replace_secondary"
108 REPLACE_DISK_ALL = "replace_all"
109
110 # instance creation modes
111 INSTANCE_CREATE = "create"
112 INSTANCE_IMPORT = "import"
113
114 DISK_TEMPLATES = frozenset([DT_DISKLESS, DT_PLAIN,
115                             DT_LOCAL_RAID1, DT_REMOTE_RAID1,
116                             DT_DRBD8])
117
118 # import/export config options
119 INISECT_EXP = "export"
120 INISECT_INS = "instance"
121
122 # common exit codes
123 EXIT_SUCCESS = 0
124 EXIT_NOTMASTER = 11
125 EXIT_NODESETUP_ERROR = 12
126 EXIT_CONFIRMATION = 13 # need user confirmation
127
128 # tags
129 TAG_CLUSTER = "cluster"
130 TAG_NODE = "node"
131 TAG_INSTANCE = "instance"
132 MAX_TAG_LEN = 128
133 MAX_TAGS_PER_OBJ = 4096
134
135 # others
136 DEFAULT_BRIDGE = "xen-br0"
137 SYNC_SPEED = 30 * 1024
138 LOCALHOST_IP_ADDRESS = "127.0.0.1"
139 TCP_PING_TIMEOUT = 10
140 GANETI_RUNAS = "root"
141 BIND_ADDRESS_GLOBAL = "0.0.0.0"
142
143 # valid os status
144 OS_VALID_STATUS = "VALID"
145
146 # ssh constants
147 SSH_INITD_SCRIPT = _autoconf.SSH_INITD_SCRIPT
148 SSH_CONFIG_DIR = "/etc/ssh/"
149 SSH_HOST_DSA_PRIV = SSH_CONFIG_DIR + "ssh_host_dsa_key"
150 SSH_HOST_DSA_PUB = SSH_HOST_DSA_PRIV + ".pub"
151 SSH_HOST_RSA_PRIV = SSH_CONFIG_DIR + "ssh_host_rsa_key"
152 SSH_HOST_RSA_PUB = SSH_HOST_RSA_PRIV + ".pub"
153
154 # reboot types
155 INSTANCE_REBOOT_SOFT = "soft"
156 INSTANCE_REBOOT_HARD = "hard"
157 INSTANCE_REBOOT_FULL = "full"
158
159 # Hypervisor constants
160 HT_XEN_PVM30 = "xen-3.0"
161 HT_FAKE = "fake"
162 HT_XEN_HVM31 = "xen-hvm-3.1"
163 HYPER_TYPES = frozenset([HT_XEN_PVM30, HT_FAKE, HT_XEN_HVM31])
164 HTS_REQ_PORT = frozenset([HT_XEN_HVM31])
165
166 HT_HVM_VNC_BASE_PORT = 5900
167 HT_HVM_DEFAULT_BOOT_ORDER = 'dc'
168 VNC_PASSWORD_FILE = _autoconf.SYSCONFDIR + "/ganeti/vnc-cluster-password"
169 VNC_DEFAULT_BIND_ADDRESS = '0.0.0.0'
170
171 # Cluster Verify steps
172 VERIFY_NPLUSONE_MEM = 'nplusone_mem'
173 VERIFY_OPTIONAL_CHECKS = frozenset([VERIFY_NPLUSONE_MEM])
174
175 # Allocator framework constants
176 IALLOCATOR_DIR_IN = "in"
177 IALLOCATOR_DIR_OUT = "out"
178 IALLOCATOR_MODE_ALLOC = "allocate"
179 IALLOCATOR_MODE_RELOC = "relocate"
180 IALLOCATOR_SEARCH_PATH = _autoconf.IALLOCATOR_SEARCH_PATH
181 IARUN_NOTFOUND = 1
182 IARUN_FAILURE = 2
183 IARUN_SUCCESS = 3
184
185 # Remote API constants
186 RAPI_ENABLE = _autoconf.RAPI_ENABLE
187 RAPI_PORT = 5080