Learning the Basics of Citrix XenApp 5 for Windows Server 2003 and XenServer 5.5 (Part 6 of 10)
In Part 5 of this 10-part series, you installed XenApp 5 for Server 2003 – Platinum Edition. In Part 6, you will upgrade the License Server to 11.6.1, update the Java Runtime Environment, backup the data store, install the Microsoft Visual C++ 2005 SP1 Redistributable Package and install Hotfix Rollup Pack 5.
Note: Even though you could have installed Hotfix Rollup Pack 5 from the installation media, I feel it is important to learn how to update a XenApp server. Also, every update you need for this article is on the installation media. Again, I feel it is important for you to learn how to read the readme and learn how to manually update a XenApp server.
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 1).
Click XenApp 5.0 for Windows Server 2003 (Figure 2).
Click View all (13 more) to the right of Hotfixes for XenApp 5.0 for Windows Server 2003 x86 (Figure 3).
Click Hotfix Rollup Pack 5 for Citrix XenApp 5.0… (Figure 4).
Click the Download button or PSE450W2K3R05 (Figure 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.
- R05 – Hotfix Rollup Number 5.
In Citrix lingo, this file is called HRP05 for Hotfix Rollup Pack #5.
Save this file… (Figure 6).
To the server’s desktop (Figure 7).
Once HRP05 has finished downloading, back on the web page, scroll down until you get to the Before You Install This Release (Prerequisites) section (Figure 8).
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 the 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 HRP05 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 HRP05 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.
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 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 to help out. Note: That article is no longer available.
Click Start -> Run, type in regedit and press Enter (Figure 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 10).
This shows our installed version as the correct 11.6.1. Exit Registry Editor.
What if the version had not been 11.6.1? Click on the words Citrix Web site in the first bullet point in the Before You Install This Release (Prerequisites) section of the readme (Figure 11).
A new browser Window opens up (Figure 12).
Click Download (Figure 13).
You now receive a Popup Window for the Download Manager (Figure 14). You can either use the Download Manager or not. Since you will be downloading one file, go ahead and skip installing the Download Manager add-on. Click on the click here link (Figure 14).
Click Open (Figure 15).
Extract the files and folder to c:\license (Figure 16).
Exit all Windows and Popups except for the browser window for HRP05.
Click Start -> Run and type in c:\license\CTX_Licensing.msi and press Enter (Figure 17).
Click Next (Figure 18).
Click Next (Figure 19).
Citrix License Server 11.6.1 is installed. Click Finish (Figure 20).
Java Runtime Environment
The Java Runtime Environment must be updated to at least Version 6 Update 14. Open another Internet Explorer tab and go to http://www.java.com. Click on the Free Java Download button (Figure 21).
Click on the Free Java Download button (Figure 22).
Click Run (Figure 23).
Click Run (Figure 24).
Click Install (Figure 25).
Click Close Browsers and Continue (Figure 26).
Click OK (Figure 27).
Java Version 6 Update 17 is installed. Click Close (Figure 28).
Data Store Backup
As part of the installation of HRP05, a custom action is run by the Installer 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 HRP05 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 29). This backs up the Access Data Store only.
Type Exit and press Enter to exit the command prompt.
Microsoft Visual C++ 2005 SP1 Redistributable Package (x86)
Start Internet Explorer and select Restore last session (Figure 30).
Close the Download Java for Windows tab. On the HRP05 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 31).
A new browser Windows opens. Click the Download button (Figure 32).
Click Run (Figure 33).
Click Run (Figure 34).
Click Yes to accept the Microsoft license agreement (Figure 35).
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.
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 36).
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.
Install Hotfix Rollup Package 5
On the server’s desktop, double-click the PSE450W2K3R05.msp file and click Open (Figure 37).
Click Next (Figure 38).
Click Finish (Figure 39).
Click Next (Figure 40).
Click Close (Figure 41).
Click OK to restart your VM (Figure 42).
You have now successfully updated the License Server to version 11.6.1 (if necessary), installed Java Runtime Environment 6 Update 17, installed the Microsoft Visual C++ 2005 SP1 Redistributable Package and installed Hotfix Rollup Pack 5 for XenApp 5 for Server 2003.
In Part 7, you will learn to create a Web Interface site and do basic configuration of that site to allow users access.