• No results found

Citrix Technical Support: Brief Troubleshooting Guide

N/A
N/A
Protected

Academic year: 2020

Share "Citrix Technical Support: Brief Troubleshooting Guide"

Copied!
56
0
0

Loading.... (view fulltext now)

Full text

(1)

Citrix Technical Support:

Brief Troubleshooting Guide

(2)

Introduction

This Brief Troubleshooting Guide is intended as the first resource for Citrix administrators and Citrix engineers to troubleshoot technical issues for all Citrix products and technologies.

The Brief Troubleshooting Guide provides you with a single point of access to narrow down your technical issues and help you resolve as many as possible in an autonomous manner.

Citrix Technical Support expects you to have carried out basic troubleshooting before you contact them, and will request this information from you, helping to decrease resolution time.

Each product section includes a brief description, supported languages, links to Knowledge Base articles and third-party articles, troubleshooting tools and questions, and information to gather to help you pinpoint the your technical issues.

An electronic copy of this document is available from CTX106727 This Brief Troubleshooting Guide should be used when tackling any issue.

The Knowledge Center continues to be a very useful resource and is constantly being updated by Citrix Technical Support engineers worldwide.

If there is an article that you would like to see in our Knowledge Center, please let us know. Any feedback you have on this Brief Troubleshooting Guide is also welcome.

(3)

Table of Contents

1. METAFRAME PRESENTATION SERVER FOR WINDOWS . . . .8

1.1. Languages Supported . . . .8

1.2. Administration Guides . . . .8

1.3. Supported Versions . . . .8

1.4. Troubleshooting Questions to Ask . . . .9

1.5. Related Knowledge Base Articles . . . .14

1.6. Other Relevant Information . . . .14

2. RESOURCE MANAGER . . . .15

2.1. Languages Supported . . . .15

2.2. Administration Guides . . . .15

2.3. Troubleshooting Questions to Ask . . . .15

2.4. Related Knowledge Base Articles . . . .15

3. INSTALLATION MANAGER . . . .16

3.1. Languages Supported . . . .16

3.2. Administration Guides . . . .16

3.3. Troubleshooting Questions to Ask . . . .16

3.4. Related Knowledge Base Articles . . . .16

3.5. Other Relevant Information . . . .16

4. NETWORK MANAGER . . . .17

4.1. Languages Supported . . . .17

4.2. Administration Guides . . . .17

4.3. Troubleshooting Questions to Ask . . . .17

4.4. Related Knowledge Base Articles . . . .17

5. PRESENTATION SERVER MANAGEMENT PACK FOR MOM . . . .18

5.1. Languages Supported . . . .18

5.2. Administration Guide . . . .18

5.3. Troubleshooting Questions to Ask . . . .18

5.4. Related Knowledge Base Articles . . . .18

6. CITRIX ACCESS ESSENTIALS . . . .19

6.1. Languages Supported . . . .19

6.2. Administration Guide . . . .19

6.3. Troubleshooting Questions to Ask . . . .19

6.4. Related Knowledge Base Articles . . . .19

7. WEB INTERFACE . . . .20

7.1. Languages Supported . . . .20

7.2. Administration Guide . . . .20

7.3. Troubleshooting Questions to Ask . . . .20

7.4. Related Knowledge Base Articles . . . .25

7.5. Other Relevant Information . . . .25

8. CITRIX ACCESS GATEWAY . . . .26

8.1. Languages Supported . . . .26

8.2. Administration Guides . . . .26

8.3. Troubleshooting Questions to Ask . . . .26

(4)

9. SECURE GATEWAY . . . .28

9.1. Languages Supported . . . .28

9.2. Administration Guides . . . .28

9.3. Troubleshooting Questions to Ask . . . .28

9.4. Related Knowledge Base Articles . . . .31

9.5. Other Relevant Information . . . .31

10. ICA CLIENTS . . . .32

10.1. Languages Supported . . . .32

10.2. Administration Guides . . . .32

10.3. Troubleshooting Questions to Ask . . . .32

10.4. Related Knowledge Base Articles . . . .33

10.5. Other Relevant Information . . . .33

11. UNIX CLIENT . . . .34

11.1. Current Version . . . .34

11.2. Languages Supported . . . .34

11.3. Administration Guide . . . .34

11.4. Troubleshooting Questions to Ask . . . .34

11.5. Related Knowledge Base Articles and Troubleshooting Tools . . . .35

11.6. Other Relevant Information . . . .35

12. CITRIX ACCESS SUITE LICENSING . . . .36

12.1. Languages Supported . . . .36

12.2. Administration Guides . . . .36

12.3. Troubleshooting Questions to Ask . . . .36

12.4. Related Knowledge Base Articles . . . .37

12.5. Most Common Problems . . . .37

12.6. Other Relevant Information . . . .37

13. METAFRAME XP PRESENTATION SERVER LICENSING . . . .38

14. ADVANCED ACCESS CONTROL . . . 40

14.1. Languages Supported . . . .40

14.2. Administration Guides . . . .40

14.3. Troubleshooting Questions to Ask . . . .40

14.4. Related Knowledge Base Articles . . . .42

14.5. Other Relevant Information . . . .42

15. CITRIX DIAGNOSTIC FACILITY (CDF) . . . .43

15.1. Products Supported . . . .43

15.2. How to Enable Tracing . . . .43

15.3. Tools . . . .43

15.4. Related Knowledge Base Articles . . . .44

16. METAFRAME SECURE ACCESS MANAGER . . . .45

16.1. Languages Supported . . . .45

16.2. Administration Guides . . . .45

16.3. Troubleshooting Questions to Ask . . . .45

16.4. Related Knowledge Base Articles . . . .46

16.5. Most Common Problems . . . .46

(5)

17. CITRIX PASSWORD MANAGER . . . .47

17.1. Languages Supported . . . .47

17.2. Administration Guide . . . .47

17.3. Troubleshooting Questions to Ask . . . .47

17.4. Related Knowledge Base Articles . . . .49

18. CONFERENCING MANAGER FOR CITRIX®PRESENTATION SERVER . . . .50

18.1. Languages Supported . . . .50

18.2. Administration Guide . . . .50

18.3. Troubleshooting Questions to Ask . . . .50

18.4. Related Knowledge Base Articles . . . .51

18.5. Other Relevant Information . . . .51

19. CITRIX METAFRAME PRESENTATION SERVER FOR UNIX . . . .52

19.1. Languages Supported . . . .52

19.2. Administration Guide . . . .52

19.3. Troubleshooting Questions to Ask . . . .52

19.4. Related Knowledge Base Articles . . . .54

20. CONTACTING CITRIX TECHNICAL SUPPORT . . . .55

20.1. Your Citrix Technical Support Checklist . . . .55

(6)

Citrix Technical Support:

(7)

1.

Citrix Presentation Server for Windows

Citrix Presentation Server™is the easiest way to manage enterprise applications from a central location and access

them from anywhere. The foundation of the Citrix Access Suite™, Citrix Presentation Server is the world’s most widely

deployed presentation server for centrally managing heterogeneous applications and delivering their functionality as a service to workers, wherever they may be.

http://www.Citrix.com/site/PS/products/product.asp?familyID=19&productID=186

1.1.

Languages Supported

English, French, Spanish, German

1.2.

Administration Guides

Each version of Presentation Server for Windows®has its own administrator’s guide. These can be found in the product

documentation section of the Citrix web site – http://support.citrix.com/docs/

Most common versions

• CTX106319– Citrix Presentation Server 4.0 Administrator's Guide • CTX103723– MetaFrame Presentation Server 3.0 Administrator’s Guide

• CTX16879 – MetaFrame XP Presentation Server with Feature Release 3 Administrator’s Guide

1.3.

Supported Versions

There are currently three releases of Presentation Server supported by Citrix: MetaFrame XP®Presentation Server,

MetaFrame®Presentation Server 3.0, and Citrix Presentation Server 4.0. The troubleshooting information below applies

