Citrix Application Layering – User layers

As indicated by What’s new in Citrix App Layering 4.1 onwards –https://docs.citrix.com/en-us/citrix-app-layering/4/whats-new/what-s-new-in-app-layering-4-1.html. User layers has been in labs for a number of version updates now.

A User layer  allows you to preserve users’ data and configuration settings. Essentially attaching a VHD during login allowing user profile settings, data, and user-installed applications in non-persistent VDI environments. This provides user flexibility with administrative control in situations where dedicated VDI would traditionally be required(replacement for PVD)

Below image gives context to where User Layers fit in the App layering priority list.

FSLayer3-768x374.png

 

This article is intended to be used to help setup/understand and test the user layers in a test environment before implementing in production. It is NOT advisable to use this in production until it is out of Labs.

NOTES:

  • Supported only on
    • Windows 7, 64-bit
    • Windows 10, 64-bit
  • Available Citrix XenDesktop or VMware Horizon View
  • You set Elastic Layering on an Image Template to Application and User Layers, so that the Layered Image supports User Layers.
  • VHD is created in ELM Appliance Shared “\Users\domainIname\username\OS-Layer-ID-in-hex_OS-Layer-name\username.vhd”. This the default is no other storage location is added and assigned to users/group.
  • User Layers are based on the same technology as Elastic Layers, and therefore share the same limitations
  • When a user first logs into desktop, a User Layer is created.
  • Storage Locations can be added under System\Storage location can be assigned to groups
  • Storage locations are listed in priority order , If a user belongs to more than one group and those groups are assigned to different storage locations, the person’s User Layer will be stored in the highest priority storage location.
  • Multiple access to VHD is not allowed and will result is message “Attach a User Layer because it is in use” being displayed and no information being saved.
  • Policy to reboot device on logoff is required to unlock the VHD and revert back to original image (PVS/MCS does this automatically), not using these provisioning method will cause issues after first login.
  • Default Max size of a User Layer is 10 GB (if no manual override is specified)

    To change default max size , add the following registry override

    HKLM\Software\Unidesk\Ulayer\
    DWORD : DefaultUserLayerSizeInGb
    VALUE: Size required

Enable Feature & Publish Layered Image

Step 1: Browse to System > Settings and Configuration >Labs Section. Select User Layer (Full) and Click Save

applay48Userlayer-1.PNG

Step 2: Adjust the template, browse to Images, Right Click Image Template and Click Edit Template. Select User Layer Full in Layered Image Disk.

applay48Userlayer-2

Step 3:Then Click Publish Layered Image

applay48Userlayer-3

Step 4:Then Click Publish Layered Image

applay48Userlayer-4

Step 5: The published layered image will then be updated to include the User layer setting enabled.

applay48Userlayer-5

Add Storage Location

Step 1 : Create a share with the below permissions on a file share:-

applay48Userlayer-14

In my case “Group to receive user layers” is “WILKYIT\Domain Users”

Step 2: Browse to System > Storage Locations, Click Add Storage Locaiton

applay48Userlayer-6

Step 3: Add Name & the UNC Network Path (\\LAB-DC1\UserLayers$. Click Down Arrow

applay48Userlayer-7

Step 4: Search for Domain Users (an example i am using), Select the Group. Click Down Arrow

applay48Userlayer-8

Step 5: Leave default messages when layer is in use/unavailable/system not reset after user sign out. Click Down Arrow

applay48Userlayer-9

Step 6: Click “Add Storage Locations”

applay48Userlayer-10

Step 7: Confirm additional of storage location on the appliance.

applay48Userlayer-11

Testing

Step 1: Log in a user (in my case ctxuser1)

Step 2: Confirm the VHD is created in the assigned storage location (Not the default)

As per NOTES, The location is in the following format “StorageLocation\Users\domainIname_username\OS-Layer-ID-in-hex_OS-Layer-name\username.vhd”

applay48Userlayer-13

Step 2: Logging off the Windows 10 image , you’ll the VHD has increased in size which will be the

applay48Userlayer-17

Taking a look inside the VHD created (using read-only 7zip) you can see the following:

applay48Userlayer-20

Troubleshooting:-

Two log files are created to give some information.

  • Diag – indicates logon user,sid,machine,logon-time
  • Logoff  – as by the name the logofff user,sid,machine,logon-time

applay48Userlayer-15

applay48Userlayer-16

Further debug user layers, the following log file “ulayersvc” can be found “C:\ProgramData\Unidesk\Logs” which contains details around attaching disk, detaching etc and be a good place to start if you have any issues attaching VHD.

applay48Userlayer-19

14 comments

  1. Hi, I have two storage locations and for each storage location I have signed a group. When I login to the pvs server how does it know where to set my user layer profile? I mean how does the process go, does the applayering agent know that?

    Like

  2. Thanks for good details on setting up the User layer share. In the Testing section you mention to verify the User Layer (UL) is going to the designated UL share – not the Default share location. How do you force it to go there? I’m seeing an issue where my test logins somewhat randomly send me to one or the other between the default and the UL. Citrix suggests to change the path of the Default so the UL will go there for sure, but won’t that impact other things like the Elastic layers?

    Like

  3. […] File shares for User Layers are configured at System > Storage Locations. The Elastic Layer file share is listed by default. But you can add more Locations. Each Storage Location can be assigned to different user groups. And you can prioritize the Storage Locations. See Add storage locations for User layers at Citrix Docs. And see David Wilkinson Citrix Application Layering – User layers. […]

    Like

  4. Hello, We’ve implemented Full User layers on the latest version of ELM and are having Major issues with Windows Apps and Windows Store Apps. We are also having issues with Search/Indexing not working properly. We are Using the Image to create random MCS machines. The Windows 10 apps want to reinstall each time the user logs in and the 3rd time they login they completely stop working. I have a case open with Citrix and it has been open for 26 days. They’ve been terrible at troubleshooting this issue. I’m just wondering if anyone has seen this behavior.

    Like

Leave a Reply to Site Updates – January 2018 – Carl Stalhood Cancel reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.