Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel3
minLevel1

Info

This page is a guide for cloud administrators to provision tenants (enterprises) in private cloud.Before you provision tenants, provision infrastructure. See Infrastructure provisioning guide.

Flow chart

This flow chart describes the basic process for provisioning infrastructure and tenants. 

  

Mermaid
fileNamemermaid_1655114480704
themeneutral
version78
{"diagramDefinition":"graph TD\r\n\r\nZ(( ))\r\n\r\nstyle Z fill:#g1g,stroke:#100,stroke-width:20px\r\n\r\nZ-->A(Create datacenters and<br/>public cloud regions)\r\nProvision infrastructure)\r\nA--> |Private cloud|B>B(Create datastore<br/>service levels)\r\nroles)\r\nB-->C(ConfigureCreate networksscopes)\r\n\r\nC-->D(AddCreate compute with<br/>racks and servers)\r\nenterprise tenants)\r\nD-->E(OptionallyCreate create<br/>allocationtenant rulesadmins)\r\n\r\nE-->F(Optionally create<br/>hardware profiles)\r\n\r\nF-->G(Provision tenants)\r\n\r\nA-->|Public cloud|G\r\n\r\nG-->|Private cloud|H>H(Provision networks)\r\n\r\n\r\nG-->|Public cloud|I(Obtain public<br/>cloud credentials)\r\n\r\n\r\nH-->J(Create virtual datacenters)\r\n\r\nJ-->K(Capture VMs)\r\n\r\nK-->L(Configure backups)\r\n\r\nL-->Q((<fontcolour=f3efe6> * ))\r\n\tstyle Q fill:#f3efe6,stroke:#030300,stroke-width:7px,color:#f3efe6\r\n\r\nI-->M(Add credentials<br/>for a tenant)nsubgraph Provision tenants\r\n        B\r\n\r\nM-->N(Onboard from<br/>public cloud)        C\r\n        D\r\n        E\r\nN-->Qnend"}

...

Provision tenants

...

tenants

...

Before you create tenants, you should do these steps:

Add infrastructure to the platform as described in the Infrastructure provisioning guide 

provision tenants:

You can also do any of these additional steps:

Introduction to user roles

Create a user role

...

Modify the privileges of a role

...

Manage roles with the API

Tip

API Documentation

For the Abiquo API documentation of this feature, see Abiquo API Resources and the page for this resource RolesResource.

Introduction to user scopes

...

Create a scope

...

Manage scopes with the API

Tip

API Documentation

For the Abiquo API documentation of this feature, see Abiquo API Resources and the page for this resource ScopesResource.

Create a basic enterprise

This section describes how to create a basic tenant enterprise for a cloud tenant. For more detailed information, see Manage enterprises.

To create a basic customer enterprise do these steps:

...

Go to Users

...

