Go to main content
Oracle® VM Server for SPARC 3.4 Reference Manual

Exit Print View

Updated: September 2016
 
 

ovmtadm (1M)

Name

ovmtadm - administer Oracle VM for SPARC templates

Synopsis

/opt/ovmtutils/bin/ovmtadm config

/opt/ovmtutils/bin/ovmtadm create

/opt/ovmtutils/bin/ovmtadm deploy

/opt/ovmtutils/bin/ovmtadm help

/opt/ovmtutils/bin/ovmtadm remove

Description

The ovmtadm command enables you to create, configure, deploy, and remove a template by initiating the ovmtcreate, ovmtconfig, and ovmtdeploy commands.

Run this command on the control domain of the system that contains the domain to configure.

You can configure only one domain at a time.

The ovmtadm command has the following subcommands:

config

Runs the ovmtconfig command. For information about command options, see the ovmtconfig(1M) man page.

create

Runs the ovmtcreate command. For information about command options, see the ovmtcreate(1M) man page.

deploy

Runs the ovmtdeploy command. For information about command options, see the ovmtdeploy(1M) man page.

help

Shows detailed help about the command.

remove

Runs the ovmtdeploy -U command. For information about command options, see the ovmtdeploy(1M) man page.

Exit Status

The following exit values are returned:

0

Successful completion.

1

An error occurred.

2

A usage error occurred.

99

An error in the execution of the commands file.

Examples

Example 1 Deploying a Template

The following example shows how to use the ovmtadm deploy command to deploy the ./ovmtutils_data/small-1.ova template to the ldg1 domain.

primary# /opt/ovmtutils/bin/ovmtadm deploy -d ldg1 ./ovmtutils_data/small-1.ova
executing wrapped command: /opt/ovmtutils/bin/ovmtdeploy -d ldg1 ./ovmtutils_data/small-1.ova 

Oracle VM for SPARC Deployment Utility
ovmtdeploy Version 3.4.0.0.13.1910
Copyright (c) 2014, 2015, Oracle and/or its affiliates. All rights reserved.

STAGE 1 - EXAMINING SYSTEM AND ENVIRONMENT
------------------------------------------
Checking user privilege
Performing platform & prerequisite checks
Checking for required services
Named resources available

STAGE 2 - ANALYZING ARCHIVE & RESOURCE REQUIREMENTS
---------------------------------------------------
Checking .ova format and contents
Validating archive configuration
Checking sufficient resources present
WARNING: Virtual switch primary-vsw0 already exists

STAGE 3 - EXTRACTING ARCHIVE
----------------------------
Extracting archive
Validating checksums
Decompressing disk image(s)

STAGE 4 - DEPLOYING DOMAIN
--------------------------
Creating domain and adding resources
Validating deployment
Example 2 Creating a Template

The following example shows how to use the ovmtadm create command to create the ./test.ova template from the ldg1 domain.

primary# /opt/ovmtutils/bin/ovmtadm create -d ldg1 -o ./test.ova -f -n
executing wrapped command: /opt/ovmtutils/bin/ovmtcreate -d ldg1 -o ./test.ova -f -n 

Oracle VM for SPARC Template Creation Utility
ovmtcreate        Version: 3.4.0.0.13.1910
Copyright (c) 2014, 2015, Oracle and/or its affiliates. All rights reserved.


STAGE 1 - EXAMINING SYSTEM AND ENVIRONMENT
-------------------------------------------
Performing platform & prerequisite checks
Checking user permissions
Checking for required packages
Checking for required services
Checking directory permissions

STAGE 2 - ANALYZING DOMAIN
---------------------------
Retrieving and processing attributes
Checking domain state
Getting domain resource settings
Discovering network topology
Discovering disk topology

STAGE 3 - ARCHIVE CREATION
---------------------------
Checking destination and current directory capacity
Compressing disk image
Creating XML configuration
Calculating manifest checksums
Creating archive file
Checking archive

PROCESS COMPLETED
------------------
Started: Fri Jan 15 10:40:53 PST 2016
Completed: Fri Jan 15 10:40:56 PST 2016
Elapsed time: 0:00:03
Example 3 Configuring a Domain

The following example shows how to use the ovmtadm config command to configure the ldg1 domain by setting the com.oracle.solaris.system.computer-name property value to system1.

primary# /opt/ovmtutils/bin/ovmtadm config -d ldg1 -v -p com.oracle.solaris.system.computer-name=system1
executing wrapped command: /opt/ovmtutils/bin/ovmtconfig -d ldg1 -v -p com.oracle.solaris.system.computer-name=system1 

Oracle VM for SPARC Configuration Utility
ovmtconfig        Version: 3.4.0.0.13.1910
Copyright (c) 2014, 2015, Oracle and/or its affiliates. All rights reserved.


STAGE 1/7 - EXAMINING SYSTEM AND ENVIRONMENT
--------------------------------
Checking operating system
Checking platform type
Checking user permissions
Checking packages
Checking host domain name
Checking host domain type
Checking services

STAGE 2/7 - PROCESSING COMMAND LINE OPTIONS
-------------------------------
Parsing individual properties
Creating consolidated properties list

STAGE 3/7 - ANALYZING TARGET DOMAIN
-----------------------

STAGE 4/4 - SETTING TARGET DOMAIN ENVIRONMENT
---------------------------------
Checking 1 properties to set as domain variables
Process completed
Example 4 Removing a Domain

The following example shows how to use the ovmtadm remove command to uninstall and remove the ldg1 domain.

primary# /opt/ovmtutils/bin/ovmtadm remove ldg1
executing wrapped command: /opt/ovmtutils/bin/ovmtdeploy -U ldg1 

Oracle VM for SPARC Deployment Utility
ovmtdeploy Version 3.4.0.0.13.1910
Copyright (c) 2014, 2015, Oracle and/or its affiliates. All rights reserved.

STAGE 1 - EXAMINING SYSTEM AND ENVIRONMENT
------------------------------------------
Checking user privilege
Performing platform & prerequisite checks

STAGE 2 - UNINSTALL DOMAIN
--------------------------
Stopping and unbinding domain
Removing virtual disks
Removing backend devices
Removing domain files
Uninstall completed

Attributes

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

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

See Also

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

Oracle VM Server for SPARC 3.4 Developer’s Guide