Manage enterprises

Prepare to create an enterprise

In the platform, enterprises are cloud tenants, meaning they are groups of cloud users with their own logical resources. For each tenant, you can assign access to infrastructure and resources. And you can enter the credentials of one cloud account or subscription from a cloud provider.

Before you begin to create enterprises, we recommend that you do these steps:

1. Add infrastructure to the platform in https://abiquo.atlassian.net/wiki/spaces/doc/pages/311371096. Create datacenters and public cloud regions; configure networks; in private cloud, configure hypervisors and storage; and configure the platform in https://abiquo.atlassian.net/wiki/spaces/doc/pages/311371358, and also see Configure two factor authentication

2. Prepare pricing. See https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370925

3. Prepare themes for white-labelling with https://abiquo.atlassian.net/wiki/spaces/doc/pages/360939624

4. Prepare user roles for cloud users and administrators. See https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370787

5. Create a scope for the enterprise. See https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370717

Create an enterprise

To create a cloud tenant enterprise, do these steps:

1. Go to Users → Enterprise list

2. Click the + add button

   Open

   

   In Users view, add an enterprise

3. To create a tenant enter the following. There are more details in the sections below:

   1. General information

   2. Allocation limits: to define the resources the enterprise can use

   3. Datacenters: To enable the tenant's users to deploy, allow the tenant to access at least one datacenter or public cloud region. You can also edit the Allowed datacenters and providers to set Allocations limits and defaults. See below

   4. Optionally, set Credentials and Properties (metadata). See https://abiquo.atlassian.net/wiki/spaces/doc/pages/327581812

   5. Pricing: optionally, select a pricing model, see below.

4. Click Accept to save

Abiquo will create the enterprise and filter to display only this enterprise. To display other enterprises, click the X beside the enterprise name in the filter box at the top of the Enterprises list. 

After you have created the enterprise:

1. Abiquo will add this enterprise to the scope of the administrator who created the enterprise

2. Abiquo will add this enterprise to the enterprise’s own Default scope

You can then do the following actions

1. Optionally, add this enterprise to a scope with related enterprises and assign the scope to the appropriate cloud and/or tenant administrators

Before you create users for the enterprise, you can edit the tenant to change the Default scope to assign to users created in this tenant. You can allow a tenant administrator to create their own users

Enterprise general information

Enter the general information:

1. Enter the Name

2. For the Default scope, select a scope to assign to future users in this tenant. This scope will also define the enterprise hierarchy, by the parent scopes. See Abiquo cloud reseller guide

3. Optionally, select the checkbox to Require two-factor authentication

   1. First, see Configure two factor authentication

4. Optionally, select the checkbox to Enable workflow.

   1. First, configure the https://abiquo.atlassian.net/wiki/spaces/doctest/pages/311374701

5. Optionally, mark the Reseller checkbox to create a reseller enterprise. For more details see:

   • Private cloud: Abiquo cloud reseller guide

   • Public cloud: https://abiquo.atlassian.net/wiki/spaces/doc/pages/443056256

   OR if your enterprise is not a Reseller, optionally, select the checkbox to create a Key node.
   When you create a Key node enterprise, the Default scope of the key node enterprise should have a reseller scope as its parent. See Abiquo cloud reseller guide in the Tenant hierarchy section.

Open

Create an enterprise, entering general information

Set allocation limits for a tenant

To control the use of resources, you can create allocation limits for

• an enterprise

• an enterprise in a cloud provider

• an enterprise in a datacenter or public cloud region

• virtual datacenters

Screenshot: Allocation limits for an enterprise

To set allocation limits for a tenant:

1. Create or edit the enterprise

2. Enter a hard limit and soft limit for each resource

   1. To allow unlimited resources at this level, set the limits to 0

   2. If you set a hard limit, you must also set a soft limit. The hard limit must be greater than the soft limit

   3. You must set the hard limit above the level of resources that are already in use

Table of allocation limits

In public cloud regions, the platform does not use Repository (Catalogue storage) features or limits.

Allow a tenant to access datacenters and cloud providers

