Home Folder Content Synchronization
When home folders are enabled, AppStream 2.0 creates a unique folder for each user in which to store their content. The folder is created as a unique Amazon S3 prefix that uses a hash of the user name within an S3 bucket for your Amazon Web Services account and Region. After AppStream 2.0 creates the home folder in Amazon S3, it copies the accessed content in that folder from the S3 bucket to the fleet instance. This enables the user to access their home folder content quickly, from the fleet instance, during their streaming session. Changes that you make to a user’s home folder content in an S3 bucket and that the user makes to their home folder content on a fleet instance are synchronized between Amazon S3 and AppStream 2.0 as follows.
-
At the beginning of a user’s AppStream 2.0 streaming session, AppStream 2.0 catalogs the home folder files that are stored for that user in the Amazon S3 bucket for your Amazon Web Services account and Region.
-
A user’s home folder content is also stored on the AppStream 2.0 fleet instance from which they stream. When a user accesses their home folder on the AppStream 2.0 fleet instance, the list of cataloged files is displayed.
-
AppStream 2.0 downloads a file from the S3 bucket to the fleet instance only after the user uses a streaming application to open the file during their streaming session.
-
After AppStream 2.0 downloads the file to the fleet instance, synchronization occurs after the file is accessed
-
If the user changes the file during their streaming session, AppStream 2.0 uploads the new version of the file from the fleet instance to the S3 bucket periodically or at the end of the streaming session. However, the file is not downloaded from the S3 bucket again during the streaming session.
The following sections describe synchronization behavior when you add, replace, or remove a user's home folder file in Amazon S3.
Contents
Synchronization of files that you add to a user’s home folder in Amazon S3
If you add a new file to a user’s home folder in an S3 bucket, AppStream 2.0 catalogs the file and displays it in the list of files in the user’s home folder within a few minutes. However, the file isn’t downloaded from the S3 bucket to the fleet instance until the user opens the file with an application during their streaming session.
Synchronization of files that you replace in a user’s home folder in Amazon S3
If a user opens a file in their home folder on the fleet instance during their streaming session, and you replace the same file in their home folder in an S3 bucket with a new version during that user’s active streaming session, the new version of the file is not immediately downloaded to the fleet instance. The new version is downloaded from the S3 bucket to the fleet instance only after the user starts a new streaming session and opens the file again.
Synchronization of files that you remove from a user’s home folder in Amazon S3
If a user opens a file in their home folder on the fleet instance during their streaming session, and you remove the file from their home folder in an S3 bucket during that user’s active streaming session, the file is removed from the fleet instance after the user does either of the following:
-
Opens the home folder again
-
Refreshes the home folder
