Statistics
| Branch: | Tag: | Revision:

root / lib / ssconf.py @ 920b5878

History | View | Annotate | Download (7.9 kB)

1
#
2
#
3

    
4
# Copyright (C) 2006, 2007, 2008 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
"""Global Configuration data for Ganeti.
23

24
This module provides the interface to a special case of cluster
25
configuration data, which is mostly static and available to all nodes.
26

27
"""
28

    
29
import sys
30
import re
31

    
32
from ganeti import errors
33
from ganeti import constants
34
from ganeti import utils
35
from ganeti import serializer
36

    
37

    
38
SSCONF_LOCK_TIMEOUT = 10
39

    
40
RE_VALID_SSCONF_NAME = re.compile(r'^[-_a-z0-9]+$')
41

    
42

    
43
class SimpleConfigReader(object):
44
  """Simple class to read configuration file.
45

46
  """
47
  def __init__(self, file_name=constants.CLUSTER_CONF_FILE):
48
    """Initializes this class.
49

50
    @type file_name: string
51
    @param file_name: Configuration file path
52

53
    """
54
    self._file_name = file_name
55
    self._config_data = serializer.Load(utils.ReadFile(file_name))
56
    # TODO: Error handling
57

    
58
  def GetClusterName(self):
59
    return self._config_data["cluster"]["cluster_name"]
60

    
61
  def GetHostKey(self):
62
    return self._config_data["cluster"]["rsahostkeypub"]
63

    
64
  def GetMasterNode(self):
65
    return self._config_data["cluster"]["master_node"]
66

    
67
  def GetMasterIP(self):
68
    return self._config_data["cluster"]["master_ip"]
69

    
70
  def GetMasterNetdev(self):
71
    return self._config_data["cluster"]["master_netdev"]
72

    
73
  def GetFileStorageDir(self):
74
    return self._config_data["cluster"]["file_storage_dir"]
75

    
76
  def GetHypervisorType(self):
77
    return self._config_data["cluster"]["hypervisor"]
78

    
79
  def GetNodeList(self):
80
    return self._config_data["nodes"].keys()
81

    
82
  @classmethod
83
  def FromDict(cls, val, cfg_file=constants.CLUSTER_CONF_FILE):
84
    """Alternative construction from a dictionary.
85

86
    """
87
    obj = SimpleConfigReader.__new__(cls)
88
    obj._config_data = val
89
    obj._file_name = cfg_file
90
    return obj
91

    
92

    
93
class SimpleConfigWriter(SimpleConfigReader):
94
  """Simple class to write configuration file.
95

96
  """
97
  def SetMasterNode(self, node):
98
    """Change master node.
99

100
    """
101
    self._config_data["cluster"]["master_node"] = node
102

    
103
  def Save(self):
104
    """Writes configuration file.
105

106
    Warning: Doesn't take care of locking or synchronizing with other
107
    processes.
108

109
    """
110
    utils.WriteFile(self._file_name,
111
                    data=serializer.Dump(self._config_data),
112
                    mode=0600)
113

    
114

    
115
class SimpleStore(object):
116
  """Interface to static cluster data.
117

118
  This is different that the config.ConfigWriter and
119
  SimpleConfigReader classes in that it holds data that will always be
120
  present, even on nodes which don't have all the cluster data.
121

122
  Other particularities of the datastore:
123
    - keys are restricted to predefined values
124

125
  """
126
  _SS_FILEPREFIX = "ssconf_"
127
  _VALID_KEYS = (
128
    constants.SS_CLUSTER_NAME,
129
    constants.SS_CLUSTER_TAGS,
130
    constants.SS_FILE_STORAGE_DIR,
131
    constants.SS_MASTER_CANDIDATES,
132
    constants.SS_MASTER_IP,
133
    constants.SS_MASTER_NETDEV,
134
    constants.SS_MASTER_NODE,
135
    constants.SS_NODE_LIST,
136
    constants.SS_OFFLINE_NODES,
137
    constants.SS_ONLINE_NODES,
138
    constants.SS_INSTANCE_LIST,
139
    constants.SS_RELEASE_VERSION,
140
    )
141
  _MAX_SIZE = 131072
142

    
143
  def __init__(self, cfg_location=None):
144
    if cfg_location is None:
145
      self._cfg_dir = constants.DATA_DIR
146
    else:
147
      self._cfg_dir = cfg_location
148

    
149
  def KeyToFilename(self, key):
150
    """Convert a given key into filename.
151

152
    """
153
    if key not in self._VALID_KEYS:
154
      raise errors.ProgrammerError("Invalid key requested from SSConf: '%s'"
155
                                   % str(key))
156

    
157
    filename = self._cfg_dir + '/' + self._SS_FILEPREFIX + key
158
    return filename