to all three of these releases, unless otherwise specified.

On February 2, 2004 Citrix announced the End of Life (EOL) schedule for the MetaFrame 1.8 product line. As of January 1, 2006 there will be no further support of any level available for the MetaFrame 1.8 product line. For further information regarding Citrix product lifecycle support, see the Citrix website at

http://www.citrix.com/site/SS/supportThird.asp?slID=5107&tlID=5110

Troubleshooting guides for MetaFrame 1.8 can be found in the following locations: • CTX107559– Troubleshooting MetaFrame 1.8 for Windows

(8)

1.4.

Troubleshooting Questions to Ask

Gathering General Information

• What are the details of your environment: size of server farm, version(s) of Presentation Server, operating system(s) of server(s), Service Packs, WAN/LAN architecture?

This information can be obtained automatically by using one of the following methods: • Run the diagnostic tool from the Access Suite console

(you can collect server farm information, Presentation Server computer information and event logs). See CTX104578for more information.

• Run the CTXDataXP utility available from Citrix Technical Support to collect environment information (MetaFrame XP only). See CTX106682for more information.

• For assistance in manually determining the version of Presentation Server that is running, please see the article CTX107570

• Which types of clients are in use? (If this is a client issue refer to the ICA clients section.) • What is the exact issue that you are having? (What is happening or what should happen?) • What are the exact steps to reproduce the issue?

• When did it start? What triggered the issue?

• Who is affected by the issue (administrators and/or users)? • Does the issue affect all servers or only some?

• Do you get an error (send screenshot) or an event in the event log? • Can the issue be reproduced at the server console in a loop-back session?

(Make a test ICA connection from the server back to the same server desktop.) • Can the issue be reproduced when using RDP?

• What troubleshooting steps have you taken to resolve this issue? • Have you tested with seamless and non-seamless connections?

Troubleshooting Installation

• Where in the install did the failure occur?

Send a screenshot of the last panel seen before the failure occurs.

• Are there any errors recorded in the event viewer? If so, please obtain and send. • Does the problem occur with a local database (Access or MSDE or with Oracle/SQL)?

If it is a third-party database, is it on a dedicated database server?

• Is the installation performed from a CD or a network share? Does it work if the CD is copied to the server? • Are you trying to install onto a domain controller or server with different OS language?

This is not supported.CTX106529 • Which account was used during the install?

• Send the install log generated using “msiexec.exe mps.msi /L*v install.log.” • During the installation, are you joining a farm or creating a new farm? • Is the server built from an image (Ghost/Altiris, etc.)?

• Is the install a standard install or an unattended install?

• Check the build number in the Readme on the Presentation Server CD.

NOTE: There are two different user accounts involved: the first is the user you are logged in as while you are performing the install.

(9)

Troubleshooting IMA Service and Data Store

• What is the data store type, and is it on a dedicated server? CTX105257 • Is a change farm possible to confirm that the data store is not corrupt?

(Refer to chfarm section of Administrator’s Guide – p 357) • Use Qfarm to identify which server is the data collector.

• Does changing the data collector help? Farm Properties →Zone – Set Election Preference. • Does the IMA service start? If not, what is the error message?

Check event viewer – send errors to Citrix Technical Support. • What is the current loading plug-in? Check in:

HKLM\SOFTWARE\Citrix\IMA\Runtime\CurrentlyLoadingPlugin

• Check the article on troubleshooting IMA service for possible causes:CTX105292

• For MetaFrame Presentation Server 3.0 and Citrix Presentation Server 4.0, enable tracing via the CDF and send the log file from the server during an attempted IMA service restart to Citrix Technical Support:CTX104578

• For MetaFrame XP Presentation Server, enable IMA subsystem tracing, and send log to Citrix Technical Support. See CTX539756to determine which modules to trace.

• Verify in the Administrator’s Guide that the MDAC (Microsoft Data Access Components) is a supported version. See CTX809548– How to Determine the MDAC Version.

Troubleshooting Load Manager

• Ensure that you have Advanced or Enterprise Edition of Presentation Server. Highlight server to set edition. • Run qfarm/app and send Citrix Technical Support the result (included in CTXDataXP).

• Are there many disconnected sessions? (Disconnected sessions do not use load balancing.) See CTX439031.

• Are you using custom connections to connect directly to a specific server? These do not use the load balancing system.

• Is Load Manager showing correct information in the Presentation Server Console? (CTX103441) If incorrect, take a screenshot and send to Citrix Technical Support.

• Does the issue persist when default load evaluators are used?

Troubleshooting Connectivity Issues

• Check article CTX106250for troubleshooting ICA session initialization steps.

• Is the same behavior seen with a local account from the server? With an admin account? With a brand-new user account?

• Can you ping the server and telnet to the ICA port (1494 by default)?

• Are there any routers, firewalls or proxy servers used between the client and the server? • Can you connect using RDP?

• Do you use TCP/IP+HTTP or only TCP/IP? (Check PN > Application Set Settings > Network Protocol.) • Can you make a direct ICA connection to the server? Using its NetBIOS name? IP address?

Using Program Neighborhood, Web Interface or published applications?

• Does a loop-back connection (ICA connection from the server console back to the same server) work? • Can you delete and create a new ICA listener from the Citrix connection configuration tool?

(10)

• Can you connect if session reliability is disabled? (MetaFrame Presentation Server 3.0 and Citrix Presentation Server 4.0 only). You can disable on the server via Management Console | Farm properties | Session reliability tab or ICA client application set settings | Default options. • Use netstat to check that server is listening on connection ports:

• 1494 (by default) for ICA

• 2598 (by default) for session reliability

Troubleshooting Printing Issues

General

• What kind of printer is it: client autocreated/client network printer/CMC assigned network printer? • What are the make and model and driver of the printer?

• Is the driver installed on Presentation Server? (Check in Print Server Properties | Drivers tab or CMC.) • Is driver mapping or compatibility list used?

(Check in CMC | Printer Management | Drivers tab | Compatibility.)

• Is the printer issue only with a specific application? Test that application with RDP. • Are printers created synchronously or after the application is displayed?

Check application properties | client options.

• CTX458114– Steps for Connecting Local Printers to Thin Client Devices

• CTX774641– Printer Driver Replication Failed for Certain Printers and Printer Drivers • CTX104553– A4 Paper Size Setting and Citrix Printing

• CTX051476– Troubleshooting the Deletion of AutoCreated Printers

MetaFrame XP or MetaFrame Presention Server 3.0

• Does the printer autocreate if Universal Print Driver (UPD) is used? (CMC | Printer Management | Properties | Universal Driver)

• For autocreation issues, refer to CTX681954– Troubleshooting Citrix ICA Printer Autocreation • For printer settings issues refer to CTX959786– User Defined Printer Properties

• Check the CMC | Policies node for any Citrix policies that control printing. Check the policy filter. Check if there are any policies with higher priorities.

• CTX881017– Troubleshooting MetaFrame XP Imported Network Print Servers

Citrix Presentation Server 4.0

• Printing architecture is changed in CPS 4.0: extra troubleshooting steps are required.

• Autocreation of printers is now manually controlled and to be configured through a policy in the Management Console; it is no longer automatic.

• Check the policy filter. Check if there are any policies with higher priorities with similar settings. • Test reverting to pre-CPS 4.0 printer functionality by enabling the “Legacy Client Printers” rule in

the policy.

• While a user is logged in, check that the policy is actually enforced on the session of the Server registry key HKLM | Software | Citrix | Sessionid

• CTX107137– Troubleshooting Printing Problems in Presentation Server 4.0 • Test ICA client 9.0 or later to take advantage of CPS 4.0 printing changes

• CTX106698– Unable to Print from Presentation Server 4.0 when Connecting via ICA 9.0 Client • CTX106623– Failure to Create Printer Monitors or Drivers When an Application is Installed into

an Isolation Environment

(11)

