bootstrap.py 46.2 KB
Newer Older
1 2 3
#
#

4
# Copyright (C) 2006, 2007, 2008, 2010, 2011, 2012 Google Inc.
Klaus Aehlig's avatar
Klaus Aehlig committed
5
# All rights reserved.
6
#
Klaus Aehlig's avatar
Klaus Aehlig committed
7 8 9
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are
# met:
10
#
Klaus Aehlig's avatar
Klaus Aehlig committed
11 12
# 1. Redistributions of source code must retain the above copyright notice,
# this list of conditions and the following disclaimer.
13
#
Klaus Aehlig's avatar
Klaus Aehlig committed
14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
# 2. Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 30 31 32 33 34 35 36 37


"""Functions to bootstrap a new cluster.

"""

import os
import os.path
import re
38
import logging
39
import time
40
import tempfile
41

42
from ganeti.cmdlib import cluster
43
import ganeti.rpc.node as rpc
44 45 46 47 48
from ganeti import ssh
from ganeti import utils
from ganeti import errors
from ganeti import config
from ganeti import constants
49
from ganeti import objects
50
from ganeti import ssconf
51
from ganeti import serializer
52
from ganeti import hypervisor
53
from ganeti.storage import drbd
54
from ganeti.storage import filestorage
55
from ganeti import netutils
56
from ganeti import luxi
57
from ganeti import jstore
58
from ganeti import pathutils
59
from ganeti import runtime
60
from ganeti import vcluster
61

62

63 64 65
# ec_id for InitConfig's temporary reservation manager
_INITCONF_ECID = "initconfig-ecid"

66 67 68
#: After how many seconds daemon must be responsive
_DAEMON_READY_TIMEOUT = 10.0

69

70
def _InitSSHSetup():
71 72 73 74 75 76
  """Setup the SSH configuration for the cluster.

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

  """
Michael Hanselmann's avatar
Michael Hanselmann committed
77
  priv_key, pub_key, auth_keys = ssh.GetUserFiles(constants.SSH_LOGIN_USER)
78 79 80 81 82 83 84 85 86 87 88 89 90

  for name in priv_key, pub_key:
    if os.path.exists(name):
      utils.CreateBackup(name)
    utils.RemoveFile(name)

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

91
  utils.AddAuthorizedKey(auth_keys, utils.ReadFile(pub_key))
92 93


94 95 96 97 98 99 100
def GenerateHmacKey(file_name):
  """Writes a new HMAC key.

  @type file_name: str
  @param file_name: Path to output file

  """
101 102 103 104
  utils.WriteFile(file_name, data="%s\n" % utils.GenerateSecret(), mode=0400,
                  backup=True)


105
# pylint: disable=R0913
106
def GenerateClusterCrypto(new_cluster_cert, new_rapi_cert, new_spice_cert,
107
                          new_confd_hmac_key, new_cds,
108 109
                          rapi_cert_pem=None, spice_cert_pem=None,
                          spice_cacert_pem=None, cds=None,
110 111 112 113 114 115
                          nodecert_file=pathutils.NODED_CERT_FILE,
                          rapicert_file=pathutils.RAPI_CERT_FILE,
                          spicecert_file=pathutils.SPICE_CERT_FILE,
                          spicecacert_file=pathutils.SPICE_CACERT_FILE,
                          hmackey_file=pathutils.CONFD_HMAC_KEY,
                          cds_file=pathutils.CLUSTER_DOMAIN_SECRET_FILE):
116 117 118 119 120 121
  """Updates the cluster certificates, keys and secrets.

  @type new_cluster_cert: bool
  @param new_cluster_cert: Whether to generate a new cluster certificate
  @type new_rapi_cert: bool
  @param new_rapi_cert: Whether to generate a new RAPI certificate
122 123
  @type new_spice_cert: bool
  @param new_spice_cert: Whether to generate a new SPICE certificate
124 125
  @type new_confd_hmac_key: bool
  @param new_confd_hmac_key: Whether to generate a new HMAC key
Michael Hanselmann's avatar
Michael Hanselmann committed
126 127
  @type new_cds: bool
  @param new_cds: Whether to generate a new cluster domain secret
128 129
  @type rapi_cert_pem: string
  @param rapi_cert_pem: New RAPI certificate in PEM format
130 131 132 133 134
  @type spice_cert_pem: string
  @param spice_cert_pem: New SPICE certificate in PEM format
  @type spice_cacert_pem: string
  @param spice_cacert_pem: Certificate of the CA that signed the SPICE
                           certificate, in PEM format
Michael Hanselmann's avatar
Michael Hanselmann committed
135 136
  @type cds: string
  @param cds: New cluster domain secret
137 138 139 140
  @type nodecert_file: string
  @param nodecert_file: optional override of the node cert file path
  @type rapicert_file: string
  @param rapicert_file: optional override of the rapi cert file path
141 142 143 144
  @type spicecert_file: string
  @param spicecert_file: optional override of the spice cert file path
  @type spicecacert_file: string
  @param spicecacert_file: optional override of the spice CA cert file path
145 146
  @type hmackey_file: string
  @param hmackey_file: optional override of the hmac key file path
147 148

  """
149
  # pylint: disable=R0913
150
  # noded SSL certificate
151
  utils.GenerateNewSslCert(
152
    new_cluster_cert, nodecert_file, 1,
153
    "Generating new cluster certificate at %s" % nodecert_file)
