Installing Hotfix Rollup Pack 6

In Chapter 5, you installed XenApp 5 for Server 2003 Feature Pack 2 – Platinum Edition, your Citrix product license and added your license server to the Learning Farm. In this chapter, you will:

Extract the Feature Pack 3 files,
Upgrade the License Server to 11.6.1 build 10007,
Update the Java Runtime Environment,
Backup the data store,
Install the Microsoft Visual C++ 2005 SP1 Redistributable Package, and then
Install Hotfix Rollup Pack 6

Extract the Feature Pack 3 Files

Browse to the XA5_FP3_PLT_ML1.zip file and extract the contents to c:\FP3 (Figure 6-1).

Several updates from Feature Pack 3 will be used in this Part and Part 10.

Download Hotfix Rollup Pack 6

When you completed Part 5, you had just exited the Citrix Delivery Services Console. Start Internet Explorer and go to http://support.citrix.com/.

In the left column, click XenApp (Figure 6-2).

Click XenApp 5.0 for Windows Server 2003 (Figure 6-3).

Click Hotfix Rollup Pack 6 for Citrix XenApp 5.0… (Figure 6-4).

Click the Download button or PSE450W2K3R06 (Figure 6-5).

Note: Deciphering the file name PSE450W2K3R05.

PSE – Presentation SErver
450 – Version 4.5
W2K3 – For Windows Server 2003 x86. For Windows Server 2003 x64 this would be W2K3X64.
R06 – Hotfix Rollup Number 6.

In Citrix lingo, this file is called HRP06 for Hotfix Rollup Pack #6.

Save this file… (Figure 6-6).

To the server’s desktop (Figure 6-7).

Once HRP06 has finished downloading, back on the web page, scroll down until you get to the Before You Install This Release (Prerequisites) section (Figure 6-8).

Note: Some text has been removed that does not pertain to the Windows Server version being used.

It is extremely important that you ALWAYS read the documentation that comes with Citrix product and Component updates. There are four very important items contained in this section of the readme:

You will see a note that “your Citrix License Server must be at version 11.6.1 to install this hotfix rollup pack”. Missing this prerequisite would cause you a lot of grief if your server had stopped working when you applied HRP06 BEFORE upgrading your license server.
The Java Runtime Environment must be upgraded to at least Version 6 Update 14 BEFORE installing this hotfix rollup pack.
Citrix recommends that the data store be backed up before installing this hotfix rollup pack.
There is also a note that “the Microsoft Visual C++ 2005 SP1 Redistributable Package (x86) must be installed on all servers before installing this hotfix rollup pack”. Please notice this says “…on ALL servers BEFORE installing…”. This means this Visual C++ package MUST be installed on ALL of your XenApp servers BEFORE you install HRP06 on the FIRST XenApp server.

Let me stress again – IT IS EXTREMELY IMPORTANT that you read ALL the documentation that comes with ALL Citrix Product and Component updates. Failure to do so can have disastrous consequences for your production XenApp Farm and Data Store.

Let’s look at each of these in the order listed above.

Upgrade License Server

The first item Citrix says to check is that the license server be upgraded to version 11.6.1. How do we determine the installed version? The license server version is not displayed anywhere in the License Management Console prior to build 10007 and it is not shown in the Add or Remove Programs option in Control Panel. Citrix does have an article titled How to Determine the Version of the Citrix License Server (the article no longer exists) to help out.

Click Start -> Run, type in regedit and press Enter (Figure 6-9).

Look at the following registry key:

My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\LicenseServer\Install and in the right pane look at the Version value (Figure 6-10).

This shows our installed version as the correct version 11.6.1 but at build 9020. The latest build of version 11.6.1 is 10007. Exit Registry Editor. Build 10007 is in the Feature Pack 3 update files. Click Start -> Run, type in c:\fp3\Licensing\CTX_Licensing.msi and press Enter (Figure 6-11).

Click Upgrade (Figure 6-12).

You receive an error message saying the ICA Administrator Toolbar is in use. Since the ICA Toolbar has been removed from XenApp 5 for Server 2008 and all future XenApp versions, you will not use it in the article. This will also give you more space on your screen for the management consoles. Right-click an empty spot on the toolbar and select Exit (Figure 6-13).

Click No so the ICA Toolbar will not start each time you logon to Windows (Figure 6-14).

Note: What is ICA? Independent Computing Architecture (ICA) is a proprietary protocol designed by Citrix for application servers. The ICA protocol describes a mechanism for passing data between server and clients, but is not bound to any one platform.