Questions for Application Install & Integration Issues

• Is this application a multi-user application Ref TechNet? (Check with vendor.) Consider using AIE. • Is AIE involved? Refer to Troubleshooting Application Isolation Environments below.

• What are the name and version number of the application?

• If the application is custom-written, what language was it written in? Is it a 16bit, 32bit or 64bit application? Any other application details?

• Does the application run properly when you are logged in at the server console? • Do you have the same issue when you make an ICA connection to a desktop?

• Do you experience the same problem using a seamless connection? A fixed-size window? Different color depths?

• Is it working with an RDP client?

• Was the application installed using Add/Remove Programs (change user/install mode)? • CTX101709– How to Troubleshoot Application Integration Issues

• Can you install the application on a server without Terminal Services?

• For CPS 4.0, check if the application requires unique client-IP addresses or loop-back addresses (127.0.0.1) to function properly. See the Virtual IP section below.

• For CPS 4.0, check if Memory Optimisation enabled at the farm or server level.

Does the application work properly if the feature is disabled or the offending processes are excluded? • For CPS 4.0, check if CPU Utilization Management is enabled at the farm or server level.

Does disabling this feature affect the application?

Troubleshooting Performance Issues/Server Lock-ups

• What kind of server is it (IBM, Compaq, Dell, etc.) and how much CPU and RAM? • Does the event viewer show any entries just before the slow-down or trap occurs? • Under what conditions is the server lock-up seen?

• Does the slow-down also occur when connected using RDP? • Is the server blue-screening? What is the STOP code? • See Troubleshooting Blue Screens – Q216206. • Is a memory dump created? If not, can you create one?

• If the server freezes completely, can you generate a full dump (Q244139)?

• Can you see which process and thread (TID) is hogging CPU using Qslice (from Windows Resource Kit)? • CTX106110– How to Get a Spiking Thread ID Using Process Explorer When QSlice Utility Does Not Work • Can you get a user dump of the process that is using high CPU? See Q278689 –

How to Manually Create a User.dmp File with Dr.Watson. Could you FTP the dump to Citrix site? Contact Citrix Technical Support for FTP instructions.

• If a process crashes a Dr Watson dump is generated, see Q308538, Q246084, then FTP to Citrix site – contact Citrix Technical Support for FTP instructions.

• CTX105888– Dr. Watson doesn’t work as the default debugger

(12)

Troubleshooting Virtual IP Issues (Presentation Server 4.0 only)

• To correctly configure the virtual IP feature, you may need to work with your application vendor to determine the specific requirements of the application.

• To determine whether the application requires a virtual IP address or virtual loop-back address, consult the Administrators Guide (p 240).

• Ensure that the IP address range provided to the Presentation Server(s) is unique and is on the same subnet as the Presentation Server(s).

• Ensure that the virtual IP address range is correctly assigned to appropriate servers via the farm and/or server properties.

• Check that the correct processes are configured for virtual IP and/or virtual loop-back within the virtual IP process section of the farm properties.

• Check that the correct IP address is being assigned to the process by using TCPView from SysInternals • If there is a red ‘X’ beside the server name when configuring farm properties, ensure that virtual IP

is enabled at the server level – CTX106063

Troubleshooting Application Isolation Environment Issues (Presentation Server 4.0 only)

• CTX106868– Application Isolation Environments Explained

• CTX106100– Application Isolation Environment Supported Applications

• Refer to Advanced Concepts Guide Troubleshooting Application Compatibility Issues section • Ensure that AIE is enabled in the Management Console Farm Properties | Isolation Settings • Is the application installed into an AIE using AIESETUP or associated with an AIE?

Check Management Console AIE Properties

• Does the application install correctly using the AIESETUP command? What is the error message? • Are there any sessions at install time? Reboot the server and retry.

• Is it possible to create a new AIE in the Management Console and try again? • Verify that the folders and registry keys were created after application install.

Check AIE properties for exact locations.

• Does the application launch successfully using the AIERUN command on the server console? • Is it possible to publish the application?

• Can the application be correctly seen in the Management Console AIE Properties after installation? • Why exactly did the application need to be isolated?

• Can you provide a copy of the software to Citrix Technical Support for testing?

• You should involve the software developer, who may advise you to add rules to the AIE properties. • CTX106595– Unable to Start Different Versions of Acrobat Reader in an Isolation Environment

from a Single User Session

Migrating and Upgrading Presentation Server from Previous Versions

Citrix recommends using the latest release of Presentation Server, and having all servers on the same product version and service pack. For further information regarding Citrix product lifecycle support, see the Citrix website:http://www.citrix.com/site/SS/supportThird.asp?slID=5107&tlID=5110

When migrating your server, you should consult the guide corresponding to the version you wish to migrate to.

(13)

1.5.

Related Knowledge Base Articles

1.6.

Other Relevant Information

• CTX107572 Troubleshooting Tools for Your Citrix Environment

• CTX101892 Application Troubleshooting in a MetaFrame Environment

• CTX564283 How to Troubleshoot 1003 and 1004 Terminal Server Licensing Errors

• CTX159159 Troubleshooting and Explaining Session Sharing

• CTX424827 Troubleshooting and Installing the Citrix Web Console

• CTX881017 Troubleshooting MetaFrame XP Imported Network Print Servers

• CTX051476 Troubleshooting the Deletion of AutoCreated Printers

• CTX089874 Troubleshooting and Explaining the Citrix Universal Print Driver, UPD

• CTX104216 Troubleshooting and Optimizing Digital Dictation

• CTX086028 Troubleshooting Client Clipboard Issues

• CTX103126 Troubleshooting Server to Client Content Redirection

• CTX238200 Troubleshooting Various Client Drive Mapping Issues

• CTX107433 The Logon Process Hangs At "Running logon scripts..."

• CTX101705 Troubleshooting Slow Logons

• CTX104891 Troubleshooting Slow Logoff

• CTX106021 FAQ: The CPU Utilization Management Feature

• CTX106023 Virtual Memory Optimization Feature

• CTX956895 Error: Could Not Write Application Data to the Citrix Server Farm.

• CTX107323 Unable to Delete Objects from the Citrix Management Console

• CTX106951 Session Stays in Active State After User Logs Off

• CTX102750 Seamless Applications Launch in a Fixed Window

• CTX106920 Error: You do not have access to logon to this Session...

• CTX107411 Troubleshooting TWAIN with Citrix Presentation Server 4.0

• CTX106610 Error: An unknown error occurred while communicating with server <servername>

• CTX228511 Explaining Printer Properties for Network Printers

• CTX106058 Known issues with Windows 2003 Service Pack 1

• CTX106393 How to Recreate the Ctx_SmaUser Account

• CTX107059 Advanced Concepts Guide for Citrix Presentation Server 4.0

• CTX104144 Advanced Concepts Guide for MetaFrame Presentation Server 3.0

(14)

2.

Resource Manager

Presentation Server administrators can use Resource Manager to monitor, report and collect server resource metrics, as well as the execution of processes, for all Presentation Servers in the server farm. Enterprise edition of Presentation Server is required.

http://www.Citrix.com/site/PS/products/product.asp?familyID=19&productID=186

2.1.

Languages Supported

English, Spanish, French, German

2.2.

Administration Guides

CTX5178 – Administrator's Guide – Resource Manager for MetaFrame XPe, FR3 CTX103746– Administrator's Guide – Resource Manager for MPS 3.0

CTX106471– Administrator's Guide – Resource Manager for CPS 4.0

2.3.

Troubleshooting Questions to Ask

Installation

• RM is installed by default with enterprise edition of MetaFrame XP Presentation Server. • Use add/remove programs to add or remove RM plug-ins for the Presentation Server console.

General

• CTX104629– Troubleshooting Resource Manager Issues

• Contact Citrix Technical Support for the utility to reset Resource Manager metrics thresholds to the default values.

RM Summary Database

• What database type is being used? Please check that other databases are working correctly on that server.

