Citrix Director - System unavailable error displayed after Director upgrade

book

Article ID: CTX696056

calendar_today

Updated On:

Description

Citrix Director has been upgraded to a recent version (we observed the issue with different upgrade paths 2402 -> 2507, 2511).

The issue occurs in the environment where the default IIS Application Pool location has been changed to a different drive (Physical Path). By default, Director is installed on the C drive.

Administrators and Help Desk users are not able to log in to Director.

The error displayed:

 

image.png

Cause

Assembly binding contains a reference to the C drive, which is not valid in a scenario where the Director files are located on a different drive.

Resolution

How to check current Director location:

 

  • Open IIS Manager and check Director > Manage Application > Advanced Settings

image.png

  • Check Physical Path

image.png

 

How to resolve the issue:

  • Backup the existing web.config file located in the Physical Path location (screenshot above).
  • Edit the file in the text editor.
  • Locate the problematic assembly binding (usually at the bottom of the config file).
  • Change the 'linkedConfiguration' link and point to the valid location (change the drive letter).

Example:

  <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <!-- autogenerated bindings are in a different file -->
    <linkedConfiguration href="file://C:\inetpub\wwwroot\Director\Bin\WebService.dll.config"/>
  </assemblyBinding>
  • Save the file.
  • Restart IIS (you can do this from cmd.exe, command: IISRESET).

 

Issue/Introduction

Administrators and Help Desk users are not able to log in to Director.