Statistics
| Branch: | Tag: | Revision:

root / lib / bootstrap.py @ 88828491

History | View | Annotate | Download (17.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
"""Functions to bootstrap a new cluster.
23

24
"""
25

    
26
import os
27
import os.path
28
import re
29
import logging
30
import tempfile
31

    
32
from ganeti import rpc
33
from ganeti import ssh
34
from ganeti import utils
35
from ganeti import errors
36
from ganeti import config
37
from ganeti import constants
38
from ganeti import objects
39
from ganeti import ssconf
40
from ganeti import hypervisor
41

    
42

    
43
def _InitSSHSetup():
44
  """Setup the SSH configuration for the cluster.
45

46
  This generates a dsa keypair for root, adds the pub key to the
47
  permitted hosts and adds the hostkey to its own known hosts.
48

49
  """
50
  priv_key, pub_key, auth_keys = ssh.GetUserFiles(constants.GANETI_RUNAS)
51

    
52
  for name in priv_key, pub_key:
53
    if os.path.exists(name):
54
      utils.CreateBackup(name)
55
    utils.RemoveFile(name)
56

    
57
  result = utils.RunCmd(["ssh-keygen", "-t", "dsa",
58
                         "-f", priv_key,
59
                         "-q", "-N", ""])
60
  if result.failed:
61
    raise errors.OpExecError("Could not generate ssh keypair, error %s" %
62
                             result.output)
63

    
64
  f = open(pub_key, 'r')
65
  try:
66
    utils.AddAuthorizedKey(auth_keys, f.read(8192))
67
  finally:
68
    f.close()
69

    
70

    
71
def _GenerateSelfSignedSslCert(file_name, validity=(365 * 5)):
72
  """Generates a self-signed SSL certificate.
73

74
  @type file_name: str
75
  @param file_name: Path to output file
76
  @type validity: int
77
  @param validity: Validity for certificate in days
78

79
  """
80
  (fd, tmp_file_name) = tempfile.mkstemp(dir=os.path.dirname(file_name))
81
  try:
82
    try:
83
      # Set permissions before writing key
84
      os.chmod(tmp_file_name, 0600)
85

    
86
      result = utils.RunCmd(["openssl", "req", "-new", "-newkey", "rsa:1024",
87
                             "-days", str(validity), "-nodes", "-x509",
88
                             "-keyout", tmp_file_name, "-out", tmp_file_name,
89
                             "-batch"])
90
      if result.failed:
91
        raise errors.OpExecError("Could not generate SSL certificate, command"
92
                                 " %s had exitcode %s and error message %s" %
93
                                 (result.cmd, result.exit_code, result.output))
94

    
95
      # Make read-only
96
      os.chmod(tmp_file_name, 0400)
97

    
98
      os.rename(tmp_file_name, file_name)
99
    finally:
100
      utils.RemoveFile(tmp_file_name)
101
  finally:
102
    os.close(fd)
103

    
104

    
105
def _InitGanetiServerSetup():
106
  """Setup the necessary configuration for the initial node daemon.
107

108
  This creates the nodepass file containing the shared password for
109
  the cluster and also generates the SSL certificate.
110

111
  """
112
  _GenerateSelfSignedSslCert(constants.SSL_CERT_FILE)
113

    
114
  # Don't overwrite existing file
115
  if not os.path.exists(constants.RAPI_CERT_FILE):
116
    _GenerateSelfSignedSslCert(constants.RAPI_CERT_FILE)
117

    
118
  result = utils.RunCmd([constants.NODE_INITD_SCRIPT, "restart"])
119

    
120
  if result.failed:
121
    raise errors.OpExecError("Could not start the node daemon, command %s"
122
                             " had exitcode %s and error %s" %
123
                             (result.cmd, result.exit_code, result.output))
124

    
125

    
126
def InitCluster(cluster_name, mac_prefix, def_bridge,
127
                master_netdev, file_storage_dir, candidate_pool_size,
128
                secondary_ip=None, vg_name=None, beparams=None, hvparams=None,
129
                enabled_hypervisors=None, default_hypervisor=None):
130
  """Initialise the cluster.
131

132
  @type candidate_pool_size: int
133
  @param candidate_pool_size: master candidate pool size
134

135
  """
136
  # TODO: complete the docstring
137
  if config.ConfigWriter.IsCluster():
138
    raise errors.OpPrereqError("Cluster is already initialised")
139

    
140
  hostname = utils.HostInfo()
141

    
142
  if hostname.ip.startswith("127."):
143
    raise errors.OpPrereqError("This host's IP resolves to the private"
144
                               " range (%s). Please fix DNS or %s." %
145
                               (hostname.ip, constants.ETC_HOSTS))
146

    
147
  if not utils.OwnIpAddress(hostname.ip):
148
    raise errors.OpPrereqError("Inconsistency: this host's name resolves"
149
                               " to %s,\nbut this ip address does not"
150
                               " belong to this host."
151
                               " Aborting." % hostname.ip)
152

    
153
  clustername = utils.HostInfo(cluster_name)
154

    
155
  if utils.TcpPing(clustername.ip, constants.DEFAULT_NODED_PORT,
156
                   timeout=5):
157
    raise errors.OpPrereqError("Cluster IP already active. Aborting.")
158

    
159
  if secondary_ip:
160
    if not utils.IsValidIP(secondary_ip):
161
      raise errors.OpPrereqError("Invalid secondary ip given")
162
    if (secondary_ip != hostname.ip and
163
        not utils.OwnIpAddress(secondary_ip)):
164
      raise errors.OpPrereqError("You gave %s as secondary IP,"
165
                                 " but it does not belong to this host." %
166
                                 secondary_ip)
167
  else:
168
    secondary_ip = hostname.ip
169

    
170
  if vg_name is not None:
171
    # Check if volume group is valid
172
    vgstatus = utils.CheckVolumeGroupSize(utils.ListVolumeGroups(), vg_name,
173
                                          constants.MIN_VG_SIZE)
174
    if vgstatus:
175
      raise errors.OpPrereqError("Error: %s\nspecify --no-lvm-storage if"
176
                                 " you are not using lvm" % vgstatus)
177

    
178
  file_storage_dir = os.path.normpath(file_storage_dir)
179

    
180
  if not os.path.isabs(file_storage_dir):
181
    raise errors.OpPrereqError("The file storage directory you passed is"
182
                               " not an absolute path.")
183

    
184
  if not os.path.exists(file_storage_dir):
185
    try:
186
      os.makedirs(file_storage_dir, 0750)
187
    except OSError, err:
188
      raise errors.OpPrereqError("Cannot create file storage directory"
189
                                 " '%s': %s" %
190
                                 (file_storage_dir, err))
191

    
192
  if not os.path.isdir(file_storage_dir):
193
    raise errors.OpPrereqError("The file storage directory '%s' is not"
194
                               " a directory." % file_storage_dir)
195

    
196
  if not re.match("^[0-9a-z]{2}:[0-9a-z]{2}:[0-9a-z]{2}$", mac_prefix):
197
    raise errors.OpPrereqError("Invalid mac prefix given '%s'" % mac_prefix)
198

    
199
  result = utils.RunCmd(["ip", "link", "show", "dev", master_netdev])
200
  if result.failed:
201
    raise errors.OpPrereqError("Invalid master netdev given (%s): '%s'" %
202
                               (master_netdev,
203
                                result.output.strip()))
204

    
205
  if not (os.path.isfile(constants.NODE_INITD_SCRIPT) and
206
          os.access(constants.NODE_INITD_SCRIPT, os.X_OK)):
207
    raise errors.OpPrereqError("Init.d script '%s' missing or not"
208
                               " executable." % constants.NODE_INITD_SCRIPT)
209

    
210
  dirs = [(constants.RUN_GANETI_DIR, constants.RUN_DIRS_MODE)]
211
  utils.EnsureDirs(dirs)
212

    
213
  utils.ForceDictType(beparams, constants.BES_PARAMETER_TYPES)
214
  # hvparams is a mapping of hypervisor->hvparams dict
215
  for hv_name, hv_params in hvparams.iteritems():
216
    utils.ForceDictType(hv_params, constants.HVS_PARAMETER_TYPES)
217
    hv_class = hypervisor.GetHypervisor(hv_name)
218
    hv_class.CheckParameterSyntax(hv_params)
219

    
220
  # set up the inter-node password and certificate
221
  _InitGanetiServerSetup()
222

    
223
  # set up ssh config and /etc/hosts
224
  f = open(constants.SSH_HOST_RSA_PUB, 'r')
225
  try:
226
    sshline = f.read()
227
  finally:
228
    f.close()
229
  sshkey = sshline.split(" ")[1]
230

    
231
  utils.AddHostToEtcHosts(hostname.name)
232
  _InitSSHSetup()
233

    
234
  # init of cluster config file
235
  cluster_config = objects.Cluster(
236
    serial_no=1,
237
    rsahostkeypub=sshkey,
238
    highest_used_port=(constants.FIRST_DRBD_PORT - 1),
239
    mac_prefix=mac_prefix,
240
    volume_group_name=vg_name,
241
    default_bridge=def_bridge,
242
    tcpudp_port_pool=set(),
243
    master_node=hostname.name,
244
    master_ip=clustername.ip,
245
    master_netdev=master_netdev,
246
    cluster_name=clustername.name,
247
    file_storage_dir=file_storage_dir,
248
    enabled_hypervisors=enabled_hypervisors,
249
    default_hypervisor=default_hypervisor,
250
    beparams={constants.BEGR_DEFAULT: beparams},
251
    hvparams=hvparams,
252
    candidate_pool_size=candidate_pool_size,
253
    )
254
  master_node_config = objects.Node(name=hostname.name,
255
                                    primary_ip=hostname.ip,
256
                                    secondary_ip=secondary_ip,
257
                                    serial_no=1,
258
                                    master_candidate=True,
259
                                    offline=False, drained=False,
260
                                    )
261

    
262
  sscfg = InitConfig(constants.CONFIG_VERSION,
263
                     cluster_config, master_node_config)
264
  ssh.WriteKnownHostsFile(sscfg, constants.SSH_KNOWN_HOSTS_FILE)
265
  cfg = config.ConfigWriter()
266
  cfg.Update(cfg.GetClusterInfo())
267

    
268
  # start the master ip
269
  # TODO: Review rpc call from bootstrap
270
  rpc.RpcRunner.call_node_start_master(hostname.name, True)
271

    
272

    
273
def InitConfig(version, cluster_config, master_node_config,
274
               cfg_file=constants.CLUSTER_CONF_FILE):
275
  """Create the initial cluster configuration.
276

277
  It will contain the current node, which will also be the master
278
  node, and no instances.
279

280
  @type version: int
281
  @param version: configuration version
282
  @type cluster_config: L{objects.Cluster}
283
  @param cluster_config: cluster configuration
284
  @type master_node_config: L{objects.Node}
285
  @param master_node_config: master node configuration
286
  @type cfg_file: string
287
  @param cfg_file: configuration file path
288

289
  @rtype: L{ssconf.SimpleConfigWriter}
290
  @return: initialized config instance
291

292
  """
293
  nodes = {
294
    master_node_config.name: master_node_config,
295
    }
296

    
297
  config_data = objects.ConfigData(version=version,
298
                                   cluster=cluster_config,
299
                                   nodes=nodes,
300
                                   instances={},
301
                                   serial_no=1)
302
  cfg = ssconf.SimpleConfigWriter.FromDict(config_data.ToDict(), cfg_file)
303
  cfg.Save()
304

    
305
  return cfg
306

    
307

    
308
def FinalizeClusterDestroy(master):
309
  """Execute the last steps of cluster destroy
310

311
  This function shuts down all the daemons, completing the destroy
312
  begun in cmdlib.LUDestroyOpcode.
313

314
  """
315
  result = rpc.RpcRunner.call_node_stop_master(master, True)
316
  if result.failed or not result.data:
317
    logging.warning("Could not disable the master role")
318
  result = rpc.RpcRunner.call_node_leave_cluster(master)
319
  if result.failed or not result.data:
320
    logging.warning("Could not shutdown the node daemon and cleanup the node")
321

    
322

    
323
def SetupNodeDaemon(cluster_name, node, ssh_key_check):
324
  """Add a node to the cluster.
325

326
  This function must be called before the actual opcode, and will ssh
327
  to the remote node, copy the needed files, and start ganeti-noded,
328
  allowing the master to do the rest via normal rpc calls.
329

330
  @param cluster_name: the cluster name
331
  @param node: the name of the new node
332
  @param ssh_key_check: whether to do a strict key check
333

334
  """
335
  sshrunner = ssh.SshRunner(cluster_name)
336

    
337
  noded_cert = utils.ReadFile(constants.SSL_CERT_FILE)
338
  rapi_cert = utils.ReadFile(constants.RAPI_CERT_FILE)
339

    
340
  # in the base64 pem encoding, neither '!' nor '.' are valid chars,
341
  # so we use this to detect an invalid certificate; as long as the
342
  # cert doesn't contain this, the here-document will be correctly
343
  # parsed by the shell sequence below
344
  if (re.search('^!EOF\.', noded_cert, re.MULTILINE) or
345
      re.search('^!EOF\.', rapi_cert, re.MULTILINE)):
346
    raise errors.OpExecError("invalid PEM encoding in the SSL certificate")
347

    
348
  if not noded_cert.endswith("\n"):
349
    noded_cert += "\n"
350
  if not rapi_cert.endswith("\n"):
351
    rapi_cert += "\n"
352

    
353
  # set up inter-node password and certificate and restarts the node daemon
354
  # and then connect with ssh to set password and start ganeti-noded
355
  # note that all the below variables are sanitized at this point,
356
  # either by being constants or by the checks above
357
  mycommand = ("umask 077 && "
358
               "cat > '%s' << '!EOF.' && \n"
359
               "%s!EOF.\n"
360
               "cat > '%s' << '!EOF.' && \n"
361
               "%s!EOF.\n"
362
               "chmod 0400 %s %s && "
363
               "%s restart" %
364
               (constants.SSL_CERT_FILE, noded_cert,
365
                constants.RAPI_CERT_FILE, rapi_cert,
366
                constants.SSL_CERT_FILE, constants.RAPI_CERT_FILE,
367
                constants.NODE_INITD_SCRIPT))
368

    
369
  result = sshrunner.Run(node, 'root', mycommand, batch=False,
370
                         ask_key=ssh_key_check,
371
                         use_cluster_key=False,
372
                         strict_host_check=ssh_key_check)
373
  if result.failed:
374
    raise errors.OpExecError("Remote command on node %s, error: %s,"
375
                             " output: %s" %
376
                             (node, result.fail_reason, result.output))
377

    
378

    
379
def MasterFailover():
380
  """Failover the master node.
381

382
  This checks that we are not already the master, and will cause the
383
  current master to cease being master, and the non-master to become
384
  new master.
385

386
  """
387
  sstore = ssconf.SimpleStore()
388

    
389
  old_master, new_master = ssconf.GetMasterAndMyself(sstore)
390
  node_list = sstore.GetNodeList()
391
  mc_list = sstore.GetMasterCandidates()
392

    
393
  if old_master == new_master:
394
    raise errors.OpPrereqError("This commands must be run on the node"
395
                               " where you want the new master to be."
396
                               " %s is already the master" %
397
                               old_master)
398

    
399
  if new_master not in mc_list:
400
    mc_no_master = [name for name in mc_list if name != old_master]
401
    raise errors.OpPrereqError("This node is not among the nodes marked"
402
                               " as master candidates. Only these nodes"
403
                               " can become masters. Current list of"
404
                               " master candidates is:\n"
405
                               "%s" % ('\n'.join(mc_no_master)))
406

    
407
  vote_list = GatherMasterVotes(node_list)
408

    
409
  if vote_list:
410
    voted_master = vote_list[0][0]
411
    if voted_master is None:
412
      raise errors.OpPrereqError("Cluster is inconsistent, most nodes did not"
413
                                 " respond.")
414
    elif voted_master != old_master:
415
      raise errors.OpPrereqError("I have wrong configuration, I believe the"
416
                                 " master is %s but the other nodes voted for"
417
                                 " %s. Please resync the configuration of"
418
                                 " this node." % (old_master, voted_master))
419
  # end checks
420

    
421
  rcode = 0
422

    
423
  logging.info("Setting master to %s, old master: %s", new_master, old_master)
424

    
425
  result = rpc.RpcRunner.call_node_stop_master(old_master, True)
426
  if result.failed or not result.data:
427
    logging.error("Could not disable the master role on the old master"
428
                 " %s, please disable manually", old_master)
429

    
430
  # Here we have a phase where no master should be running
431

    
432
  # instantiate a real config writer, as we now know we have the
433
  # configuration data
434
  cfg = config.ConfigWriter()
435

    
436
  cluster_info = cfg.GetClusterInfo()
437
  cluster_info.master_node = new_master
438
  # this will also regenerate the ssconf files, since we updated the
439
  # cluster info
440
  cfg.Update(cluster_info)
441

    
442
  result = rpc.RpcRunner.call_node_start_master(new_master, True)
443
  if result.failed or not result.data:
444
    logging.error("Could not start the master role on the new master"
445
                  " %s, please check", new_master)
446
    rcode = 1
447

    
448
  return rcode
449

    
450

    
451
def GetMaster():
452
  """Returns the current master node.
453

454
  This is a separate function in bootstrap since it's needed by
455
  gnt-cluster, and instead of importing directly ssconf, it's better
456
  to abstract it in bootstrap, where we do use ssconf in other
457
  functions too.
458

459
  """
460
  sstore = ssconf.SimpleStore()
461

    
462
  old_master, _ = ssconf.GetMasterAndMyself(sstore)
463

    
464
  return old_master
465

    
466

    
467
def GatherMasterVotes(node_list):
468
  """Check the agreement on who is the master.
469

470
  This function will return a list of (node, number of votes), ordered
471
  by the number of votes. Errors will be denoted by the key 'None'.
472

473
  Note that the sum of votes is the number of nodes this machine
474
  knows, whereas the number of entries in the list could be different
475
  (if some nodes vote for another master).
476

477
  We remove ourselves from the list since we know that (bugs aside)
478
  since we use the same source for configuration information for both
479
  backend and boostrap, we'll always vote for ourselves.
480

481
  @type node_list: list
482
  @param node_list: the list of nodes to query for master info; the current
483
      node will be removed if it is in the list
484
  @rtype: list
485
  @return: list of (node, votes)
486

487
  """
488
  myself = utils.HostInfo().name
489
  try:
490
    node_list.remove(myself)
491
  except ValueError:
492
    pass
493
  if not node_list:
494
    # no nodes left (eventually after removing myself)
495
    return []
496
  results = rpc.RpcRunner.call_master_info(node_list)
497
  if not isinstance(results, dict):
498
    # this should not happen (unless internal error in rpc)
499
    logging.critical("Can't complete rpc call, aborting master startup")
500
    return [(None, len(node_list))]
501
  votes = {}
502
  for node in results:
503
    nres = results[node]
504
    data = nres.data
505
    if nres.failed or not isinstance(data, (tuple, list)) or len(data) < 3:
506
      # here the rpc layer should have already logged errors
507
      if None not in votes:
508
        votes[None] = 0
509
      votes[None] += 1
510
      continue
511
    master_node = data[2]
512
    if master_node not in votes:
513
      votes[master_node] = 0
514
    votes[master_node] += 1
515

    
516
  vote_list = [v for v in votes.items()]
517
  # sort first on number of votes then on name, since we want None
518
  # sorted later if we have the half of the nodes not responding, and
519
  # half voting all for the same master
520
  vote_list.sort(key=lambda x: (x[1], x[0]), reverse=True)
521

    
522
  return vote_list