Create and Manage Organizations

This document applies to OnApp 5.6 and later versions.

In vCloud, an organization is a unit of administration for a collection of users, groups, and computing resources. Users authenticate at the organization level, supplying credentials established by an organization administrator when the user was created or imported. System administrators create and provision organizations, while organization administrators manage organization users, groups, and catalogs.

vCloud organizations when imported into OnApp are associated with user groups. User groups define the bucket under which the users in the organization are billed. You can view/create/delete organizations at the OnApp Control Panel.

When an organization is created or deleted at the OnApp Control Panel, it is synchronized with vCloud Director and a new organization is created or deleted in vCD.


View Organizations



To view vCloud Director organizations:

  1. Go to your Control Panel's Organizations menu.
  2. Click an organization's label to see the compute resource and the user group the organization is associated with.
  3. Click the number of users to see the list of users assigned to this user group.


Create Organizations



To create a new organization:

  1. Go to Control Panel > Organizations and click Add new Organization
  2. On the page that loads, fill in the following parameters:
    • Label - the name of the organization
    • Compute Resource - the vCD compute resource with which the new organization is to be associated
    • Automatically create User Group? - whether you wish to create a new user group with which this organization will be associated. If you enable this slider, a new user group with the label of this organization will be created and will contain this organization. If you do not enable this option, you can associate this organization with an already existing user group. 

      Note that your existing user group should have at least one company billing plan and user billing plan assigned. Otherwise, the organization creation will fail.


    • User Group - the user group with which this organization is to be associated. This parameter applies only if you disable the Automatically create User Group? slider.
    • Company Billing Plan - the bucket for the user group that is to be created once to create this organization. This parameter applies only if you enable the Automatically create User Group? slider.
  3. Click Submit to save create the new organization.


Import Organizations



When importing vCD resources you can choose whether you wish your users to be associated with one or several vCloud Director instances. If you wish your users to have access to multiple vCloud Director instances, you can set up several organizations in OnApp to be associated with a single user groups and have access to resources across multiple vCD instances. For such configuration, vCD compute resources should be imported in multiple vCloud Director mode at Control Panel > Settings > Compute Resources > Add New Compute Resource. In this mode you select which organization is imported and is associated with a certain user group. After the initial import, changes to the organization will be synchronized between vCD and OnApp.

To import an organization:

  1. Go to Control Panel > Settings > Compute Resources > Label.
  2. The page that loads shows the details of your vCD compute resource. Click Tools and select Import Organization from vCloud.
  3. Move the Import slider to the right next to the organization(s) you wish ti import.
  4. Select a user group to which you wish to assign the organization in the Assign to User Group field. If you do not select a user group but enable the Importslider, a new user group will be created for this organization. If you select a user group that is already associated with one or several organizations, the users from the new organization will be created in the already present organizations and the users from the already present organizations will be created in the new user group.
  5. Click Submit to import the organizations.


Delete Organizations



To delete an organization:

  1. Go to Control Panel > Organizations
  2. Click the Actions icon next to the organization you wish to remove
  3. Select Delete. Once the organization is removed in OnApp it will also be removed in vCD.


User Groups



Organizations are associated with OnApp user groups. If there are several organizations associated with one user group, the users from one organization will be created in other organizations in the user group. In this case, users will have access to multiple vCD instances. User groups define the bucket under which the users in the organization are billed.

To give users access to multiple vCD instances, you need to select the multiple vCloud Director mode for the vCD compute resource during import configuration.

View User Groups




For vCloud Director Organizations the following parameters are displayed on the user group details page at Control Panel > Groups:

  • Roles - the list of roles, assigned to users of the user group
  • Organizations - vCloud user groups
  • Bucket - the bucket assigned to this user group
  • User Buckets - bucket available for the users of this group
  • Monthly fee-  the money amount which has to be paid on a monthly basis according to the bucket
  • Price per hour - the price per hour including the total for all resources that are billed on an hourly basis for the last hour 
  • Paid Amount - the already paid money amount
  • Total Amount - the total money amount according to the bucket
  • Discount due to free - the amount that will be deducted from the invoice because there are free resources in the bucket
  • Total Amount with Discount - the sum total for the resource usage after discount due to free deduction
  • Outstanding Amount - the money amount which has to be paid ( total amount minus paid amount)
  • Payments - click this link to see the list of payments. To manage payments, go to the Billing > Payments menu. For more info refer to the Payments section of this guide.
  • Monthly bills - click this link to see the list of monthly bills
  • Service Addons Stats - click this link to see the service add-on billing statistics and total amount. That will show the amount due for the service add-on usage for all the users in the group that have assigned the service add-ons to their VSs.
  • User Group Billing Report - click this link to see the billing statistics for all the resources used by users within this user group. For more information, refer to the section below. 
  • Resource Pools - the list of the resource pools associated with the organization.


View User Group Billing Report 




The User Group Report page displays billing statistics for the specified period of time for all resources used by users within the user group.

To view the billing report for a particular user group: 

  1. Go to you Control Panel > Groups menu.
  2. Click a label of a destination user group.
  3. Click the User Group Billing Report link. 
  4. Filter statistics for a particular period of time and click the Apply button.
    On the page that follows, you can see the following details: 
    • From - the start date for generating statistics
    • Till - the end date for generating statistics
    • Virtual Server - the label of the virtual server that you can click to view the VS details
    • User - the username of the VS owner that you can click to view the user profile
    • Resource Pool - the price for the usage of resource pool for the selected period of time
    • Storage - the price for the usage of storage resources for the selected period of time
    • Network - the price for the usage of network resources for the selected period of time
    • Service Add-ons - the price for the usage of service add-ons for the selected period of time
    • Total Cost - the price for all used resources (Resource Pool, Storage, Network, and Service Add-ons) for the selected period of time

To download a CSV file with statistics for a selected period of time, click the Save as CSV button. The download will start automatically after you click the button. 


Create User Group




To create a new user group with default bucket and all roles:

  1. Go to your Control Panel's Groups menu.
  2. Click the "+" button or the Create Group button.
  3. On the screen that appears, fill in the organization creation form:
    • Label - choose a name for the organization
    • Buckets - choose the bucket from the drop-down list
    • Assign vCloud  roles - move this slider to the right to assign vCD roles to the user group
    • Roles - the roles for the users in the group
    • User Buckets - the buckets for the user group
  4. Click Save

After you create a user group, you can assign organizations to it during the import.


Edit User Group




To edit a user group:

  1. Go to your Control Panel's Groups menu.
  2. Click the label of the required organization.
  3. Click the Edit icon in the upper right corner.
  4. On the page that loads, make the necessary changes:
    • Label - choose a name for the organization
    • Buckets - choose the bucket from the drop-down list
    • Assign vCloud Roles - move this slider to the right to assign vCD roles to the user group
    • Roles - the roles for the users in the group
    • User Buckets- the buckets for the user group
  5. Click Save.


Delete User Group




To delete an organization:

  1. Go to your Control Panel's Groups menu.
  2. Click Delete in the Actions list next to a user group to delete a specific group.