Versions Compared

Version Old Version 2 New Version Current
Changes made by

MS (Unlicensed)

MS (Unlicensed)

Saved on

Key

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

Prepare to onboard from public cloud

Before onboarding virtual resources, administrators must do these steps:

  1. Create the public cloud region to import from

  2. Allow the tenant access to the public cloud region (Enterprise → Datacenters → Allow public cloud region)

  3. Register the tenant's credentials for the public cloud provider (Enterprise → Credentials)

...

Introduction to onboard from public cloud

You can onboard virtual resources from public cloud into the platform. If the cloud provider supports virtual datacentersdatacenter (VDC) entities, such as AWS VPCs or Azure virtual networks, you can onboard them . After you onboard the virtual datacenters, you can synchronize them and the virtual resources. If as VDCs and synchronize them. If the cloud provider does not support virtual datacentersVDCs, then you can onboard the resources from the public cloud regions, such as RackSpace and OpenStack Google Cloud Platform regions. 

Panel

PrivilegePrivileges: Manage virtual datacenters

Before onboarding virtual resources, administrators must do the following steps:

  • Create the public cloud region to import from
  • Allow the tenant access to the public cloud region (Enterprise → Datacenters → Allow datacenter)
  • Register the tenant's credentials for the public cloud provider (Enterprise → Credentials)

...

...

Onboard virtual datacenters from public cloud

Excerpt
nameOnboard virtual datacenters from public cloud

To onboard resources from public cloud:

  1. Go to myCloud → Virtual datacenters

and

  2. At the

top

  1. bottom of

the

  1. the V. Datacenters

