Class FakeHypervisor

x.__init__(...) initializes x; see help(type(x)) for signature

Overrides: object.__init__

(inherited documentation)

Get the list of running instances.

Overrides: hv_base.BaseHypervisor.ListInstances

Get instance properties.

Parameters:

• instance_name (string) - the instance name
• hvparams (dict of strings) - hvparams to be used with this instance

Returns: (string, string, int, int, HvInstanceState, int)

tuple of (name, id, memory, vcpus, stat, times)

Overrides: hv_base.BaseHypervisor.GetInstanceInfo

Get properties of all instances.

Parameters:

• hvparams (dict of strings) - hypervisor parameter

Returns: (string, string, int, int, HvInstanceState, int)

list of tuples (name, id, memory, vcpus, stat, times)

Overrides: hv_base.BaseHypervisor.GetAllInstancesInfo

Start an instance.

For the fake hypervisor, it just creates a file in the base dir, creating an exception if it already exists. We don't actually handle race conditions properly, since these are *FAKE* instances.

Overrides: hv_base.BaseHypervisor.StartInstance

Stop an instance.

For the fake hypervisor, this just removes the file in the base dir, if it exist, otherwise we raise an exception.

Parameters:

• instance - instance to stop
• force - whether to do a "hard" stop (destroy)
• retry - whether this is just a retry call
• name - if this parameter is passed, the the instance object should not be used (will be passed as None), and the shutdown must be done by name only
• timeout - if the parameter is not None, a soft shutdown operation will be killed after the specified number of seconds. A hard (forced) shutdown cannot have a timeout

Raises:

• errors.HypervisorError - when a parameter is not valid or the instance failed to be stopped

Overrides: hv_base.BaseHypervisor.StopInstance

Reboot an instance.

For the fake hypervisor, this does nothing.

Overrides: hv_base.BaseHypervisor.RebootInstance

Balloon an instance memory to a certain value.

Parameters:

• instance (objects.Instance) - instance to be accepted
• mem (int) - actual memory size to use for instance runtime

Overrides: hv_base.BaseHypervisor.BalloonInstanceMemory

Return information about the node.

See BaseHypervisor.GetLinuxNodeInfo.

Parameters:

• hvparams - hypervisor parameters

Returns:

a dict with at least the following keys (memory values in MiB):

• memory_total: the total memory size on the node
• memory_free: the available memory on the node for instances
• memory_dom0: the memory used by the node itself, if available
• cpu_total: total number of CPUs
• cpu_dom0: number of CPUs used by the node OS
• cpu_nodes: number of NUMA domains
• cpu_sockets: number of physical CPU sockets

Overrides: hv_base.BaseHypervisor.GetNodeInfo

Return information for connecting to the console of an instance.

Overrides: hv_base.BaseHypervisor.GetInstanceConsole

Verify the hypervisor.

For the fake hypervisor, it just checks the existence of the base dir.

Parameters:

• hvparams (dict of strings) - hypervisor parameters to be verified against; not used for fake hypervisors

Returns:

Problem description if something is wrong, None otherwise

Overrides: hv_base.BaseHypervisor.Verify

Fake hypervisor powercycle, just a wrapper over Linux powercycle.

Parameters:

• hvparams (dict of strings) - hypervisor params to be used on this node

Overrides: hv_base.BaseHypervisor.PowercycleNode

Prepare to accept an instance.

Parameters:

• instance (objects.Instance) - instance to be accepted
• info (string) - instance info, not used
• target (string) - target host (usually ip), on this node

Overrides: hv_base.BaseHypervisor.AcceptInstance

Migrate an instance.

Parameters:

• cluster_name (string) - name of the cluster
• instance (objects.Instance) - the instance to be migrated
• target (string) - hostname (usually ip) of the target node
• live (boolean) - whether to do a live or non-live migration

Overrides: hv_base.BaseHypervisor.MigrateInstance

Finalize the instance migration on the target node.

For the fake hv, this just marks the instance up.

Parameters:

• instance (objects.Instance) - instance whose migration is being finalized
• info (string/data (opaque)) - migration information, from the source node
• success (boolean) - whether the migration was a success or a failure

Overrides: hv_base.BaseHypervisor.FinalizeMigrationDst

Clean-up after a migration.

To be executed on the source node.

Parameters:

• instance (objects.Instance) - the instance that was migrated

Finalize the instance migration on the source node.

Parameters:

• instance (objects.Instance) - the instance that was migrated
• success (bool) - whether the migration succeeded or not
• live (bool) - whether the user requested a live migration or not

Overrides: hv_base.BaseHypervisor.FinalizeMigrationSource

Get the migration status

The fake hypervisor migration always succeeds.

Parameters:

• instance (objects.Instance) - the instance that is being migrated

Returns: objects.MigrationStatus

the status of the current migration (one of constants.HV_MIGRATION_VALID_STATUSES), plus any additional progress info that can be retrieved from the hypervisor

Overrides: hv_base.BaseHypervisor.GetMigrationStatus

PARAMETERS

• the required flag (boolean)
• a function to check for syntax, that will be used in CheckParameterSyntax, in the master daemon process
• an error message for the above function
• a function to check for parameter validity on the remote node, in the ValidateParameters function
• an error message for the above function

Value:

{constants.HV_MIGRATION_MODE: hv_base.MIGRATION_MODE_CHECK,}