• Can you back up your summary database and send it to Citrix Technical Support? Please refer to your database documentation for information on how to make a backup.

2.4.

Related Knowledge Base Articles

• CTX103807 Webcast Resource Manager Architecture and Troubleshooting

• CTX103248 Resource Manager Summary Database – Database connection error

• CTX18438 Using Crystal Reports Templates With Citrix Resource Manager

• CTX103121 Explaining the Resource Manager Node within the Citrix Management Console

• CTX103021 How to Query the Resource Manager Database for Clientname and IP Address

• CTX101581 An Unknown error occurred while trying to get the log for Resource Manager. Error code: C0160AE3

(15)

3.

Installation Manager

Installation Manager is a feature of Presentation Server, Enterprise Edition that allows you to rapidly deploy applications and software components to your servers from a central location.

http://www.Citrix.com/site/PS/products/product.asp?familyID=19&productID=186

3.1.

Languages Supported

English, Spanish, French, German

3.2.

Administration Guides

CTX106469– IM Administrator’s Guide for CPS 4.0 CTX103718– IM Administrator’s Guide for MPS 3.0 CTX15807 – IM Administrator’s Guide for XP FR3

3.3.

Troubleshooting Questions to Ask

General

• CTX104859– Troubleshooting Installation Manager Issues

3.4.

Related Knowledge Base Articles

3.5.

Other Relevant Information

• CTX104225 Error applying transforms. Verify that the specified transform paths are valid

• CTX101787 Installation Manager concerns when executing CHFARM

• CTX106516 Citrix Installation Manager Application Compatibility Guide for CPS 4.0 provides useful information about specific compatibility issues that occur if you package, install,

or uninstall applications using Installation Manager.

• CTX105048 Citrix Installation Manager Application Compatibility Guide for MPS 3.0

• CTX101927 Citrix Installation Manager Application Compatibility Guide for MF XP FR3

(16)

4.

Network Manager

Network Manager is the component, included with the Enterprise Edition of Presentation Server, that provides systems management capabilities through third-party SNMP management consoles.

http://www.Citrix.com/site/PS/products/product.asp?familyID=19&productID=186

4.1.

Languages Supported

English, Spanish, French, German

4.2.

Administration Guides

CTX106453– NM Administrator’s Guide for CPS 4.0 CTX103745– NM Administrator’s Guide for MPS 3.0 CTX19193 – NM Administrator’s Guide for XP FR3

4.3.

Troubleshooting Questions to Ask

General

• CTX701562– Troubleshooting Tips for Network Manager

4.4.

Related Knowledge Base Articles

(17)

5.

Presentation Server Management Pack for MOM

The MetaFrame Presentation Server Management Pack for Microsoft Operations Manager (MOM) is for system administrators who want to monitor the health and availability of their MetaFrame Presentation Server Enterprise Edition servers and server farms.

MOM is a management solution for Microsoft Windows server deployments. MOM collects, filters, analyzes, responds and reports on information about computers – all from a single view on a desktop console. System administrators can use MOM for performance monitoring, event management, alerting and reporting, and trend analysis.

For more information about MOM, see Microsoft’s Web site: http://www.microsoft.com/mom. http://www.microsoft.com/management/training/webcasts.mspx#MOM

http://www.citrix.com/English/SS/downloads/details.asp?dID=8218&downloadID=8219&pID=198

5.1.

Languages Supported

English

5.2.

Administration Guide

CTX106454– Management Pack Administrator's Guide (CPS 4.0)

5.3.

Troubleshooting Questions to Ask

Installation

• CTX18339 – Installation Guide –

Citrix MetaFrame XP Management Pack for Microsoft Operations Manager 2000 (XP FR3) The management pack can be downloaded from the downloads area of www.citrix.comthe Citrix website: http://www.citrix.com/English/SS/downloads/details.asp?dID=8218&downloadID=8219&pID=198

General

• CTX105241 – MetaFrame Management Pack Support for MOM • Check the eventvwr.msc for any errors.

• Ensure that the Citrix WMI service is running in services.msc. Does restarting the service resolve the issue?

• What is the error message received in the MOM console? • Is the error appearing on all servers?

5.4.

Related Knowledge Base Articles

• CTX107065 Configuring Disconnection Rate Rules in the Citrix Management Pack for MOM 2005

• CTX107064 Configuring Idle Session Rules in the Citrix Management Pack for MOM 2005

(18)

6.

Citrix Access Essentials

Citrix Access Essentials™is on-premises software specially designed, packaged, and priced for organizations with up

to 75 Windows users. It provides secure, remote aplication access and enables simple centralized management of infor-mation resources.

http://www.citrix.com/English/ps2/products/product.asp?contentID=21376

6.1.

Languages Supported

English, French, Spanish, German

6.2.

Administration Guide

CTX107071– Citrix Access Essentials 1.0 Administrator’s Guide

6.3.

Troubleshooting Questions to Ask

Citrix Access Essentials is based on Citrix Presentation Server 4.0, Web Interface 4.0 and Secure Gateway 3.0. For this reason many of the same troubleshooting steps and Knowledge Base articles apply, and the earlier sections in the Brief Troubleshooting Guide should be consulted.

The major differences between Presentation Server 4.0 and Access Essentials are briefly summarised as:

• Access Essentials is limited to 75 named users.

• Access Essentials is limited to a single server deployment.

• Only connections via Web Interface are supported for Access Essentials.

• Smooth Roaming and the associated technologies (session reliability and workspace control) are not licensed in Access Essentials.

• The TWAIN redirection feature of Presentation Server 4.0 is not supported in Citrix Access Essentials 1.0. • Servers containing multiple network interface cards are not supported.

• Load Manager and Resource Manager are visible in Add/Remove Programs, but are limited by license, so are not operational or supported.

• Although Novell Directory Services is configurable in the user interface, integration with NDS is not supported.

6.4.

Related Knowledge Base Articles

• CTX107097 Citrix Access Essentials – Unsupported Features

(19)

7.

Web Interface

Web Interface for Citrix®Presentation Server is an application deployment system that provides users with access

to Presentation Server applications through a standard Web browser. Web Interface employs Java and .NET technology executed on a Web server to dynamically create an HTML depiction of server farms for your users. Each user is presented with all the applications published in the server farms for that user. With Web Interface, you have centralized application management capabilities and complete control over the application deployment process. You can create standalone Web sites for application access or Web sites that can be integrated into your corporate portal. http://www.Citrix.com/site/PS/products/product.asp?familyID=19&productID=186

7.1.

Languages Supported

English, Spanish, French, German, Japanese

7.2.

Administration Guide

CTX106472– Web Interface Administration Guide

7.3.

Troubleshooting Questions to Ask

General Questions

• What is the error message? (Send a screenshot.)

• What is the version of the Web server (IIS5, IIS6, Apache, …)? • Is the error message coming from the Web server or Web Interface?

(Message from WI will be displayed in the page but you will still see a Citrix logo.)

Installation

• Do you have any COM error messages in the event viewer? (Send the event viewer files.) • Has IWAM account been modified/disabled?

• See Q297989 for more details • Could you synchronise the IWAM account?

• Configured Identity Is Incorrect for IWAM Account – Q297989

• Description of Adsutil and MetaEdit Utilities Used to Modify the Metabase – Q240225

Website Creation

• Did you create a web site using the Access Suite Console after installing Web Interface? (WI 4.0 does not create a default web site during installation.)

• Are you trying to create a web site using central or local configuration?

• If using central configuration, is the server hosting the Access Suite Console on the same domain as Citrix Presentation Server 4.0?

• Is the Web Interface server part of a different domain (as the Presentation Server) or a workgroup? • If using central configuration, are you pointing to Presentation Server 4.0?

(Only this version is supported for central configuration.)

(20)

Authentication

• What is the type of authentication in use (smart card, single sign-on, Explicit, NDS,…)? Select Configure Authentication Methods