When you first create a datacenter or public cloud region, by default only the users of the enterprise that created it will be allowed to use it. To enable other users to deploy and work with VMs, administrators allow enterprises to access datacenters or public cloud regions.

To set the datacenters and public cloud regions that an enterprise can access:

1. Go to Enterprise → Datacenters

2. From Prohibited datacenters, drag datacenters and public cloud regions (or providers) to the Allowed datacenters

3. To set default Allocation limits and VDC roles for regions in a cloud provider, edit the provider

To display the enterprises with access to a public cloud region, go to Infrastructure → Public → select region → Servers view → Virtual machines → Accounts.

Assign a pricing model to a tenant

To display charge-forward messages to your customers assign a pricing model to the enterprise. The platform can display a message with pricing information when the users deploy VMs and on-demand through the UI and API.

Before you begin:

1. Go to https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370925  and configure pricing and create a pricing model.  

To set a pricing model for an enterprise:

1. Go to Users → edit enterprise → Pricing

2. Select a Pricing model from the list. The details of the pricing model will be displayed. 

3. Continue editing or to finish editing, click Save 

You can also assign pricing models to multiple enterprises in https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370925.

Display and filter enterprises

To search for an enterprise by name and filter the list of enterprises to display only the matching enterprises

1. Go to Users

2. In the search box at the top of the Enterprises list, enter text and wildcards 

After you create an enterprise, Abiquo will filter the enterprise display by the name of the new enterprise and select this enterprise.

To remove the new enterprise filter:

1. Click the x beside the search box 

Abiquo will display the enterprise list in alphabetical order. If the new enterprise is on the first page, it will remain selected. Otherwise Abiquo will select All and display the first page.

Switch to another tenant

Edit an enterprise

Before you edit an enterprise, check if the users have created virtual datacenters and deployed VMs and the general resource usage of tenant.

To edit an enterprise:

1. Go to Home view

2. Select the enterprise in the Enterprises list 

3. Click the pencil edit button

4. Move through the tabs and edit as required

   • Editing an enterprise is very similar creating an enterprise

   • Remember you may not be able to change some settings, especially for Allowed datacenters, after users have created virtual datacenters and deployed VMs

   • Some changes will not be retroactive, for example, if you change the default VLAN, this change will apply to all new virtual datacenters the enterprise creates

When you edit a tenant, you can change the Default scope for future users created in the tenant. 

Create an enterprise using the API

To create an enterprise in the Abiquo API, create the enterprise using the EnterprisesResource.

Then to allow the users of the enterprise to work with VMs, assign an allowed datacenter or public cloud region. To do this, create an Enterprise-Datacenter Limit. See EnterpriseLimitsByDatacentersResource.

The platform will then create a cloud location, which defines this relationship, so you can then manage cloud elements for the location. See AllowedLocationsResource

For more details, see https://abiquo.atlassian.net/wiki/spaces/doc/pages/311375969 .

Delete an enterprise

We recommend that you wait until the end of the billing period to delete enterprises.
If you delete an enterprise before the next billing check has been run after usage has ended, there may be costs that are not included in the enterprise’s bill.

Before you begin:

1. Delete the enterprise's virtual resources:

   1. Delete each virtual datacenter: you may be able to delete them in the platform only, or in the platform and the provider.

   2. In myCloud Virtual datacenters view, go to Locations → Network section and delete firewalls in the platform only, or in the provider

To delete an enterprise:

2. Select the enterprise and click the Delete button. The platform will automatically delete all of the enterprise's users

Pages related to enterprise tenants

• https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370770

• Create roles with privileges to control access to platform actions: https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370787

• Create action lists for users: https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370717

• To set enterprise policies for allowed datacenters and public cloud regions, see https://abiquo.atlassian.net/wiki/spaces/doc/pages/311377504

• To control resource usage, send notifications, and restrict access for a tenant, see Manage enterprise policies

• To configure a tenant for public cloud and tenant metadata, see https://abiquo.atlassian.net/wiki/spaces/doc/pages/327581812