list
  • Click the + Add button  select Synchronize public cloud from the pull-down menu
    Image Removed
  • The platform opens a dialog box with a pull-down list of public cloud regions. Select one of these regions.
  • After you select the region, there are two possibilities:
      • If the provider supports virtual datacenters, Abiquo will display a list of virtual datacenters
      • If the provider does not support virtual datacenters, Abiquo will automatically onboard the virtual resources in the region

    Onboard virtual datacenters from public cloud

    To onboard a virtual datacenter:

    ...

    1.  list, click the + add button

    2. Select Synchronize public cloud

    3. On the General information tab, select the region and the other entities to onboard

      1. The virtual datacenter entities are: AWS VPCs, Azure Virtual Private Networks, OCI Virtual Cloud Networks, vCloud vApps

        Onboard from public cloud regionsImage Added

      2. (warning) Google Cloud Platform (GCP) does not use virtual datacenter entities, so the platform onboards and synchronizes regions and all their resources.
        (warning) In GCP You cannot onboard or synchronize individual resources, for example, a public IP. 

        • When you first onboard from GCP, the platform will onboard virtual datacenter resources into a generic virtual datacenter for the region. 

        • The platform will add regional or global resources separately, such as global networks and public IP addresses. 

        • If you created virtual datacenters and resources before onboarding, the platform will add related resources into your virtual datacenters

        If conflicts occur during onboarding, the platform may stop and roll back the onboarding.

      3. Optionally, to restrict user permissions in the virtual datacenter, go to Roles and select a custom user role.
        Optionally, set exceptions to the virtual datacenter role 

        Assign a role for using public cloud resourcesImage Added

    For more details see Set a virtual datacenter role to limit user access.

    The platform will onboard the selected resources for you to manage.

    • If metrics are enabled on the platform, the platform will enable the fetch of metrics for the VM. The user can then edit the VM to select the metrics to display in the UI.

    • The platform will store the timestamps of when the VM was created and when it was captured into the platform. It will display these time stamps on the VM details panel.

    • The platform will mark the Public subnet (identified by a custom route table and NAT gateway) with a globe symbol and set the Internet gateway flag for this subnet. 

    • Users with bespoke network configurations should check the results of the synchronization.

    • The platform will synchronize private and public IP addresses even if they are not in use by VMs, and mark the IP addresses in use by provider entities with provider identifiers.

    ...

    titleClick here to show/hide the screenshot

    ...

    • The platform will import VM templates. If

    ...

    • the platform cannot find the VM template, the VM will have no template in the platform

    ...

    • . To save a copy of your VM disk

    ...

    • to create a template, so you can recreate the VM, make an Abiquo instance of the VM.

    ...

    titleClick here to show/hide the screenshot

    ...

    •  

    Warning

    If you delete

    a synchronized

    an onboarded VDC, the platform will delete it in

    the provider. Always check which is

    the

    default VDC in your

    provider

    , e.g

    .

    AWS default VPC, because it may be inconvenient to delete this VPC


    If your enterprise does not have valid credentials for the public cloud provider, when you delete public cloud entities in the platform, they will still exist in the public cloud provider.

    ...


    View classic VMs

    To view display classic VMs , for example in AWS these are EC2 classic VMs, click the "See classic" link. 

    Expand
    titleClick here to show/hide the screenshot

    The platform will display classic VMsImage Removed

     in public cloud:

    1. Go to Virtual datacenters

    2. Click the + Add button and select Synchronize public cloud

    3. Select the public cloud region

    4. Click the See classic link

    ...

    Synchronize VDCs and resources

    During VDC synchronization, the platform will ensure that the resources in the platform and the provider are the same.

    • It will delete entities in the platform that were deleted already in the provider
    • However, it will maintain resources attached to undeployed VMs in the platform
      • For example, if a user has an undeployed VM with IPs and a load balancer, then after the synchronization, these resources are attached to the VM in the platform only
      • Warning: These resources are "free" in the provider. Users working directly in the provider could assign these resources to other VMs. This will cause a conflict and error at deploy time
    Excerpt
    nameSynchronize VDCs and resources

    To update a virtual datacenter and onboard any changes made in the provider, synchronize the virtual datacenter:

    1. Go to Virtual datacenters → V. Datacenters list

    2. Beside the virtual datacenter

    ...

    1. Name, click the

    ...

    1. round arrow Synchronize button

    Onboarding public cloud resources in progressImage Added

    To synchronize specific resources such as networks, public IPs,

    ...

    and so on:

    1. Go to Virtual datacenters → select the resource tab

    2. Click the round arrow Synchronize button for the resource. 

    For more information, see the resource documentation.

    ...

    Click here to show/hide the screenshots
    Expand
    title

    Screenshot: Synchronize firewallsnetworks

    Synchronize firewalls that you onboarded or created in public cloudImage Removed

    Screenshot: Synchronize private networks in public cloud

    Image Removed

    Info
    titlePublic cloud synchronization parameters
    Note to System Administrators: For information about tuning public cloud synchronization, see Abiquo Configuration Properties.Manage public cloud resources in the multicloud platformImage Added

    ...


    Manage resources that were deleted directly in the cloud provider

    Excerpt
    nameManage resources that were deleted directly in the cloud provider

    When administrators delete resources in the provider, the platform will display the resource name in light gray to indicate that the user cannot work with the resource. The resource types include:

    • External networks

    • Firewalls 

    • Classic firewalls 

    • Load balancers 

    • NAT network

    • NAT IPs

    To delete these resources (if they are not in use), select the resource and click the delete button.

    ...

    titleClick here to show/hide the screenshot

    ...

    Delete or release virtual resources in public cloud

    Excerpt
    nameDelete or release virtual resources in public cloud

    The virtual resources that you onboarded or created in public cloud will be grouped with their associated virtual datacenters.

    Before you begin:

    1. If you recently created virtual resources, such as load balancers, synchronize the virtual datacenter to ensure that the platform can find

    ...

    1. all the dependencies of the virtual datacenter.

    To delete onboarded resources in public cloud:

    1. Delete each virtual datacenter

      • You can choose to delete each virtual datacenter in the platform only, or in the platform and the provider. 

      • If you delete in the platform only, the platform will automatically remove VMs, virtual appliances, load balancers, public IPs, and firewalls from the virtual datacenter. It will not delete the firewalls

      • When you delete a virtual datacenter, public IPs that are not attached to VMs will remain in the provider and the synchronization process will delete them

      • Remember to check which is the default VDC in your provider,

    ...

      • such as the AWS default VPC, because it may be inconvenient to delete this VPC

    Warning

    If the enterprise does not have valid credentials for the public cloud provider, when you delete public cloud entities in the platform, they will continue to exist in the public cloud provider

    ...


    Onboard from public cloud using the API

    Tip
    title

    Abiquo API Feature

    This feature is available in the Abiquo API. See VirtualDatacentersResource for synchronization and AllowedLocationsResource for retrieval of virtual datacenters and VMs.


    ...

    Onboard from public cloud regions without

    ...

    If your public cloud provider does not support virtual datacenter entities, Abiquo will automatically onboard when you select the public cloud region.

    ...

    virtual datacenters

    The platform onboards and synchronizes virtual resources in public cloud regions for providers that do not use virtual datacenters or similar entities, for example, OpenStack clouds and RackspaceGoogle Cloud Platform. You can only synchronize these providers at the public cloud region level. You cannot synchronize a VDC or an individual resource, for example, a load balancer. 

    If Abiquo already has virtual resources on the platform for the provider, then these entities will already be part of a virtual datacenter. Abiquo will check if any new entities in the provider are related to the existing ones in Abiquo and place them in the existing virtual datacenter.Abiquo your public cloud provider does not support virtual datacenter entities, to onboard virtual resources do the following steps:

    1. Go to Virtual datacenters

    2. At the bottom of the V. Datacenters list, click the + add button

    3. Select Synchronize public cloud

    4. Select a public cloud region

    The platform will place all VMs and network resources that are not related to existing Abiquo virtual resources into a generic virtual datacenter. Abiquo The platform names this virtual datacenter with the same name as the public cloud region, but the user can rename it. Abiquo The platform will use this virtual datacenter for future synchronizations, adding or removing resources to match the cloud provider.

    If the Abiquo there are already virtual resources in the platform for this provider, then these entities will already be part of a virtual datacenter. The platform will check if any new entities in the provider are related to the existing ones in the platform and place them in the existing virtual datacenter.

    If the integration with the provider supports entities that are not assigned to any in a virtual datacenter, such as firewalls, load balancers, or floating IPs, these may be loaded into Abiquo as unassigned  the platform may load these as separate entities.

    If conflicts occur during synchronization, Abiquo the platform will cancel the synchronization. This would could occur if two VMs already exist in different VDCs but are related by a firewall or load balancer. Or if two firewall policies or load balancers exist in different virtual datacenters but are related by a VM.

    ...

    Control onboard of VMs to VApps

    Excerpt
    nameControl onboard of VMs to VApps

    When you onboard virtual resources from providers without virtual datacenters, by default, the platform will onboard each VM into its own VApp.

    To onboard all VMs into a single virtual appliance, set the singlevapp enterprise property to true. If you wish to configure the name, set the singlevapp name enterprise property:

    Code Block
    "sync.singlevapp":"true",
"sync.singlevapp.name":"sync vapp name"

    For instructions on how to set an enterprise property, see Manage enterprise credentials and properties