(21)

• Has strong authentication being enabled?

• Do you have the same problem if you disable the strong authentication? • Could you logon locally on the server running the XML service? • Do the users go through a proxy server?

• If using several farms on different domains, does a trust relation ship exist between the domains?

Enumerating Applications

• Did you re-create the LHC on the server(s) running the XML service? (CTX759510) • Could you use Tube to capture the XML traffic and send us the capture file?

(See troubleshooting tools below.)

Launching Applications

• Does it happen with all the ICA clients? • What is the version of the ICA client(s)? • Has the template.ica file been modified? • Could you send the template.ica?

• Have the DMZ settings been changed? (Send a screen shot.) • In the Access Suite console,

(22)

• If the DMZ settings have been changed, what are the address translation settings? • In the Access Suite Console,

select the Manage Secure Client Access→Edit Address translationsection

• Is Secure Gateway enabled? (Send a screen shot.) • In the Access Suite Console,

(23)

• You can see the general configuration by selecting in the Access Suite Console

Manage Secure Client Access→Display Settings

• Is same problem seen if you disable Secure Gateway?

• Can you download the ICA file? (Right-click on the application icon and launch it by double-clicking on it.) • Can you send the ICA file?

• Does it happen for all the users (internal, external)?

Troubleshooting Tools

(24)

7.4.

Related Knowledge Base Articles

7.5.

Other Relevant Information

• CTX107181 Error: An error has occurred while connecting to the requested resource

• CTX107061 Error: The supplied credentials were invalid...

when using password with a leading or trailing character that is a SPACE

• CTX102226 Error: The credentials supplied were invalid. Please try again... with RSA integration

• CTX107146 Error: You do not have access to logon to this session... When launching sessions from Web Interface

• CTX106617 Citrix ISAPI Extensions Return HTTP Error 404 (ConfProxy, STA, XML)

• CTX107270 Web Interface 4.0 does not display a link to download the ICA Client when using the Safari Browser

• CTX107235 ICA Client for Macintosh OS X is not displayed on Web Interface 4

• CTX106697 Download client from the Citrix client download site link redirects the users to the Citrix Systems download site...

• CTX106803 Password Expiry Detection Failure in Web Interface 4.0

• CTX103163 Error: Your session with the web server expired. You have been logged out

• CTX106681 Error in WebInterfaceSetupDotNet.exe When Installing Web Interface 4.0

• CTX106114 Web Interface 4.0 Command-line Installation and Site Management

• CTX107053 Smart Access for Web Interface Guide

• CTX106665 Customizing the Web Interface for Presentation Server 4.0

• CTX107050 Enabling Citrix Access Management Console Traffic Across Firewall Policies

• CTX106974 Web Interface 4.0 Troubleshooter's Guide

(25)

8.

Citrix Access Gateway

Citrix Access Gateway™is a universal SSL VPN appliance that provides a secure, always-on, single point-of-access

to any information resource. It has all of the advantages of IPSec and typical SSL VPNs – without the costly and cumbersome implementation and management – making access easy for users, secure for the company and low-cost for IT administrators. It works in both non-Citrix and Citrix environments, and provides the best integration with Citrix Presentation Server.

http://www.citrix.com/English/ps2/products/product.asp?contentID=15005&ntref=PROHOME_ProductsBar

8.1.

Languages Supported

English, French, Spanish, German

8.2.

Administration Guides

CTX106783– Citrix Access Gateway Administration Guide CTX106776– Access Gateway Enterprise Administration Guide

8.3.

Troubleshooting Questions to Ask

Installation

• What is the error message you are receiving? • Send screenshot of error message • Hardware issue?

• If you are having an issue during the install and hardware may be the issue, consult the hardware error information article – CTX106921

• Have you upgraded to the latest release?

• See CTX106192– Access Gateway Software Updates • Readme for Access Gateway 4.1.2 – CTX107403

Configuration

• Are you integrating Web Interface with Access Gateway?

• See CTX106978– How to Integrate Access Gateway with Web Interface • What is the exact error message you are receiving?

• Send screenshot error message • Configuring network information

(26)

• Configuring Authentication and Authorization

• See P57 of the Access Gateway Administrator’s Guide • Configuring local users and groups

• See P80 of the Access Gateway Administrator’s Guide • Configuring Web Interface to support Access Gateway

• See P104 of the Access Gateway Administrator’s Guide

User Errors

• Is the user connecting from a private or public computer?

• Private computer – See P122 of the Access Gateway Administrator’s Guide for more information • Public computer – See P125 of the Access Gateway Administrator’s Guide for more information • User receives Disconnected message when using kiosk mode client

• See CTX106694for resolution

• What is the error message that the user receives? • Send screenshot or event log error message

Web Interface Integration

• Did you install and configure Web Interface? • See P43 of the Web Interface Admin Guide

8.4.

Related Knowledge Base Articles

• CTX106921 Citrix Access Gateway Hardware Error Information

• CTX105961 Access Gateway Quick Start

• CTX107403 Readme for Access Gateway 4.1.2

• CTX106694 Users Receive Disconnected Message … When Using the Kiosk Mode Client

• CTX107203 The Access Gateway Client Installs But Fails To Initialize – User Enters Into Unprivileged Mode

• CTX107495 Configuring Radius Authentication on Windows 2003 for Use with Citrix Access Gateway

• CTX107110 Duplicate Gateways Appear in Access Gateway Administration Tool

(27)

9.

Secure Gateway

Secure Gateway for Citrix®Presentation Server is a Presentation Server infrastructure component you can use to secure

access to resources and applications hosted on servers running one or more Presentation Server products. The Secure Gateway transparently encrypts and authenticates all user connections to protect against data tampering and theft. http://www.citrix.com/English/ps2/products/product.asp?contentID=186

9.1.

Languages Supported

English only

9.2.

Administration Guides

• CTX103759 – Secure Gateway for Windows Administration Guide • CTX106472 – Web Interface Administration Guide

• CTX106776 – Access Gateway Enterprise Administration Guide

9.3.

Troubleshooting Questions to Ask

Installation

• What is the error message you are receiving? • Send screenshot of error message.

• Did you install the server certificate on Secure Gateway?

• See Obtaining and Installing Server Certificates on P163 of the Admin Guide. Secure Gateway for Windows Administration Guide.

• Certificate Requirements in a Single-hop DMZ deployment – See P45 of the Admin Guide. • Certificate Requirements in a Double-hop DMZ deployment – See P47 of the Admin Guide. • Are you installing Secure Gateway in a single or double-hop DMZ?

• Single-hop DMZ deployment – See P49 of the Admin Guide. • Double-hop DMZ deployment – See P49 of the Admin Guide. • Are you upgrading from a previous version of Secure Gateway?

• See P52, P107 of the Admin Guide.

Configuration

• Are you integrating Secure Gateway with MSAM (Access Gateway Enterprise), Presentation Server or both? • Deploying Secure Gateway for Access to MSAM – See P55 of the Admin Guide.

• Deploying Secure Gateway for Access to Presentation Servers – See P87 of the Admin Guide. • What is the exact error message you are receiving?

• Send screenshot or event log error message.

(28)

• Re-run the configuration to make sure you entered the correct details.

Deploying Secure Gateway for Access to MSAM – Info from Admin Guide

• Single-Hop DMZ deployment – Secure Gateway Service – See P58 of the Admin Guide. • Double-Hop DMZ deployment – Secure Gateway Proxy – See P80 of the Admin Guide. • Double-Hop DMZ deployment – Secure Gateway Service – See P82 of the Admin Guide.

Deploying Secure Gateway for Access to Presentation Servers – Info from Admin Guide

• Single-Hop DMZ deployment – Secure Gateway Service – See P91 of the Admin Guide. • Double-Hop DMZ deployment – Secure Gateway Proxy – See P98 of the Admin Guide. • Check the certificate to make sure it is valid.

