Skip Headers

Oracle® JRockit Virtual Edition User's Guide Release 2.0.0 Part Number E22518-01 |
Home | Contents | Contact Us

Previous | Next
| View PDF

# -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
--- | --- | ---
`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. Options are: `oraclevm` `virtualbox` (for development and evaluation purpose only) | Mandatory

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)