How to install Citrix XPa Release 3

By: Loc Huynh Last Update: 22-Feb-05 1. Pre-Installation............................................................................................................................ 2 2. Installation................................................................................................................................... 2 3. Post Installation......................................................................................................................... 14

3.1 Adding License ................................................................................................................... 14 3.2 Security ............................................................................................................................... 15

4. Tricks & Tips ............................................................................................................................ 15

Please see the below for the basic instruction of how to install Citrix Xpa Release 3 to Windows 2000 Server 1. Pre-Installation

- Terminal Services is installed and running in application mode on the Windows server. Make sure the Windows Terminal Services installed.

- For Web Interface, IIS Version 5 and Microsoft Java Virtual Machine are required. - MetaFrame Name Server is less 32 characters, case sensitive and unique. Note: if there is

a need for a new server name in an existing Citrix, server name needs to be change before the upgrade.

- Client MODEM can connect directly to MODEM on MetaFrame server without overhead of RASand TCP/IP. If there is a setup for this, remove the MetaFrame MODEM out of RAS before the installation.

- To install Management Console, JRE will be needed. If install on Windows NT, we will need to install the latest Microsoft Installer.

- Choosing Data Base store o MS Access: Lightweight o MS SQL Desktop Engine: Small to Medium o MS SQL Server: Any size o Oracle: Any size o IBM DB2: Any size

- When adding a new AD or change the Domain Trust, might need to restart IMA service. - Recommend to use TCP/IP + HTTP for ICA Browsing.

2. Installation 2.1 Install Windows Terminal Service 2.2 Install SQL Server 2000 Enterprise Edition 2.2.1 Create new database: OZCitrix 2.2.2 Create new security account: SQL Authentication type Login: ozcitrix Password: xxxxx 2.3 Install Citrix MetaFrame XP Release 3.

2.3.1 Insert Citrix CD 2.3.2 click on MetaFrame XP Feature Release 3

2.3.3 Click Next

2.3.4 Accept the license

2.3.5 Select MetaFrame Xpa, then click Next

2.3.6 Select Retail then click Next

2.3.7 Select the appropriate location for install then click next

2.3.8 Select Yes for the pass-Through authentication then click Next

2.3.9 Select Create a new farm, then click Next

2.3.10 Enter the new farm name and select the SQL Server as a database server, then click

Next FarmName: Meldevcitrix; Database: SQL Server

2.3.10.1 Enter the description and select Local for SQL server connection, then click Next

2.3.10.2 SQL Server Authentication, then click Next Login ID: ozcitrix Password: xxxx

2.3.10.3 Select OZCitrix Database as a default database then click Next

2.3.10.4 Change the Log file to appropriate drive, Click Finish

2.3.10.5 Click Finish to finish create a new data source to SQL Server. Click on Test Data Source, then OK, OK to quit

2.3.11 Enter the Administrator Credentials Details then click Next

2.3.12 Select options for Shadowing. Click Next

2.3.13 Select default TCP/IP port, click Next

2.3.14 Select Set server’s default web page to web interface, click Next

2.3.15 Click Finish to start installation.

2.3.16 Select Options to launch the ICA client distribution wizard, then click Close to finish off the Citrix MetaFrame XP installation

2.4 Install ICA Client Distribution

2.4.1 Click Next 2.4.2 Insert the Component CD into the CD Drive, then select Install from CD then click

Next 2.4.3 Select Typical then click Next 2.4.4 Click Finish to finish the installation 2.4.5 Put the Citrix XP Server CD back to CD drive, click Yes to restart the machine to

complete the installation.

2.5 Second Citrix Server – Joining the current Citrix Farm 2.5.1 Install as above until the step below, then select Join an existing farm then click

Next

2.5.2 Select Connect directly to the Database using ODBC then click Next

2.5.3 Enter information as appropriate, then select Local Server

2.5.4 Select SQL Server authentication then enter login name as created before, then click

Next

2.5.5 Select Change the Default Database to OZCitrix then click Next

2.5.6 Click Finish to start the installation

2.5.7 Click on Test Data Source to test the Database, then click OK to continue

2.5.8 Alternative is we can use the Existing SQL Database on current Citrix Server 2.5.8.1 Select connect to a Database on the MetaFrame XP server, enter the current Citrix

server computer name, then click Next

2.5.8.2 Enter the Administrator right to access the Citrix server, then click Next.

2.5.8.3 Select Allow shadowing of ICA session on this server and select all options then click Next.

2.5.8.4 Select Use a separate port, then click Next

2.5.8.5 Click Next

2.5.8.6 Select Skip this step, we can add users to the Remote Desktop Group later. Click Next to continue.

