Cloud Account Management

Frame provides administrators with the ability to manage various components of their cloud accounts easily from the Frame console. We’ll review how administrators can manage their virtual networks, master images, and instance types in this guide. Before moving forward, please ensure that you have successfully set up and configured your cloud account using one of the guides listed on this page.

Before we get started, use the instructions below to navigate to the cloud account page in your Frame console view. Start by navigating to the desired entity from the Frame console view and clicking on the adjacent kebab menu. Select “Cloud accounts.”

../../_images/instance_1.png

Navigate to the cloud account you would like to modify. Again, click on the adjacent kebab menu. Select “Update.”

../../_images/instance_2.png

The tabs you see at the top of the page will vary depending on the type of cloud account you’re accessing. Use the drop-down menus below to find more information for the corresponding cloud provider:

Virtual Networks

AHV

The “Virtual Networks” tab is typically the first tab you see when navigating through your cloud accounts page for AHV-based cloud accounts. Under “Virtual Networks,” administrators can see which virtual networks have already been applied.

If you would like to apply another virtual network, you can click on the desired network and hit “Save” in the upper right corner of your Frame console view.

../../_images/virt_nets1.png

Instance Types

AHV

Administrators can add and remove custom instance types for AHV from the “Instance Types” tab by following the instructions below.

Add an Instance Type

Adding an instance type from your Frame console view can be completed in a few simple steps.

  1. Select the “Instance Types” tab at the top of the page and then click the blue “Add instance type” link.

../../_images/instance_3.png
  1. A new window will appear prompting you to enter the following information:

../../_images/instance_4.png
  • Display name: Enter the desired display name for your new instance type.

  • GPU: Select an available GPU from the drop-down menu.

  • Cores: Use the buttons or enter the desired number of CPU cores.

  • Memory: Use the buttons or enter the desired amount of vRAM for your new instance type.

Note

Frame recommends giving the instance type a name that provides sizing information at-a-glance.

  1. Click “Create” at the bottom of the window when you’re done.

Use your Custom Instance Type

Once your instance type has been added under the cloud account, you can start using it in your Frame accounts.

  1. Navigate to the desired account Dashboard where you would like to start using your new instance type.

  2. Click on the “Capacity” page and then click the blue “+ Add Instance Type” link at the top of the page.

../../_images/instance_5.png
  1. A new window will appear, select your new instance type from the drop-down menu and click “Add.”

../../_images/instance_6.png

You can check your notification center for progress updates.

../../_images/instance_7.png

Once the production pool for your new instance type has been created, it will appear as a selectable tab at the top of the “Capacity” page where you can modify capacity settings.

Delete/Remove an Instance Type

Follow the instructions below to learn how to delete an instance type and remove it from your cloud account.

  1. Start by navigating to each account Dashboard where this instance type is being used and set all capacity settings to zero. Click “Save” in the upper corner of the page.

../../_images/instance_8.png
  1. Once all capacity settings have been updated, click on the kebab menu in the corner of the “Default Capacity” section and select “Delete.”

../../_images/instance_9.png
  1. Click “Delete” in the corner of the prompt that appears to confirm. The notification center will provide you with progress updates.

  2. Once the instance type has been deleted from all accounts, you can fully remove it from the Cloud accounts page. Navigate to the Customer/Organization entity in the console view and click the kebab menu listed next to the entity. Select “Cloud accounts” from the menu.

../../_images/instance_1.png
  1. Navigate to the cloud account where you will be deleting the instance type. Again, click on the adjacent kebab menu. Select “Update.”

../../_images/instance_2.png
  1. Click on the “Instance Types” tab at the top of the page. Click the red “Delete” link next to the instance type you would like to delete.

../../_images/instance_10.png
  1. Click “Remove” in the bottom corner of the prompt that appears to confirm your choice.

The instance type has successfully been removed from your cloud account.

Configuration

The “Configuration” tab is available on the cloud account management page for certain IaaS providers, including Azure and AWS. The sections below outline what this tab looks like for each provider.

AWS

If you are accessing the configuration tab for an AWS cloud account, you will see two sub-tabs: “Update Stack” and “Recreate Stack.” The Frame console provides an explanation detailing what each tab is for.

Update Stack

../../_images/aws_config1.png

The “Update Stack” tab provides you with your CloudFormation Stack template URL and Stack parameters, as shown above. These details can be used to update IAM (Identity and Access Management) roles as needed. As an example, you may need to use the CloudFormation Stack template URL to expand your IAM permissions after a product update in order to use new product features.

Recreate Stack

Use the “Recreate Stack” sub-tab to recreate your CloudFormation stack to a known good state and verify the connection. Typically, most administrators will access this page when troubleshooting permissions/account setup issues.

../../_images/aws_config2.png

Warning

In order to recreate your CloudFormation stack, you must delete the existing stack in your AWS Console which you can access directly from the “Recreate Stack” sub-tab.

Azure

The configuration tab for Azure can be used to update your Azure credentials found in the Azure Portal. Most administrators will need to access this page in order to update the client secret before it expires. Microsoft Azure limits client secrets to expire 2 years or less after their creation date.

../../_images/azure_config1.png

Warning

The client secret is used by Frame to manage your BYO Azure account. Microsoft recently implemented a maximum expiration date of 2 years from the client secret creation date. When your key expires, you will need to re-enter your cloud account credentials from the cloud account management view of your Frame console. If you fail to update your client secret before it expires, Frame will no longer be able to manage your Azure account and you will likely experience an outage.

If your client secret has expired, you can simply re-enter your cloud credentials here and click the “Verify Connection” button. Your Application ID and Directory ID can be found in the “Overview” section of your Frame app registration in the Azure portal.

../../_images/byoazure_new3.png

Master Images

The “Master Images” tab provides the same functionality across all cloud infrastructure providers. Administrators can select the desired master images they would like to be used for Frame account creation. Please refer to the Image Management section of our documentation for detailed instructions on how to add your own custom master images. The guides in this section outline how to add your desired master images through your infrastructure provider and then make them available through the Frame console. Once master images have been created, they can be added from the “Master images” tab and made available to build Frame accounts with.

Add a Cloud Account Region

Administrators can add additional regions after their cloud account has been setup using the “Add Regions” option. This option can be found by navigating to the desired entity from the Frame console view and clicking on the adjacent kebab menu. Select “Cloud accounts.”

../../_images/instance_1.png

Warning

Administrators should ensure they have sufficient resource limits in the regions they decide to add before adding them through the Frame console.

Navigate to the cloud account you would like to modify. Again, click the adjacent kebab menu and select “Add regions.”

../../_images/addregion_1.png

A new window will appear. You have two options to choose from:

../../_images/addregion_2.png
  • All supported regions: Select this option if you would like to add all other supported regions aside from the ones you have already specified.

  • Specify regions: Select this option if you would like to add just a few additional supported regions to your cloud account. Simply click inside the regions field and select as many regions as you wish from the drop-down menu.

../../_images/addregion_3.png

Once you have made your selection, click “Save” in the bottom right corner of the window. You will receive updates in your notification center regarding the status.

../../_images/addregion_4.png