Skip to main content

Settings

Administrators can manage a wide range of settings from an entity Dashboard's settings page. The configurable settings for this page depends on which entity level it is being accessed from (Customer, Organization, or Account level.) varies.

Dashboard - Settings

TabDescription
Basic InfoAllows administrators to update the Frame Account Name, URL name, description, and notes on the Frame account.
GeneralProvides administrators with the ability to enable Quick Publish and/or Test Publish, generate Session Reports, set the machine name prefix for non-domain-joined workload VMs, and enable custom terminal and login banners.
SessionDefines the behavior of a Frame session, including the features available to the users, time limits, keyboard mappings and profiles, and Advanced Terminal and Server Arguments.
NetworkingAllows administrators to view and update the Frame account's networking settings.
Availability ZonesEnable AWS and GCP Availability Zones for Enterprise Profiles and Personal Drives.
ProfilesEnable and manage Enterprise Profile volume settings.
Personal DrivesEnable and manage Personal Drive settings.
Domain SettingsDefines the parameters for joining your test/production workload VMs to your Windows domain, if required for your use case(s).
Deployment GroupDetermines when a Frame Account's workload VMs will receive the latest version of the Frame Guest Agent (FGA), Frame Server, and any associated drivers or components.
Shutdown TimeoutDetermines the interval of time (in minutes) that Frame checks to see if a VM is in a state where it can be powered off (no session). By default Frame checks every 60 minutes.
Scheduled TerminationEnable or disable the scheduled termination of a Frame account.
TerminateTerminate a Frame account.

Basic Info

The Basic Info tab allows administrators to update the Account Name, Account URL, and other information associated with your Frame Account. These values were specified during the creation of the account.

  1. From the Frame Account Dashboard, go to Settings page. Click on the Basic Info tab if you are on a different Settings tab.

    Settings

FieldDescription
NameThis editable field specifies the account name which will be displayed in the account Dashboard and Launchpad.
URL nameThis editable field designates the unique identifier of the URL for users to access the login page. Note: This value is used as part of the URL for users to access the login page or Launchpad. If you change this value, you will need to make sure to communicate this change to your users and update references to the Account URL in any websites or documentation.
DescriptionThis editable field allows you to describe the Frame Account. It is currently only displayed in the Frame Console for administrators.
WebsiteThis editable field is only visible in the Frame Console to administrators. The field is not used by Frame.
NotesThis editable field is only visible in the Frame Console to administrators. The field is not used by Frame.

General

The General tab allows administrators to enable/disable general settings on the account.

  1. From the Frame Account Dashboard, go to Settings page. Click on the General tab if you are on a different Settings tab.

    General Settings

FieldDescription
Enable Quick PublishRefer to Quick Publish documentation for further details.
Session Report GenerationRefer to Session Reports documentation for additional details.
Promote user to local adminIf disabled, the Frame session will use the local Windows user FrameUser who does not have local Windows administrator access. If enabled, the Frame session will use the local Windows user Frame who is in the local Windows Administrators group.
Machine Name PrefixFrame will provision VMs with the specified Machine Name Prefix value to create a unique machine name for each workload VM.
Enable Test PublishRefer to Test Publish documentation for further details.
Enable Custom Terminal BannerRefer to Custom Terminal Banner documentation.
Enable Custom Login BannerRefer to Custom Login Banner documentation.

Networking

The Networking tab allows administrators to review the networking configuration for the Frame Account.

  1. From the Frame Account Dashboard, go to Settings page. Click on the Networking tab if you are on a different Settings tab.

    Network Settings

FieldDescription
NetworkingThis field specifies whether the Frame account was created using Frame-managed versus Customer-managed networking.
Network typeFor accounts created using Frame-managed networking, this field specifies whether the workload VMs are on a public network, private network, or a private network with one or more Streaming Gateway Appliances.
Customize VPC SettingsThis field shows the VPC/VNET CIDR value for accounts created using Frame-managed networking with a specified VPC/VNET CIDR.

Details on the networking deployment models are discussed in the Networking Requirements documentation.

danger

Administrators should not modify any of these Networking settings unless they have consulted a Frame Solutions Architect and validated the change in a test network and Frame account.

Shutdown Timeout

The Shutdown Timeout feature is accessible from any account Dashboard.

Shutdown Timeout

The Frame platform automatically checks for VMs that are in an unutilized state (no active or disconnected session) to power off every 60 minutes, by default. The Shutdown Timeout feature allows the administrator to adjust the length of that interval (in minutes) as needed to accomodate for infrastructure costs or user experience. This setting can be adjusted to a minimum of 5 minutes and a maximum of 30 days (43,200 minutes).

danger

Administrators leveraging public cloud infrastructure should exercise caution when adjusting this value as:

  • Increasing the Shutdown Timeout value causes the VMs to remain powered on for longer increments, which increases total infrastructure usage and cost.
  • Decreasing the Shutdown Timeout value can substantially reduce infrastructure usage by turning off VMs sooner when not in use, but it may adversely affect the user experience. This is particularly true for Persistent Desktop scenarios, where users might frequently encounter delays as they wait for VMs to power up between sessions.