Manage VMware Cloud Director VSs

VMware Cloud Director virtual servers, built on a guest operating system, can be used to install and run software compatible with that operating system. Below you can view the list of the current functions you can perform with VMware Cloud Director virtual servers by means of OnApp Control Panel:

This document provides the information on how you can manage the virtual servers imported from your VMware Cloud Director. 

View Virtual Servers

To view all virtual servers deployed in the cloud:

  1. Go to your Control Panel > Cloud > Virtual Servers menu to see an overview of all virtual servers in the cloud.
  2. The page that loads will show the list of VSstogether with their: 
    • operating system - the OS on which the virtual server is based
    • label - the name of the virtual server. Click the label to see the VS details.
    • IP addresses - IP addresses assigned to the virtual server
    • disk size - disk size assigned to the virtual server in GB
    • RAM - RAM assigned to the virtual server in GB
    • backups - the number of snapshots and the space these snapshots occupy
    • CPU(s) - the number of CPU(s) included
    • power status - whether the VS is powered ON or OFF. Click the on/off buttons to change the status.
    • actions - click the Actions button next to the VS for the quick access to the list of VS actions:
      • reboot -  click this action to reboot the virtual server
      • shutdown - click this action to shut down the virtual server

You can access the details page of a vApp to which the virtual server is assigned from the VS's Overview page. To view the details of the vApp with which the VS is associated, click the Tools button on the VS Overview screen at Dashboard > Cloud > Virtual Servers > VS label > Tools > Go to vApp.

To be redirected to the VCD user interface from VS Tools menu: go to Dashboard > Cloud > Virtual Servers > VS label > Tools > Go to vCD UI.  

You can install VMware tools for your VSs to customize the guest operation system. To install VMware tools go to Dashboard > Virtual Servers > VS label > Tools > Install VMWare Tools. After that you can find VMware tools version at VS's Overview page. A VS must be powered on to install VMware Tools.

Ensure that Install VMWare Tools permission is on before managing VMWare tools. For more information about permissions refer to the Permissions section.


The Notes section lists brief comments or reminders for a VS. You can add either Admin's or User's notes. The Admin's note will be available to cloud administrators with the Any action with admin note permission enabled. Click the Actions button in the Notes section of the page to add admin's or user's note.

Service Add-ons

If you have the service add-on functionality enabled and service add-on is assigned to the VS, you can view it at the VS overview page together with the following details:

  • Label - the service add-on name (by clicking on it you can edit the service add-on)
  • Price - the service add-on price, set for this service add-on in the Service Add-on Store
  • Type - user or system
  • Status - whether the service add-on is active or not
  • Delete icon - you can unassign the Service Add-on from this Virtual Server by clicking the Delete icon.

To assign more service add-ons to the VS, click the "+" button at the upper right corner of the section. You will be redirected to the VS Overview > VMware Cloud Director VS Service Add-ons section of the VS options.

Edit Virtual Server

You can edit the label, CPU, and RAM resources for all VCD virtual servers. You can allocate more CPU and RAM without rebooting a virtual server. When you hot add more RAM to virtual servers with Linux 64-bit or Windows 7 32-bit guest operating systems, the following conditions are applied:

  • If the powered-on VS has less than 3 GB of RAM, you cannot hot add more than 3 GB of RAM.
  • If the VS has 1 GB of RAM, you can add 2 GB.
  • If the VS has 2 GB of RAM, you can add 1 GB.
  • If the VS has 3444 MB of RAM, you can add 128 MB.
  • If the powered-on VS has 3 GB of RAM, you cannot hot add any more RAM.

To edit a VCD virtual server:

  1. Go to your Control Panel > Cloud > Virtual Servers menu.
  2. Click a label of the server that you want to edit.
  3. Click the Tools button and then click Edit Virtual Server.
  4. You can edit the following virtual server settings:
    • Label - edit the label of the virtual server
    • Virtual CPU hot add -select this checkbox to add CPU resources without rebooting the VS
    • Memory hot add select this checkbox to add RAM resources without rebooting the VS 
    • RAM - change the amount of RAM allocated to the VS
    • CPU Cores - change the number of CPU cores allocated to the VS
    • Cores per Socket - select the number of CPU cores per socket

      If the Virtual CPU hot add and Memory hot add checkboxes are selected, you can add RAM and CPU without rebooting a VS. If only one checkbox is selected but you change both RAM and CPU, the VS needs to be rebooted.

  5. Click the Save button.
  6. If rebooting is required to apply the settings, click the Continue button.

