Statistics
| Branch: | Tag: | Revision:

root / lib / bootstrap.py @ 1fe93c75

History | View | Annotate | Download (19.1 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 serializer
41
from ganeti import hypervisor
42

    
43

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

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

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

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

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

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

    
71

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

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

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

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

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

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

    
105

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

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

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

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

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

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

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

    
131

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

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

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

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

    
155
  hostname = utils.HostInfo()
156

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

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

    
168
  clustername = utils.HostInfo(cluster_name)
169

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    
252
  _InitSSHSetup()
253

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

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

    
291

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

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

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

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

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

    
322

    
323
def FinalizeClusterDestroy(master):
324
  """Execute the last steps of cluster destroy
325

326
  This function shuts down all the daemons, completing the destroy
327
  begun in cmdlib.LUDestroyOpcode.
328

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

    
340

    
341
def SetupNodeDaemon(cluster_name, node, ssh_key_check):
342
  """Add a node to the cluster.
343

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

348
  @param cluster_name: the cluster name
349
  @param node: the name of the new node
350
  @param ssh_key_check: whether to do a strict key check
351

352
  """
353
  sshrunner = ssh.SshRunner(cluster_name)
354

    
355
  noded_cert = utils.ReadFile(constants.SSL_CERT_FILE)
356
  rapi_cert = utils.ReadFile(constants.RAPI_CERT_FILE)
357

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

    
366
  if not noded_cert.endswith("\n"):
367
    noded_cert += "\n"
368
  if not rapi_cert.endswith("\n"):
369
    rapi_cert += "\n"
370

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

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

    
396

    
397
def MasterFailover(no_voting=False):
398
  """Failover the master node.
399

400
  This checks that we are not already the master, and will cause the
401
  current master to cease being master, and the non-master to become
402
  new master.
403

404
  @type no_voting: boolean
405
  @param no_voting: force the operation without remote nodes agreement
406
                      (dangerous)
407

408
  """
409
  sstore = ssconf.SimpleStore()
410

    
411
  old_master, new_master = ssconf.GetMasterAndMyself(sstore)
412
  node_list = sstore.GetNodeList()
413
  mc_list = sstore.GetMasterCandidates()
414

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

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

    
429
  if not no_voting:
430
    vote_list = GatherMasterVotes(node_list)
431

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

    
445
  rcode = 0
446

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

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

    
455
  # Here we have a phase where no master should be running
456

    
457
  # instantiate a real config writer, as we now know we have the
458
  # configuration data
459
  cfg = config.ConfigWriter()
460

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

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

    
474
  return rcode
475

    
476

    
477
def GetMaster():
478
  """Returns the current master node.
479

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

485
  """
486
  sstore = ssconf.SimpleStore()
487

    
488
  old_master, _ = ssconf.GetMasterAndMyself(sstore)
489

    
490
  return old_master
491

    
492

    
493
def GatherMasterVotes(node_list):
494
  """Check the agreement on who is the master.
495

496
  This function will return a list of (node, number of votes), ordered
497
  by the number of votes. Errors will be denoted by the key 'None'.
498

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

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

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

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

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

    
555
  return vote_list