This section lists the changes and new features to the CLI in Release 3.3. In this release, a lot of changes have been introduced due to the move to the Web Services API.
A major change to the way in which the CLI interacts with Oracle VM Manager means that CLI-based transactions have changed in Release 3.3. From Release 3.3 onwards, if a CLI command that contains child operations fails, it is important to check the state of all objects affected by the parent and child operations. For example, during the creation of a server pool, the parent command calls a number of child operations. If any of these child operations fail, the command returns an error, but the server pool object may still be created by the parent operation. In this case, the server pool object must be removed manually before attempting to create the server pool again.
This section lists the modifications made to existing CLI commands.
Table 1.1 CLI Modifications in Release 3.3
Object Type | Description |
---|---|
The getEvents command has a completely different syntax. | |
AccessGroup |
The
edit AccessGroup
command now includes a Note This change was introduced after the initial release of Oracle VM 3.3, so may not be available if you are not running the latest patched version of this release. |
AccessGroup (was NfsAccessGroup) |
The
|
Assembly | The createTemplatesFromAssembly command has been removed and replaced with the new createVmFromAssembly command. |
Assembly, VirtualCdrom, VirtualDisk, Vm |
The following commands no longer require or have the
|
BondPort, Port, VlanInterface |
The
|
BondPort, Port | The commands to manage ports and bond ports have changed. The following commands have been significantly modified: |
FileServer |
The
create FileServer
and
edit FileServer
commands no longer have the
|
FileServer |
The
The removeNfsRefreshServer command
has been renamed to
removeRefreshServer,
and the |
Job | The getJobsUsingRange and getLatestNumberOfJobs commands have been removed and are no longer available. Instead, use the getJobs command. |
Network |
The
create Network
option to create a local network on an Oracle VM Server,
|
PhysicalDisk |
The |
PhysicalDisk, VirtualDisk |
The
edit PhysicalDisk
and
edit VirtualDisk
commands no longer have the |
Repository | The create Repository command has significantly changed to allow a repository to be created only on a file system and no longer allows you to create a repository on a physical disk. |
Repository |
The
edit Repository
command has removed the |
Server |
The
discoverServer
command |
Server |
The
add Server
command options
The
remove Server
command options |
Server |
The
The |
Server |
The setNtp,
showNtp and
syncNtp commands have been removed.
Instead, use the
edit Server
command with the new |
Server | The initiateYumUpgrade command has been removed. Instead, use the upgrade command to update the software on an Oracle VM Server. |
ServerPool |
The
create ServerPool
and
edit ServerPool
commands |
StorageArray (was SanServer) |
The
Other commands that relate to this object type, such
as commands specific to |
StorageArray |
The
create StorageArray
and
edit StorageArray
commands have different values for the
|
VlanInterface (was VlanGroup and VlanSegment) | The commands to manage VLANs have changed. You should now use the VlanInterface object type instead of the VlanGroup and VlanSegment object types. The following commands have been removed:
The following commands have been modified to remove
the
The following commands have been modified to remove
the
The
edit VlanInterface
command no longer has the options
|
Vm | The add Vm and remove Vm commands have additional syntax options and functions. In addition to adding or removing a virtual machine to/from an Oracle VM Server, you can now add or remove a virtual machine to/from a server pool or an anti affinity group. |
Vm |
The
clone Vm
command |
VmDiskMapping |
The
create VmDiskMapping
command has changed. Instead of specifying the
|
Vnic |
You can no longer add a VNIC to a virtual machine. To
support this change, the
add Vnic
command no longer allows to add a VNIC to a virtual
machine. Instead, you may add a VNIC to either a
|
Vnic |
The
create Vnic
command has a completely different syntax. The command
now uses syntax that forces the specification of the
virtual machine to which the VNIC must be attached.
The
edit Vnic
command no longer allows you to specify the network
(the |
Vnic | The vnicCreate command to create multiple VNICs has been removed as VNICs can no longer exist within Oracle VM Manager outside of the context of a virtual machine. |
Vnic | The show command can now take either the ID or name of a VNIC to display the properties of a VNIC object. Previously, you could only use the VNIC name. |
Vm | The getIncompatibleReasons command is no longer available. |
Vm |
The
create Vm
command syntax to create a virtual machine on an
Oracle VM Server has changed. A new |
YumConfig | The edit yumConfig command is no longer available. Instead, use the create ServerUpdateRepository command to set a YUM repository for Oracle VM Server software updates. The show YumConfig command has also been removed. |
This section lists the new commands introduced in Release 3.3.
Table 1.2 CLI New Features in Release 3.3
Object Type | Description |
---|---|
N/A |
The
set
command now includes options to set the
|
N/A | The setStatsConfig and getStatsConfig commands set and display the statistics information displayed in Oracle VM Manager. |
N/A | The getDebugTranscript command displays the debug transcript of a job. |
All | The getEventsForObject command displays the events for an object. |
All | The getTriageEvent command displays the highest severity event for an object. |
AccessGroup |
The
refresh
command has a new |
AntiAffinityGroup |
The
create AntiAffinityGroup
command provides a way to create an anti affinity
group for virtual machines in a server pool. There is
also an
edit AntiAffinityGroup
to edit an anti affinity group. The
add Vm
and
remove Vm
commands now allow you to add and remove virtual
machines to and from an anti affinity group
respectively using the
The
show,
list,
and
delete
commands include the
|
Assembly | A new createVmFromAssembly command replaces the now removed createTemplatesFromAssembly command. |
Assembly | A new getDescriptor command lists the contents of the OVF descriptor file for the assembly. |
AssemblyVirtualDisk | A new command edit AssemblyVirtualDisk allows you to edit an AssemblyVirtualDisk object type.
The
show,
and
list,
commands now have the
|
AssemblyVm | A new command edit AssemblyVm allows you to edit an AssemblyVm object type.
The
show,
and
list,
commands now have the |
Assembly, VirtualCdrom, VirtualDisk, Vm |
The following commands include a
|
Bond, BondPort, VlanInterface | Three new commands allow editing of the ipAddressConfig object, which is an object associated with a parent network-related object that cannot be accessed directly with other CLI commands. This allows you to configure IP addresses on a port, bond port or VLAN interface. The new commands are: |
ControlDomain | A new edit ControlDomain command allows you to edit the ControlDomain object type.
The
show,
and
list,
commands now have a |
Cpu | A new edit Cpu command allows you to edit the Cpu object type.
The
show,
and
list,
commands now an have a |
CPUCompatibilityGroup |
New commands to access the
Commands that contain a new
|
FileServer |
The
create FileServer
command includes two new options to set
|
FileServer |
The
edit FileServer
command includes a new |
FileServer, StorageArray | The addAdminServer command allows you to add an administrative Oracle VM Server to a file server or storage array. There is also a new removeAdminServer command that allows you to remove an administrative Oracle VM Server from a file server or storage array. |
FileServer, FileSystem | The create FileSystem command creates an OCFS2 file system on a physical disk on a file server. |
FileServerPlugin | A new edit FileServerPlugin command allows you to edit the FileServerPlugin object type.
The
show,
and
list,
commands now an have a
|
Job | A new getJobs command lists jobs. A new getQueuedJobInfo command lists information about a queued job. |
Manager | A new edit Manager command allows you to edit the Manager object type.
The
show,
and
list,
commands now an have a |
PeriodicTask | A new edit PeriodicTask command allows you to edit the PeriodicTask object type.
The
show,
and
list,
commands now an have a |
PhysicalDisk |
The
create PhysicalDisk
command has a new mandatory
|
PhysicalDisk, VirtualDisk | The resize command resizes a physical or virtual disk. |
Repository | The show command with the Repository option displays a new parameter to show the share path. |
RepositoryExport | The create RepositoryExport command provides a way to create a repository export to enable back up of an OCFS2-based storage repository.
The
show,
list,
and
delete
commands now have a The show Server command now lists the repository exports on an Oracle VM Server. |
Server | The setMaintenanceMode command sets whether an Oracle VM Server is in maintenance mode. |
Server | The create ServerUpdateGroup command creates an object to contain a repository for updating the software on Oracle VM Servers. This group can be associated with a single server pool. There is also an associated edit ServerUpdateGroup command.
The
show,
list,
and
delete
commands include the
|
Server | The create ServerUpdateRepository command sets a repository for updating the software on Oracle VM Servers. This repository is then used in a server update group. There is also an associated edit ServerUpdateRepository command.
The
show,
list,
and
delete
commands include the
|
Server | The checkUpToDate command checks whether the Oracle VM Server software is up-to-date, according to the server update repository. |
Server |
The
edit Server
command now includes the |
Server | The show command with the Server option displays several new parameters:
|
Server | The changeServerAgentPassword allows you to change the Oracle VM Agent password on an Oracle VM Server. |
Server, FileServer, StorageArray | The refreshAll command rediscovers all Oracle VM Server instances, file servers, and storage arrays. |
Server, Repository | A new takeOwnership command provides a way to take ownership of an Oracle VM Server or storage repository. There is also an associated releaseOwnership command. |
ServerController | A new create ServerController command provides a way to configure IMPI on an Oracle VM Server. There is also an associated edit ServerController command.
The
show,
list,
and
delete
commands include the |
ServerPool |
The
create ServerPool
and
edit ServerPool
commands have new options for setting the cluster
timeout ( |
ServerPool |
The
add ServerPool
command has a new |
ServerPoolNetworkPolicy | The create ServerPoolNetworkPolicy and edit ServerPoolNetworkPolicy commands provide a way manage the network policy for a server pool. The addPolicyServer and removePolicyServer commands allow to you add a policy server to a server pool, or to remove one.
The
show,
list,
and
delete
commands now have a
|
StorageArray |
The
create StorageArray
command includes a |
StorageArray |
The
create StorageArray
and
edit StorageArray
commands have a new |
StorageArray |
The
edit StorageArray
command includes a new |
StorageArray | The validate command validates a storage array using the storage array plug-in. Validation is required after the storage array is discovered and after modification of storage array attributes. |
StorageArrayPlugin | The edit StorageArrayPlugin command allows you to edit the StorageArrayPlugin object type.
The
show,
and
list,
commands now an have a
|
VirtualCdrom |
The
edit VirtualCdrom
command now includes a |
VlanInterface | The commands to manage VLANs have changed significantly. The following commands have been introduced:
The following commands now include a
|
Vm |
The
create Vm
and
edit Vm
commands have an new
The
create Vm
and
edit Vm
commands have an new |
Vm |
The
add Vm
and
remove Vm
have a |
Vm | New commands are available to list all, or clear one or all messages sent or received by a virtual machine: |
Vm | The getVmOsTypes command displays the operating system types used when creating or editing a virtual machine. |
Vm | The getVmCfgFileContent command displays the contents of the virtual machine configuration file. |
Vm, Repository | The moveVmToRepository command allows you to move a virtual machine to another storage repository. |
VmCloneCustomizer, VmCloneNetworkMapping, VmCloneStorageMapping | The ability to add and manage virtual machine clone customizers is now available in the CLI. This includes the introduction of three new object types:
As with most object types, you can use the respective create, edit, delete, show, and list commands to manage these new object types: This feature also facilitates a variety of cloning options. Newly added cloning commands are:
The
clone Vm
command also has a new
|
Vnic | The setVnicMacAddrRange command changes the range of MAC addresses that are available to use for newly created VNICs. The getVnicMacAddrRange lists the MAC address range. |
This section lists the changes to the attributes of CLI objects
in Release 3.3.1. The attribute changes affect the output of the
show command, and the options available with
create object
and
edit object
commands.
Table 1.3 CLI Object Attributes Changes in Release 3.3.1
Object | Attributes Added | Attributes Removed | Attributes Modified |
---|---|---|---|
AccessGroup | agType storageArray fileSystems servers fileServer locked | sanServer |
Attribute description's display name has changed. Old
display name is |
Assembly | origin locales assemblyVms assemblyVirtualDisks locked |
Attribute repository's display name has changed. Old
display name is
Attribute description's display name has changed. Old
display name is | |
BondPort | ipAddressConfig network portType vlanInterfaces locked | ethernetPort1 ethernetPort2 addressType ipAddress netMask |
Attribute description's display name has changed. Old
display name is |
FileServer | fstype storageDescription refreshServers server locked | nfsRefreshServers adminHost adminUserName adminPassword |
Attribute uniformedExports's display name has changed.
Old display name is
Attribute description's display name has changed. Old
display name is |
FileSystem | clusterId fileServers accessGroup physicalDisk shared locked | fileServer |
Attribute description's display name has changed. Old
display name is |
Job | runState summaryState done summaryDone jobGroup childJobs creationTime creationTimeLong startTimeLong endTimeLong durationDouble progressMessage abortedUser isAborted isAbortable id name locked | uniqueId timestamp status | |
ManagedObj | locked |
Attribute description's display name has changed. Old
display name is | |
Network | isLocal mtu roles vlanInterfaces locked | vlanSegment |
Attribute description's display name has changed. Old
display name is |
PhysicalDisk | deviceNames storageTargetNames page83Id qos serverReserved state status pdtype userFriendlyName vendor accessGroups fileSystems reservingServers vmDiskMappings locked | sanserver |
Attribute volumeGroup's display name has changed. Old
display name is
Attribute description's display name has changed. Old
display name is |
Port | ipAddressConfig network bondPort portType vlanInterfaces locked | addressType ipAddress netMask |
Attribute description's display name has changed. Old
display name is |
Repository | managerUuid repoPresented virtualCdroms locked | serverPool physicalDisk ownership VirtualCdroms templates |
Attribute fileSystem's display name has changed. Old
display name is
Attribute description's display name has changed. Old
display name is |
Server | roles runVmsEnabled agentLogin statisticInterval ntpServers biosVendor biosVersion biosReleaseDate processorType populatedProcessorSockets threadsPerCore coresPerProcessorSocket totalProcessorCores enabledProcessorCores usableMemory noExecuteFlag ovmVersion hostName managerUuid serverAbilities productSerialNumber upToDate controlDomains cpus controllers repositoryExports networks fileServerPlugins storageArrayPlugins storageArray storageArrayPlugin fileServerPlugin refreshFileServers AccessGroups locked | MACAddress numProcessors numISCSIPorts numEthernetPorts numFibrePorts memoryOverhead networkFailOverGroupsCount architectureType serialNumber processorFamily processorModel takeOwnership l1CacheSize l2CacheSize l3CacheSize BIOSVersion BIOSReleaseDate socketsAvailable socketsFilled managerUUID version |
Attribute ipAddress's display name has changed. Old
display name is
Attribute memory's display name has changed. Old
display name is
Attribute cpuCompatibilityGroup's display name has
changed. Old display name is
Attribute tags' display name has changed. Old display
name is
Attribute description's display name has changed. Old
display name is |
ServerPool | antiAffinityGroups clusterTimeout policyId clusterId heartbeatDeviceId managerUuid poolFileSystem policyMode policyCpuEnable policyPeriod policyCpuThreshold policyServers networkPolicies serverUpdateGroup locked |
Attribute tags' display name has changed. Old display
name is
Attribute startPolicy's display name has changed. Old
display name is
Attribute description's display name has changed. Old
display name is | |
StorageInitiator | accessGroupIds initType fcFabricName fcPortId fcPortType fcPortSpeed fcSupportedSpeeds fcNodeName locked |
Attribute description's display name has changed. Old
display name is | |
Tag | locked |
Attribute description's display name has changed. Old
display name is | |
VirtualCdrom | vmDiskMapping shareable assemblyVirtualDisk importFileName locked | vms |
Attribute description's display name has changed. Old
display name is |
VirtualDisk | file mountPoint vmDiskMapping assemblyVirtualDisk importFileName locked | status vms |
Attribute description's display name has changed. Old
display name is |
VlanInterface | interfaceName port portType vlanId ipAddressConfig network macAddress locked | vlansegment addressType ipAddress netMask |
Attribute description's display name has changed. Old
display name is |
Vm | currentMemory currentCpuCount startPolicy bootOrder diskLimit hugePagesEnabled serverPool vmCloneCustomizers locked | cpuCompatibilityGroupName networkBootPath |
Attribute tags' display name has changed. Old display
name is
Attribute description's display name has changed. Old
display name is |
VmDiskMapping | slot virtualDisk virtualCd physicalDisk locked | storageDevice |
Attribute vm's display name has changed. Old display
name is
Attribute description's display name has changed. Old
display name is |
Vnic | ipAddresses interfaceName locked | ipAddress |
Attribute vm's display name has changed. Old display
name is
Attribute network's display name has changed. Old
display name is
Attribute description's display name has changed. Old
display name is |
VolumeGroup | allocatedSize volumeDescription storageArray locked | sanserver |
Attribute description's display name has changed. Old
display name is |