154

155
  # confd HMAC key
156 157 158
  if new_confd_hmac_key or not os.path.exists(hmackey_file):
    logging.debug("Writing new confd HMAC key to %s", hmackey_file)
    GenerateHmacKey(hmackey_file)
159 160 161

  if rapi_cert_pem:
    # Assume rapi_pem contains a valid PEM-formatted certificate and key
162 163
    logging.debug("Writing RAPI certificate at %s", rapicert_file)
    utils.WriteFile(rapicert_file, data=rapi_cert_pem, backup=True)
164

165 166
  else:
    utils.GenerateNewSslCert(
167
      new_rapi_cert, rapicert_file, 1,
168
      "Generating new RAPI certificate at %s" % rapicert_file)
169

170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186
  # SPICE
  spice_cert_exists = os.path.exists(spicecert_file)
  spice_cacert_exists = os.path.exists(spicecacert_file)
  if spice_cert_pem:
    # spice_cert_pem implies also spice_cacert_pem
    logging.debug("Writing SPICE certificate at %s", spicecert_file)
    utils.WriteFile(spicecert_file, data=spice_cert_pem, backup=True)
    logging.debug("Writing SPICE CA certificate at %s", spicecacert_file)
    utils.WriteFile(spicecacert_file, data=spice_cacert_pem, backup=True)
  elif new_spice_cert or not spice_cert_exists:
    if spice_cert_exists:
      utils.CreateBackup(spicecert_file)
    if spice_cacert_exists:
      utils.CreateBackup(spicecacert_file)

    logging.debug("Generating new self-signed SPICE certificate at %s",
                  spicecert_file)
187
    (_, cert_pem) = utils.GenerateSelfSignedSslCert(spicecert_file, 1)
188 189 190 191 192 193 194

    # Self-signed certificate -> the public certificate is also the CA public
    # certificate
    logging.debug("Writing the public certificate to %s",
                  spicecert_file)
    utils.io.WriteFile(spicecacert_file, mode=0400, data=cert_pem)

Michael Hanselmann's avatar
Michael Hanselmann committed
195 196
  # Cluster domain secret
  if cds:
197 198 199 200 201 202
    logging.debug("Writing cluster domain secret to %s", cds_file)
    utils.WriteFile(cds_file, data=cds, backup=True)

  elif new_cds or not os.path.exists(cds_file):
    logging.debug("Generating new cluster domain secret at %s", cds_file)
    GenerateHmacKey(cds_file)
Michael Hanselmann's avatar
Michael Hanselmann committed
203

204

205
def _InitGanetiServerSetup(master_name):
206 207 208
  """Setup the necessary configuration for the initial node daemon.

  This creates the nodepass file containing the shared password for
209 210 211 212
  the cluster, generates the SSL certificate and starts the node daemon.

  @type master_name: str
  @param master_name: Name of the master node
213 214

  """
215
  # Generate cluster secrets
216
  GenerateClusterCrypto(True, False, False, False, False)
217

218
  result = utils.RunCmd([pathutils.DAEMON_UTIL, "start", constants.NODED])
219 220 221 222 223
  if result.failed:
    raise errors.OpExecError("Could not start the node daemon, command %s"
                             " had exitcode %s and error %s" %
                             (result.cmd, result.exit_code, result.output))

224 225 226 227 228 229 230
  _WaitForNodeDaemon(master_name)


def _WaitForNodeDaemon(node_name):
  """Wait for node daemon to become responsive.

  """
231
  def _CheckNodeDaemon():
232 233
    # Pylint bug <http://www.logilab.org/ticket/35642>
    # pylint: disable=E1101
234
    result = rpc.BootstrapRunner().call_version([node_name])[node_name]
235 236
    if result.fail_msg:
      raise utils.RetryAgain()
237

238
  try:
239
    utils.Retry(_CheckNodeDaemon, 1.0, _DAEMON_READY_TIMEOUT)
240
  except utils.RetryTimeout:
241
    raise errors.OpExecError("Node daemon on %s didn't answer queries within"
242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262
                             " %s seconds" % (node_name, _DAEMON_READY_TIMEOUT))


def _WaitForMasterDaemon():
  """Wait for master daemon to become responsive.

  """
  def _CheckMasterDaemon():
    try:
      cl = luxi.Client()
      (cluster_name, ) = cl.QueryConfigValues(["cluster_name"])
    except Exception:
      raise utils.RetryAgain()

    logging.debug("Received cluster name %s from master", cluster_name)

  try:
    utils.Retry(_CheckMasterDaemon, 1.0, _DAEMON_READY_TIMEOUT)
  except utils.RetryTimeout:
    raise errors.OpExecError("Master daemon didn't answer queries within"
                             " %s seconds" % _DAEMON_READY_TIMEOUT)
263

264

265
def _WaitForSshDaemon(hostname, port):
266 267 268
  """Wait for SSH daemon to become responsive.

  """
269
  family = ssconf.SimpleStore().GetPrimaryIPFamily()
