Statistics
| Branch: | Tag: | Revision:

root / lib / bootstrap.py @ d693c864

History | View | Annotate | Download (19.2 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
import time
32

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

    
44

    
45
def _InitSSHSetup():
46
  """Setup the SSH configuration for the cluster.
47

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

51
  """
52
  priv_key, pub_key, auth_keys = ssh.GetUserFiles(constants.GANETI_RUNAS)
53

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

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

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

    
72

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

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

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

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

    
97
      # Make read-only
98
      os.chmod(tmp_file_name, 0400)
99

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

    
106

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

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

113
  """
114
  _GenerateSelfSignedSslCert(constants.SSL_CERT_FILE)
115

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

    
120
  if not os.path.exists(constants.HMAC_CLUSTER_KEY):
121
    utils.WriteFile(constants.HMAC_CLUSTER_KEY,
122
                    data=utils.GenerateSecret(),
123
                    mode=0400)
124

    
125
  result = utils.RunCmd([constants.NODE_INITD_SCRIPT, "restart"])
126

    
127
  if result.failed:
128
    raise errors.OpExecError("Could not start the node daemon, command %s"
129
                             " had exitcode %s and error %s" %
130
                             (result.cmd, result.exit_code, result.output))
131

    
132

    
133
def InitCluster(cluster_name, mac_prefix,
134
                master_netdev, file_storage_dir, candidate_pool_size,
135
                secondary_ip=None, vg_name=None, beparams=None,
136
                nicparams=None, hvparams=None, enabled_hypervisors=None,
137
                modify_etc_hosts=True):
138
  """Initialise the cluster.
139

140
  @type candidate_pool_size: int
141
  @param candidate_pool_size: master candidate pool size
142

143
  """
144
  # TODO: complete the docstring
145
  if config.ConfigWriter.IsCluster():
146
    raise errors.OpPrereqError("Cluster is already initialised")
147

    
148
  if not enabled_hypervisors:
149
    raise errors.OpPrereqError("Enabled hypervisors list must contain at"
150
                               " least one member")
151
  invalid_hvs = set(enabled_hypervisors) - constants.HYPER_TYPES
152
  if invalid_hvs:
153
    raise errors.OpPrereqError("Enabled hypervisors contains invalid"
154
                               " entries: %s" % invalid_hvs)
155

    
156
  hostname = utils.HostInfo()
157

    
158
  if hostname.ip.startswith("127."):
159
    raise errors.OpPrereqError("This host's IP resolves to the private"
160
                               " range (%s). Please fix DNS or %s." %
161
                               (hostname.ip, constants.ETC_HOSTS))
162

    
163
  if not utils.OwnIpAddress(hostname.ip):
164
    raise errors.OpPrereqError("Inconsistency: this host's name resolves"
165
                               " to %s,\nbut this ip address does not"
166
                               " belong to this host."
167
                               " Aborting." % hostname.ip)
168

    
169
  clustername = utils.HostInfo(cluster_name)
170

    
171
  if utils.TcpPing(clustername.ip, constants.DEFAULT_NODED_PORT,
172
                   timeout=5):
173
    raise errors.OpPrereqError("Cluster IP already active. Aborting.")
174

    
175
  if secondary_ip:
176
    if not utils.IsValidIP(secondary_ip):
177
      raise errors.OpPrereqError("Invalid secondary ip given")
178
    if (secondary_ip != hostname.ip and
179
        not utils.OwnIpAddress(secondary_ip)):
180
      raise errors.OpPrereqError("You gave %s as secondary IP,"
181
                                 " but it does not belong to this host." %
182
                                 secondary_ip)
183
  else:
184
    secondary_ip = hostname.ip
185

    
186
  if vg_name is not None:
187
    # Check if volume group is valid
188
    vgstatus = utils.CheckVolumeGroupSize(utils.ListVolumeGroups(), vg_name,
189
                                          constants.MIN_VG_SIZE)
190
    if vgstatus:
191
      raise errors.OpPrereqError("Error: %s\nspecify --no-lvm-storage if"
192
                                 " you are not using lvm" % vgstatus)
193

    
194
  file_storage_dir = os.path.normpath(file_storage_dir)
195

    
196
  if not os.path.isabs(file_storage_dir):
197
    raise errors.OpPrereqError("The file storage directory you passed is"
198
                               " not an absolute path.")
199

    
200
  if not os.path.exists(file_storage_dir):
201
    try:
202
      os.makedirs(file_storage_dir, 0750)
203
    except OSError, err:
204
      raise errors.OpPrereqError("Cannot create file storage directory"
205
                                 " '%s': %s" %
206
                                 (file_storage_dir, err))
207

    
208
  if not os.path.isdir(file_storage_dir):
209
    raise errors.OpPrereqError("The file storage directory '%s' is not"
210
                               " a directory." % file_storage_dir)
211

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

    
215
  result = utils.RunCmd(["ip", "link", "show", "dev", master_netdev])
216
  if result.failed:
217
    raise errors.OpPrereqError("Invalid master netdev given (%s): '%s'" %
218
                               (master_netdev,
219
                                result.output.strip()))
220

    
221
  if not (os.path.isfile(constants.NODE_INITD_SCRIPT) and
222
          os.access(constants.NODE_INITD_SCRIPT, os.X_OK)):
223
    raise errors.OpPrereqError("Init.d script '%s' missing or not"
224
                               " executable." % constants.NODE_INITD_SCRIPT)
225

    
226
  dirs = [(constants.RUN_GANETI_DIR, constants.RUN_DIRS_MODE)]
227
  utils.EnsureDirs(dirs)
228

    
229
  utils.ForceDictType(beparams, constants.BES_PARAMETER_TYPES)
230
  utils.ForceDictType(nicparams, constants.NICS_PARAMETER_TYPES)
231
  objects.NIC.CheckParameterSyntax(nicparams)
232

    
233
  # hvparams is a mapping of hypervisor->hvparams dict
234
  for hv_name, hv_params in hvparams.iteritems():
235
    utils.ForceDictType(hv_params, constants.HVS_PARAMETER_TYPES)
236
    hv_class = hypervisor.GetHypervisor(hv_name)
237
    hv_class.CheckParameterSyntax(hv_params)
238

    
239
  # set up the inter-node password and certificate
240
  _InitGanetiServerSetup()
241

    
242
  # set up ssh config and /etc/hosts
243
  f = open(constants.SSH_HOST_RSA_PUB, 'r')
244
  try:
245
    sshline = f.read()
246
  finally:
247
    f.close()
248
  sshkey = sshline.split(" ")[1]
249

    
250
  if modify_etc_hosts:
251
    utils.AddHostToEtcHosts(hostname.name)
252

    
253
  _InitSSHSetup()
254

    
255
  # init of cluster config file
256
  cluster_config = objects.Cluster(
257
    serial_no=1,
258
    rsahostkeypub=sshkey,
259
    highest_used_port=(constants.FIRST_DRBD_PORT - 1),
260
    mac_prefix=mac_prefix,
261
    volume_group_name=vg_name,
262
    tcpudp_port_pool=set(),
263
    master_node=hostname.name,
264
    master_ip=clustername.ip,
265
    master_netdev=master_netdev,
266
    cluster_name=clustername.name,
267
    file_storage_dir=file_storage_dir,
268
    enabled_hypervisors=enabled_hypervisors,
269
    beparams={constants.PP_DEFAULT: beparams},
270
    nicparams={constants.PP_DEFAULT: nicparams},
271
    hvparams=hvparams,
272
    candidate_pool_size=candidate_pool_size,
273
    modify_etc_hosts=modify_etc_hosts,
274
    )
275
  master_node_config = objects.Node(name=hostname.name,
276
                                    primary_ip=hostname.ip,
277
                                    secondary_ip=secondary_ip,
278
                                    serial_no=1,
279
                                    master_candidate=True,
280
                                    offline=False, drained=False,
281
                                    )
282
  InitConfig(constants.CONFIG_VERSION, cluster_config, master_node_config)
283
  cfg = config.ConfigWriter()
284
  ssh.WriteKnownHostsFile(cfg, constants.SSH_KNOWN_HOSTS_FILE)
285
  cfg.Update(cfg.GetClusterInfo())
286

    
287
  # start the master ip
288
  # TODO: Review rpc call from bootstrap
289
  # TODO: Warn on failed start master
290
  rpc.RpcRunner.call_node_start_master(hostname.name, True, False)
291

    
292

    
293
def InitConfig(version, cluster_config, master_node_config,
294
               cfg_file=constants.CLUSTER_CONF_FILE):
295
  """Create the initial cluster configuration.
296

297
  It will contain the current node, which will also be the master
298
  node, and no instances.
299

300
  @type version: int
301
  @param version: configuration version
302
  @type cluster_config: L{objects.Cluster}
303
  @param cluster_config: cluster configuration
304
  @type master_node_config: L{objects.Node}
305
  @param master_node_config: master node configuration
306
  @type cfg_file: string
307
  @param cfg_file: configuration file path
308

309
  """
310
  nodes = {
311
    master_node_config.name: master_node_config,
312
    }
313

    
314
  now = time.time()
315
  config_data = objects.ConfigData(version=version,
316
                                   cluster=cluster_config,
317
                                   nodes=nodes,
318
                                   instances={},
319
                                   serial_no=1,
320
                                   ctime=now, mtime=now)
321
  utils.WriteFile(cfg_file,
322
                  data=serializer.Dump(config_data.ToDict()),
323
                  mode=0600)
324

    
325

    
326
def FinalizeClusterDestroy(master):
327
  """Execute the last steps of cluster destroy
328

329
  This function shuts down all the daemons, completing the destroy
330
  begun in cmdlib.LUDestroyOpcode.
331

332
  """
333
  result = rpc.RpcRunner.call_node_stop_master(master, True)
334
  msg = result.RemoteFailMsg()
335
  if msg:
336
    logging.warning("Could not disable the master role: %s" % msg)
337
  result = rpc.RpcRunner.call_node_leave_cluster(master)
338
  msg = result.RemoteFailMsg()
339
  if msg:
340
    logging.warning("Could not shutdown the node daemon and cleanup"
341
                    " the node: %s", msg)
342

    
343

    
344
def SetupNodeDaemon(cluster_name, node, ssh_key_check):
345
  """Add a node to the cluster.
346

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

351
  @param cluster_name: the cluster name
352
  @param node: the name of the new node
353
  @param ssh_key_check: whether to do a strict key check
354

355
  """
356
  sshrunner = ssh.SshRunner(cluster_name)
357

    
358
  noded_cert = utils.ReadFile(constants.SSL_CERT_FILE)
359
  rapi_cert = utils.ReadFile(constants.RAPI_CERT_FILE)
360

    
361
  # in the base64 pem encoding, neither '!' nor '.' are valid chars,
362
  # so we use this to detect an invalid certificate; as long as the
363
  # cert doesn't contain this, the here-document will be correctly
364
  # parsed by the shell sequence below
365
  if (re.search('^!EOF\.', noded_cert, re.MULTILINE) or
366
      re.search('^!EOF\.', rapi_cert, re.MULTILINE)):
367
    raise errors.OpExecError("invalid PEM encoding in the SSL certificate")
368

    
369
  if not noded_cert.endswith("\n"):
370
    noded_cert += "\n"
371
  if not rapi_cert.endswith("\n"):
372
    rapi_cert += "\n"
373

    
374
  # set up inter-node password and certificate and restarts the node daemon
375
  # and then connect with ssh to set password and start ganeti-noded
376
  # note that all the below variables are sanitized at this point,
377
  # either by being constants or by the checks above
378
  mycommand = ("umask 077 && "
379
               "cat > '%s' << '!EOF.' && \n"
380
               "%s!EOF.\n"
381
               "cat > '%s' << '!EOF.' && \n"
382
               "%s!EOF.\n"
383
               "chmod 0400 %s %s && "
384
               "%s restart" %
385
               (constants.SSL_CERT_FILE, noded_cert,
386
                constants.RAPI_CERT_FILE, rapi_cert,
387
                constants.SSL_CERT_FILE, constants.RAPI_CERT_FILE,
388
                constants.NODE_INITD_SCRIPT))
389

    
390
  result = sshrunner.Run(node, 'root', mycommand, batch=False,
391
                         ask_key=ssh_key_check,
392
                         use_cluster_key=False,
393
                         strict_host_check=ssh_key_check)
394
  if result.failed:
395
    raise errors.OpExecError("Remote command on node %s, error: %s,"
396
                             " output: %s" %
397
                             (node, result.fail_reason, result.output))
398

    
399

    
400
def MasterFailover(no_voting=False):
401
  """Failover the master node.
402

403
  This checks that we are not already the master, and will cause the
404
  current master to cease being master, and the non-master to become
405
  new master.
406

407
  @type no_voting: boolean
408
  @param no_voting: force the operation without remote nodes agreement
409
                      (dangerous)
410

411
  """
412
  sstore = ssconf.SimpleStore()
413

    
414
  old_master, new_master = ssconf.GetMasterAndMyself(sstore)
415
  node_list = sstore.GetNodeList()
416
  mc_list = sstore.GetMasterCandidates()
417

    
418
  if old_master == new_master:
419
    raise errors.OpPrereqError("This commands must be run on the node"
420
                               " where you want the new master to be."
421
                               " %s is already the master" %
422
                               old_master)
423

    
424
  if new_master not in mc_list:
425
    mc_no_master = [name for name in mc_list if name != old_master]
426
    raise errors.OpPrereqError("This node is not among the nodes marked"
427
                               " as master candidates. Only these nodes"
428
                               " can become masters. Current list of"
429
                               " master candidates is:\n"
430
                               "%s" % ('\n'.join(mc_no_master)))
431

    
432
  if not no_voting:
433
    vote_list = GatherMasterVotes(node_list)
434

    
435
    if vote_list:
436
      voted_master = vote_list[0][0]
437
      if voted_master is None:
438
        raise errors.OpPrereqError("Cluster is inconsistent, most nodes did"
439
                                   " not respond.")
440
      elif voted_master != old_master:
441
        raise errors.OpPrereqError("I have a wrong configuration, I believe"
442
                                   " the master is %s but the other nodes"
443
                                   " voted %s. Please resync the configuration"
444
                                   " of this node." %
445
                                   (old_master, voted_master))
446
  # end checks
447

    
448
  rcode = 0
449

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

    
452
  result = rpc.RpcRunner.call_node_stop_master(old_master, True)
453
  msg = result.RemoteFailMsg()
454
  if msg:
455
    logging.error("Could not disable the master role on the old master"
456
                 " %s, please disable manually: %s", old_master, msg)
457

    
458
  # Here we have a phase where no master should be running
459

    
460
  # instantiate a real config writer, as we now know we have the
461
  # configuration data
462
  cfg = config.ConfigWriter()
463

    
464
  cluster_info = cfg.GetClusterInfo()
465
  cluster_info.master_node = new_master
466
  # this will also regenerate the ssconf files, since we updated the
467
  # cluster info
468
  cfg.Update(cluster_info)
469

    
470
  result = rpc.RpcRunner.call_node_start_master(new_master, True, no_voting)
471
  msg = result.RemoteFailMsg()
472
  if msg:
473
    logging.error("Could not start the master role on the new master"
474
                  " %s, please check: %s", new_master, msg)
475
    rcode = 1
476

    
477
  return rcode
478

    
479

    
480
def GetMaster():
481
  """Returns the current master node.
482

483
  This is a separate function in bootstrap since it's needed by
484
  gnt-cluster, and instead of importing directly ssconf, it's better
485
  to abstract it in bootstrap, where we do use ssconf in other
486
  functions too.
487

488
  """
489
  sstore = ssconf.SimpleStore()
490

    
491
  old_master, _ = ssconf.GetMasterAndMyself(sstore)
492

    
493
  return old_master
494

    
495

    
496
def GatherMasterVotes(node_list):
497
  """Check the agreement on who is the master.
498

499
  This function will return a list of (node, number of votes), ordered
500
  by the number of votes. Errors will be denoted by the key 'None'.
501

502
  Note that the sum of votes is the number of nodes this machine
503
  knows, whereas the number of entries in the list could be different
504
  (if some nodes vote for another master).
505

506
  We remove ourselves from the list since we know that (bugs aside)
507
  since we use the same source for configuration information for both
508
  backend and boostrap, we'll always vote for ourselves.
509

510
  @type node_list: list
511
  @param node_list: the list of nodes to query for master info; the current
512
      node will be removed if it is in the list
513
  @rtype: list
514
  @return: list of (node, votes)
515

516
  """
517
  myself = utils.HostInfo().name
518
  try:
519
    node_list.remove(myself)
520
  except ValueError:
521
    pass
522
  if not node_list:
523
    # no nodes left (eventually after removing myself)
524
    return []
525
  results = rpc.RpcRunner.call_master_info(node_list)
526
  if not isinstance(results, dict):
527
    # this should not happen (unless internal error in rpc)
528
    logging.critical("Can't complete rpc call, aborting master startup")
529
    return [(None, len(node_list))]
530
  votes = {}
531
  for node in results:
532
    nres = results[node]
533
    data = nres.payload
534
    msg = nres.RemoteFailMsg()
535
    fail = False
536
    if msg:
537
      logging.warning("Error contacting node %s: %s", node, msg)
538
      fail = True
539
    elif not isinstance(data, (tuple, list)) or len(data) < 3:
540
      logging.warning("Invalid data received from node %s: %s", node, data)
541
      fail = True
542
    if fail:
543
      if None not in votes:
544
        votes[None] = 0
545
      votes[None] += 1
546
      continue
547
    master_node = data[2]
548
    if master_node not in votes:
549
      votes[master_node] = 0
550
    votes[master_node] += 1
551

    
552
  vote_list = [v for v in votes.items()]
553
  # sort first on number of votes then on name, since we want None
554
  # sorted later if we have the half of the nodes not responding, and
555
  # half voting all for the same master
556
  vote_list.sort(key=lambda x: (x[1], x[0]), reverse=True)
557

    
558
  return vote_list