Insert/Eject Media

This option allows you to attach an ISO file from the media library to the VS allowing you to utilize the contents of the ISO.
To attach ISO to VS:

  1. Go to your Control Panel > Cloud > Virtual Servers menu.
  2. Click the label of the appropriate virtual server.
  3. Click the Tools button and select the Insert Media link.
  4. Choose the ISO file from the drop-down list.
  5. Click Insert.

To remove ISO from VS:

  1. Go to your Control Panel's Virtual Servers menu.
  2. Click the label of the appropriate virtual server.
  3. Click the Tools button and select the Eject Media link.
  4. Confirm by clicking the Eject button.
  • Maximum one ISO can be inserted per VS at a time.
  • Ensure that the Media permissions are on before enabling this option. For more information refer to the Permissions section.
  • Use only unique media file names. When you copy a media file from public catalogs, rename it (use a unique name) to avoid issues with media ejection.

  • You cannot insert floppy disk image files since they are no longer supported by VMware Cloud Director. 

Virtual Server Power Options

The power options available for VS depend on the current state of the virtual server. For example, a powered-on VS will have the Reboot, Suspend and Shut down options, while for a powered-off VS there will be the single option to Startup Virtual Server.

To manage your virtual server's power options:

  1. Go to your Control Panel > Cloud > Virtual Servers menu.
  2. Click the label of a required virtual server.
  3. Click the Tools button and select the required power option:
    • Startup Virtual Server - power on a powered-off virtual server
    • Reboot Virtual Server - reboot the virtual server
    • Shut down Virtual Server - power off the virtual server. A pop-up window will appear where you can select whether the VS should be powered off gracefully (Gracefully shutdown) or forcefully (Power Off). If you select the former option and the system fails to shut down the VS gracefully in the time period indicated in the Timeout Before Shutting Down VSs (30-600 sec) parameter at Settings > Configuration > System, the VS will be shut down forcefully.
    • Suspend - suspend the virtual server
    • Unsuspend - unsuspend the virtual server

      You can set custom timeouts that will be applied for executing the VS power actions and other VCD-related operations. For more information, refer to the Configuration Settings guide.

Virtual Server Console

You can use the MKS virtual server console to manage your virtual servers in the command line mode. To use the virtual server console:

  1. Go to the Control Panel > Cloud > Virtual Servers menu.
  2. Click a label of a virtual server.
  3. Click the Console button.

VMware Tools support shared folders and cut and paste operations between the guest operating system and the server from which you launch the VMware Cloud Director Web Console. VMware Cloud Director depends on VMware Tools to customize the guest OS. Using VMware Tools, you can move the pointer in and out of the virtual server console window. A virtual server must be powered on to install VMware Tools. 

To add VMware tools:

  1. Go to Control Panel > Cloud > Virtual Servers menu.
  2. Click the Label of appropriate Virtual Server.
  3. Click the Tools button > Add VMware Tools. You will be redirected to the VCD user interface, where you can install or upgrade VMware Tools. 

Set SSH Keys

  • This functionality is applicable to Linux-based VSs only.
  • The virtual server will be rebooted after setting SSH keys.
  • If a VS owner does not have any SSH keys, the system will only assign admin keys.
  • When you have more than one SSH key, you will have access to a list of available SSH keys containing SSH keys of a VS owner and SSH keys of a user who proceeds with such changes.
To set SSH keys for a virtual server: 
  1. Go to your Control Panel > Cloud > Virtual Servers menu.
  2. Click the label of the necessary virtual server.
  3. Click the Tools button and select thSet SSH keys option to assign SSH keys of the admin and a VS owner to the VS. 

  4. If available, select the SSH keys from the list of VS owner keys and user keys from the dropbox.

  5. Click the Set SSH keys button to confirm the action. 

Delete Virtual Servers

Shut down the virtual server before destroying it. To remove the virtual server from the cloud: 

  1. Go to your Control Panel > Cloud > Virtual Servers menu.
  2. On the screen that appears, you'll see the list of all virtual servers in the cloud. Click the label of the virtual server you want to delete.
  3. On the virtual server's screen, click the Tools button, then select Delete Virtual Server.
  4. Confirm deleting.