Home Folder sync is temporarily interrupted

Hi,

I understand you have AppStream setup to run Sql Server Management Studio and home folders are enabled but Home Folder sync is temporarily interrupted. You created few test files including home folder and none of them are there when after I exit and start a new session.

This issue mostly occurs if there is no internet connection on your AppStream 2.0 fleet or if you are using a proxy on your streaming instance that doesn't allow connections to the S3 endpoints. For AppStream 2.0 Home Folder to sync successfully, streaming instances must be able to talk to the S3 endpoint as it uses an S3 Bucket (appstream2-36fb080bb8-region-account-id) to store user's Home Folder data.

Please see the action plan below to troubleshoot this issue:

1. Please verify if your fleet has "Default Internet Access" enabled so that your streaming instances will have internet connectivity [1]. If the fleet doesn't have "Default Internet Access" enabled then it will not have direct internet access, please verify if you are using NAT Gateway [2], VPC S3 Endpoint [3] or any custom Proxy that is routing traffic to internet from your VPC where AppStream 2.0 fleet resides.

2. You can test connectivity to the S3 endpoints usingbelow PowerShell cmdlet over port 443 from your streaming instance. S3 Endpoint would change in the command below based on your S3 bucket location. If this test fails then it indicates that there is network level connectivity issue from your AppStream 2.0 fleet.

                  Test-NetConnection -RemoteAddress s3.amazonaws.com  -Port 443
   

3. Verify the proxy configuration on the fleet's streaming instances using command "netsh winhttp show proxy", this would show you if there is any system level proxy configured on the fleet. If yes, then please verify if it's whitelisting required S3 endpoints as well as EC2 metadata IP addresses because AppStream 2.0 Agent (Storage Connector) does not bypass the system proxy server.

4. If there is a proxy configured in Internet Explorer settings then it must have an exclusion for these following metadata IP addresses to mount Home Folders successfully. If these exclusions aren't in place then AppStream 2.0 agent will not be able to successfully authenticate with S3 Bucket to mount Home Folders. 169.254.169.250 169.254.169.251 169.254.169.254

If problems still occur after following the instructions above, please provide the following:

1. Storage connector logs which can be located on the streaming instance in the following location:

   %localappdata%\Amazon\AppStream2\StorageConnector\log\

2. Please confirm the name and region of the problematic AppStream 2.0 resources (I.e. image builder or fleet)

3. Please confirm if domain joined or not

Resources:

[1] Internet Access - https://docs.aws.amazon.com/appstream2/latest/developerguide/internet-access.html

[2] Configure a VPC with Private Subnets and a NAT Gateway - https://docs.aws.amazon.com/appstream2/latest/developerguide/managing-network-internet-NAT-gateway.html

[3] Using Amazon S3 VPC Endpoints for AppStream 2.0 Features - https://docs.aws.amazon.com/appstream2/latest/developerguide/managing-network-vpce-iam-policy.html