• Open the MMCconsole on the Secure Gateway server and load the certificate snap-in for the local computer. Open the Web Server certificate.

• Verify that the Issued to address (circled above) matches the Fully Qualified Domain Name (FQDN) of the Secure Gateway server.

• Verify the Valid from and to dates are correct and not expired.

• Verify that your certificate has You have a private key that corresponds to this certificate. The server certificate must be paired with its private key in order to support SSL connections.

(29)

User Errors

• Does the user have a valid root certificate installed?

• To indicate your trust in a given CA, you must install their root certificate. Once a root certificate is installed on your workstation, your Web browser or ICA client will automatically trust any server possessing a certificate signed by that CA.

• To view your installed root certificates, select the Tools> Internet Optionsmenu in Internet Explorer, view the Contenttab, and click the Certificates button.

This opens a Certificatesdialog. View the Trusted Root Certification Authoritiestab to see what CA certificates have been installed.

• Double-click on the root certificate that trusts the server certificate on your Secure Gateway server.

• On the Certification Path, you will find the root to your Certification Authority and the Certificate status should read “This certificate is OK”.

• Can the user resolve the FQDN of the Secure Gateway server?

• Users will receive the following error message when trying to launch applications through Secure Gateway: “Cannot connect to the Citrix server:

The Citrix SSL relay name could not be resolved (SSL error 40).”

• The fully qualified domain name (FQDN) of the Secure Gateway server is not recognized by the client.

• Create a DNS record that resolves the FQDN of the Secure Gateway server or create an entry in the host file on the client devices.

(30)

Web Interface Integration

• Did you install and configure Web Interface?

• See P43 of the Web Interface Administrator’s Guide.

Access Gateway Enterprise Integration

• Did you install and configure Access Gateway Enterprise?

• See P49 of the Access Gateway Enterprise Administrator’s Guide.

Troubleshooting Tools

• MSAM Authentication Service Test Tool (ASTest) –

contact Citrix Technical Support in Dublin for access to this tool. • Secure Ticket Authority Test Tool (STATest) –

contact Citrix Technical Support in Dublin for access to this tool.

9.4.

Related Knowledge Base Articles

9.5.

Other Relevant Information

• CTX106975 Secure Gateway 3.0 for Presentation Server Troubleshooter's Guide

• CTX103696 SSL error 4 when using ISA and Secure Gateway

• CTX103569 The Citrix SSL relay name could not be resolved (SSL error 40)

• CTX102765 Using a Private Certificate Authority with Secure Access Manager/Secure Gateway and a Secure Gateway proxy client requires a root certificate on

the client device from that Private Certificate Authority

• CTX104717 How to Enable Extended Activity Logging at the Logon Agent

• CTX101993 Configuring Address Translation with Secure Gateway

• CTX435418 Troubleshooting Disconnected Sessions in Secure Gateway

• CTX711855 Common SSL Error Messages and their Causes

• CTX102579 The SSL certificate could not be checked for revocation

(31)

10. ICA

®

Clients

Citrix Presentation Server clients are the components that users run on their computers to access resources published on servers running Citrix Presentation Server. The clients combine ease of deployment and use, and offer quick, secure access to applications, content and entire server desktops. The ICA clients will allow the establishment of an ICA session between the user’s computer and the Presentation Server.

http://www.Citrix.com/site/SS/downloads/downloads.asp?dID=2755

10.1. Languages Supported

Depends on the client version and client type but in general, English, French, Spanish, German

10.2. Administration Guides

Each ICA®client has its own Administrator’s Guide. These can be found in the downloads section of the Citrix web-site

at http://www.Citrix.com/site/SS/downloads/downloads.asp?dID=2755

Guides for most common clients

• CTX106223– Client for 32-bit Windows Administrator's Guide – Version 9.0 • CTX106470– Client for Java Administrator’s Guide- Version 9.x

10.3. Troubleshooting Questions to Ask

For Every Problem

• Which version of the client are you using?

• Is it the same problem with the latest version (if not already in use)? • Did it work at least once?

Installation

• What is the error message? (Send a screen shot.)

• How are you trying to install the client (client database, MSI, silent installation, …)? • If you are using the Citrix Access Client packageto deploy multiple Citrix clients, refer

to CTX107569

• Is the same problem seen when a user with administrator’s rights is tested?

Connectivity

• Do you see the login box or the background screen of the server, or does the connection fail before this? • Any errors on the event viewer of the server? (Send the event viewer files.)

• Is it happening for all applications? All servers? All users?

• Is it the same issue for non-seamless connections? And for seamless connections? • Are you connecting through Web Interface, MSAM or Advanced Access Control?

If so, could you try connecting directly to the farm using a custom ICA connection?

• Please refer to the admin guide of the ICA client in use to know how to create an ICA connection. • Is it the same problem if you disable the mappings (drives, printers, …)?

(32)

• If connecting with the Web client, what is the browser version?

• If connecting with the Java™client, what is the Java Virtual Machine (JVM) version?

• Do you have the same problem when connecting with the RDP client? • Are there any proxies/firewalls between the client and the server? • Is the browser configured to allow ActiveX script?

10.4.

Related Knowledge Base Articles

10.5.

Other Relevant Information Win32 Client

• CTX859359 How the Win32 ICA Client determines the value for Clientname

• CTX105353 Universal Print Driver output is faded and illegible

• CTX102919 Wfica32.exe program error may occur when printing from the ICA Version 7.100 Client using Universal Print Driver PCL:4

• CTX105793 Error: Cannot connect to the Citrix server. Protocol Driver Error and/or Transport Driver

• CTX106656 Windows shortcut keys are not passed to an ICA session on Microsoft Windows 95, Windows 98, or Windows ME

• CTX105567 Error: Unable to enumerate your disconnected or active session, the remote server might be down, or the reconnect.asp cannot be found

• CTX105226 Cannot open the Citrix ICA Client. [Error 1000: (no error text available)]

• CTX105006 Single Sign-On fails after upgrading to Program Neighborhood Agent 8.0

• CTX105958 Error: A previous version of one of the Citrix ICA Client utilities is already running. Please close the Citrix ICA Client, Remote Application Manager, and Connection

Center before launching an application

• CTX443787 Troubleshooting ICA Client Audio Issues

• CTX103913 Launched ICA files create new temporary ICA files in the same directory as the original ICA file

• CTX336368 What are the .SRC Files in the ICA client directory and on the install disks? Web Client

• CTX075552 Troubleshooting ICA 32-bit and Web Client Connectivity Issues

• CTX104546 Updating ICA Web Clients for deployment through Web Interface

• CTX104386 to determine the Client IP Address of a Web Interface/NFuse Connection

• CTX568194 ICA Client File Security: WEB Client drive access and the Webica.ini File explained Java Client

• CTX101666 Prompting the acceptance of a Digital Certificate when downloading the Java Client

• CTX101620 Changing keyboard layout and type in Java Client

• CTX101845 TS CAL Issue with the ICA Client for Java

• CTX103079 Configuring the Java Client to Work with private certificates with MetaFrame Secure Access Manager

• CTX106728 Client for Java 9.0 hangs while connecting

• CTX105291 Java Client sessions disconnect when there is no mouse activity

• CTX106749 How to use private certificates with the Client for Java 9.0

• CTX105617 Error: Root certificate not found

UNIX and Macintosh®Clients

• CTX104179 UNIX and Macintosh clients automatically launch Java clients even if a Citrix client exists

• CTX106223 Client for 32-bit Windows Administrator's Guide – Version 9.0

• CTX103289 The evolution of the ICA Win32 clients

(33)

11. UNIX

®

Client

ICA clients for major UNIX platforms currently supported: Linux®, Solaris(Sparc/Intel), IBM AIX, HP-UX, SunOS,

Compaq Tru64, SGI, SCO

http://www.citrix.com/site/SS/downloads/downloads.asp?dID=2755

11.1. Current Version

Variable depending on platforms.

11.2. Languages Supported

