stoney conductor: prov-backup-kvm - Revision history

Michael: /* createSnapshot */

2014-06-27T14:39:35Z

createSnapshot

← Older revision		Revision as of 16:39, 27 June 2014
Line 11:		Line 11:

	=== createSnapshot ===		=== createSnapshot ===
	[[File:KVM-Backup-Workflow-Snapshot.png\|thumb\|none\|~~500px~~\|Figure 2: Detailed workflow for the createsSnaphshot process]]		[[File:KVM-Backup-Workflow-Snapshot.png\|thumb\|none\|650px\|Figure 2: Detailed workflow for the createsSnaphshot process]]

	You can edit this workflow with the following file (you may need umbrello to modify it): [[File:KVM-Backup-Workflow-detailed.xmi]]		You can edit this workflow with the following file (you may need umbrello to modify it): [[File:KVM-Backup-Workflow-detailed.xmi]]

Michael: /* Backup */

2014-06-27T14:39:21Z

Backup

← Older revision		Revision as of 16:39, 27 June 2014
Line 6:		Line 6:
	This is the simplified workflow for the Provisioning-Backup-KVM Daemon. The Subroutines (create-, export- and commitSnapshot) are shown later.		This is the simplified workflow for the Provisioning-Backup-KVM Daemon. The Subroutines (create-, export- and commitSnapshot) are shown later.

	[[File:KVM-Backup-Workflow.png\|thumb\|none\|~~400px~~\|Figure 1: Simplified prov-backup-kvm workflow]]		[[File:KVM-Backup-Workflow.png\|thumb\|none\|650px\|Figure 1: Simplified prov-backup-kvm workflow]]

	You can modify/update this workflow by editing [[File:KVM-Backup-simple.xmi]] (you may need [http://uml.sourceforge.net/ Umbrello UML Modeller] diagram programme for KDE to display the content properly).		You can modify/update this workflow by editing [[File:KVM-Backup-simple.xmi]] (you may need [http://uml.sourceforge.net/ Umbrello UML Modeller] diagram programme for KDE to display the content properly).

Pat: /* Backend */

2014-06-26T14:55:54Z

Backend

← Older revision		Revision as of 16:55, 26 June 2014
Line 140:		Line 140:

	== Backend ==		== Backend ==
			''' Currently the backend configuration is not active. If it is active it will be (maybe some minor modifications) as the following: '''

	In the backend, you need to have at least one configuration which applies for the whole stoney cloud. This configuration is referenced in the [[#Global\|global configuration]]. You are able to overwrite the stoney-cloud-wide configuration for		In the backend, you need to have at least one configuration which applies for the whole stoney cloud. This configuration is referenced in the [[#Global\|global configuration]]. You are able to overwrite the stoney-cloud-wide configuration for
	* A VM-Pool		* A VM-Pool

Pat: /* Exit codes */

2014-06-26T14:54:39Z

Exit codes

← Older revision		Revision as of 16:54, 26 June 2014
Line 180:		Line 180:

	= Exit codes =		= Exit codes =
	The following list defines the return codes and their meaning for the KVM-Backup script ~~see also [https://github.com/stepping-stone/prov-backup-kvm/blob/master/lib/Provisioning/Backup/KVM/Constants.pm KVMConstants.pm]~~:		The following list defines the return codes and their meaning for the KVM-Backup script:
	<pre>		<pre>
	use constant SUCCESS_CODE => 0;		use constant
			{
	~~### Error codes constants~~		SUCCESS_CODE => 0,
	~~use constant UNDEFINED_ERROR~~ => 1~~; # Always the first!~~		ERROR_CODE => 1,
	~~use constant MISSING_PARAMETER_IN_CONFIG_FILE => 2;~~
	~~use constant CONFIGURED_RAM_DISK_IS_NOT_VALUD~~ => 3;		TRUE => 1,
	~~use constant NOT_ENOUGH_SPACE_ON_RAM_DISK~~ => 4;		FALSE => 0,
	~~use constant CANNOT_SAVE_MACHINE_STATE => 5;~~
	~~use constant CANNOT_WRITE_TO_BACKUP_LOCATION => 6;~~		# Specific error codes
	~~use constant CANNOT_COPY_FILE_TO_BACKUP_LOCATION~~ => 7;		TEMPLATE_NOT_READABLE => 101,
	~~use constant CANNOT_COPY_IMAGE_TO_BACKUP_LOCATION~~ => 8;		NO_MACHINE => 102,
	~~use constant CANNOT_COPY_XML_TO_BACKUP_LOCATION~~ => 9;		NO_XML_DESCRIPTION => 103,
	~~use constant CANNOT_COPY_BACKEND_FILE_TO_BACKUP_LOCATION~~=> ~~10;~~		CANNOT_CREATE_SNAPSHOT => 104,
	~~use constant CANNOT_MERGE_DISK_IMAGES~~ => ~~11;~~		NO_STATE_INFORMATION => 105,
	~~use constant CANNOT_REMOVE_OLD_DISK_IMAGE => 12;~~		CANNOT_START_MACHINE => 106,
	~~use constant CANNOT_REMOVE_FILE => 13;~~		NO_BACKUP_LOCATION => 107,
	~~use constant CANNOT_CREATE_EMPTY_DISK_IMAGE => 15;~~		UNCONSISTENT_BACKUP => 108,
	~~use constant CANNOT_RENAME_DISK_IMAGE => 16;~~		CANNOT_GET_SNAPSHOT => 109,
	~~use constant CANNOT_CONNECT_TO_BACKEND => 17;~~		CANNOT_DELETE_SNAPSHOT => 110,
	~~use constant WRONG_STATE_INFORMATION => 18;~~		CANNOT_UPDATE_XML => 111,
	~~use constant CANNOT_SET_DISK_IMAGE_OWNERSHIP~~ => ~~19;~~		NO_SPACE_LEFT => 112,
	~~use constant CANNOT_SET_DISK_IMAGE_PERMISSION~~ => ~~20;~~		};
	~~use constant CANNOT_RESTORE_MACHINE~~ => ~~21;~~
	~~use constant CANNOT_LOCK_MACHINE~~ => ~~22;~~
	~~use constant CANNOT_FIND_MACHINE~~ => ~~23;~~
	~~use constant CANNOT_COPY_STATE_FILE_TO_RETAIN~~ => ~~24;~~
	~~use constant RETAIN_ROOT_DIRECTORY_DOES_NOT_EXIST~~ => ~~25;~~
	~~use constant BACKUP_ROOT_DIRECTORY_DOES_NOT_EXIST => 26;~~
	~~use constant CANNOT_CREATE_DIRECTORY => 27;~~
	~~use constant CANNOT_SAVE_XML => 28;~~
	~~use constant CANNOT_SAVE_BACKEND_ENTRY => 29;~~
	~~use constant CANNOT_SET_DIRECTORY_OWNERSHIP => 30;~~
	~~use constant CANNOT_SET_DIRECTORY_PERMISSION => 31;~~
	~~use constant CANNOT_FIND_CONFIGURATION_ENTRY => 32;~~
	~~use constant BACKEND_XML_UNCONSISTENCY => 33;~~
	~~use constant CANNOT_CREATE_TARBALL => 34;~~
	~~use constant UNSUPPORTED_FILE_TRANSFER_PROTOCOL => 35;~~
	~~use constant UNKNOWN_BACKEND_TYPE => 36;~~
	~~use constant MISSING_NECESSARY_FILES => 37;~~
	~~use constant CORRUPT_DISK_IMAGE_FOUND => 38;~~
	~~use constant UNSUPPORTED_CONFIGURATION_PARAMETER => 39;~~
	~~use constant CANNOT_MOVE_DISK_IMAGE_TO_ORIGINAL_LOCATION=> 40;~~
	~~use constant CANNOT_DEFINE_MACHINE => 41;~~
	~~use constant CANNOT_START_MACHINE => 42;~~
	~~use constant CANNOT_WORK_ON_UNDEFINED_OBJECT => 43;~~
	~~use constant CANNOT_READ_STATE_FILE => 44;~~
	~~use constant CANNOT_READ_XML_FILE => 45;~~
	~~use constant NOT_ALL_FILES_DELETED_FROM_RETAIN_LOCATION => 46;~~
	~~use constant NOT_ENOUGH_DISK_SPACE => 47;~~
	~~use constant NO_DISK_SPACE_INFORMATION => 48~~;
	</pre>		</pre>

Pat: /* Source Code */

2014-06-26T14:53:47Z

Source Code

← Older revision		Revision as of 16:53, 26 June 2014
Line 240:		Line 240:
	The source code is located in our GitHub Repository:		The source code is located in our GitHub Repository:

	https://github.com/~~stepping~~-~~stone~~/prov-backup-kvm		https://github.com/stoney-cloud/stoney-conductor/tree/master/prov-backup-kvm

	= Links =		= Links =

	[[Category:stoney conductor]][[Category:Provisioning Modules]]		[[Category:stoney conductor]][[Category:Provisioning Modules]]

Pat: /* Next steps */

2014-06-26T14:53:00Z

Next steps

← Older revision		Revision as of 16:53, 26 June 2014
Line 235:		Line 235:

	= Next steps =		= Next steps =
	* ~~Change the behaviour of the snapshot/merge process~~		* Implement restore
	** No longer merge the original file into the new one but merge (commit) backing store file back into original one
	*** Like that we are able to reduce the backup (merge) time a lot.
	*** Needs different behaviour for save -> copy/move -> create new image -> restore ~~-> merge~~

	= Source Code =		= Source Code =

Pat: /* Restore */

2014-06-26T14:52:28Z

Restore

← Older revision		Revision as of 16:52, 26 June 2014
Line 32:		Line 32:

	== Restore ==		== Restore ==
	* <span style="background:#00FF00">Task for the control-instance daemon</span>		''' Restore is currently not implemented '''
	* <span style="background:#FFFF00">Task for the prov-backup-kvm daemon</span>
	* <span style="background:#FF8000">Task for the vm-manager</span>
	~~[[File:KVM-Backup-Workflow-~~Restore~~.png\|thumb\|none\|500px\|Figure 4: Detailed workflow for the restore process]]~~

	~~You can edit this workflow with the following file (you may need umbrello to modify it): [[File:KVM-Backup-Workflow-restore.xmi]]~~



	~~See also [[stoney_conductor:_Backup#Basic_idea_2 \| Restore: Basic idea]]~~

	= Configuration =		= Configuration =

Pat: /* commitSnapshot */

2014-06-26T14:52:00Z

commitSnapshot

← Older revision		Revision as of 16:52, 26 June 2014
Line 25:		Line 25:

	=== commitSnapshot ===		=== commitSnapshot ===
	[[File:KVM-Backup-Workflow-Retain.png\|thumb\|none\|500px\|Figure 3: Detailed workflow for the ~~retain~~ process]]		[[File:KVM-Backup-Workflow-Retain.png\|thumb\|none\|500px\|Figure 3: Detailed workflow for the commitSnapshot process]]

	You can edit this workflow with the following file (you may need umbrello to modify it): [[File:KVM-Backup-Workflow-detailed.xmi]]		You can edit this workflow with the following file (you may need umbrello to modify it): [[File:KVM-Backup-Workflow-detailed.xmi]]

Pat: /* createSnapshot */

2014-06-26T14:50:52Z

createSnapshot

← Older revision		Revision as of 16:50, 26 June 2014
Line 11:		Line 11:

	=== createSnapshot ===		=== createSnapshot ===
	[[File:KVM-Backup-Workflow-Snapshot.png\|thumb\|none\|500px\|Figure 2: Detailed workflow for the ~~snaphshot~~ process]]		[[File:KVM-Backup-Workflow-Snapshot.png\|thumb\|none\|500px\|Figure 2: Detailed workflow for the createsSnaphshot process]]

	You can edit this workflow with the following file (you may need umbrello to modify it): [[File:KVM-Backup-Workflow-detailed.xmi]]		You can edit this workflow with the following file (you may need umbrello to modify it): [[File:KVM-Backup-Workflow-detailed.xmi]]

Pat: /* exportSnapshot */

2014-06-26T14:50:38Z

exportSnapshot

← Older revision		Revision as of 16:50, 26 June 2014
Line 18:		Line 18:

	=== exportSnapshot ===		=== exportSnapshot ===
	[[File:KVM-Backup-Workflow-Merge.png\|thumb\|none\|500px\|Figure 2: Detailed workflow for the ~~merge~~ process]]		[[File:KVM-Backup-Workflow-Merge.png\|thumb\|none\|500px\|Figure 2: Detailed workflow for the exportSnapshot process]]

	You can edit this workflow with the following file (you may need umbrello to modify it): [[File:KVM-Backup-Workflow-detailed.xmi]]		You can edit this workflow with the following file (you may need umbrello to modify it): [[File:KVM-Backup-Workflow-detailed.xmi]]