Actions are changes that you can make to provisioned resources. The vRealize Automation actions are used to manage the life cycle of the resources.

The options on the Action menu for a provisioned item include the actions specified on the blueprint and might include custom menu operations created by your service architects. The available actions depend on how your business group manager or tenant administrator configured the entitlement that contains the resource on which the actions run.

Table 1. Action Menu Options

Action

Resource Type

Description

Associate Floating IP

Machine (OpenStack)

Associate a floating IP address with an Openstack machine.

Cancel Reconfigure

Machine

Cancel a running reconfiguration action.

Change Lease

Deployment and Machine

Change the number of days remaining in the lease for either a specific machine or for all resources included in a deployment. If you do not provide a value, the lease does not expire.

Change Owner

Deployment

Change the owner of the deployment and all the included resources. Only Business group managers and support users can change the ownership of a deployment.

The machine must be in the On, Off, or Active state when you initiate the change owner action or the action fails with the following message:

The action is invalid for the machine.

Connect using VMRC

Machine

Connect to the virtual machine using a VMRC 8.x application.

To use this action, the VMRC application must be installed on the local system of the service catalog user who is running the action.

For installation and user instructions, see VMware Remote Console Documentation. To download, see Download VMware Remote Console.

The VMRC 8.x replaces the previous VMware Remote Console.

Connect to remote console

Machine

Connect to the selected machine using VMware Remote Console.

The virtual machine console appears in the browser. The VMRC 8.x replaces the VMware Remote Console.

Connect using Console Ticket

Machine (OpenStack and KVM)

Connect to the OpenStack or KVM virtual machine using a console ticket for a VMware Remote Console connection.

Connect using ICA

Machine (Citrix)

Connect to the Citrix machine using the Independent Computing Architecture.

Connect using RDP

Machine

Connect to the machine by using Microsoft Remote Desktop Protocol.

Connect using SSH

Machine

Connect to the selected machine by using SSH.

The Connect Using SSH option requires that your browser has a plug-in that supports SSH, for example the FireSSH SSH terminal client for Mozilla Firefox and Google Chrome. When the plug-in is present, selecting Connect Using SSH displays an SSH console and prompts for your administrator credentials.

To use this action, the Machine.SSH custom property must be included and set to true in the blueprint's machine component in either a property group or individual custom property.

Connect using Virtual Desktop

Machine

Connect to the selected machine using Microsoft virtual desktop.

Create Snapshot

Virtual Machine

Create a snapshot of the virtual machine. If you are allowed only two snapshots and you already have them, this option is not available until you delete a snapshot.

Delete Snapshot

Virtual Machine

Delete a snapshot of the virtual machine.

Destroy

Cloud Machine, Deployment, Virtual Machine, and VMware NSX Edge

Immediately destroy a provisioned resource. You must run this action to destroy XaaS resources, even if they are part of a deployment you are destroying. Other resources are destroyed when their lease or their archival period ends.

With the exception of XaaS, destroying components of a deployment is not a recommended best practice. It is recommended to use the scale in action to reduce the number of machines in your deployment, or destroy the entire deployment.

The Destroy action is not available for the following deployment situations:

  • physical machine deployments

  • deployments with an NSX existing network or NSX existing security resource

  • deployments with an NSX on-demand load balancer resource

Because an NSX load balancer is property of an on-demand NSX edge, when an NSX edge is destroyed, the load balancer resource is also destroyed and resources are released. When a machine tier that is load balanced is destroyed, it is removed from the load balancer pool on the respective NSX edge.

Note:

Note: Storage and memory that are assigned to a provisioned machine by a reservation are released when the machine to which they are assigned is deleted in vRealize Automation by the Destroy action. The storage and memory are not released if the machine is deleted on the vCenter Server.

When destroying a deployment that contains an Amazon machine component, all EBS volumes that were added to the machine during its life cycle are detached, rather than destroyed. vRealize Automation does not provide an option for destroying the EBS volumes.

Destroy Existing Network

Existing Network

Destroy the network.

Destroy VMWare NSX Load Balancer

VMWare NSX Load Balancer

Destroy the NSX load balancer.

