Module cli

List the tags on a given object.

This is a generic implementation that knows how to deal with all three cases of tag objects (cluster, node, instance). The opts argument is expected to contain a tag_type field denoting what object type we work on.

Add tags on a given object.

This is a generic implementation that knows how to deal with all three cases of tag objects (cluster, node, instance). The opts argument is expected to contain a tag_type field denoting what object type we work on.

Remove tags from a given object.

This is a generic implementation that knows how to deal with all three cases of tag objects (cluster, node, instance). The opts argument is expected to contain a tag_type field denoting what object type we work on.

Calculates all the names an OS can be called, according to its variants.

Parameters:

• os_name (string) - base name of the os
• os_variants (list or None) - list of supported variants

Returns: list

list of valid names

Parses the values of "--field"-like options.

Parameters:

• selected (string or None) - User-selected options
• default (list) - Default fields

RPC-wrapper decorator.

When applied to a function, it runs it with the RPC system initialized, and it shutsdown the system afterwards. This means the function must be called without RPC being initialized.

Ask the user a question.

Parameters:

• text - the question to ask
• choices - list with elements tuples (input_char, return_value, description); if not given, it will default to: [('y', True, 'Perform the operation'), ('n', False, 'Do no do the operation')]; note that the '?' char is reserved for help

Returns:

one of the return values from the choices list; if input is not possible (i.e. not running with a tty, we return the last entry from the list

Legacy function to submit an opcode.

This is just a simple wrapper over the construction of the processor instance. It should be extended to better handle feedback and interaction functions.

Wrapper around SubmitOpCode or SendJob.

This function will decide, based on the 'opts' parameter, whether to submit and wait for the result of the opcode (and return it), or whether to just send the job and print its identifier. It is used in order to simplify the implementation of the '--submit' option.

It will also process the opcodes if we're sending the via SendJob (otherwise SubmitOpCode does it).

Return a formatted error message for a given error.

This function takes an exception instance and returns a tuple consisting of two values: first, the recommended exit code, and second, a string describing the error message (not newline-terminated).

Generic main function for all the gnt-* commands.

Parameters:

• commands - a dictionary with a special structure, see the design doc for command line handling.
• override - if not None, we expect a dictionary with keys that will override command line options; this can be used to pass options from the scripts to generic functions
• aliases - dictionary with command aliases {'alias': 'target, ...}
• env_override - list of environment names which are allowed to submit default args for commands

Add an instance to the cluster via either creation or import.

Parameters:

• mode - constants.INSTANCE_CREATE or constants.INSTANCE_IMPORT
• opts - the command line options selected by the user
• args (list) - should contain only one element, the new instance name

Returns: int

the desired exit code

Calls a function while all cluster daemons are stopped.

Parameters:

• feedback_fn (callable) - Feedback function
• fn (callable) - Function to be called when daemons are stopped

Prints a table with headers and different fields.

Parameters:

• headers (dict) - dictionary mapping field names to headers for the table
• fields (list) - the field names corresponding to each row in the data field
• separator - the separator to be used; if this is None, the default 'smart' algorithm is used which computes optimal field width, otherwise just the separator is used between each field
• data (list) - a list of lists, each sublist being one row to be output
• numfields (list) - a list with the fields that hold numeric values and thus should be right-aligned
• unitfields (list) - a list with the fields that hold numeric values that should be formatted with the units field
• units (string or None) - the units we should use for formatting, or None for automatic choice (human-readable for non-separator usage, otherwise megabytes); this is a one-letter string

Formats data in objects.QueryResponse.

Parameters:

• result (objects.QueryResponse) - result of query operation
• unit (string) - Unit used for formatting fields of type constants.QFT_UNIT, see utils.text.FormatUnit
• format_override (dict) - Dictionary for overriding field formatting functions, indexed by field name, contents like _DEFAULT_FORMAT_QUERY
• separator (string or None) - String used to separate fields
• header (bool) - Whether to output header row
• verbose (boolean) - whether to use verbose field descriptions or not

Generic implementation for listing all items of a resource.

Parameters:

• resource - One of constants.QR_VIA_LUXI
• fields (list of strings) - List of fields to query for
• names (list of strings) - Names of items to query for
• unit (string or None) - Unit used for formatting fields of type constants.QFT_UNIT or None for automatic choice (human-readable for non-separator usage, otherwise megabytes); this is a one-letter string
• separator (string or None) - String used to separate fields
• header (bool) - Whether to show header row
• force_filter (bool) - Whether to always treat names as filter
• format_override (dict) - Dictionary for overriding field formatting functions, indexed by field name, contents like _DEFAULT_FORMAT_QUERY
• verbose (boolean) - whether to use verbose field descriptions or not
• namefield (string) - Name of field to use for simple filters (see qlang.MakeFilter for details)
• qfilter (list or None) - Query filter (in addition to names)
• isnumeric - bool
• isnumeric - Whether the namefield's type is numeric, and therefore any simple filters built by namefield should use integer values to reflect that

Generic implementation for listing fields for a resource.

Parameters:

• resource - One of constants.QR_VIA_LUXI
• fields (list of strings) - List of fields to query for
• separator (string or None) - String used to separate fields
• header (bool) - Whether to show header row

Formats a given timestamp.

Parameters:

• ts (timestamp) - a timeval-type timestamp, a tuple of seconds and microseconds

Returns: string

a string with the formatted timestamp

Parse a time specification.

The following suffixed will be recognized:

• s: seconds
• m: minutes
• h: hours
• d: day
• w: weeks

Without any suffix, the value will be taken to be in seconds.

Returns the names of online nodes.

This function will also log a warning on stderr with the names of the online nodes.

Parameters:

• nodes - if not empty, use only this subset of nodes (minus the offline ones)
• cl - if not None, luxi client to use
• nowarn (boolean) - by default, this function will output a note with the offline nodes that are skipped; if this parameter is True the note is not displayed
• secondary_ips (boolean) - if True, return the secondary IPs instead of the names, useful for doing network traffic over the replication interface (if any)
• filter_master (boolean) - if True, do not return the master node in the list (useful in coordination with secondary_ips where we cannot check our node name against the list)
• nodegroup (string) - If set, only return nodes in this node group

Retrieves SSH ports of given nodes.

Parameters:

• nodes (a list of strings) - the names of nodes
• cl (Client) - a client to use for the query

Returns: a list of tuples

the list of SSH ports corresponding to the nodes

Write a message to stdout only, bypassing the logging system

This is just a wrapper over _ToStream.

Parameters:

• txt (str) - the message

Write a message to stderr only, bypassing the logging system

This is just a wrapper over _ToStream.

Parameters:

• txt (str) - the message

Formats a parameter dictionary.

Parameters:

• param_dict (dict) - the own parameters
• actual (dict) - the current parameter set (including defaults)

Returns: dict

dictionary where the value of each parameter is either a fully formatted string or a dictionary containing formatted strings

Formats an instance policy.

Parameters:

• custom_ipolicy (dict) - own policy
• eff_ipolicy (dict) - effective policy (including defaults); ignored for cluster
• iscluster (bool) - the policy is at cluster level

Returns: list of pairs

formatted data, suitable for PrintGenericInfo

Print the command option used to generate the given instance policy.

Currently only the parts dealing with specs are supported.

Parameters:

• buf (StringIO) - stream to write into
• ipolicy (dict) - instance policy
• isgroup (bool) - whether the policy is at group level

Ask the user to confirm an operation on a list of list_type.

This function is used to request confirmation for doing an operation on a given list of list_type.

Parameters:

• names (list) - the list of names that we display when we ask for confirmation
• list_type (str) - Human readable name for elements in the list (e.g. nodes)
• text (str) - the operation that the user should confirm

Returns: boolean

True or False depending on user's confirmation.

Creation of instance policy based on command line options.

Parameters:

• fill_all - whether for cluster policies we should ensure that all values are filled

Print information formatted according to the hierarchy.

The output is a valid YAML string.

Parameters:

• data - the data to print. It's a hierarchical structure whose elements can be:
  • dictionaries, where keys are strings and values are of any of the types listed here
  • lists of pairs (key, value), where key is a string and value is of any of the types listed here; it's a way to encode ordered dictionaries
  • lists of any of the types listed here
  • strings

DEBUG_OPT

Value:

cli_option("-d", "--debug", default= 0, action= "count", help= "Increa se debugging level")

NOHDR_OPT

Value:

cli_option("--no-headers", default= False, action= "store_true", dest= "no_headers", help= "Don't display column headers")

SEP_OPT

Value:

cli_option("--separator", default= None, action= "store", dest= "separ ator", help= ("Separator between output fields" " (defaults to one spa ce)"))

USEUNITS_OPT

Value:

cli_option("--units", default= None, dest= "units", choices= ("h", "m" , "g", "t"), help= "Specify units for output (one of h/m/g/t)")

FIELDS_OPT

Value:

cli_option("-o", "--output", dest= "output", action= "store", type= "s tring", metavar= "FIELDS", help= "Comma separated list of output field s")

FORCE_OPT

Value:

cli_option("-f", "--force", dest= "force", action= "store_true", defau lt= False, help= "Force the operation")

CONFIRM_OPT

Value:

cli_option("--yes", dest= "confirm", action= "store_true", default= Fa lse, help= "Do not require confirmation")

IGNORE_OFFLINE_OPT

Value:

cli_option("--ignore-offline", dest= "ignore_offline", action= "store_ true", default= False, help= ("Ignore offline nodes and do as much" " as possible"))

TAG_ADD_OPT

Value:

cli_option("--tags", dest= "tags", default= None, help= "Comma-separat ed list of instance" " tags")

TAG_SRC_OPT

Value:

cli_option("--from", dest= "tags_source", default= None, help= "File w ith tag names")

SUBMIT_OPT

Value:

cli_option("--submit", dest= "submit_only", default= False, action= "s tore_true", help= ("Submit the job and return the job ID, but" " don't wait for the job to finish"))

PRINT_JOBID_OPT

Value:

cli_option("--print-jobid", dest= "print_jobid", default= False, actio n= "store_true", help= ("Additionally print the job as first line" " o n stdout (for scripting)."))

SEQUENTIAL_OPT

Value:

cli_option("--sequential", dest= "sequential", default= False, action= "store_true", help= ("Execute all resulting jobs sequentially"))

SYNC_OPT

Value:

cli_option("--sync", dest= "do_locking", default= False, action= "stor e_true", help= ("Grab locks while doing the queries" " in order to ens ure more consistent results"))

DRY_RUN_OPT

Value:

cli_option("--dry-run", default= False, action= "store_true", help= (" Do not execute the operation, just run the" " check steps and verify i f it could be" " executed"))

VERBOSE_OPT

Value:

cli_option("-v", "--verbose", default= False, action= "store_true", he lp= "Increase the verbosity of the operation")

DEBUG_SIMERR_OPT

Value:

cli_option("--debug-simulate-errors", default= False, action= "store_t rue", dest= "simulate_errors", help= "Debugging option that makes the operation" " treat most runtime checks as failed")

NWSYNC_OPT

Value:

cli_option("--no-wait-for-sync", dest= "wait_for_sync", default= True, action= "store_false", help= "Don't wait for sync (DANGEROUS!)")

WFSYNC_OPT

Value:

cli_option("--wait-for-sync", dest= "wait_for_sync", default= False, a ction= "store_true", help= "Wait for disks to sync")

ONLINE_INST_OPT

Value:

cli_option("--online", dest= "online_inst", action= "store_true", defa ult= False, help= "Enable offline instance")

OFFLINE_INST_OPT

Value:

cli_option("--offline", dest= "offline_inst", action= "store_true", de fault= False, help= "Disable down instance")

DISK_TEMPLATE_OPT

Value:

cli_option("-t", "--disk-template", dest= "disk_template", help= ("Cus tom disk setup (%s)" % utils.CommaJoin(constants.DISK_TEMPLATES)), def ault= None, metavar= "TEMPL", choices= list(constants.DISK_TEMPLATES))

NONICS_OPT

Value:

cli_option("--no-nics", default= False, action= "store_true", help= "D o not create any network cards for" " the instance")

FILESTORE_DIR_OPT

Value:

cli_option("--file-storage-dir", dest= "file_storage_dir", help= "Rela tive path under default cluster-wide" " file storage dir to store file -based disks", default= None, metavar= "<DIR>")

FILESTORE_DRIVER_OPT

Value:

cli_option("--file-driver", dest= "file_driver", help= "Driver to use for image files", default= None, metavar= "<DRIVER>", choices= list(co nstants.FILE_DRIVER))

IALLOCATOR_OPT

Value:

cli_option("-I", "--iallocator", metavar= "<NAME>", help= "Select node s for the instance automatically" " using the <NAME> iallocator plugin ", default= None, type= "string", completion_suggest= OPT_COMPL_ONE_IA LLOCATOR)

DEFAULT_IALLOCATOR_OPT

Value:

cli_option("-I", "--default-iallocator", metavar= "<NAME>", help= "Set the default instance" " allocator plugin", default= None, type= "stri ng", completion_suggest= OPT_COMPL_ONE_IALLOCATOR)

DEFAULT_IALLOCATOR_PARAMS_OPT

Value:

cli_option("--default-iallocator-params", dest= "default_iallocator_pa rams", help= "iallocator template" " parameters, in the format" " temp late:option=value," " option=value,...", type= "keyval", default= None )

OS_OPT

Value:

cli_option("-o", "--os-type", dest= "os", help= "What OS to run", meta var= "<os>", completion_suggest= OPT_COMPL_ONE_OS)

OSPARAMS_OPT

Value:

cli_option("-O", "--os-parameters", dest= "osparams", type= "keyval", default= {}, help= "OS parameters")

FORCE_VARIANT_OPT

Value:

cli_option("--force-variant", dest= "force_variant", action= "store_tr ue", default= False, help= "Force an unknown variant")

NO_INSTALL_OPT

Value:

cli_option("--no-install", dest= "no_install", action= "store_true", d efault= False, help= "Do not install the OS (will" " enable no-start)" )

NORUNTIME_CHGS_OPT

Value:

cli_option("--no-runtime-changes", dest= "allow_runtime_chgs", default = True, action= "store_false", help= "Don't allow runtime changes")

BACKEND_OPT

Value:

cli_option("-B", "--backend-parameters", dest= "beparams", type= "keyv al", default= {}, help= "Backend parameters")

HVOPTS_OPT

Value:

cli_option("-H", "--hypervisor-parameters", type= "keyval", default= { }, dest= "hvparams", help= "Hypervisor parameters")

DISK_PARAMS_OPT

Value:

cli_option("-D", "--disk-parameters", dest= "diskparams", help= "Disk template parameters, in the format" " template:option=value,option=val ue,...", type= "identkeyval", action= "append", default= [])

SPECS_MEM_SIZE_OPT

Value:

cli_option("--specs-mem-size", dest= "ispecs_mem_size", type= "keyval" , default= {}, help= "Memory size specs: list of key=value," " where k ey is one of min, max, std" " (in MB or using a unit)")

SPECS_CPU_COUNT_OPT

Value:

cli_option("--specs-cpu-count", dest= "ispecs_cpu_count", type= "keyva l", default= {}, help= "CPU count specs: list of key=value," " where k ey is one of min, max, std")

SPECS_DISK_COUNT_OPT

Value:

cli_option("--specs-disk-count", dest= "ispecs_disk_count", type= "key val", default= {}, help= "Disk count specs: list of key=value," " wher e key is one of min, max, std")

SPECS_DISK_SIZE_OPT

Value:

cli_option("--specs-disk-size", dest= "ispecs_disk_size", type= "keyva l", default= {}, help= "Disk size specs: list of key=value," " where k ey is one of min, max, std" " (in MB or using a unit)")

SPECS_NIC_COUNT_OPT

Value:

cli_option("--specs-nic-count", dest= "ispecs_nic_count", type= "keyva l", default= {}, help= "NIC count specs: list of key=value," " where k ey is one of min, max, std")

IPOLICY_STD_SPECS_OPT

Value:

cli_option(IPOLICY_STD_SPECS_STR, dest= "ipolicy_std_specs", type= "ke yval", default= None, help= "Complete standard instance specs")

IPOLICY_DISK_TEMPLATES

Value:

cli_option("--ipolicy-disk-templates", dest= "ipolicy_disk_templates", type= "list", default= None, help= "Comma-separated list of" " enable d disk templates")

IPOLICY_VCPU_RATIO

Value:

cli_option("--ipolicy-vcpu-ratio", dest= "ipolicy_vcpu_ratio", type= " maybefloat", default= None, help= "The maximum allowed vcpu-to-cpu rat io")

HYPERVISOR_OPT

Value:

cli_option("-H", "--hypervisor-parameters", dest= "hypervisor", help= "Hypervisor and hypervisor options, in the" " format hypervisor:option =value,option=value,...", default= None, type= "identkeyval")

HVLIST_OPT

Value:

cli_option("-H", "--hypervisor-parameters", dest= "hvparams", help= "H ypervisor and hypervisor options, in the" " format hypervisor:option=v alue,option=value,...", default= [], action= "append", type= "identkey val")

NOIPCHECK_OPT

Value:

cli_option("--no-ip-check", dest= "ip_check", default= True, action= " store_false", help= "Don't check that the instance's IP" " is alive")

NONAMECHECK_OPT

Value:

cli_option("--no-name-check", dest= "name_check", default= True, actio n= "store_false", help= "Don't check that the instance's name" " is re solvable")

NET_OPT

Value:

cli_option("--net", help= "NIC parameters", default= [], dest= "nics", action= "append", type= "identkeyval")

DISK_OPT

Value:

cli_option("--disk", help= "Disk parameters", default= [], dest= "disk s", action= "append", type= "identkeyval")

DISKIDX_OPT

Value:

cli_option("--disks", dest= "disks", default= None, help= "Comma-separ ated list of disks" " indices to act on (e.g. 0,2) (optional," " defau lts to all disks)")

OS_SIZE_OPT

Value:

cli_option("-s", "--os-size", dest= "sd_size", help= "Enforces a singl e-disk configuration using the" " given disk size, in MiB unless a suf fix is used", default= None, type= "unit", metavar= "<size>")

IGNORE_CONSIST_OPT

Value:

cli_option("--ignore-consistency", dest= "ignore_consistency", action= "store_true", default= False, help= "Ignore the consistency of the di sks on" " the secondary")

ALLOW_FAILOVER_OPT

Value:

cli_option("--allow-failover", dest= "allow_failover", action= "store_ true", default= False, help= "If migration is not possible fallback to " " failover")

FORCE_FAILOVER_OPT

Value:

cli_option("--force-failover", dest= "force_failover", action= "store_ true", default= False, help= "Do not use migration, always use" " fail over")

NONLIVE_OPT

Value:

cli_option("--non-live", dest= "live", default= True, action= "store_f alse", help= "Do a non-live migration (this usually means" " freeze th e instance, save the state, transfer and" " only then resume running o n the secondary node)")

MIGRATION_MODE_OPT

Value:

cli_option("--migration-mode", dest= "migration_mode", default= None, choices= list(constants.HT_MIGRATION_MODES), help= "Override default m igration mode (choose" " either live or non-live")

NODE_PLACEMENT_OPT

Value:

cli_option("-n", "--node", dest= "node", help= "Target node and option al secondary node", metavar= "<pnode>[:<snode>]", completion_suggest= OPT_COMPL_INST_ADD_NODES)

NODE_LIST_OPT

Value:

cli_option("-n", "--node", dest= "nodes", default= [], action= "append ", metavar= "<node>", help= "Use only this node (can be used multiple" " times, if not given defaults to all nodes)", completion_suggest= OP T_COMPL_ONE_NODE)

NODEGROUP_OPT

Value:

cli_option("-g", NODEGROUP_OPT_NAME, dest= "nodegroup", help= "Node gr oup (name or uuid)", metavar= "<nodegroup>", default= None, type= "str ing", completion_suggest= OPT_COMPL_ONE_NODEGROUP)

SINGLE_NODE_OPT

Value:

cli_option("-n", "--node", dest= "node", help= "Target node", metavar= "<node>", completion_suggest= OPT_COMPL_ONE_NODE)

NOSTART_OPT

Value:

cli_option("--no-start", dest= "start", default= True, action= "store_ false", help= "Don't start the instance after creation")

SHOWCMD_OPT

Value:

cli_option("--show-cmd", dest= "show_command", action= "store_true", d efault= False, help= "Show command instead of executing it")

CLEANUP_OPT

Value:

cli_option("--cleanup", dest= "cleanup", default= False, action= "stor e_true", help= "Instead of performing the migration/failover," " try t o recover from a failed cleanup. This is safe" " to run even if the in stance is healthy, but it" " will create extra replication traffic and " " disrupt briefly the replication (like during the" " migration/fai lover")

STATIC_OPT

Value:

cli_option("-s", "--static", dest= "static", action= "store_true", def ault= False, help= "Only show configuration data, not runtime data")

ALL_OPT

Value:

cli_option("--all", dest= "show_all", default= False, action= "store_t rue", help= "Show info on all instances on the cluster." " This can ta ke a long time to run, use wisely")

SELECT_OS_OPT

Value:

cli_option("--select-os", dest= "select_os", action= "store_true", def ault= False, help= "Interactive OS reinstall, lists available" " OS te mplates for selection")

IGNORE_FAILURES_OPT

Value:

cli_option("--ignore-failures", dest= "ignore_failures", action= "stor e_true", default= False, help= "Remove the instance from the cluster" " configuration even if there are failures" " during the removal proce ss")

IGNORE_REMOVE_FAILURES_OPT

Value:

cli_option("--ignore-remove-failures", dest= "ignore_remove_failures", action= "store_true", default= False, help= "Remove the instance from the" " cluster configuration even if there" " are failures during the removal" " process")

REMOVE_INSTANCE_OPT

Value:

cli_option("--remove-instance", dest= "remove_instance", action= "stor e_true", default= False, help= "Remove the instance from the cluster")

DST_NODE_OPT

Value:

cli_option("-n", "--target-node", dest= "dst_node", help= "Specifies t he new node for the instance", metavar= "NODE", default= None, complet ion_suggest= OPT_COMPL_ONE_NODE)

NEW_SECONDARY_OPT

Value:

cli_option("-n", "--new-secondary", dest= "dst_node", help= "Specifies the new secondary node", metavar= "NODE", default= None, completion_s uggest= OPT_COMPL_ONE_NODE)

NEW_PRIMARY_OPT

Value:

cli_option("--new-primary", dest= "new_primary_node", help= "Specifies the new primary node", metavar= "<node>", default= None, completion_s uggest= OPT_COMPL_ONE_NODE)

ON_PRIMARY_OPT

Value:

cli_option("-p", "--on-primary", dest= "on_primary", default= False, a ction= "store_true", help= "Replace the disk(s) on the primary" " node (applies only to internally mirrored" " disk templates, e.g. %s)" % u tils.CommaJoin(constants.DTS_INT_MIRROR))

ON_SECONDARY_OPT

Value:

cli_option("-s", "--on-secondary", dest= "on_secondary", default= Fals e, action= "store_true", help= "Replace the disk(s) on the secondary" " node (applies only to internally mirrored" " disk templates, e.g. %s )" % utils.CommaJoin(constants.DTS_INT_MIRROR))

AUTO_PROMOTE_OPT

Value:

cli_option("--auto-promote", dest= "auto_promote", default= False, act ion= "store_true", help= "Lock all nodes and auto-promote as needed" " to MC status")

AUTO_REPLACE_OPT

Value:

cli_option("-a", "--auto", dest= "auto", default= False, action= "stor e_true", help= "Automatically replace faulty disks" " (applies only to internally mirrored" " disk templates, e.g. %s)" % utils.CommaJoin(co nstants.DTS_INT_MIRROR))

IGNORE_SIZE_OPT

Value:

cli_option("--ignore-size", dest= "ignore_size", default= False, actio n= "store_true", help= "Ignore current recorded size" " (useful for fo rcing activation when" " the recorded size is wrong)")

SRC_NODE_OPT

Value:

cli_option("--src-node", dest= "src_node", help= "Source node", metava r= "<node>", completion_suggest= OPT_COMPL_ONE_NODE)

SRC_DIR_OPT

Value:

cli_option("--src-dir", dest= "src_dir", help= "Source directory", met avar= "<dir>")

SECONDARY_IP_OPT

Value:

cli_option("-s", "--secondary-ip", dest= "secondary_ip", help= "Specif y the secondary ip for the node", metavar= "ADDRESS", default= None)

READD_OPT

Value:

cli_option("--readd", dest= "readd", default= False, action= "store_tr ue", help= "Readd old node after replacing it")

NOSSH_KEYCHECK_OPT

Value:

cli_option("--no-ssh-key-check", dest= "ssh_key_check", default= True, action= "store_false", help= "Disable SSH key fingerprint checking")

NODE_FORCE_JOIN_OPT

Value:

cli_option("--force-join", dest= "force_join", default= False, action= "store_true", help= "Force the joining of a node")

MC_OPT

Value:

cli_option("-C", "--master-candidate", dest= "master_candidate", type= "bool", default= None, metavar= _YORNO, help= "Set the master_candida te flag on the node")

OFFLINE_OPT

Value:

cli_option("-O", "--offline", dest= "offline", metavar= _YORNO, type= "bool", default= None, help= ("Set the offline flag on the node" " (cl uster does not communicate with offline" " nodes)"))

DRAINED_OPT

Value:

cli_option("-D", "--drained", dest= "drained", metavar= _YORNO, type= "bool", default= None, help= ("Set the drained flag on the node" " (ex cluded from allocation operations)"))

CAPAB_MASTER_OPT

Value:

cli_option("--master-capable", dest= "master_capable", type= "bool", d efault= None, metavar= _YORNO, help= "Set the master_capable flag on t he node")

CAPAB_VM_OPT

Value:

cli_option("--vm-capable", dest= "vm_capable", type= "bool", default= None, metavar= _YORNO, help= "Set the vm_capable flag on the node")

ALLOCATABLE_OPT

Value:

cli_option("--allocatable", dest= "allocatable", type= "bool", default = None, metavar= _YORNO, help= "Set the allocatable flag on a volume")

ENABLED_HV_OPT

Value:

cli_option("--enabled-hypervisors", dest= "enabled_hypervisors", help= "Comma-separated list of hypervisors", type= "string", default= None)

ENABLED_DISK_TEMPLATES_OPT

Value:

cli_option("--enabled-disk-templates", dest= "enabled_disk_templates", help= "Comma-separated list of " "disk templates", type= "string", de fault= None)

ENABLED_USER_SHUTDOWN_OPT

Value:

cli_option("--user-shutdown", default= None, dest= "enabled_user_shutd own", help= "Whether user shutdown is enabled", type= "bool")

NIC_PARAMS_OPT

Value:

cli_option("-N", "--nic-parameters", dest= "nicparams", type= "keyval" , default= {}, help= "NIC parameters")

CP_SIZE_OPT

Value:

cli_option("-C", "--candidate-pool-size", default= None, dest= "candid ate_pool_size", type= "int", help= "Set the candidate pool size")

RQL_OPT

Value:

cli_option("--max-running-jobs", dest= "max_running_jobs", type= "int" , help= "Set the maximal number of jobs to " "run simultaneously")

VG_NAME_OPT

Value:

cli_option("--vg-name", dest= "vg_name", help= ("Enables LVM and speci fies the volume group" " name (cluster-wide) for disk allocation" " [% s]" % constants.DEFAULT_VG), metavar= "VG", default= None)

YES_DOIT_OPT

Value:

cli_option("--yes-do-it", "--ya-rly", dest= "yes_do_it", help= "Destro y cluster", action= "store_true")

NOVOTING_OPT

Value:

cli_option("--no-voting", dest= "no_voting", help= "Skip node agreemen t check (dangerous)", action= "store_true", default= False)

MAC_PREFIX_OPT

Value:

cli_option("-m", "--mac-prefix", dest= "mac_prefix", help= "Specify th e mac prefix for the instance IP" " addresses, in the format XX:XX:XX" , metavar= "PREFIX", default= None)

MASTER_NETDEV_OPT

Value:

cli_option("--master-netdev", dest= "master_netdev", help= "Specify th e node interface (cluster-wide)" " on which the master IP address will be added" " (cluster init default: %s)" % constants.DEFAULT_BRIDGE, m etavar= "NETDEV", default= None)

MASTER_NETMASK_OPT

Value:

cli_option("--master-netmask", dest= "master_netmask", help= "Specify the netmask of the master IP", metavar= "NETMASK", default= None)

USE_EXTERNAL_MIP_SCRIPT

Value:

cli_option("--use-external-mip-script", dest= "use_external_mip_script ", help= "Specify whether to run a" " user-provided script for the mas ter" " IP address turnup and" " turndown operations", type= "bool", me tavar= _YORNO, default= None)

GLOBAL_FILEDIR_OPT

Value:

cli_option("--file-storage-dir", dest= "file_storage_dir", help= "Spec ify the default directory (cluster-" "wide) for storing the file-based disks [%s]" % pathutils.DEFAULT_FILE_STORAGE_DIR, metavar= "DIR", def ault= None)

GLOBAL_SHARED_FILEDIR_OPT

Value:

cli_option("--shared-file-storage-dir", dest= "shared_file_storage_dir ", help= "Specify the default directory (cluster-wide) for storing the " " shared file-based disks [%s]" % pathutils.DEFAULT_SHARED_FILE_STOR AGE_DIR, metavar= "SHAREDDIR", default= None)

GLOBAL_GLUSTER_FILEDIR_OPT

Value:

cli_option("--gluster-storage-dir", dest= "gluster_storage_dir", help= "Specify the default directory (cluster-wide) for mounting Gluster" " file systems [%s]" % pathutils.DEFAULT_GLUSTER_STORAGE_DIR, metavar= "GLUSTERDIR", default= pathutils.DEFAULT_GLUSTER_STORAGE_DIR)

NOMODIFY_ETCHOSTS_OPT

Value:

cli_option("--no-etc-hosts", dest= "modify_etc_hosts", help= "Don't mo dify %s" % pathutils.ETC_HOSTS, action= "store_false", default= True)

MODIFY_ETCHOSTS_OPT

Value:

cli_option("--modify-etc-hosts", dest= "modify_etc_hosts", metavar= _Y ORNO, default= None, type= "bool", help= "Defines whether the cluster should autonomously modify" " and keep in sync the /etc/hosts file of the nodes")

NOMODIFY_SSH_SETUP_OPT

Value:

cli_option("--no-ssh-init", dest= "modify_ssh_setup", help= "Don't ini tialize SSH keys", action= "store_false", default= True)

ERROR_CODES_OPT

Value:

cli_option("--error-codes", dest= "error_codes", help= "Enable parseab le error messages", action= "store_true", default= False)

NONPLUS1_OPT

Value:

cli_option("--no-nplus1-mem", dest= "skip_nplusone_mem", help= "Skip N +1 memory redundancy tests", action= "store_true", default= False)

REBOOT_TYPE_OPT

Value:

cli_option("-t", "--type", dest= "reboot_type", help= "Type of reboot: soft/hard/full", default= constants.INSTANCE_REBOOT_HARD, metavar= "< REBOOT>", choices= list(constants.REBOOT_TYPES))

IGNORE_SECONDARIES_OPT

Value:

cli_option("--ignore-secondaries", dest= "ignore_secondaries", default = False, action= "store_true", help= "Ignore errors from secondaries")

NOSHUTDOWN_OPT

Value:

cli_option("--noshutdown", dest= "shutdown", action= "store_false", de fault= True, help= "Don't shutdown the instance (unsafe)")

TIMEOUT_OPT

Value:

cli_option("--timeout", dest= "timeout", type= "int", default= constan ts.DEFAULT_SHUTDOWN_TIMEOUT, help= "Maximum time to wait")

COMPRESS_OPT

Value:

cli_option("--compress", dest= "compress", default= constants.IEC_NONE , help= "The compression mode to use", choices= list(constants.IEC_ALL ))

TRANSPORT_COMPRESSION_OPT

Value:

cli_option("--transport-compression", dest= "transport_compression", d efault= constants.IEC_NONE, choices= list(constants.IEC_ALL), help= "T he compression mode to use during transport")

SHUTDOWN_TIMEOUT_OPT

Value:

cli_option("--shutdown-timeout", dest= "shutdown_timeout", type= "int" , default= constants.DEFAULT_SHUTDOWN_TIMEOUT, help= "Maximum time to wait for instance" " shutdown")

INTERVAL_OPT

Value:

cli_option("--interval", dest= "interval", type= "int", default= None, help= ("Number of seconds between repetions of the" " command"))

EARLY_RELEASE_OPT

Value:

cli_option("--early-release", dest= "early_release", default= False, a ction= "store_true", help= "Release the locks on the secondary" " node (s) early")

NEW_CLUSTER_CERT_OPT

Value:

cli_option("--new-cluster-certificate", dest= "new_cluster_cert", defa ult= False, action= "store_true", help= "Generate a new cluster certif icate")

NEW_NODE_CERT_OPT

Value:

cli_option("--new-node-certificates", dest= "new_node_cert", default= False, action= "store_true", help= "Generate new node certificates (fo r all nodes)")

RAPI_CERT_OPT

Value:

cli_option("--rapi-certificate", dest= "rapi_cert", default= None, hel p= "File containing new RAPI certificate")

NEW_RAPI_CERT_OPT

Value:

cli_option("--new-rapi-certificate", dest= "new_rapi_cert", default= N one, action= "store_true", help= ("Generate a new self-signed RAPI" " certificate"))

SPICE_CERT_OPT

Value:

cli_option("--spice-certificate", dest= "spice_cert", default= None, h elp= "File containing new SPICE certificate")

SPICE_CACERT_OPT

Value:

cli_option("--spice-ca-certificate", dest= "spice_cacert", default= No ne, help= "File containing the certificate of the CA" " which signed t he SPICE certificate")

NEW_SPICE_CERT_OPT

Value:

cli_option("--new-spice-certificate", dest= "new_spice_cert", default= None, action= "store_true", help= ("Generate a new self-signed SPICE" " certificate"))

NEW_CONFD_HMAC_KEY_OPT

Value:

cli_option("--new-confd-hmac-key", dest= "new_confd_hmac_key", default = False, action= "store_true", help= ("Create a new HMAC key for %s" % constants.CONFD))

CLUSTER_DOMAIN_SECRET_OPT

Value:

cli_option("--cluster-domain-secret", dest= "cluster_domain_secret", d efault= None, help= ("Load new new cluster domain" " secret from file" ))

NEW_CLUSTER_DOMAIN_SECRET_OPT

Value:

cli_option("--new-cluster-domain-secret", dest= "new_cluster_domain_se cret", default= False, action= "store_true", help= ("Create a new clus ter domain" " secret"))

USE_REPL_NET_OPT

Value:

cli_option("--use-replication-network", dest= "use_replication_network ", help= "Whether to use the replication network" " for talking to the nodes", action= "store_true", default= False)

MAINTAIN_NODE_HEALTH_OPT

Value:

cli_option("--maintain-node-health", dest= "maintain_node_health", met avar= _YORNO, default= None, type= "bool", help= "Configure the cluste r to automatically maintain node" " health, by shutting down unknown i nstances, shutting down" " unknown DRBD devices, etc.")

IDENTIFY_DEFAULTS_OPT

Value:

cli_option("--identify-defaults", dest= "identify_defaults", default= False, action= "store_true", help= "Identify which saved instance para meters are equal to" " the current cluster defaults and set them as su ch, instead" " of marking them as overridden")

UIDPOOL_OPT

Value:

cli_option("--uid-pool", default= None, action= "store", dest= "uid_po ol", help= ("A list of user-ids or user-id" " ranges separated by comm as"))

ADD_UIDS_OPT

Value:

cli_option("--add-uids", default= None, action= "store", dest= "add_ui ds", help= ("A list of user-ids or user-id" " ranges separated by comm as, to be" " added to the user-id pool"))

REMOVE_UIDS_OPT

Value:

cli_option("--remove-uids", default= None, action= "store", dest= "rem ove_uids", help= ("A list of user-ids or user-id" " ranges separated b y commas, to be" " removed from the user-id pool"))

RESERVED_LVS_OPT

Value:

cli_option("--reserved-lvs", default= None, action= "store", dest= "re served_lvs", help= ("A comma-separated list of reserved" " logical vol umes names, that will be" " ignored by cluster verify"))

ROMAN_OPT

Value:

cli_option("--roman", dest= "roman_integers", default= False, action= "store_true", help= "Use roman numbers for positive integers")

DRBD_HELPER_OPT

Value:

cli_option("--drbd-usermode-helper", dest= "drbd_helper", action= "sto re", default= None, help= "Specifies usermode helper for DRBD")

PRIMARY_IP_VERSION_OPT

Value:

cli_option("--primary-ip-version", default= constants.IP4_VERSION, act ion= "store", dest= "primary_ip_version", metavar= "%d|%d" %(constants .IP4_VERSION, constants.IP6_VERSION), help= "Cluster-wide IP version f or primary IP")

SHOW_MACHINE_OPT

Value:

cli_option("-M", "--show-machine-names", default= False, action= "stor e_true", help= "Show machine name for every line in output")

FAILURE_ONLY_OPT

Value:

cli_option("--failure-only", default= False, action= "store_true", hel p= ("Hide successful results and show failures" " only (determined by the exit code)"))

REASON_OPT

Value:

cli_option("--reason", default= None, help= "The reason for executing the command")

PRIORITY_OPT

Value:

cli_option("--priority", default= None, dest= "priority", metavar= "|" .join(name for name, _ in _PRIORITY_NAMES), choices= _PRIONAME_TO_VALU E.keys(), action= "callback", type= "choice", callback= _PriorityOptio nCb, help= "Priority for opcode processing")

HID_OS_OPT

Value:

cli_option("--hidden", dest= "hidden", type= "bool", default= None, me tavar= _YORNO, help= "Sets the hidden flag on the OS")

BLK_OS_OPT

Value:

cli_option("--blacklisted", dest= "blacklisted", type= "bool", default = None, metavar= _YORNO, help= "Sets the blacklisted flag on the OS")

PREALLOC_WIPE_DISKS_OPT

Value:

cli_option("--prealloc-wipe-disks", default= None, type= "bool", metav ar= _YORNO, dest= "prealloc_wipe_disks", help= ("Wipe disks prior to i nstance" " creation"))

NODE_PARAMS_OPT

Value:

cli_option("--node-parameters", dest= "ndparams", type= "keyval", defa ult= None, help= "Node parameters")

ALLOC_POLICY_OPT

Value:

cli_option("--alloc-policy", dest= "alloc_policy", action= "store", me tavar= "POLICY", default= None, help= "Allocation policy for the node group")

NODE_POWERED_OPT

Value:

cli_option("--node-powered", default= None, type= "bool", metavar= _YO RNO, dest= "node_powered", help= "Specify if the SoR for node is power ed")

OOB_TIMEOUT_OPT

Value:

cli_option("--oob-timeout", dest= "oob_timeout", type= "int", default= constants.OOB_TIMEOUT, help= "Maximum time to wait for out-of-band he lper")

POWER_DELAY_OPT

Value:

cli_option("--power-delay", dest= "power_delay", type= "float", defaul t= constants.OOB_POWER_DELAY, help= "Time in seconds to wait between p ower-ons")

FORCE_FILTER_OPT

Value:

cli_option("-F", "--filter", dest= "force_filter", action= "store_true ", default= False, help= ("Whether command argument should be treated" " as filter"))

NO_REMEMBER_OPT

Value:

cli_option("--no-remember", dest= "no_remember", action= "store_true", default= False, help= "Perform but do not record the change" " in the configuration")

PRIMARY_ONLY_OPT

Value:

cli_option("-p", "--primary-only", default= False, action= "store_true ", help= "Evacuate primary instances only")

SECONDARY_ONLY_OPT

Value:

cli_option("-s", "--secondary-only", default= False, action= "store_tr ue", help= "Evacuate secondary instances only" " (applies only to inte rnally mirrored" " disk templates, e.g. %s)" % utils.CommaJoin(constan ts.DTS_INT_MIRROR))

STARTUP_PAUSED_OPT

Value:

cli_option("--paused", dest= "startup_paused", action= "store_true", d efault= False, help= "Pause instance at startup")