270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286
  hostip = netutils.GetHostname(name=hostname, family=family).ip

  def _CheckSshDaemon():
    if netutils.TcpPing(hostip, port, timeout=1.0, live_port_needed=True):
      logging.debug("SSH daemon on %s:%s (IP address %s) has become"
                    " responsive", hostname, port, hostip)
    else:
      raise utils.RetryAgain()

  try:
    utils.Retry(_CheckSshDaemon, 1.0, _DAEMON_READY_TIMEOUT)
  except utils.RetryTimeout:
    raise errors.OpExecError("SSH daemon on %s:%s (IP address %s) didn't"
                             " become responsive within %s seconds" %
                             (hostname, port, hostip, _DAEMON_READY_TIMEOUT))


287
def RunNodeSetupCmd(cluster_name, node, basecmd, debug, verbose,
288 289
                    use_cluster_key, ask_key, strict_host_check,
                    port, data):
290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307
  """Runs a command to configure something on a remote machine.

  @type cluster_name: string
  @param cluster_name: Cluster name
  @type node: string
  @param node: Node name
  @type basecmd: string
  @param basecmd: Base command (path on the remote machine)
  @type debug: bool
  @param debug: Enable debug output
  @type verbose: bool
  @param verbose: Enable verbose output
  @type use_cluster_key: bool
  @param use_cluster_key: See L{ssh.SshRunner.BuildCmd}
  @type ask_key: bool
  @param ask_key: See L{ssh.SshRunner.BuildCmd}
  @type strict_host_check: bool
  @param strict_host_check: See L{ssh.SshRunner.BuildCmd}
308 309
  @type port: int
  @param port: The SSH port of the remote machine or None for the default
310 311 312 313 314 315 316 317 318 319 320 321
  @param data: JSON-serializable input data for script (passed to stdin)

  """
  cmd = [basecmd]

  # Pass --debug/--verbose to the external script if set on our invocation
  if debug:
    cmd.append("--debug")

  if verbose:
    cmd.append("--verbose")

322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345
  logging.debug("Node setup command: %s", cmd)

  version = constants.DIR_VERSION
  all_cmds = [["test", "-d", os.path.join(pathutils.PKGLIBDIR, version)]]
  if constants.HAS_GNU_LN:
    all_cmds.extend([["ln", "-s", "-f", "-T",
                      os.path.join(pathutils.PKGLIBDIR, version),
                      os.path.join(pathutils.SYSCONFDIR, "ganeti/lib")],
                     ["ln", "-s", "-f", "-T",
                      os.path.join(pathutils.SHAREDIR, version),
                      os.path.join(pathutils.SYSCONFDIR, "ganeti/share")]])
  else:
    all_cmds.extend([["rm", "-f",
                      os.path.join(pathutils.SYSCONFDIR, "ganeti/lib")],
                     ["ln", "-s", "-f",
                      os.path.join(pathutils.PKGLIBDIR, version),
                      os.path.join(pathutils.SYSCONFDIR, "ganeti/lib")],
                     ["rm", "-f",
                      os.path.join(pathutils.SYSCONFDIR, "ganeti/share")],
                     ["ln", "-s", "-f",
                      os.path.join(pathutils.SHAREDIR, version),
                      os.path.join(pathutils.SYSCONFDIR, "ganeti/share")]])
  all_cmds.append(cmd)

346 347 348
  if port is None:
    port = netutils.GetDaemonPort(constants.SSH)

349
  srun = ssh.SshRunner(cluster_name)
350
  scmd = srun.BuildCmd(node, constants.SSH_LOGIN_USER,
351 352
                       utils.ShellQuoteArgs(
                           utils.ShellCombineCommands(all_cmds)),
353 354
                       batch=False, ask_key=ask_key, quiet=False,
                       strict_host_check=strict_host_check,
355 356
                       use_cluster_key=use_cluster_key,
                       port=port)
357 358 359 360 361 362 363 364 365 366 367 368 369 370

  tempfh = tempfile.TemporaryFile()
  try:
    tempfh.write(serializer.DumpJson(data))
    tempfh.seek(0)

    result = utils.RunCmd(scmd, interactive=True, input_fd=tempfh)
  finally:
    tempfh.close()

  if result.failed:
    raise errors.OpExecError("Command '%s' failed: %s" %
                             (result.cmd, result.fail_reason))

371
  _WaitForSshDaemon(node, port)
372

373

374
def _InitFileStorageDir(file_storage_dir):
375 376 377 378 379 380 381 382 383 384
  """Initialize if needed the file storage.

  @param file_storage_dir: the user-supplied value
  @return: either empty string (if file storage was disabled at build
      time) or the normalized path to the storage directory

  """
  file_storage_dir = os.path.normpath(file_storage_dir)

  if not os.path.isabs(file_storage_dir):
385 386
    raise errors.OpPrereqError("File storage directory '%s' is not an absolute"
                               " path" % file_storage_dir, errors.ECODE_INVAL)
387 388 389 390 391 392 393 394 395 396 397 398 399

  if not os.path.exists(file_storage_dir):
    try:
      os.makedirs(file_storage_dir, 0750)
    except OSError, err:
      raise errors.OpPrereqError("Cannot create file storage directory"
                                 " '%s': %s" % (file_storage_dir, err),
                                 errors.ECODE_ENVIRON)

  if not os.path.isdir(file_storage_dir):
    raise errors.OpPrereqError("The file storage directory '%s' is not"
                               " a directory." % file_storage_dir,
                               errors.ECODE_ENVIRON)
400

401 402 403
  return file_storage_dir


404 405 406 407 408 409 410 411 412 413 414 415 416 417
def _PrepareFileBasedStorage(
    enabled_disk_templates, file_storage_dir,
    default_dir, file_disk_template,
    init_fn=_InitFileStorageDir, acceptance_fn=None):
  """Checks if a file-base storage type is enabled and inits the dir.

  @type enabled_disk_templates: list of string
  @param enabled_disk_templates: list of enabled disk templates
  @type file_storage_dir: string
  @param file_storage_dir: the file storage directory
  @type default_dir: string
  @param default_dir: default file storage directory when C{file_storage_dir}
      is 'None'
  @type file_disk_template: string
418 419
  @param file_disk_template: a disk template whose storage type is 'ST_FILE' or
      'ST_SHARED_FILE'
420 421
  @rtype: string
  @returns: the name of the actual file storage directory
422 423

  """
424 425 426 427
  assert (file_disk_template in utils.storage.GetDiskTemplatesOfStorageTypes(
            constants.ST_FILE, constants.ST_SHARED_FILE
         ))

428
  if file_storage_dir is None:
429
    file_storage_dir = default_dir
430 431 432 433 434 435 436 437
  if not acceptance_fn:
    acceptance_fn = \
        lambda path: filestorage.CheckFileStoragePathAcceptance(
            path, exact_match_ok=True)

  cluster.CheckFileStoragePathVsEnabledDiskTemplates(
      logging.warning, file_storage_dir, enabled_disk_templates)

438
  file_storage_enabled = file_disk_template in enabled_disk_templates
439 440 441 442 443 444 445 446 447 448 449
  if file_storage_enabled:
    try:
      acceptance_fn(file_storage_dir)
    except errors.FileStoragePathError as e:
      raise errors.OpPrereqError(str(e))
    result_file_storage_dir = init_fn(file_storage_dir)
  else:
    result_file_storage_dir = file_storage_dir
  return result_file_storage_dir


450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477
def _PrepareFileStorage(
    enabled_disk_templates, file_storage_dir, init_fn=_InitFileStorageDir,
    acceptance_fn=None):
  """Checks if file storage is enabled and inits the dir.

  @see: C{_PrepareFileBasedStorage}

  """
  return _PrepareFileBasedStorage(
      enabled_disk_templates, file_storage_dir,
      pathutils.DEFAULT_FILE_STORAGE_DIR, constants.DT_FILE,
      init_fn=init_fn, acceptance_fn=acceptance_fn)


def _PrepareSharedFileStorage(
    enabled_disk_templates, file_storage_dir, init_fn=_InitFileStorageDir,
    acceptance_fn=None):
  """Checks if shared file storage is enabled and inits the dir.

  @see: C{_PrepareFileBasedStorage}

  """
  return _PrepareFileBasedStorage(
      enabled_disk_templates, file_storage_dir,
      pathutils.DEFAULT_SHARED_FILE_STORAGE_DIR, constants.DT_SHARED_FILE,
      init_fn=init_fn, acceptance_fn=acceptance_fn)


478 479 480 481 482 483 484 485 486 487 488 489 490 491
def _PrepareGlusterStorage(
    enabled_disk_templates, file_storage_dir, init_fn=_InitFileStorageDir,
    acceptance_fn=None):
  """Checks if gluster storage is enabled and inits the dir.

  @see: C{_PrepareFileBasedStorage}

  """
  return _PrepareFileBasedStorage(
      enabled_disk_templates, file_storage_dir,
      pathutils.DEFAULT_GLUSTER_STORAGE_DIR, constants.DT_GLUSTER,
      init_fn=init_fn, acceptance_fn=acceptance_fn)


492 493 494 495 496 497 498 499 500 501 502 503 504 505 506
def _InitCheckEnabledDiskTemplates(enabled_disk_templates):
  """Checks the sanity of the enabled disk templates.

  """
  if not enabled_disk_templates:
    raise errors.OpPrereqError("Enabled disk templates list must contain at"
                               " least one member", errors.ECODE_INVAL)
  invalid_disk_templates = \
    set(enabled_disk_templates) - constants.DISK_TEMPLATES
  if invalid_disk_templates:
    raise errors.OpPrereqError("Enabled disk templates list contains invalid"
                               " entries: %s" % invalid_disk_templates,
                               errors.ECODE_INVAL)


507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526
def _RestrictIpolicyToEnabledDiskTemplates(ipolicy, enabled_disk_templates):
  """Restricts the ipolicy's disk templates to the enabled ones.

  This function clears the ipolicy's list of allowed disk templates from the
  ones that are not enabled by the cluster.

  @type ipolicy: dict
  @param ipolicy: the instance policy
  @type enabled_disk_templates: list of string
  @param enabled_disk_templates: the list of cluster-wide enabled disk
    templates

  """
  assert constants.IPOLICY_DTS in ipolicy
  allowed_disk_templates = ipolicy[constants.IPOLICY_DTS]
  restricted_disk_templates = list(set(allowed_disk_templates)
                                   .intersection(set(enabled_disk_templates)))
  ipolicy[constants.IPOLICY_DTS] = restricted_disk_templates


527
def _InitCheckDrbdHelper(drbd_helper, drbd_enabled):
528 529 530 531 532 533 534
  """Checks the DRBD usermode helper.

  @type drbd_helper: string
  @param drbd_helper: name of the DRBD usermode helper that the system should
    use

  """
535 536 537
  if not drbd_enabled:
    return

538 539 540 541 542
  if drbd_helper is not None:
    try:
      curr_helper = drbd.DRBD8.GetUsermodeHelper()
    except errors.BlockDeviceError, err:
      raise errors.OpPrereqError("Error while checking drbd helper"
543 544
                                 " (disable drbd with --enabled-disk-templates"
                                 " if you are not using drbd): %s" % str(err),
545 546 547 548 549 550 551 552
                                 errors.ECODE_ENVIRON)
    if drbd_helper != curr_helper:
      raise errors.OpPrereqError("Error: requiring %s as drbd helper but %s"
                                 " is the current helper" % (drbd_helper,
                                                             curr_helper),
                                 errors.ECODE_INVAL)


553
def InitCluster(cluster_name, mac_prefix, # pylint: disable=R0913, R0914
554
                master_netmask, master_netdev, file_storage_dir,
555 556
                shared_file_storage_dir, gluster_storage_dir,
                candidate_pool_size, secondary_ip=None,
557
                vg_name=None, beparams=None, nicparams=None, ndparams=None,
558 559 560
                hvparams=None, diskparams=None, enabled_hypervisors=None,
                modify_etc_hosts=True, modify_ssh_setup=True,
                maintain_node_health=False, drbd_helper=None, uid_pool=None,
561 562
                default_iallocator=None, default_iallocator_params=None,
                primary_ip_version=None, ipolicy=None,
563
                prealloc_wipe_disks=False, use_external_mip_script=False,
Hrvoje Ribicic's avatar
Hrvoje Ribicic committed
564
                hv_state=None, disk_state=None, enabled_disk_templates=None,
565
                install_image=None, zeroing_image=None, compression_tools=None,
566
                enabled_user_shutdown=False):
567 568
  """Initialise the cluster.

569 570
  @type candidate_pool_size: int
  @param candidate_pool_size: master candidate pool size
571

572 573
  @type enabled_disk_templates: list of string
  @param enabled_disk_templates: list of disk_templates to be used in this
574
    cluster
575

576 577 578 579
  @type enabled_user_shutdown: bool
  @param enabled_user_shutdown: whether user shutdown is enabled cluster
                                wide

580
  """
581
  # TODO: complete the docstring
582
  if config.ConfigWriter.IsCluster():
583 584
    raise errors.OpPrereqError("Cluster is already initialised",
                               errors.ECODE_STATE)
585

586 587
  data_dir = vcluster.AddNodePrefix(pathutils.DATA_DIR)
  queue_dir = vcluster.AddNodePrefix(pathutils.QUEUE_DIR)
588 589 590 591 592 593 594 595 596
  archive_dir = vcluster.AddNodePrefix(pathutils.JOB_QUEUE_ARCHIVE_DIR)
  for ddir in [queue_dir, data_dir, archive_dir]:
    if os.path.isdir(ddir):
      for entry in os.listdir(ddir):
        if not os.path.isdir(os.path.join(ddir, entry)):
          raise errors.OpPrereqError(
            "%s contains non-directory enries like %s. Remove left-overs of an"
            " old cluster before initialising a new one" % (ddir, entry),
            errors.ECODE_STATE)
597

598 599
  if not enabled_hypervisors:
    raise errors.OpPrereqError("Enabled hypervisors list must contain at"
600
                               " least one member", errors.ECODE_INVAL)
601 602 603
  invalid_hvs = set(enabled_hypervisors) - constants.HYPER_TYPES
  if invalid_hvs:
    raise errors.OpPrereqError("Enabled hypervisors contains invalid"
604 605
                               " entries: %s" % invalid_hvs,
                               errors.ECODE_INVAL)
606

607
  _InitCheckEnabledDiskTemplates(enabled_disk_templates)
608

609 610 611
  try:
    ipcls = netutils.IPAddress.GetClassFromIpVersion(primary_ip_version)
  except errors.ProgrammerError:
612
    raise errors.OpPrereqError("Invalid primary ip version: %d." %
613
                               primary_ip_version, errors.ECODE_INVAL)
614 615 616 617

  hostname = netutils.GetHostname(family=ipcls.family)
  if not ipcls.IsValid(hostname.ip):
    raise errors.OpPrereqError("This host's IP (%s) is not a valid IPv%d"
618 619
                               " address." % (hostname.ip, primary_ip_version),
                               errors.ECODE_INVAL)
620 621

  if ipcls.IsLoopback(hostname.ip):
622 623
    raise errors.OpPrereqError("This host's IP (%s) resolves to a loopback"
                               " address. Please fix DNS or %s." %
624
                               (hostname.ip, pathutils.ETC_HOSTS),
625
                               errors.ECODE_ENVIRON)
626

627
  if not ipcls.Own(hostname.ip):
628 629
    raise errors.OpPrereqError("Inconsistency: this host's name resolves"
                               " to %s,\nbut this ip address does not"
630
                               " belong to this host" %
631
                               hostname.ip, errors.ECODE_ENVIRON)
632

633
  clustername = netutils.GetHostname(name=cluster_name, family=ipcls.family)
634

635
  if netutils.TcpPing(clustername.ip, constants.DEFAULT_NODED_PORT, timeout=5):
636
    raise errors.OpPrereqError("Cluster IP already active",
637
                               errors.ECODE_NOTUNIQUE)
638

639 640 641
  if not secondary_ip:
    if primary_ip_version == constants.IP6_VERSION:
      raise errors.OpPrereqError("When using a IPv6 primary address, a valid"
642 643
                                 " IPv4 address must be given as secondary",
                                 errors.ECODE_INVAL)
644
    secondary_ip = hostname.ip
645

646 647 648 649 650 651 652 653 654 655
  if not netutils.IP4Address.IsValid(secondary_ip):
    raise errors.OpPrereqError("Secondary IP address (%s) has to be a valid"
                               " IPv4 address." % secondary_ip,
                               errors.ECODE_INVAL)

  if not netutils.IP4Address.Own(secondary_ip):
    raise errors.OpPrereqError("You gave %s as secondary IP,"
                               " but it does not belong to this host." %
                               secondary_ip, errors.ECODE_ENVIRON)

656 657 658
  if master_netmask is not None:
    if not ipcls.ValidateNetmask(master_netmask):
      raise errors.OpPrereqError("CIDR netmask (%s) not valid for IPv%s " %
659 660
                                  (master_netmask, primary_ip_version),
                                 errors.ECODE_INVAL)
661 662 663
  else:
    master_netmask = ipcls.iplen

664
  if vg_name:
665 666 667 668
    # Check if volume group is valid
    vgstatus = utils.CheckVolumeGroupSize(utils.ListVolumeGroups(), vg_name,
                                          constants.MIN_VG_SIZE)
    if vgstatus:
669
      raise errors.OpPrereqError("Error: %s" % vgstatus, errors.ECODE_INVAL)
670

671 672
  drbd_enabled = constants.DT_DRBD8 in enabled_disk_templates
  _InitCheckDrbdHelper(drbd_helper, drbd_enabled)
673

674 675 676 677 678 679 680
  logging.debug("Stopping daemons (if any are running)")
  result = utils.RunCmd([pathutils.DAEMON_UTIL, "stop-all"])
  if result.failed:
    raise errors.OpExecError("Could not stop daemons, command %s"
                             " had exitcode %s and error '%s'" %
                             (result.cmd, result.exit_code, result.output))

681 682
  file_storage_dir = _PrepareFileStorage(enabled_disk_templates,
                                         file_storage_dir)
683 684
  shared_file_storage_dir = _PrepareSharedFileStorage(enabled_disk_templates,
                                                      shared_file_storage_dir)
685 686

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

690
  if not nicparams.get('mode', None) == constants.NIC_MODE_OVS:
691 692 693 694 695 696 697
    # Do not do this check if mode=openvswitch, since the openvswitch is not
    # created yet
    result = utils.RunCmd(["ip", "link", "show", "dev", master_netdev])
    if result.failed:
      raise errors.OpPrereqError("Invalid master netdev given (%s): '%s'" %
                                 (master_netdev,
                                  result.output.strip()), errors.ECODE_INVAL)
698

699
  dirs = [(pathutils.RUN_DIR, constants.RUN_DIRS_MODE)]
700 701
  utils.EnsureDirs(dirs)

702
  objects.UpgradeBeParams(beparams)
703
  utils.ForceDictType(beparams, constants.BES_PARAMETER_TYPES)
704
  utils.ForceDictType(nicparams, constants.NICS_PARAMETER_TYPES)
705

706
  objects.NIC.CheckParameterSyntax(nicparams)
707

708
  full_ipolicy = objects.FillIPolicy(constants.IPOLICY_DEFAULTS, ipolicy)
709
  _RestrictIpolicyToEnabledDiskTemplates(full_ipolicy, enabled_disk_templates)
710

711 712 713 714 715
  if ndparams is not None:
    utils.ForceDictType(ndparams, constants.NDS_PARAMETER_TYPES)
  else:
    ndparams = dict(constants.NDC_DEFAULTS)

716
  # This is ugly, as we modify the dict itself
717 718
  # FIXME: Make utils.ForceDictType pure functional or write a wrapper
  # around it
719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736
  if hv_state:
    for hvname, hvs_data in hv_state.items():
      utils.ForceDictType(hvs_data, constants.HVSTS_PARAMETER_TYPES)
      hv_state[hvname] = objects.Cluster.SimpleFillHvState(hvs_data)
  else:
    hv_state = dict((hvname, constants.HVST_DEFAULTS)
                    for hvname in enabled_hypervisors)

  # FIXME: disk_state has no default values yet
  if disk_state:
    for storage, ds_data in disk_state.items():
      if storage not in constants.DS_VALID_TYPES:
        raise errors.OpPrereqError("Invalid storage type in disk state: %s" %
                                   storage, errors.ECODE_INVAL)
      for ds_name, state in ds_data.items():
        utils.ForceDictType(state, constants.DSS_PARAMETER_TYPES)
        ds_data[ds_name] = objects.Cluster.SimpleFillDiskState(state)

737 738 739 740 741
  # hvparams is a mapping of hypervisor->hvparams dict
  for hv_name, hv_params in hvparams.iteritems():
    utils.ForceDictType(hv_params, constants.HVS_PARAMETER_TYPES)
    hv_class = hypervisor.GetHypervisor(hv_name)
    hv_class.CheckParameterSyntax(hv_params)
742

743 744 745 746 747 748 749 750
  # diskparams is a mapping of disk-template->diskparams dict
  for template, dt_params in diskparams.items():
    param_keys = set(dt_params.keys())
    default_param_keys = set(constants.DISK_DT_DEFAULTS[template].keys())
    if not (param_keys <= default_param_keys):
      unknown_params = param_keys - default_param_keys
      raise errors.OpPrereqError("Invalid parameters for disk template %s:"
                                 " %s" % (template,
751 752
                                          utils.CommaJoin(unknown_params)),
                                 errors.ECODE_INVAL)
753
    utils.ForceDictType(dt_params, constants.DISK_DT_TYPES)
754 755 756 757 758
    if template == constants.DT_DRBD8 and vg_name is not None:
      # The default METAVG value is equal to the VG name set at init time,
      # if provided
      dt_params[constants.DRBD_DEFAULT_METAVG] = vg_name

759 760 761 762 763
  try:
    utils.VerifyDictOptions(diskparams, constants.DISK_DT_DEFAULTS)
  except errors.OpPrereqError, err:
    raise errors.OpPrereqError("While verify diskparam options: %s" % err,
                               errors.ECODE_INVAL)
764

765
  # set up ssh config and /etc/hosts
766 767 768 769 770 771 772 773 774 775 776
  rsa_sshkey = ""
  dsa_sshkey = ""
  if os.path.isfile(pathutils.SSH_HOST_RSA_PUB):
    sshline = utils.ReadFile(pathutils.SSH_HOST_RSA_PUB)
    rsa_sshkey = sshline.split(" ")[1]
  if os.path.isfile(pathutils.SSH_HOST_DSA_PUB):
    sshline = utils.ReadFile(pathutils.SSH_HOST_DSA_PUB)
    dsa_sshkey = sshline.split(" ")[1]
  if not rsa_sshkey and not dsa_sshkey:
    raise errors.OpPrereqError("Failed to find SSH public keys",
                               errors.ECODE_ENVIRON)
777

778
  if modify_etc_hosts:
779
    utils.AddHostToEtcHosts(hostname.name, hostname.ip)
780

781 782
  if modify_ssh_setup:
    _InitSSHSetup()
783

784 785 786 787 788 789 790 791
  if default_iallocator is not None:
    alloc_script = utils.FindFile(default_iallocator,
                                  constants.IALLOCATOR_SEARCH_PATH,
                                  os.path.isfile)
    if alloc_script is None:
      raise errors.OpPrereqError("Invalid default iallocator script '%s'"
                                 " specified" % default_iallocator,
                                 errors.ECODE_INVAL)
792 793
  else:
    # default to htools
794 795 796 797
    if utils.FindFile(constants.IALLOC_HAIL,
                      constants.IALLOCATOR_SEARCH_PATH,
                      os.path.isfile):
      default_iallocator = constants.IALLOC_HAIL
798

799 800 801 802 803 804 805
  # check if we have all the users we need
  try:
    runtime.GetEnts()
  except errors.ConfigurationError, err:
    raise errors.OpPrereqError("Required system user/group missing: %s" %
                               err, errors.ECODE_ENVIRON)

806 807
  candidate_certs = {}

808 809
  now = time.time()

810 811 812
  if compression_tools is not None:
    cluster.CheckCompressionTools(compression_tools)

813
  # init of cluster config file
814 815
  cluster_config = objects.Cluster(
    serial_no=1,
816 817
    rsahostkeypub=rsa_sshkey,
    dsahostkeypub=dsa_sshkey,
818 819 820 821
    highest_used_port=(constants.FIRST_DRBD_PORT - 1),
    mac_prefix=mac_prefix,
    volume_group_name=vg_name,
    tcpudp_port_pool=set(),
822
    master_ip=clustername.ip,
823
    master_netmask=master_netmask,
824 825 826
    master_netdev=master_netdev,
    cluster_name=clustername.name,
    file_storage_dir=file_storage_dir,
827
    shared_file_storage_dir=shared_file_storage_dir,
828
    gluster_storage_dir=gluster_storage_dir,
829
    enabled_hypervisors=enabled_hypervisors,
830
    beparams={constants.PP_DEFAULT: beparams},
831
    nicparams={constants.PP_DEFAULT: nicparams},
832
    ndparams=ndparams,
833
    hvparams=hvparams,
834
    diskparams=diskparams,
835
    candidate_pool_size=candidate_pool_size,
Guido Trotter's avatar
Guido Trotter committed
836
    modify_etc_hosts=modify_etc_hosts,
837
    modify_ssh_setup=modify_ssh_setup,
838
    uid_pool=uid_pool,
839 840
    ctime=now,
    mtime=now,
841
    maintain_node_health=maintain_node_health,
842
    drbd_usermode_helper=drbd_helper,
843
    default_iallocator=default_iallocator,
844
    default_iallocator_params=default_iallocator_params,
845
    primary_ip_family=ipcls.family,
846
    prealloc_wipe_disks=prealloc_wipe_disks,
847
    use_external_mip_script=use_external_mip_script,
848
    ipolicy=full_ipolicy,
849 850
    hv_state_static=hv_state,
    disk_state_static=disk_state,
851
    enabled_disk_templates=enabled_disk_templates,
852
    candidate_certs=candidate_certs,
853
    osparams={},
Hrvoje Ribicic's avatar
Hrvoje Ribicic committed
854
    osparams_private_cluster={},
855
    install_image=install_image,
856
    zeroing_image=zeroing_image,
857
    compression_tools=compression_tools,
858
    enabled_user_shutdown=enabled_user_shutdown,
859 860 861
    )
  master_node_config = objects.Node(name=hostname.name,
                                    primary_ip=hostname.ip,
862
                                    secondary_ip=secondary_ip,
863 864
                                    serial_no=1,
                                    master_candidate=True,
865
                                    offline=False, drained=False,
866
                                    ctime=now, mtime=now,
867
                                    )