Destroy VMWare NSX Network

VMWare NSX Network

Destroy the NSX network.

Destroy VMWare NSX Security Group

VMWare NSX Security Group

Destroy the NSX security group.

Destroy VMWare NSX Security Tag

VMWare NSX Security Tag

Destroy the NSX security tag.

Disassociate Floating IP

Machine (Openstack)

Remove the floating IP from the Openstack machine.

Execute Reconfigure

Machine

Override a scheduled reconfiguration, or rerun or reschedule a failed reconfiguration.

Expire

Deployment and Machine

Terminate the deployment or machine lease for all resources included in the deployment.

Export Certificate

Machine

Export the certificate from a Cloud machine.

Get Expiration Reminder

Machine

Downloads a calendar event file for the current lease expiration date.

Install Tools

Machine

Install VMware Tools on a vSphere virtual machine.

Power Cycle

Machine

Power off the machine, then power it back on.

Power Off

Machine

Power off the machine without shutting down the guest operating system.

Power On

Machine

Power on the machine. If the machine was suspended, normal operation resumes from the point at which the machine was suspended.

Reboot

Machine

Reboot the guest operating system on a vSphere virtual machine. VMware Tools must be installed on the machine to use this action.

Reconfigure

Machine

A business group manager, support user, or machine owner can reconfigure the following machine settings on a vSphere machine:

  • Change description

  • Change CPU, memory, network, and disk settings

  • Add, edit, and delete properties

  • Reconfigure shutdown

  • Change machine owner (Business group managers and support users only)

You cannot change a storage reservation policy if doing so would change the storage profile on a disk.

Register VDI

Virtual Machine (XenServer)

Register the virtual disk image on XenServer items.

Reprovision

Machine

Destroys the machine, then initiates the provisioning workflow to create a new machine with the same name.

When you request that a machine be reprovisioned, a known issue might cause vRealize Automation to display the reprovisioning status as Complete in the catalog, when the actual state is In Progress. After you submit a request to reprovision a machine, you can use any of the following sequences to check the status of the reprovisioned machine:

  • Infrastructure > Managed Machines

  • Items > Item Details

  • Administration > Events > Event Logs

Revert Snapshot

Virtual Machine

Revert to a previous snapshot of the machine. You must have an existing snapshot to use this action.

Scale In

Deployment

Destroy unneeded instances of machines in your deployment to adjust to reduced capacity requirements. Machine components and any software components installed on them are destroyed. Dependent software components and networking and security components are updated for the new deployment configuration. XaaS components are not scalable and are not updated during scale operations.

You can try to repair partially successful scale operations by attempting to scale the deployment again. However, you cannot scale a deployment to its current size, and fixing a partially successful scale this way does not deallocate the dangling resources. You can view the request execution details screen and find out which tasks failed on which nodes to help you decide whether to fix the partially successful scale with another scale operation. Failed and partially successful scale operations do not impact the functionality of your original deployment, and you can continue to use your catalog items while you troubleshoot any failures.

Scale Out

Deployment

Provision additional instances of machines in your deployment to adjust to growing capacity requirements. Machine components and any software components installed on them are provisioned. Dependent software components and networking and security components are updated for the new deployment configuration. XaaS components are not scalable and are not updated during scale operations.

You can try to repair partially successful scale operations by attempting to scale the deployment again. However, you cannot scale a deployment to its current size, and fixing a partially successful scale this way does not deallocate the dangling resources. You can view the request execution details screen and find out which tasks failed on which nodes to help you decide whether to fix the partially successful scale with another scale operation. Failed and partially successful scale operations do not impact the functionality of your original deployment, and you can continue to use your catalog items while you troubleshoot any failures.

Shutdown

Machine

Shut down the guest operating system and power off the machine. VMware Tools must be installed on the machine to use this action.

Suspend

Machine

Pause the machine so that it cannot be used and does not consume any system resources other than the storage it is currently using.

Unregister

Machine

Remove the machine from the inventory without destroying it. Unregistered machines are not usable.

Unregister VDI

Virtual Machine (XenServer)

Unregister the virtual disk image on XenServer items.