• Learning the Basics of Citrix XenApp 5 for Windows Server 2003 and XenServer 5.5 (Part 6 of 10)

    February 18, 2010

    XenApp, XenApp 5 for Server 2003

    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).

    Figure 1

    Click XenApp 5.0 for Windows Server 2003 (Figure 2).

    Figure 2

    Click View all (13 more) to the right of Hotfixes for XenApp 5.0 for Windows Server 2003 x86 (Figure 3).

    Figure 3

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

    Figure 4

    Click the Download button or PSE450W2K3R05 (Figure 5).

    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).

    Figure 6

    To the server’s desktop (Figure 7).

    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).

    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:

    1. 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.
    2. The Java Runtime Environment must be upgraded to at least Version 6 Update 14 BEFORE installing this hotfix rollup pack.
    3. Citrix recommends that the data store be backed up before installing this hotfix rollup pack.
    4. 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.

    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 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).

    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).

    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).

    Figure 11

    A new browser Window opens up (Figure 12).

    Figure 12

    Click Download (Figure 13).

    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).

    Figure 14

    Click Open (Figure 15).

    Figure 15

    Extract the files and folder to c:\license (Figure 16).

    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).

    Figure 17

    Click Next (Figure 18).

    Figure 18

    Click Next (Figure 19).

    Figure 19

    Citrix License Server 11.6.1 is installed.  Click Finish (Figure 20).

    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).


    Figure 21

    Click on the Free Java Download button (Figure 22).

    Figure 22

    Click Run (Figure 23).

    Figure 23

    Click Run (Figure 24).

    Figure 24

    Click Install (Figure 25).

    Figure 25

    Click Close Browsers and Continue (Figure 26).

    Figure 26

    Click OK (Figure 27).

    Figure 27

    Java Version 6 Update 17 is installed.  Click Close (Figure 28).

    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.

    Figure 29

    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).

    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).

    Figure 31

    A new browser Windows opens.  Click the Download button (Figure 32).

    Figure 32

    Click Run (Figure 33).

    Figure 33

    Click Run (Figure 34).

    Figure 34

    Click Yes to accept the Microsoft license agreement (Figure 35).

    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:

    1. Data Collectors
    2. Database Connection Server
    3. Member Servers

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

    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).

    Figure 37

    Click Next (Figure 38).

    Figure 38

    Click Finish (Figure 39).

    Figure 39

    Click Next (Figure 40).

    Figure 40

    Click Close (Figure 41).

    Figure 41

    Click OK to restart your VM (Figure 42).

    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.

    , , , , ,

    About Carl Webster

    Webster is a Sr. Solutions Architect for Choice Solutions, LLC and specializes in Citrix, Active Directory and Technical Documentation. Webster has been working with Citrix products for many years starting with Multi-User OS/2 in 1990.

    View all posts by Carl Webster

    No comments yet.

    Leave a Reply