Import VMA Backups into Proxmox Backup Server - Revision history

Tlamprecht at 13:15, 25 April 2024

2024-04-25T13:15:04Z

← Older revision		Revision as of 13:15, 25 April 2024
Line 8:		Line 8:
	First, install the package providing the <code>vma-to-pbs</code> tool:		First, install the package providing the <code>vma-to-pbs</code> tool:

	<syntaxhighlight lang="~~Bash~~">		<syntaxhighlight lang="bash">
	apt install proxmox-vma-to-pbs		apt install proxmox-vma-to-pbs
	</syntaxhighlight>		</syntaxhighlight>
Line 33:		Line 33:
	The file may then be imported as follows:		The file may then be imported as follows:

	<syntaxhighlight lang="~~Bash~~">		<syntaxhighlight lang="bash">
	zstd -d --stdout vzdump.vma.zst \| \		zstd -d --stdout vzdump.vma.zst \| \
	PBS_FINGERPRINT=~~<PBS_FINGERPRINT>~~ vma-to-pbs \		PBS_FINGERPRINT='PBS-FINGERPRINT' vma-to-pbs \
	--repository user@realm\!token@server:port:datastore \		--repository 'user@realm!token@server:port:datastore' \
	--vmid 123 \		--vmid 123 \
	--password-file path/to/pbs_password		--password-file path/to/pbs_password
Line 43:		Line 43:
	Alternatively, you may also decompress the archive first and then run the import:		Alternatively, you may also decompress the archive first and then run the import:

	<syntaxhighlight lang="~~Bash~~">		<syntaxhighlight lang="bash">
	zstd -d vzdump.vma.zst		zstd -d vzdump.vma.zst
	</syntaxhighlight>		</syntaxhighlight>
	<syntaxhighlight lang="Bash">		<syntaxhighlight lang="Bash">
	PBS_FINGERPRINT=~~<PBS_FINGERPRINT>~~ vma-to-pbs \		PBS_FINGERPRINT='PBS-FINGERPRINT' vma-to-pbs \
	--repository user@realm\!token@server:port:datastore \		--repository 'user@realm!token@server:port:datastore' \
	--vmid 123 \		--vmid 123 \
	--password-file path/to/pbs_password \		--password-file path/to/pbs_password \
Line 55:		Line 55:

	'''Note''': For all available options, run: <code>vma-to-pbs --help</code>.		'''Note''': For all available options, run: <code>vma-to-pbs --help</code>.

			[[Category:HOW-TO]]

F.weber: mention proxmox-vma-to-pbs package

2024-04-25T12:46:25Z

mention proxmox-vma-to-pbs package

← Older revision		Revision as of 12:46, 25 April 2024
Line 5:		Line 5:

	== Prerequisites ==		== Prerequisites ==

			First, install the package providing the <code>vma-to-pbs</code> tool:

			<syntaxhighlight lang="Bash">
			apt install proxmox-vma-to-pbs
			</syntaxhighlight>

	In order to be able to import an archive, <code>vma-to-pbs</code> requires:		In order to be able to import an archive, <code>vma-to-pbs</code> requires:

F.weber at 12:42, 25 April 2024

2024-04-25T12:42:06Z

← Older revision		Revision as of 12:42, 25 April 2024
Line 1:		Line 1:
			== Introduction ==
	'''placeholder'''

			The <code>vma-to-pbs</code> command allows Proxmox Virtual Machine Archives (VMA) to be imported into [https://pbs.proxmox.com/wiki/index.php/Main_Page Proxmox Backup Server].
			The archive is converted and then made available as a regular backup in Proxmox Backup Server.

			== Prerequisites ==

			In order to be able to import an archive, <code>vma-to-pbs</code> requires:
			* the '''fingerprint''' of the PBS instance
			* the '''PBS repository location'''
			* the '''VM ID''' the archive belongs to
			: '''Note''': Ensure that the VM ID really matches! You will otherwise end up with the wrong VM should you ever need to do a restore, possibly risking loss of data!

			The datastore repository is specified in the following format: <code><nowiki>[[user@realm[!token]@]server[:port]:]datastore</nowiki></code><br>Refer to the [https://pbs.proxmox.com/docs/backup-client.html#backup-repository-locations '''Backup Client Usage Docs'''] for some examples.

			=== Obtaining The PBS Fingerprint ===

			The fingerprint can be copied directly from the web interface via '''Dashboard -> Show Fingerprint''' or be displayed by issuing the following command on the Proxmox Backup Server instance:
			<syntaxhighlight lang="Bash">
			proxmox-backup-manager cert info \| grep Fingerprint
			</syntaxhighlight>

			== Running The Import ==

			If you pass the VMA file through <code>stdin</code>, you must also provide a file containing the password for your user via <code>--password-file path/to/pbs_password</code>.

			The file may then be imported as follows:

			<syntaxhighlight lang="Bash">
			zstd -d --stdout vzdump.vma.zst \| \
			PBS_FINGERPRINT=<PBS_FINGERPRINT> vma-to-pbs \
			--repository user@realm\!token@server:port:datastore \
			--vmid 123 \
			--password-file path/to/pbs_password
			</syntaxhighlight>

			Alternatively, you may also decompress the archive first and then run the import:

			<syntaxhighlight lang="Bash">
			zstd -d vzdump.vma.zst
			</syntaxhighlight>
			<syntaxhighlight lang="Bash">
			PBS_FINGERPRINT=<PBS_FINGERPRINT> vma-to-pbs \
			--repository user@realm\!token@server:port:datastore \
			--vmid 123 \
			--password-file path/to/pbs_password \
			vzdump.vma
			</syntaxhighlight>

			'''Note''': For all available options, run: <code>vma-to-pbs --help</code>.

F.weber: add placeholder

2024-04-25T12:28:03Z

add placeholder

New page

'''placeholder'''