Create and Manage vApps

A vCloud Director vApp consists of one or more virtual servers that communicate over a network and use resources and services in a deployed environment. A vApp can contain multiple virtual servers. To view the list of the current vApp functions you can perform in OnApp Control Panel refer to the Supported Functionality section of this guide.

This document provides the information on how you can manage the vApps imported from your vCloud Director. 

 

On this page:

View vApps


 

To view all vApps in the cloud:

  1. Go to your Control Panel's vApps menu to see an overview of all vApps in the cloud.
  2. The page that loads will show the list of vApps together with their details: 
    • Name - the name of the vApp

    • User - the owner of the vApp. Click the user name to see the owner details. The owner of the vApp can be changed in vCloud Director. These changes are synchronized with OnApp and can be seen in Control Panel > vApps menu.

    • Resource pool - the label of the resource pool of this vApp

    • Number of virtual servers - the number of virtual servers within the vApp

    • Number of networks - the amount of vApp networks associated with this vApp

    • Power - the power status of the vApp. Click the on/off buttons to change the status. After the vApp is created or imported, its status will be Building, until the creation/import process is finished. On the overview screen of a specific vApp, its status will be shown as Pending. The user cannot perform any actions to the pending vApp except for deleting it.

    • Actions - click the Actions button to perform one of the following processes on the vApp:
      • Edit
      • Recompose
      • Add to Catalog
      • Spin up Network
      • Stop/Start

vApp Details

Click the name of the vApp to view its details:

  • Name - the name of the vApp
  • Status - the status of the vApp. A vApp can have the following statuses:
    • FAILED_CREATION - the vApp could not be created
    • UNRESOLVED - the vApp is damaged and cannot be controlled by vCloud
    • RESOLVED - the vApp has been created but it does not contain VSs
    • SUSPENDED - the vApp has been suspended
    • POWERED_ON - all the VSs in the vApp are on
    • WAITING_FOR_INPUT - the vApp is waiting for user input
    • UNKNOWN - the vApp is in a state that is identified but is not known to the system
    • UNRECOGNIZED - the vApp is in a state that cannot be identified by the system
    • POWERED_OFF - all the VSs in the vApp are on
    • INCONSISTENT_STATE - the vApp is in an inconsistent state. This status appears when the vApp was edited from the vSphere associated with the vCD in which the vApp resides, therefore, the vSphere and vCD databases are not yet fully synchronized.
    • MIXED - the VSs in the vApp have different power statuses: some are on and some are off
  • Virtual servers - the number of virtual servers within the vApp
  • Number of CPUs - the number of CPUs used by the vApp
  • Virtual Servers - the list of VSs associated with this vApp and their details. By pressing the "+" button you can recompose this vApp.
  • vApp Networks - the list of vApp networks associated with this vApp and their details: label, status, network address. Click the Actions button to delete a vApp network. Removing the network will restart the vApp.
  • Activity log - the list of log items associated with this vApp. Click the Ref number of a log item to view its details (data, action, status, initiator of transaction etc.)

Alternatively, you can access the details page of a particular vApp from the Overview page of a VS assigned to this vApp. To view the details of the vApp with which the VS is associated, click the Tools button on the VS Overview screen at Dashboard > Virtual Servers > label of the VS you are interested in > Tools > Go to vApp.

 

Create vApps


 

You can create a new vApp based on a vApp template stored in a catalog to which you have access. Alternatively, you can compose a new vApp using virtual servers from vApp templates, new virtual servers, or a combination of both.

You cannot add vApps when being logged in as a non vCloud Director user.

Deploy New vApp


 

To create a new vApp:

  1. Go to your Control Panel's vApps menu to see an overview of all vApps in the cloud.
  2. Click the Deploy New vApp button. If a new vApp template is created and added to catalog in vCloud Director, it will be  synchronized with OnApp. This vApp template will be added to the list of all vApp templates.
  3. On the screen that appears, fill in the vApps creation form:

    vApp Template and Location

    • name - specify the vApp label
    • vApp Template - select the vApp template

    • vDC - select the virtual data center
    • Network - the network(s) that will be associated with the vApp
    • Click Next.

    Configure resources

    • Label - the name of template
    • Virtual cores - use the slider to set the number of virtual cores 
    • Cores per socket  - set the number of cores per socket for vApp
    • Total memory - use the slider to set the total memory for vApp
    • Data Store - choose data store from the drop-down list
    • Hard disk 1 Size - set the size in GB
    • NIC 0 Connection - the network to which the NIC will be connected


  4. Click Submit to finish the vApp creation process.


 

Compose vApp


 

To compose a new vApp:

  1. Go to your Control Panel's vApps menu to see an overview of all vApps in the cloud.
  2. Click the Compose vApp button.
  3. On the screen that appears, fill in the form:

    • Create Blank vApp - move the slider to the right if you want to create a blank vApp. Such a vApp will not contailn any virtual servers. You need to fill in only the Name and vDC  fields for a blank vApp.
    • Name - specify the vApp label
    • vDC - select the virtual data center
    • vApp Templates - select one or several vApp templates from the drop-down list. All VSs, built on those templates, will be copied to your new vApp.

    • VApps - select one or several vApps from the drop-down list. All VSs within selected vApps will be copied to your new vApp.

  4. Click the Compose button.

 

Recompose vApp


 

Unlike a Compose vApp option, which helps you to create a new vApp, the Recompose vApp option allows you to modify an existing vApp.

To recompose vApp:

  1. Go to Control Panel > vApps menu.
  2. Click the Actions button next to the vApp you want to change, then click Recompose.
  3. On the screen that appears, select an option from drop-down menu in field vApp Template.
  4. Click the Recompose button.

Add vApp to Catalog


 

To add a vApp to catalog:

  1. Go to Control Panel vApps menu.
  2. Click the Actions button next to the vApp you want to add to catalog, then click Add to Catalog.
  3. Fill in the following fields:

    • Catalog - choose the catalog from the drop-down menu
    • Overwrite Catalog Item - move the slider to the right to save this vApp as template instead of another vApp template. In the Target vApp Template fileld choose the appropriate vApp template, which will be replaced, from the drop-down menu.
    • Label - specify the name of the vApp. This option is missing if the Overwrite catalog item slider is enabled.
    • Description - add the appropriate vApp description
  4. Click Add vApp to Catalog.

After you add a vApp to catalog, you will be able to create a new vApp with the same configuration as the original one.

Prerequisites

Ensure that Convert vApp permission is on before adding vApp to catalog. For more information about permissions refer to the Permissions section of this guide.

Edit vApp


 

To edit a vApp:

  1. Go to Control Panel > vApps menu.
  2. Click the Actions button next to the vApp you are interested in, then click Edit.
  3. On the screen that appears, you can edit the name of the vApp.
  4. Click Save.

 

Start/Stop vApps


 

 

To start or stop a vApp in the cloud:

  1. Go to your Control Panel's vApps menu to view all vApps.
  2. Click the Actions button next to the required vApp, then choose Start or Stop action.

Delete vApps


 

To delete a vApp in the cloud:

  1. Go to your Control Panel's vApps menu to view all vApps.
  2. Click the Actions button next to the required vApp.
  3. If the vApp is running, then choose the Stop action.
  4. When the vApp is stopped, click Delete.