159

    
160
  def _ReadFile(self, key):
161
    """Generic routine to read keys.
162

163
    This will read the file which holds the value requested. Errors
164
    will be changed into ConfigurationErrors.
165

166
    """
167
    filename = self.KeyToFilename(key)
168
    try:
169
      data = utils.ReadFile(filename, size=self._MAX_SIZE)
170
    except EnvironmentError, err:
171
      raise errors.ConfigurationError("Can't read from the ssconf file:"
172
                                      " '%s'" % str(err))
173
    data = data.rstrip('\n')
174
    return data
175

    
176
  def WriteFiles(self, values):
177
    """Writes ssconf files used by external scripts.
178

179
    @type values: dict
180
    @param values: Dictionary of (name, value)
181

182
    """
183
    ssconf_lock = utils.FileLock(constants.SSCONF_LOCK_FILE)
184

    
185
    # Get lock while writing files
186
    ssconf_lock.Exclusive(blocking=True, timeout=SSCONF_LOCK_TIMEOUT)
187
    try:
188
      for name, value in values.iteritems():
189
        if value and not value.endswith("\n"):
190
          value += "\n"
191
        utils.WriteFile(self.KeyToFilename(name), data=value, mode=0444)
192
    finally:
193
      ssconf_lock.Unlock()
194

    
195
  def GetFileList(self):
196
    """Return the list of all config files.
197

198
    This is used for computing node replication data.
199

200
    """
201
    return [self.KeyToFilename(key) for key in self._VALID_KEYS]
202

    
203
  def GetClusterName(self):
204
    """Get the cluster name.
205

206
    """
207
    return self._ReadFile(constants.SS_CLUSTER_NAME)
208

    
209
  def GetFileStorageDir(self):
210
    """Get the file storage dir.
211

212
    """
213
    return self._ReadFile(constants.SS_FILE_STORAGE_DIR)
214

    
215
  def GetMasterCandidates(self):
216
    """Return the list of master candidates.
217

218
    """
219
    data = self._ReadFile(constants.SS_MASTER_CANDIDATES)
220
    nl = data.splitlines(False)
221
    return nl
222

    
223
  def GetMasterIP(self):
224
    """Get the IP of the master node for this cluster.
225

226
    """
227
    return self._ReadFile(constants.SS_MASTER_IP)
228

    
229
  def GetMasterNetdev(self):
230
    """Get the netdev to which we'll add the master ip.
231

232
    """
233
    return self._ReadFile(constants.SS_MASTER_NETDEV)
234

    
235
  def GetMasterNode(self):
236
    """Get the hostname of the master node for this cluster.
237

238
    """
239
    return self._ReadFile(constants.SS_MASTER_NODE)
240

    
241
  def GetNodeList(self):
242
    """Return the list of cluster nodes.
243

244
    """
245
    data = self._ReadFile(constants.SS_NODE_LIST)
246
    nl = data.splitlines(False)
247
    return nl
248

    
249
  def GetClusterTags(self):
250
    """Return the cluster tags.
251

252
    """
253
    data = self._ReadFile(constants.SS_CLUSTER_TAGS)
254
    nl = data.splitlines(False)
255
    return nl
256

    
257

    
258
def GetMasterAndMyself(ss=None):
259
  """Get the master node and my own hostname.
260

261
  This can be either used for a 'soft' check (compared to CheckMaster,
262
  which exits) or just for computing both at the same time.
263

264
  The function does not handle any errors, these should be handled in
265
  the caller (errors.ConfigurationError, errors.ResolverError).
266

267
  @param ss: either a sstore.SimpleConfigReader or a
268
      sstore.SimpleStore instance
269
  @rtype: tuple
270
  @return: a tuple (master node name, my own name)
271

272
  """
273
  if ss is None:
274
    ss = SimpleStore()
275
  return ss.GetMasterNode(), utils.HostInfo().name
276

    
277

    
278
def CheckMaster(debug, ss=None):
279
  """Checks the node setup.
280

281
  If this is the master, the function will return. Otherwise it will
282
  exit with an exit code based on the node status.
283

284
  """
285
  try:
286
    master_name, myself = GetMasterAndMyself(ss)
287
  except errors.ConfigurationError, err:
288
    print "Cluster configuration incomplete: '%s'" % str(err)
289
    sys.exit(constants.EXIT_NODESETUP_ERROR)
290
  except errors.ResolverError, err:
291
    sys.stderr.write("Cannot resolve my own name (%s)\n" % err.args[0])
292
    sys.exit(constants.EXIT_NODESETUP_ERROR)
293

    
294
  if myself != master_name:
295
    if debug:
296
      sys.stderr.write("Not master, exiting.\n")
297
    sys.exit(constants.EXIT_NOTMASTER)