2.5.8.7 Click Finish to start the installation

2.5.8.8 Click Close to finish the installation

2.5.8.9 Click Yes to restart the computer.

3. Post Installation

3.1 Adding License Open Management Console, select Licenses Right Click on Licenses Numbers, then select Add new license Click Yes to start the activate progress.

Click Copy to Clipboard, then go to http://www.citrix.com.. Enter the License Number as shown below. Follow instruction, we will finally get to this screen, Click Continue.

Copy and paste the Act Code to the Activation Code field. Follow the same above procedure for the ICA Client Connections Licenses. Note: Account to login into the Citrix Website is

Login: Lockie2004 Password: xxxxx

We will need to activate for every installation for a new Activation Code.

3.2 Security You have to specify the correct security for Administrators tasks as well as running application. It’s better if you have a Distribution List. 4. Tricks & Tips

• Blue screen while launching Management Console. Check the video card driver. ATI card has some problem with Java. Either update JRE to be later than 1.4.2 or use another video card.

• If the Terminal Server is expired, we can get another 90 days by deleting the hardwareID as below:

HKLM\Software\Microsoft\MSLicensing\ delete the entire hardwareID (only the hardwareID and not the Parameters or Store entry)

• Check the SQL Server to make sure it allows both NT authentication and SQL Server authentication.

• After activated the license, we still receive the popup screen of the Warning Message

about the License. To fix this, we reset the Feature Release Level to NONE (within the Server Properties).

• For the roaming profile, please set it at AD.

• “Your Interactive Logon Privilege Has Been Disabled.” o When a user account is denied the Read permission to the active directory or local

account information in the Windows Security Account Manager (SAM) database, the logon request is unsuccessful because the operating system cannot determine if the user has permission to log on to Windows.

o Please also check the Terminal Service Permission for the Account on Domain. o Microsoft Knowledge Base Article 815266, provides a workaround.

1. Click Start, click Run, type regedit in the Open box, and then click OK. 2. Locate the following registry subkey:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server

3. On the Edit menu, point to New, and then click DWORD Value. 4. In the New Value #1 box, type IgnoreRegUserConfigErrors, and then press ENTER. 5. Right-click IgnoreRegUserConfigErrors, and then click Modify. 6. In the Value data box, type 1 (one), click Decimal, and then click OK. 7. Quit Registry Editor.

• If XML Service is corrupted Or o Remove Web Interface

o Reinstall IIS o Unregister and then register XML Service on MetaFram

Un-registering the XML Service1. Open a ‘Command Prompt’ window 2. Run ‘ctxxmlss /u’ (This command will un-register the Citrix XML service and mark it for deletion) 3. Reboot the server Registering the XML on a port other than sharing with IIS1. Un-register the service using the instructions above. 2. Open a ‘Command Prompt’ window 3. Run ctxxmlss /r[Port Number] (Notice that there is no space between the switch “/r” and the port number. 4. Reboot the server or open the service control manager and manually start the Citrix XML Service

o Reinstall Web Interface • When logging onto an NFuse Web site, the application icons appear correctly. However, when clicking the application, the following error message appears: “Ticketing feature is disabled. Please verify that Citrix XML Service is running on all the MetaFrame servers.” When connecting to a published application through NFuse using credentials in a domain where the domain name contained an ampersand (&), the following error message appeared: “The application encountered an error trying to connect to the MetaFrame server through NFuse. The ticketing feature is disabled on one or more MetaFrame servers. Please make sure the Citrix XML Service is running in the farm and that all are listening on the same port number.” An ampersand is the escape character in XML and HTML. The Citrix XML parser attempted to parse the characters after the ampersand as an escape character sequence, which caused the error in the XML parser. The ampersand in the domain name is now properly encoded in the XML request and the ticketing feature works as intended. Resolution

o From the Citrix Management Console, click the Servers tab. o Right-click a server and check the server Properties. o From the MetaFrame Settings tab, check Citrix XML Service. Verify the port

number o Click OK to save and exit o Do the same for the remaining MetaFrame servers. o Ensure that all MetaFrame servers are using the same XML port number. Edit if

necessary o Restart the servers on which you made changes

OR Apply Hotfix XE102W053 if applicable.

• Change the Port Number for XML services o Un-registering the XML Service

Open a ‘Command Prompt’ window Run ‘ctxxmlss /u’ (This command will un-register the Citrix XML service

and mark it for deletion) Reboot the server

o Registering the XML on a port other than sharing with IIS Un-register the service using the instructions above Open a ‘Command Prompt’ window Run ctxxmlss /r[Port Number] (Notice that there is no space between the

switch “/r” and the port number Reboot the server or open the service control manager and manually start

the Citrix XML Service