Using Citrix MetaFrame XP's CTXGINA.DLL in conjunction with Novell client.
(Last modified: 22Sep2003)
This document (10073207) is provided subject to the disclaimer at the end of this document.
fact
Citrix MetaFrame XP
goal
Using Citrix MetaFrame XP's CTXGINA.DLL in conjunction with Novell client.
fact
Citrix MetaFrame XP Feature Release 2 (FR2)
Microsoft Windows 2000 Server with Terminal Services
Microsoft Windows NT 4.0 Server Terminal Server Edition (TSE)
Novell Client for Windows NT/2000/XP
symptom
CTXGINA.DLL displaced by NWGINA.DLL as Windows GinaDLL during installation of Novell Client for Windows NT/2000/XP.
Properly configured TSClientAutoAdminLogon behavior is ignored completely on a MetaFrame XP Feature Release 2 (FR2) server.
Username field is truncated and/or concatenated with the NDS tree name and/or the user's password in MetaFrame XP terminal session.
fix
Citrix MetaFrame XP includes a replacement GINA, CTXGINA.DLL. Windows must be configured to call CTXGINA.DLL first, and then CTXGINA must be properly configured to call through to whichever GINA the MetaFrame XP server actually intends to use in presenting the user authentication dialog.
For a MetaFrame XP server with the Novell Client for NT/2000/XP installed, this means the CTXGINA.DLL needs to be set as the Windows GinaDLL, and then configured to call through to the Novell NWGINA.DLL.
For information on the proper configuration of CTXGINA.DLL on a MetaFrame XP server with the Novell Client for NT/2000/XP installed, see the following document:
CTX634542, Installing the Novell Client on a MetaFrame XP Server
Background:
When Citrix MetaFrame XP is installed, the Windows GinaDLL is set to be CTXGINA.DLL. If a different GINA was current set as the Windows GinaDLL, a separate "CTXGinaDLL" registry value is created such that CTXGINA.DLL will call through and invoke this original GINA. (Also referred to as "GINA chaining" or a "pass-through GINA".)
If Citrix MetaFrame XP is installed on a server where the Novell Client for Windows NT/2000/XP is already properly installed, the Citrix installation process will properly setup CTXGINA.DLL as the primary GINA and the configuration necessary for CTXGINA.DLL to call through to NWGINA.DLL such that the users continue to see the Novell client login dialog as the primary authentication dialog.
If the Novell Client for Windows NT/2000/XP is installed on a server where Citrix MetaFrame XP is already properly installed, the Novell client installation process sets NWGINA.DLL as the Windows GinaDLL such that CTXGINA.DLL is no longer being invoked. On Windows NT 4.0 Server Terminal Server Edition (TSE) the Novell client installation process will prompt to confirm whether the existing GINA should be replaced by NWGINA. On Windows 2000 Server the Windows GinaDLL will simply be set to NWGINA.DLL without prompting.
In either case (whether the customer was prompted during installation of the Novell client or not, and whether the GinaDLL was allowed to be set to NWGINA.DLL or not), installing the Novell Client for Windows NT/2000/XP into an existing Citrix MetaFrame XP installation requires that the customer now configure Windows to set CTXGINA.DLL as the primary GINA and also the configuration necessary for CTXGINA.DLL to call through to NWGINA.DLL.
The involved registry settings, when set for CTXGINA.DLL to call through to NWGINA.DLL, appear as follows:
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsNT\CurrentVersion\Winlogon]
"CTXGinaDLL"="NWGINA.DLL"
"GinaDLL"="CTXGINA.DLL"
Having the CTXGINA.DLL called first by Windows and then calling though to another GINA such as NWGINA.DLL provides opportunity for MetaFrame XP to enhance the data being returned by credential information queries and other GINA calls which would normally be handled by Windows alone. Not having CTXGINA.DLL "in the chain" for invoking the desired GINA can result in some MetaFrame XP features being degraded or disabled. The following documents list some of the issues known to be affected by not having the CTXGINA.DLL properly implemented on a MetaFrame XP server:
document
| Document Title: | Using Citrix MetaFrame XP's CTXGINA.DLL in conjunction with Novell client. |
| Document ID: | 10073207 |
| Solution ID: | NOVL81451 |
| Creation Date: | 01Aug2002 |
| Modified Date: | 22Sep2003 |
| Novell Product Class: | Management Products NetWare |
disclaimer
The Origin of this information may be internal or external to Novell. Novell makes all reasonable efforts to verify this information. However, the information provided in this document is for your information only. Novell makes no explicit or implied claims to the validity of this information.
Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.