XenApp and XenDesktop user/device licensing – troubleshooting and resetting the license count


Issue

We had a call from a customer saying that the users were getting a message stating that they were out of licenses when connecting to their XenApp/XenDesktop sessions. The customer had purchased a fixed number of user/device XenDesktop Enterprise licenses and they had reach the limit when performing user testing. That scenario is quite common when testing is performed with many users accessing the farm from various devices.

Troubleshooting

Procedure 1:

Introducing a new Citrix license management utility named UDADMIN. The tool is command line based and could be located in C:\Program Files (x86)\Citrix\Licensing\LS\  and the tool could only be run from that location by navigating there using a command line.

1

This will give you a list of all licenses currently in use.  From here you can manually delete licenses using the same command with a –delete switch.  License usage data is updated every 15 minutes, however restarting the license service will force an update.  Don’t worry if you accidentally delete a valid license – it won’t disrupt a current session and the license will simply be reissued at the next connection. below is a snippet of the udadmin -list command

Capture

The below command could be issued to delete a user or device license

Capture1

Capture2

Examples

  • udadmin -list Displays all the users and devices.
  • udadmin -list -a Lists all features, versions, counts of licenses, and the users and devices for each feature.
  • udadmin -f XDT_ENT_UD -user u8.08 -delete Releases one user from one feature.
  • udadmin -f XDT_ENT_UD -device dn01.88 -delete Releases one device from one feature.

Complete syntax for the UDADMIN utility can be found here:

http://support.citrix.com/proddocs/topic/licensing-119/lic-admin-cmds-list-deletes-user-device-r.html

Procedure 2

The below method is officially unsupported so use at your own risk.

Step 1 is to stop the Citrix Licensing service

Navigate to the cache directory under C:\Program Files (x86)\Citrix\Licensing\LS\resource\cache  and delete all the files under that.

Capture3

Those files are binary files and as such couldnt be opened in a text editor. Purging the contents of the directory will reset the license usage count to 0. I found this method much quicker to fix the issue as opposed to deleting the licenses checked out one after the other via the Citrix’s official method.

Enjoy!

Advertisements

4 thoughts on “XenApp and XenDesktop user/device licensing – troubleshooting and resetting the license count

  1. Pingback: Citrix Summer Challenge – 1Y0-200 – part 4 | pawelserwan

Leave a 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 )

Twitter picture

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

Facebook photo

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

Google+ photo

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

Connecting to %s