English, Spanish, French, German, Japanese

11.3. Administration Guide

• CTX101298– Clients for UNIX Version 9.x Administrator’s Guide

11.4. Troubleshooting Questions to Ask

Answers to these questions can provide useful background information, which can help to solve the issue. • What version of Unix client is running?

• What OS version is the client running on?

• Which kernel version? Type Uname – a output to see the version. • What is the desktop the customer is using?

• Window manager? Any customization? • What kind of network connection?

• Desktop fixed windows or seamless? Any difference? • Color depth? Screen resolution? Any difference?

Type Xdpyinfo output to get information about display’s settings.

• Window properties, output of xprop – root command, xwininfo over ICA session window • Check the user display preferences using xset – q. Send output to Citrix Technical Support • Is the problem specific for a particular platform: Linux, Solaris, HP-UX, AIX, etc?

• Does the Win32 client behave in a similar fashion? • Check configuration files for errors:

• wfclient.ini, appsrv.ini in $HOME/.ICAClient

• wfclient.ini, appsrv.ini and module.ini, in the $ICAROOT/config • If using Linux client v9.x, ensure that OpenMotif 2.2.x package is installed.

(34)

11.5.

Related Knowledge Base Articles

11.6.

Other Relevant Information

• CTX564283 How to Troubleshoot 1003 and 1004 Terminal Server Licensing Errors

• CTX103329 ICA Client for UNIX Printing Explained

• CTX103583 Integrating Smart Cards with Linux/UNIX Clients

• CTX103576 Troubleshooting UNIX / Linux Keyboard and Language issues in ICA sessions

• CTX105010 Clients for UNIX and Linux Overscrolling When Using Published Applications

• CTX105000 UpdateTime Setting on the Client for UNIX for Keystroke Latency

• CTX358392 Troubleshooting Steps for Auto Client Update Issues

Administrator's Guide – Most common problem areas.

ReadMe file – available in the default installation directory and contains last minute information.

• Does the client give back an X error? Please run the client (wfica) through xmon. Xmon can be downloaded from http://ftp.x.org/contrib/devel_tools/.

• Connectivity issue? Any difference using different browsing, (http/https, TCP/IP)?

Network traces will be required; you can use Ethereal, which is available to download from the Etherealwebsite.

• Keyboard issue, does it work locally? Which is the layout in use? xmodmap –pke, xmodmap –pm. Output of whatkey.exe/spy++ will be needed from within the remote session.

(35)

12. Citrix Access Suite Licensing

Citrix has simplified licensing for Citrix Access Suite products, such as Citrix Presentation Server 4.0 and Citrix Password Manager™. Both the license activation and license management processes are different.

http://www.Citrix.com/site/PS/products/product.asp?familyID=%2019&productID=12752

12.1. Languages Supported

English, Spanish, French, German

12.2. Administration Guides

• CTX106282– Citrix Access Suite Licensing Guide

• CTX106319– Citrix Presentation Server 4.0 Administration Guide

12.3. Troubleshooting Questions to Ask

Installation

• What is the error message you are receiving? • Send screenshot of error message.

• Where did you install your Access Suite license server?

• See P31 of the Access Suite Licensing Guide for more information. • Who are you logged in as when installing the license server?

• It is recommended that you be logged on as a domain or local administrator when installing the license server. The user who installs the license server will automatically have full access to the License Management Console.

Configuration

• What is the exact error message you are receiving? • Send screenshot of error message. • Check license server event log.

• Did you activate the license as per instructions in the Licensing Guide (See P89)? • Did you license your product correctly?

• Managing Presentation Server licensing, See P95 of the Access Suite Licensing Guide • Managing Conference Manager licensing, See P98 of the Access Suite Licensing Guide • Managing Password Manager licensing, See P99 of the Access Suite Licensing Guide • Managing Access Gateway licensing, See P100 of the Access Suite Licensing Guide • Are you upgrading from MetaFrame XP Presentation Server? See CTX105182for details. • Make sure you enter the correct case-sensitive hostname of the license server

• See point 5 on .89 of the Access Suite Licensing Guide

(36)

License Server Clustering

• Are all 4 license server resources installed and online?

• See P18 of the Licensing Cluster Guide for details – CTX104878 • If you move the resources to another node, do you still see the issue?

• If you see the same issue on another node, then the problem may lie on the resource itself. To troubleshoot this, try uninstalling and reinstalling the resource.

• If the problem does not occur on another node, then the problem is on the active node; compare to a working node to troubleshoot.

• Uninstall and reinstall the license server resource ctxlsclustres.dll • See P19 of the Licensing Cluster Guide for details – CTX104878

Troubleshooting Tools

• CTX103919– LMSTAT: Shows what licenses are in use

• CTX103920– Troubleshooting Connectivity Issues between a Computer Running Citrix Presentation Server and its License Server using NETSTAT • CTX103916– LMDIAG: Diagnose License Check-out Issues

12.4.

Related Knowledge Base Articles

12.5.

Most Common Problems

12.6.

Other Relevant Information

• CTX106282 Citrix Access Suite Licensing Guide

• CTX103980 There are no licenses installed for the use of this Citrix Presentation Server

• CTX103348 Citrix Presentation Server Edition Level Changes

• CTX104259 Supporting Microsoft Clustering for the Citrix License Server shipping with Access Suite 3.0

• CTX104878 Supporting Microsoft Clustering for Citrix Access Suite License Server 1.0.0

• CTX107591 The Most Frequently Asked Licensing Questions

Activating Licenses – make sure to enter the correct case-sensitive hostname of the license server.

• CTX103626 Clients or Servers Consume Multiple Licenses from the Citrix License Server

• CTX103980 There are no licenses installed for the use of this MetaFrame Presentation Server

• CTX107059 Advanced Concepts Guide for Citrix Presentation Server 4.0

(37)

13. MetaFrame XP

Presentation Server Licensing

This section covers the Licensing for MetaFrame XP. This Licensing mode is different than the one in use for latest products.

MetaFrame XP™Presentation Server licensing

• Uses ‘V5’ licenses

• V5 licenses are in the following format:

• xxxxx-xxxxx-xxxxx-xxxxx-xxxxx (5x5x5x5x5) • E.g E42NZ-35+++-43FH2-22CD1-@F*Q5 • As with V4 licenses, a machine code must be generated

• Enter the license into the MetaFrame management console under the license node to generate a machine code. Two new quintetsof alpha-numerics are added to the original license code. E.g.

• E42NZ-35+++-43FH2-22CD1-@F*Q5-xxxxx-xxxxx

• Again, the license needs to be activated on www.mycitrix.comto receive its validated activation code. • Add the license (along with the new activation code) to the license node in the management console.

License has been installed!

Regarding the first quintet

• E42NZ-35+++-43FH2-22CD1-@F*Q5: The 4thcharacter of the first quintet of the license

MUST be either a Yor a N.Ytells us that the customer is subscribed to Subscription Advantage™. Nmeans that they are not in the Subscription Advantage scheme

• If anything else is in the fourth position, the license is most likely illegal!

• E42NZ-35+++-43FH2-22CD1-@F*Q5: The Eat the beginning of the above example means the language of the license is English. The others are German,Spanish,Japanese or French. • E42NZ-35+++-43FH2-22CD1-@F*Q5 →42or 32: A 42 here means that the license was

created by Citrix. A 32means that the license is a retail one i.e. bought by a company from a reseller/other intermediate

Regarding the second quintet

• E42NZ-35+++-43FH2-22CD1-@F*Q5: The second quintet indicates a server license. A ‘2522Q’ in this position would denote a connection license

• The 35 means that the license was manually activated

• If it was a 55 instead, it would mean that the license was a self-activating license • The +++ means that the license allows for unlimited connections (not cheap!)

• For a connection license e.g. ‘2522Q’, the ‘Q’ at the end denotes the license count itself Q = 20 connection licenses. The others are:

• 7 = 5 connection licenses • D = 10