...

  1. Create user roles from the default roles. You may need a standard user, a tenant administrator, and optionally, a reseller administrator. Reference: Manage roles#Introduction to user roles.

    1. Go to UsersRoles

    2. Click the duplicate clone button and click the pencil edit button, OR click the +add button

    3. Enter the Name of the role

    4. To create a global role for all enterprises, select Make this role global

    5. Optionally, to create a list of network addresses from which users with this role can access the platform, enter Allowed CIDRs.

    6. Enter the corresponding External roles, e.g. LDAP group, for the user. This is required in external authentication modes (openid, ldap).
      A user's external roles must map to a single role (local or global).
      You can also set external scopes.

      • Examples of external roles for LDAP:

        • ldap_group_01

        • ldap_group_02

      • Example for OpenID:

        • id=admins,ou=group,o=qa,ou=services,dc=openam,dc=forgerock,dc=org

    Image Added

  2. Modify the privileges of the role

    1. Select the role

    2. In the Privileges pane, select or deselect the privileges 

      • To add or remove groups of privileges, click the All privileges checkbox beside the group name

      • You cannot “undo” a set of changes, but you can discard your changes

    3. To save the changes, click Save

      • (warning) The platform will discard your changes if you do an action outside of the Privileges pane, for example, clicking on a another role name

      • (warning) For troubleshooting information, see Manage roles#Role troubleshooting and tips

  3. Optionally, you can use scopes to create a tenant hierarchy with a reseller at the top level. Reference: Abiquo Reseller Guide

  4. Create a scope for each tenant, so that each user can only access their own tenant and its resources.
    Reference: Manage scopes#Introduction to user scopes
    (tick) You can delegate the administration of users in the tenant to a tenant administrator user with this scope

    1. Go to UsersScopes

    2. At the bottom of the Scopes list, click +add

    3. On the General info tab, select a parent scope, for example, the Global scope or a reseller scope

      Create scope - general informationImage Added
    4. In the Datacenters list, select the appropriate locations (datacenters and public cloud regions) where the users will work

      Create scope - entitiesImage Added
  5. Create the tenant enterprise for the scope

    1. Go to Users and at the bottom of the Enterprises list, click the + add button

    to add an enterprise
    Image Removed
    1. On the General

    tab
    1. Enter the customer Name

    2. As the  tab for the Default scope, set  select the tenant scope that will define the tenant hierarchy

      The platform

      's scope.
      Abiquo will automatically add

      this

      the enterprise to

      the scope. Note that if you change the default scope of an enteprise, the platform will not remove the enterprise from its previous scope.

      If its Default scope

    3. Optionally, if the enterprise represents the tenant headquarters or similar, select Key node

      Image RemovedEdit enterprise basic enterpriseImage Added

    4. Go to Allocation limits and set resource usage limits for the enterprise

    Include PageHard and soft limitsHard and soft limitsImage Removed
    1. . Reference: Limit resource usage with allocation limits.

      Image Added
    2. On the Datacenters tab

    , drag and drop providers, datacenters, or regions to Allowed datacenters
    1. , to allow the tenant's users to work in

    them. Image Removed
    1. locations, drag providers, datacenters, or regions into Allowed datacenters

      Image Added
    2. To configure the tenant in each allowed locationdatacenter or public cloud region, see Configure an enterprise in a cloud location

    3. Optionally, add Credentials for public cloud. See Add credentials for public cloud

    4. On the Properties tab, for each tenant metadata property, enter a Key and Value, and click Add.
      See Enterprise properties general table and Display cloud provider billing data
      To inject the tenant details into VM metadata, see https://abiquo.atlassian.net/wiki/spaces/doc/pages/327581812/Manage+enterprise+credentials+and+properties#Inject-enterprise-properties-as-VM-variables

    5. Optionally

    , add credentials for public cloud. See Add credentials for public cloud
    1. , on the Pricing tab, select a pricing model

    2. Click Save.
      The platform will create the enterprise and filter to display

...

    1. this enterprise ONLY

...

    1. (warning) To display other enterprises, click the

...

    1. x beside the enterprise

...

    1. Name in the filter box at the top of the Enterprises list

  1. Create a

...

See Create a new pricing model  

Assign a pricing model to the tenant

...

Create a tenant administrator user

...

Provision networks

To create private cloud infrastructure networks, see Network provisioning guide.

Create virtual datacenters

The platform administrator will generally create virtual datacenters for tenants when accounting is by virtual datacenter. 

See Manage virtual datacenters

You can automate the process of creating virtual datacenters using the Abiquo API. See How to create virtual datacenters and VMs via API

Import and capture VMs

  1. tenant administrator user

    1. Go to UsersUsers

    2. If the tenant enterprise is not selected, select it

    3. At the bottom of the Users tab, click + add

    4. For the Full name, enter the user’s first name and family name

    5. For the Role: select ENTERPRISE_ADMIN or similar

    6. For the Scope, select the user’s enterprise scope

    7. For the Username,enter the name that the user will log in with, which will display in the system

    8. For the E-mail, enter the address of the user for platform messages, including password reset. The platform will display the Gravatar icon associated with this address as the user icon

      Image Added

    9. For Phone number, enter the mobile cell phone number of the user to receive SMS messages if you use this option for two factor authentication

    10. Go to Advanced and enter the user’s Public key, which is required for SSH access

    11. Optionally, enter Allowed CIDRs from which the user can access the platform

    12. We recommend that you select Reset password on next login

    13. Optionally, deselect Activated to prevent the user from logging in until this option is selected

      Create user - advancedImage Added

      Replace screenshot as enterprise administrator has No VDC restriction, so Limit access to VDCs will not display for this user

  2. Provision cloud infrastructure networks. See Network provisioning guide

  3. Create virtual datacenters. See Manage virtual datacenters

  4. Import and capture VMs. See Import and capture virtual machines

  5. Configure

...

  1. additional VDC services, such as Backup as a

...

Abiquo offers optional backup plugins that support popular backup systems such as Veeam and Networker. These plugins require separate licenses. For information about configuring these plugins, see Abiquo backup plugins. After the plugins are configured, you can manage Abiquo backups in Infrastructure view on the Backup policies tab. See Backup.

Your cloud users can then configure backups for their VMs. See VM backups.

Provision tenants with the API

...

  1. Service - see Abiquo backup plugins and Backup

  2. Create cloud users. This is similar to creating a tenant administrator user, but

    1. For the Role, select a standard cloud USER role

    2. Optionally, go to Limit access to VDCs, select the VDCs that the user can access

Related API how-tos