File: README.md

package info (click to toggle)
xva-img 1.5-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 192 kB
  • sloc: cpp: 761; makefile: 3
file content (41 lines) | stat: -rw-r--r-- 1,840 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
xva-img
=======

Citrix Xen uses a custom virtual appliance format for import/export called "XVA". it's basically a strangely crafted tar-file. You don't need this program to unpack this tar-file, just use your favourite tar unpacker (tar, gtar, bsdtar). Once unpacked you will end up with a lot of different files, ova.xml (which contains the settings for the virtual appliance, think VMware vmx) and a number of folders called Ref:<number>/, this is your disks. Each of these folders contain hundreds of files named 00000000, 00000001 with a accompanying .CHECKSUM file (SHA1). Each file is a 1MB slice of the disk, but some of the files in the sequence will probably be missing this is because XVA do not use compression; instead it will exclude slices of the disk that only contains zeros (are empty). This tool can assemble the disk for you (you will end up with a RAW disk) that can easily be mounted and modified. It can then also split the file again and generate checksum. Once ready, you will probably want to use the "package" command to rebuild the XVA file.
    
Requirements
============
 
 * CMake
 * g++ or clang++
 * libssl-dev
 * libxxhash-dev
 
To build
=======
Install g++ cmake make libssl-dev

    cmake .
    make
    make install

Example
=======
Extract the XVA file.

    mkdir my-virtual-machine
    tar -xf my-virtual-machine.xva -C my-virtual-machine
    chmod -R 755 my-virtual-machine

Extract one of the disks

    xva-img -p disk-export my-virtual-machine/Ref\:1/ disk.raw

Splice the disk file (remove all files in the folder, required not to make any unnecessary mistakes)

    rm -rf my-virtual-machine/Ref\:1/*
    xva-img -p disk-import my-virtual-machine/Ref\:1/ disk.raw

Rebuild the XVA file

    xva-img -p package my-virtual-machine-fixed.xva my-virtual-machine/ova.xml my-virtual-machine/Ref\:1/