ovmtlibrary (1M)

Name

ovmtlibrary - Manage Oracle VM templates library

Synopsis

ovmtlibrary [-V] [-h | -H]

ovmtlibrary -c init [-f] [-q | -v] -l library

ovmtlibrary -c store [-d description] [-f] -l library [-n template-name] -o URI [-q | -v]

ovmtlibrary -c list [-a | -p | -o | -t type] -l library [-m] [-n template-name
  | -i template-id] [-q | -v] [-s [-e event-id]]

Description

The ovmtlibrary command enables you to manage Oracle VM templates information in the following ways:

• -c init initializes the library

• -c store stores a template

• -c list lists templates

The template archive file that is used to store templates requires the following:

• A file extension of .ova

• An XML configuration file that has a file extension of .ovf

• At least one IMG or ISO compressed disk image

At this time, the ovmtlibrary command can support templates only for disk images with the extension .img. So, ensure that you create disk images with the .img extension if you want to manage the template library with the ovmtlibrary command.

Note that an event ID is printed when you store a template. You can use this ID to check the status of a store operation.

Run the ovmtlibrary command as superuser on a system that runs at least the Oracle Solaris 11.1 OS and that has sqlite3 installed.

The ovmtlibrary command includes the following options:

–a

Lists all versions of the specified template or templates. By default, only the latest version is shown.

–c init

Initializes the template library.

–c store

Stores a template in the library.

–c list

Lists templates in the library.

–d description

Specifies a template description.

–e event-ID

Specifies the event ID for which to show the status of a store operation.

–f

Forces an overwrite of an existing library.

–h

Shows the help message.

–i template-ID

Specifies the ID of the template to list.

–l library

Specifies the path to template library.

–m

Produces output in machine-parseable format.

–n template-name

Specifies the template name.

For the store operation, this option specifies the template name to store. By default, the OVF name is used if this option is not specified.

For the list operation, this option specifies the template name to list. By default, the latest versions of all templates are shown.

–o URI

Specifies the URI of the template object to store. Valid URI values include file://, http://, and ftp://.

–o

Lists the objects for the specified template. You must specify the template name or template ID. If you specify a template name, only the objects in its latest version are listed.

–p

Shows property information for the template ID that you specify with the –i option.

–q

Suppresses headers and messages.

–s

Shows event status.

–t type

Specify an object type for a specified template. You must also specify the related template name or template ID.

–v

Shows detailed information.

–V

Shows version information about this command.

Exit Status

The following exit values are returned:

0

Successful completion.

1

An error occurred. Property value not set or property not found.

2

A usage error occurred.

Attributes

See the attributes(5) man page for a description of the following attributes.

Attribute Type Attribute Value Availability system/ldoms/ovmtutils Interface Stability Uncommitted

See also

ovmtconfig(1M), ovmtcreate(1M), ovmtdeploy(1M), attributes(5)

Oracle VM Server for SPARC 3.3 Administration Guide