Click Retry to allow the upgrade to continue (Figure 6-15).

Citrix License Server 11.6.1 build 10007 is installed. Click Finish (Figure 6-16).

Enter the password for the License Management Console and click OK (Figure 6-17).

Note: Notice the new default user name of “admin”.

Update Java Runtime Environment

The Java Runtime Environment must be updated to at least Version 6 Update 14. Version 6 Update 20 is the current release as of this writing. Open another Internet Explorer tab and go to http://www.java.com. Click on the Free Java Download button (Figure 6-18).

Click on the Free Java Download button (Figure 6-19).

Click Run (Figure 6-20).

Click Run (Figure 6-21).

Click Install (Figure 6-22).

Click the box next to Restart my browser… and Close (Figure 6-23).

Java Version 6 Update 20 is installed (Figure 6-24). Exit Internet Explorer.

Data Store Backup

As part of the installation of HRP06, a custom action is recommended to launch a full reindex of the File Type Associations in the data store. Because of this, Citrix recommends the data store be backed up before HRP06 is installed.

First you need to create a folder to contain the backup files.

Click Start -> Run, type in CMD and click OK.

Type in md c:\ctxbackup and press Enter. This will make a folder to contain the files to backup.

Type in cd c:\ctxbackup and press Enter.

You command prompt should say c:\ctxbackup>

To backup the Data Store, type in dsmaint backup c:\ctxbackup and press Enter (Figure 6-25).

Type Exit and press Enter to exit the command prompt.

Install Microsoft Visual C++ 2005 SP1 Redistributable Package (x86)

Start Internet Explorer and select Restore last session (Figure 6-26).

Close the Download Java for Windows tab. On the HRP06 tab, scroll down until you get to the Before You Install This Release (Prerequisites) section. Continue scrolling until you get to bullet point for The Microsoft Visual C++… and click the words Microsoft Visual C++ 2005 SP1 Redistributable Package (Figure 6-27).

A new browser Windows opens. Click the Download button (Figure 6-28).

Click Run (Figure 6-29).

Click Run (Figure 6-30).

Click Yes to accept the Microsoft license agreement (Figure 6-31).

The Visual C++ 2005 SP1 package is installed. Exit the Download Confirmation browser window.

Exit Internet Explorer. You are now at the server’s desktop.

Install Hotfix Rollup Package 6

Note: Most Citrix Farms have more than one XenApp server. When there are multiple XenApp servers, they must be upgraded in a specific sequence:

Data Collectors
Database Connection Server
Member Servers

To find your Data Collectors, go to a command prompt and type in qfarm /zone (Figure 6-32).

Qfarm /zone shows you the server that must be upgraded first in each Zone. The Database Connection Server is the XenApp server used by other XenApp servers to connect to the Data Store and is discussed in this article. Member servers are all XenApp servers that are not either Data Collectors or Database Connection Servers.

Note: The zone data collector is a XenApp server performing the data collector role in a particular zone. If you have multiple XenApp servers, you can control the data collector preference. Regardless of the preference selection settings there will always be only one XenApp server in a zone that must fulfill this data collector role.

Type exit and press Enter to close the command prompt.

On the server’s desktop, double-click the PSE450W2K3R06.msp file and click Open (Figure 6-33).

Click Next (Figure 6-34).

Click Finish (Figure 6-35).

Click Next (Figure 6-36).

Click Close (Figure 6-37).

Note: If you have been paying attention, almost all the screens still show the product name as Presentation Server even though XenApp has been the product name for well over two years.

Click OK to restart your VM (Figure 6-38).

When the VM restarts, login to the VM. Click Start -> Run and type in dscheck /full FTA /reindex and press Enter (Figure 6-39). Running this command allows you to take advantage of optimizations made for the Delivery Services Console.

Answer y to the Would you like to continue prompt (Figure 6-40).

Create Part 6 Snapshot

To create the Snapshot for this Part, right-click the VM and select Take Snapshot… (Figure 6-41).

Enter a Name,
Optionally enter a Description,
Select Quiesce the VM before taking the snapshot, and then
Click Take Snapshot (Figure 6-42).

Click on the Snapshots tab to see the Snapshot (Figure 6-43).

Click the Console tab to return to the Windows desktop.

Note: On my computer, there are video anomalies when switching from the Snapshot tab to the Console tab. The only way to resolve this issue is to reinstall XenTools after every snapshot is complete.

You have now successfully: