Synnefo » snf-ganeti

_MULTI = "multi-node"

#: Expected length of a rpc definition

def _WritePreamble(sw):

        raise ValueError("Procedure %s has only %d elements, expected %d" %

                         (v[0], len(v), _RPC_DEF_LEN))

      funcargs = ["self"]

      if kind == _SINGLE:

    """Entry point for automatically generated RPC wrappers.

    """

    if callable(timeout):

      read_timeout = timeout(args)

    else:

      read_timeout = timeout

    enc_args = map(self._encoder, zip(map(compat.snd, argdefs), args))

    if prep_fn is None:

      # for a no-op prep_fn, we serialise the body once, and then we

  - Name as string

  - L{SINGLE} for single-node calls, L{MULTI} for multi-node

  - Timeout (e.g. L{TMO_NORMAL}), or callback receiving all arguments in a

    tuple to calculate timeout

  - List of arguments as tuples

_FILE_STORAGE_CALLS = [

    ("file_storage_dir", None, "File storage directory"),

    ], None, None, "Create the given file storage directory"),

    ("file_storage_dir", None, "File storage directory"),

    ], None, None, "Remove the given file storage directory"),

    ("old_file_storage_dir", None, "Old name"),

    ("new_file_storage_dir", None, "New name"),

    ], None, None, "Rename file storage directory"),

  ]

_STORAGE_CALLS = [

    ("su_name", None, None),

    ("su_args", None, None),

    ("name", None, None),

    ("fields", None, None),

    ], None, None, "Get list of storage units"),

    ("su_name", None, None),

    ("su_args", None, None),

    ("name", None, None),

    ("changes", None, None),

    ], None, None, "Modify a storage unit"),

    ("su_name", None, None),

    ("su_args", None, None),

    ("name", None, None),

  ]

_INSTANCE_CALLS = [

    ("instance", None, "Instance name"),

    ("hname", None, "Hypervisor type"),

    ], None, None, "Returns information about a single instance"),

    ("hypervisor_list", None, "Hypervisors to query for instances"),

    ], None, None,

   "Returns information about all instances on the given nodes"),

    ("hypervisor_list", None, "Hypervisors to query for instances"),

    ], None, None, "Returns the list of running instances on the given nodes"),

    ("inst", ED_INST_DICT, "Instance object"),

    ("reboot_type", None, None),

    ("shutdown_timeout", None, None),

    ], None, None, "Returns the list of running instances on the given nodes"),

    ("instance", ED_INST_DICT, "Instance object"),

    ("timeout", None, None),

    ], None, None, "Stops an instance"),

    ("instance", ED_INST_DICT, "Instance object"),

    ("old_name", None, None),

    ("debug", None, None),

    ], None, None, "Run the OS rename script for an instance"),

    ("instance", ED_INST_DICT, "Instance object"),

    ], None, None, "Checks whether the given instance can be migrated"),

    ("instance", ED_INST_DICT, "Instance object"),

    ], None, None,

    "Gather the information necessary to prepare an instance migration"),

    ("instance", ED_INST_DICT, "Instance object"),

    ("info", None, "Result for the call_migration_info call"),

    ("target", None, "Target hostname (usually an IP address)"),

    ], None, None, "Prepare a node to accept an instance"),

    ("instance", ED_INST_DICT, "Instance object"),

    ("info", None, "Result for the call_migration_info call"),

    ("success", None, "Whether the migration was a success or failure"),

    ], None, None, "Finalize any target-node migration specific operation"),

    ("instance", ED_INST_DICT, "Instance object"),

    ("target", None, "Target node name"),

    ("live", None, "Whether the migration should be done live or not"),

    ], None, None, "Migrate an instance"),

    ("instance", ED_INST_DICT, "Instance object"),

    ("success", None, "Whether the migration succeeded or not"),

    ("live", None, "Whether the user requested a live migration or not"),

    ], None, None, "Finalize the instance migration on the source node"),

    ("instance", ED_INST_DICT, "Instance object"),

    ], None, _MigrationStatusPostProc, "Report migration status"),

    ("instance_hvp_bep", ED_INST_DICT_HVP_BEP, None),

    ("startup_paused", None, None),

    ], None, None, "Starts an instance"),

    ("instance_osp", ED_INST_DICT_OSP, None),

    ("reinstall", None, None),

    ("debug", None, None),

  ]

_IMPEXP_CALLS = [

    ("opts", ED_OBJECT_DICT, None),

    ("instance", ED_INST_DICT, None),

    ("component", None, None),

    ("dest", ED_IMPEXP_IO, "Import destination"),

    ], None, None, "Starts an import daemon"),

    ("opts", ED_OBJECT_DICT, None),

    ("host", None, None),

    ("port", None, None),

    ("component", None, None),

    ("source", ED_IMPEXP_IO, "Export source"),

    ], None, None, "Starts an export daemon"),

    ("names", None, "Import/export names"),

    ], None, _ImpExpStatusPostProc, "Gets the status of an import or export"),

    ("name", None, "Import/export name"),

    ], None, None, "Aborts an import or export"),

    ("name", None, "Import/export name"),

    ], None, None, "Cleans up after an import or export"),

    ("path", None, None),

    ], None, None, "Queries the export information in a given path"),

    ("instance", ED_INST_DICT, None),

    ("snap_disks", ED_FINALIZE_EXPORT_DISKS, None),

    ], None, None, "Request the completion of an export operation"),

   "Gets the stored exports list"),

    ("export", None, None),

    ], None, None, "Requests removal of a given export"),

  ]

_X509_CALLS = [

    ("validity", None, "Validity in seconds"),

    ], None, None, "Creates a new X509 certificate for SSL/TLS"),

    ("name", None, "Certificate name"),

    ], None, None, "Removes a X509 certificate"),

  ]

_BLOCKDEV_CALLS = [

    ("devices", None, None),

    ], None, None,

   "Gets the sizes of requested block devices present on a node"),

    ("bdev", ED_OBJECT_DICT, None),

    ("size", None, None),

    ("owner", None, None),

    ("on_primary", None, None),

    ("info", None, None),

    ], None, None, "Request creation of a given block device"),

    ("bdev", ED_OBJECT_DICT, None),

    ("offset", None, None),

    ("size", None, None),

    ], None, None,

    "Request wipe at given offset with given size of a block device"),

    ("bdev", ED_OBJECT_DICT, None),

    ], None, None, "Request removal of a given block device"),

    ("disks", ED_OBJECT_DICT_LIST, None),

    ("pause", None, None),

    ], None, None, "Request a pause/resume of given block device"),

    ("disk", ED_OBJECT_DICT, None),

    ("owner", None, None),

    ("on_primary", None, None),

    ("idx", None, None),

    ], None, None, "Request assembling of a given block device"),

    ("disk", ED_OBJECT_DICT, None),

    ], None, None, "Request shutdown of a given block device"),

    ("bdev", ED_OBJECT_DICT, None),

    ("ndevs", ED_OBJECT_DICT_LIST, None),

    ], None, None,

   "Request adding a list of children to a (mirroring) device"),

    ("bdev", ED_OBJECT_DICT, None),

    ("ndevs", ED_OBJECT_DICT_LIST, None),

    ], None, None,

   "Request removing a list of children from a (mirroring) device"),

    ("instance_name", None, None),

    ("disks", ED_OBJECT_DICT_LIST, None),

    ], None, None, "Closes the given block devices"),

    ("disks", ED_OBJECT_DICT_LIST, None),

    ], None, None, "Returns the size of the given disks"),

    ("nodes_ip", None, None),

    ("disks", ED_OBJECT_DICT_LIST, None),

    ], None, None, "Disconnects the network of the given drbd devices"),

    ("nodes_ip", None, None),

    ("disks", ED_OBJECT_DICT_LIST, None),

    ("instance_name", None, None),

    ("multimaster", None, None),

    ], None, None, "Connects the given DRBD devices"),

    ("nodes_ip", None, None),

    ("disks", ED_OBJECT_DICT_LIST, None),

    ], None, None,

   "Waits for the synchronization of drbd devices is complete"),

    ("cf_bdev", ED_OBJECT_DICT, None),

    ("amount", None, None),

    ("dryrun", None, None),

    ], None, None, "Request a snapshot of the given block device"),

    ("cf_bdev", ED_OBJECT_DICT, None),

    ("dest_node", None, None),

    ("dest_path", None, None),

    ("cluster_name", None, None),

    ], None, None, "Export a given disk to another node"),

    ("cf_bdev", ED_OBJECT_DICT, None),

    ], None, None, "Export a given disk to another node"),

    ("devlist", ED_BLOCKDEV_RENAME, None),

    ], None, None, "Request rename of the given block devices"),

    ("disk", ED_OBJECT_DICT, None),

    ], None, _BlockdevFindPostProc,

    "Request identification of a given block device"),

    ("disks", ED_OBJECT_DICT_LIST, None),

    ], None, _BlockdevGetMirrorStatusPostProc,

    "Request status of a (mirroring) device"),

    ("node_disks", ED_NODE_TO_DISK_DICT, None),

    ], _BlockdevGetMirrorStatusMultiPreProc,

   _BlockdevGetMirrorStatusMultiPostProc,

  ]

_OS_CALLS = [

   "Request a diagnose of OS definitions"),

    ("required", None, None),

    ("name", None, None),

    ("checks", None, None),

    ("params", None, None),

    ], None, None, "Run a validation routine for a given OS"),

    ("name", None, None),

    ], None, _OsGetPostProc, "Returns an OS definition"),

  ]

_NODE_CALLS = [

    ("address", None, "IP address"),

    ], None, None, "Checks if a node has the given IP address"),

    ("vg_names", None,

     "Names of the volume groups to ask for disk space information"),

    ("hv_names", None,

     "Names of the hypervisors to ask for node information"),

    ], None, None, "Return node information"),

    ("checkdict", None, None),

    ("cluster_name", None, None),

    ], None, None, "Request verification of given parameters"),

   "Gets all volumes on node(s)"),

   "Demote a node from the master candidate role"),

    ("hypervisor", None, "Hypervisor type"),

    ], None, None, "Tries to powercycle a node"),

  ]

_MISC_CALLS = [

    ("vg_name", None, None),

    ], None, None, "Gets the logical volumes present in a given volume group"),

    ("bridges_list", None, "Bridges which must be present on remote node"),

    ], None, None, "Checks if a node has all the bridges given"),

    ("mode", None,

     "Mode to operate; currently L{constants.ETC_HOSTS_ADD} or"

     " L{constants.ETC_HOSTS_REMOVE}"),

    ("name", None, "Hostname to be modified"),

    ("ip", None, "IP address (L{constants.ETC_HOSTS_ADD} only)"),

    ], None, None, "Modify hosts file with name"),

    ("oob_program", None, None),

    ("command", None, None),

    ("remote_node", None, None),

    ("timeout", None, None),

    ], None, None, "Runs out-of-band command"),

    ("hpath", None, None),

    ("phase", None, None),

    ("env", None, None),

    ], None, None, "Call the hooks runner"),

    ("name", None, "Iallocator name"),

    ("idata", None, "JSON-encoded input string"),

    ], None, None, "Call an iallocator on a remote node"),

    ("duration", None, None),

    ], None, None, "Sleep for a fixed time on given node(s)"),

    ("hvname", None, "Hypervisor name"),

    ("hvfull", None, "Parameters to be validated"),

    ], None, None, "Validate hypervisor params"),

             _FILE_STORAGE_CALLS + _MISC_CALLS + _INSTANCE_CALLS +

             _BLOCKDEV_CALLS + _STORAGE_CALLS),

  "RpcClientJobQueue": _Prepare([

      ("file_name", None, None),

      ("content", ED_COMPRESS, None),

      ], None, None, "Update job queue file"),

      ("rename", None, None),

      ], None, None, "Rename job queue file"),

    ]),

  "RpcClientBootstrap": _Prepare([

      ("no_voting", None, None),

      ], None, None, "Starts master daemons on a node"),

      ("master_params", ED_OBJECT_DICT, "Network parameters of the master"),

      ("use_external_mip_script", None,

       "Whether to use the user-provided master IP address setup script"),

      ], None, None,

      "Activates master IP on a node"),

     "Deactivates master IP and stops master daemons on a node"),

      ("master_params", ED_OBJECT_DICT, "Network parameters of the master"),

      ("use_external_mip_script", None,

       "Whether to use the user-provided master IP address setup script"),

      ], None, None,

     "Deactivates master IP on a node"),

      ("old_netmask", None, "The old value of the netmask"),

      ("netmask", None, "The new value of the netmask"),

      ("master_ip", None, "The master IP"),

      ("master_netdev", None, "The master network device"),

      ], None, None, "Change master IP netmask"),

      ("modify_ssh_setup", None, None),

      ], None, None,

     "Requests a node to clean the cluster information it has"),

    ]),

  "RpcClientConfig": _Prepare([

      ("file_name", ED_FILE_DETAILS, None),

      ], None, None, "Upload a file"),

      ("values", None, None),

      ], None, None, "Write ssconf files"),

    ]),