Enabling application settings persistence
Important
The WorkSpaces Pools feature is not available in the Beijing and Ningxia Regions.
Contents
Prerequisites for enabling application settings persistence
To enable application settings persistence, you must first do the following:
-
Use an image that was created from a base image published by Amazon on or after December 7, 2017.
-
Enable network connectivity to Amazon S3 from your virtual private cloud (VPC) by configuring internet access or a VPC endpoint for Amazon S3. For more information, see the Home Folders and VPC Endpoints section in Networking and Access for WorkSpaces Pools.
Best practices for enabling application settings persistence
To enable application settings persistence without providing internet access to your WorkSpaces, use a VPC endpoint. This endpoint must be in the VPC to which your WorkSpaces in WorkSpaces Pools are connected. You must attach a custom policy to enable WorkSpaces Pools access to the endpoint. For information about how to create the custom policy, see the Home Folders and VPC Endpoints section in Networking and Access for WorkSpaces Pools. For more information about private Amazon S3 endpoints, see VPC Endpoints and Endpoints for Amazon S3 in the Amazon VPC User Guide.
How to enable application settings persistence
You can enable or disable application settings persistence while creating a directory or after the directory is created by using the WorkSpaces console. For each Amazon Region, persistent application settings are stored in an S3 bucket in your account.
The first time you enable application settings persistence for a directory in an Amazon Region, WorkSpaces Pools creates an S3 bucket in your Amazon account in the same Region. The same bucket stores the application settings VHD file for all users and all directories in that Amazon Region. For more information, see Amazon S3 Bucket Storage in Administer the VHDs for your users' application settings.
To enable application settings persistence while creating a directory
-
Follow the steps in Configure SAML 2.0 and create a WorkSpaces Pools directory, and make sure that Enable Application Settings Persistence is selected.
To enable application settings persistence for an existing directory
Open the WorkSpaces console at https://console.amazonaws.cn/workspaces/v2/home
. -
In the left navigation pane, choose Pools, and select the pool for which to enable application persistence.
-
Choose Edit in the Settings section of the page.
-
In the Application Persistence section of the page, select Enable Application settings persistence.
-
Choose Save changes.
New streaming sessions now have application settings persistence enabled.