---

-a (--assemble)

The -a option creates (assembles) a hypervisor-specific virtual machine image from a Java application, by using the configuration parameters specified in an XML file.

Note:

The XML file that you use to create a virtual machine image is not retained as an XML file anywhere in the file system of the virtual machine image. During the assembly process, the configuration settings defined in the input XML file are stored within the virtual machine image.

Subsequently, if you reconfigure the virtual machine by using the -r (--reconfigure) option, the configuration changes are not reflected in the original XML file that you used to assemble the virtual machine image.

At any point, you can extract the current configuration settings of a virtual machine and rebuild an XML file that reflects the configuration state of the virtual machine, by using the -d (--disassemble) option. You can also get the configuration settings by using the -r vm.cfg get config option.

Syntax

java -jar jrockitve-imagetool.jar -a config_file.xml output_dir [hypervisor]

Note:

For information about the syntax conventions, see Documentation Conventions for Command-Line Syntax.

Arguments

Argument	Description	Mandatory / Optional	Default Value
config.xml	The path and name of the XML file that contains the configuration parameters for the virtual machine	Mandatory
output_dir	The directory in which the virtual machine image should be created	Mandatory
hypervisor	The hypervisor for which the virtual machine image should be created	Optional	ovm (Oracle VM) Note: Oracle VM is the only supported hypervisor.

Example

java -jar jrockitve-imagetool.jar -a myconfig.xml app

This command creates a virtual machine image that can be run on Oracle VM, by using the configuration parameters specified in the myconfig.xml file. The resulting virtual machine image is created in the app directory.

Related Options

-c (--create-config)

-d (--disassemble)

-r (--reconfigure)