(38)

• MetaFrame XP Presentation Server farms only need one server per farmto be licensed. • Server licenses are language-dependant – a German server license can only run on a

German-language server. All the other servers in the farm can be in different languages, but at least one must be in German.

• MetaFrame XP licenses are stored in the farm’s datastore and can be entered there from any system using the management console.

• Connection licenses are completely independent of language and are all pooled into the overall farm license pool.

• MetaFrame XP consists of base licenses, i.e., the license of the server itself, and Feature Release licenses, i.e., for any FR installed. For example, if you upgrade from FR2 to FR3, you need specific FR3 licenses – the FR2 ones are no longer valid. Same goes for upgrading from MF-1.8 to any FR of MetaFrame XP or Presentation Server 3.0.

(39)

14. Advanced Access Control

Advanced Access Control is a unique Citrix option that increases protection of the network and information resources. Advanced Access Control enables IT administrators to establish a fine degree of control over applications, files, Web content, e-mail attachments and printing. This option manages both what information resource can be accessed and what actions are permitted after access is granted, based on the user’s role, location, type of device, configuration of device, and connection. Further, the access-control policy engine and enforcement decisions are implemented inside of the protected network, resulting in greater security than is provided by typical SSL VPNs.

http://www.citrix.com/English/ps2/products/product.asp?contentID=15005&ntref=hp_nav_US

14.1. Languages Supported

English, Spanish, French, German

14.2. Administration Guides

• CTX106776– Access Gateway Enterprise Administrator's Guide • CTX106780– Access Gateway Enterprise Upgrade Guide

14.3. Troubleshooting Questions to Ask

Installation

• What is the error message you are receiving? • Send screenshot of error message.

• Are you doing a single or multiple server farm install? • Provide details of your setup.

• Did you follow the instructions in the Readme and install the prerequisites?

• See P31 of the Access Gateway Enterprise Administrator's Guide for a list of prerequisites. • What type of database did you choose?

• See P29 of the Access Gateway Enterprise Administrator's Guide for details. • Client Requirements?

• See P37 of the Access Gateway Enterprise Administrator's Guide for details.

Configuration

• Are you trying to create or join a farm?

• See from P49 of the Access Gateway Enterprise Administrator's Guide. • What is the exact error message you are receiving?

• Send screenshot of error message • Are you installing a new Logon Agent?

• See P69 of the Access Gateway Enterprise Administrator's Guide for instructions. • Is the issue the same if you create a new logon point?

(40)

Web Resources & Policies

• User Action Controls explained

• See P72/73 of the Access Gateway Enterprise Administrator's Guide. • Creating Network Resources

• What type of resource are you trying to create? • Did you select the correct resource type?

• See P76 – P84 of the Access Gateway Enterprise Administrator's Guide for instructions. • Bypass the Web Proxy – See P78 of the Access Gateway Enterprise Administrator's Guide. • Enabling Pass-Through Authentication

• See P80 of the AAC Admin Guide for further information. • Creating Resource Policies

• Did you select the option to create a default policy with the resource?

• Multiple policies can exist for one resource. If this is the case, then a policy that denies a policy-setting permission always wins over other policies that allow the permission. • Policy names must be unique; see Naming Policies section on P85 of the Access Gateway

Enterprise Administrator's Guide. • Defining logon privileges through policies

• See P89 of the Access Gateway Enterprise Administrator's Guide. • Did you apply a filter to the policy? Is the issue the same without the filter?

• See P90 – P92 of the Access Gateway Enterprise Administrator's Guide.

Access Center

• What is the error message you are receiving when browsing to the Access Center? • Send screenshot of error message.

• Did you create the Access Center correctly?

• See from P98 of the Access Gateway Enterprise Administrator's Guide. • Adding published applications to access centers

• See from P105 of the Access Gateway Enterprise Administrator's Guide.

Endpoint Analysis

• Enable audit logging to capture endpoint analysis error information. • See P169 of the Access Gateway Enterprise Administrator's Guide.

• Then for each denial of access to a resource or failed endpoint analysis scan, a unique value is displayed in the user’s browser.

• Cross-reference this unique value in the event log for more information on the error. • Verify that the scan was created correctly.

• See P112 of the Access Gateway Enterprise Administrator's Guide.

• How to add rules to scans – See P115 of the Access Gateway Enterprise Administrator's Guide. • Using scan outputs in other scans –

See P117 of the Access Gateway Enterprise Administrator's Guide. • Using scan outputs in Policies –

See P119 of the Access Gateway Enterprise Administrator's Guide.

• Using data sets in scans – See P120 of the Access Gateway Enterprise Administrator's Guide. • Problems deploying the endpoint analysis ActiveX client software?

(41)

Deploying Client Software

• Which client software are you trying to deploy?

• Endpoint Analysis client, Gateway client, Advanced Gateway client, Live Edit client or Presentation Server client?

• Did you check the requirements for each client? –

See P35 of the Access Gateway Enterprise Administrator's Guide. • To configure on-demand client deployment –

See P150 of the Access Gateway Enterprise Administrator's Guide. • How to disable the deployment of the Live Edit client –

See P151 of the Access Gateway Enterprise Administrator's Guide.

Managing Access Server Farms

• Are you adding or removing servers from the farm?

• See P162 of the Access Gateway Enterprise Administrator's Guide.

• Do you want to restart the Advanced Access Control COM+ applications, when components such as logon points, web proxy or access centers function incorrectly:

• See P161 of the Access Gateway Enterprise Administrator's Guide. • To change service account or database credentials:

• See P163 of the Access Gateway Enterprise Administrator's Guide. • How to modify a server role:

• See P164 of the Access Gateway Enterprise Administrator's Guide.

14.4.

Related Knowledge Base Articles

14.5.

Other Relevant Information

• CTX107447 Presentation Server and Client Versions Supported with Advanced Access Control 4.0

• CTX107448 Error: Access to all MetaFrame server farms and their published resources has been disabled. Contact your systems administrator for assistance.

• CTX107396 Error: “Another version of this product is already installed.” when installing the Access Client package on a client machine

• CTX107231 Creating a Logon Point in Citrix Access Gateway with Advanced Access Control Option

• CTX107240 Error: Failed to create the Sample Logon Point

• CTX107229 Citrix Access Gateway with Advanced Access Control Option Uninstall Procedure

• CTX105707 Readme for Citrix Access Gateway Enterprise, Version 4.0

(42)

15. Citrix Diagnostic Facility (CDF)

The Common Diagnostics Facility (CDF) is a troubleshooting feature introduced with MetaFrame Presentation Server 3.0. It changes the way information is collected and tracing is performed within Citrix products. The benefits CDF provides are:

• Very high performan

References

Related documents

High blood pressure 65-74 years old Genetic factors Poorly controlled INR levels on Warfarin Abnormal kidney or liver function Excessive fall risk 75 years old + Activities that

If the patient calls the neuroradiology department directly, the neuroradiology staff will page the anesthesiology PAIN pager to help coordinate.. The Neuroradiology staff

Third, the Food and Drug Administration’s attempt to regulate tobacco in the mid-1990s demonstrated the tobacco industry’s vulnerability; no federal agency has been able to

Component 1: Renewable Energy Resource Mapping Phase 1-3: This component will carry out a resource-mapping assessment of solar and/or wind capacity across 10 PICs.. The

But you will receive power when the Holy Spirit comes on you; and you will be my witnesses in Jerusalem, and in all Judea and Samaria, and to the ends of the earth.&#34; As we

The application includes projected costs related to the International Financial Reporting. Standards (“IFRS”) assessment and modifications of

Vice President Shehan Fernando Ashan Jayamanna Suraj Suraweera Vice President Derrick Perera Ashan Jayamanna Prithieraj de Silva Vice President Shirantha Perera

• Run cross-sectional regressions of firm level equity returns for each month from July of year t+1 through June of year t+2 on set of characteristics.. • Average the