868
  InitConfig(constants.CONFIG_VERSION, cluster_config, master_node_config)
869
  cfg = config.ConfigWriter(offline=True)
870
  ssh.WriteKnownHostsFile(cfg, pathutils.SSH_KNOWN_HOSTS_FILE)
871
  cfg.Update(cfg.GetClusterInfo(), logging.error)
872
  ssconf.WriteSsconfFiles(cfg.GetSsconfValues())
873 874 875

  # set up the inter-node password and certificate
  _InitGanetiServerSetup(hostname.name)
876

877
  logging.debug("Starting daemons")
878
  result = utils.RunCmd([pathutils.DAEMON_UTIL, "start-all"])
879 880 881 882
  if result.failed:
    raise errors.OpExecError("Could not start daemons, command %s"
                             " had exitcode %s and error %s" %
                             (result.cmd, result.exit_code, result.output))
Iustin Pop's avatar
Iustin Pop committed
883

884
  _WaitForMasterDaemon()
Iustin Pop's avatar
Iustin Pop committed
885

886

Oleksiy Mishchenko's avatar
Oleksiy Mishchenko committed
887
def InitConfig(version, cluster_config, master_node_config,
888
               cfg_file=pathutils.CLUSTER_CONF_FILE):
Iustin Pop's avatar
Iustin Pop committed
889 890 891 892 893 894
  """Create the initial cluster configuration.

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

  @type version: int
Iustin Pop's avatar
Iustin Pop committed
895 896 897 898 899 900 901 902
  @param version: configuration version
  @type cluster_config: L{objects.Cluster}
  @param cluster_config: cluster configuration
  @type master_node_config: L{objects.Node}
  @param master_node_config: master node configuration
  @type cfg_file: string
  @param cfg_file: configuration file path

Iustin Pop's avatar
Iustin Pop committed
903
  """
904 905 906 907 908
  uuid_generator = config.TemporaryReservationManager()
  cluster_config.uuid = uuid_generator.Generate([], utils.NewUUID,
                                                _INITCONF_ECID)
  master_node_config.uuid = uuid_generator.Generate([], utils.NewUUID,
                                                    _INITCONF_ECID)
Thomas Thrainer's avatar
Thomas Thrainer committed
909
  cluster_config.master_node = master_node_config.uuid
Iustin Pop's avatar
Iustin Pop committed
910
  nodes = {
Thomas Thrainer's avatar
Thomas Thrainer committed
911
    master_node_config.uuid: master_node_config,
Iustin Pop's avatar
Iustin Pop committed
912
    }
913 914
  default_nodegroup = objects.NodeGroup(
    uuid=uuid_generator.Generate([], utils.NewUUID, _INITCONF_ECID),
915
    name=constants.INITIAL_NODE_GROUP_NAME,
Thomas Thrainer's avatar
Thomas Thrainer committed
916
    members=[master_node_config.uuid],
917
    diskparams={},
918 919 920 921
    )
  nodegroups = {
    default_nodegroup.uuid: default_nodegroup,
    }
922
  now = time.time()
Iustin Pop's avatar
Iustin Pop committed
923 924
  config_data = objects.ConfigData(version=version,
                                   cluster=cluster_config,
925
                                   nodegroups=nodegroups,
Iustin Pop's avatar
Iustin Pop committed
926 927
                                   nodes=nodes,
                                   instances={},
928
                                   networks={},
929
                                   disks={},
930 931
                                   serial_no=1,
                                   ctime=now, mtime=now)
932 933 934
  utils.WriteFile(cfg_file,
                  data=serializer.Dump(config_data.ToDict()),
                  mode=0600)
Oleksiy Mishchenko's avatar
Oleksiy Mishchenko committed
935 936


Thomas Thrainer's avatar
Thomas Thrainer committed
937
def FinalizeClusterDestroy(master_uuid):
Iustin Pop's avatar
Iustin Pop committed
938 939 940 941 942 943
  """Execute the last steps of cluster destroy

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

  """
944 945
  livelock = utils.livelock.LiveLock("bootstrap_destroy")
  cfg = config.GetConfig(None, livelock)
946
  modify_ssh_setup = cfg.GetClusterInfo().modify_ssh_setup
947 948
  runner = rpc.BootstrapRunner()

Thomas Thrainer's avatar
Thomas Thrainer committed
949 950
  master_name = cfg.GetNodeName(master_uuid)

951
  master_params = cfg.GetMasterNetworkParameters()
Thomas Thrainer's avatar
Thomas Thrainer committed
952
  master_params.uuid = master_uuid
953
  ems = cfg.GetUseExternalMipScript()
Thomas Thrainer's avatar
Thomas Thrainer committed
954 955
  result = runner.call_node_deactivate_master_ip(master_name, master_params,
                                                 ems)
956

957 958 959 960
  msg = result.fail_msg
  if msg:
    logging.warning("Could not disable the master IP: %s", msg)