Tips for installing and configuring IBM Rational Application Developer on a Citrix Presentation Server

The Citrix Presentation Server is one of the platforms supported by IBM® Rational® Software Delivery Platform products. This article explains several important things to do on the Citrix server and client machines so that multiple users can develop with Rational Application Developer while using Citrix clients. The author also addresses a few limitations. This information is based on testing Rational Application Developer Version 7.5 with Citrix Presentation Server Version 4.5 (Version 5.0 of the Citrix Presentation Server is called Citrix XenApp).


Trina M. Burkett, Software Test Specialist, IBM Corporation

Trina Burkett photoTrina is a software engineer for the Rational Application Developer System Verification Test team. She is responsible for the installation and configuration of Rational Application Developer on the Citrix server and for leading the testing of the installation.

23 July 2009

Also available in Chinese Spanish

Applications and platforms tested

The IBM® Rational® Application Developer System Verification Test team tested this environment by using the following applications and platforms:

  • IBM Rational Application Developer Version 7.5
  • IBM® WebSphere® Application Server Versions 6.0, 6.1, and 7.0
  • Citrix Presentation Server Version 4.5 on a 64-bit Microsoft® Windows® Server 2003
  • Clients: Windows XP, 64-bit Windows XP, Windows 2008, 64-bit Windows 2008, Windows Vista

Tips for specific components

Terminal Services

Use Terminal Services Configuration to install this component on the system before the installation of the Citrix Presentation Server components. . Verify that you have the correct Terminal Services license mode (either per device or per user, based on your installed license).

Internet Information Services (IIS)

Install this component by using the Windows Components wizard before installing the Citrix Presentation Server components.

Web Interface

If you are installing on a 64-bit server, make sure that you install the Web Interface component before the other Citrix Presentation Server components since it enables 64-bit extension support.

User Settings

Add your Citrix client users to the Remote Desktop Users group. This can be done during the Citrix installation or after installation via the Computer Management wizard. Verify that all Citrix client users are in the Users group.

Network configuration

When Citrix clients log on to the Citrix server, the logon script runs the user logon command (usrlogon.cmd).

  1. Add any network-mapped drives that are needed for Rational Application Developer to the C:\WINDOWS\system32\usrlogon.cmd file. If you do not want to edit this file, use this command:
  2. Usrlogn1.cmd is called by usrlogon.cmd. Create that file. under C:\WINDOWS\system32, if it doesn’t exist, and add all of your mapped drives there. To add mapped drives from the client workstation use this line:
    net use [drive]: \\client\[client drive]$

Here is an example of how this would work:

User A needs to access a file from a remote database server, and User B needs to access files from a machine that the development team shares.

  1. Have both users create a mapped drive and use the same letter for that drive, such as M.
  2. Edit the C:\Windows\system32\Usrlogn1.cmd file on the Citrix server, and add the following line:
    net use S: \\client\M$

Now, when any user logs into Rational Application Developer using the Citrix client, the login script will run, and the Citrix server S drive will point to each client that is mapped to the M drive. Users will see only the mapped drives that they have created, and they can access those files by using the Citrix client’s S drive.

Publish Rational Application Developer on the server

See the Citrix Presentation Server Administrator’s Guide for installation, deployment and publishing instructions. These steps give you additional guidance:

  1. After creating your server setup, right-click on it and select New > Publish Application.
  2. Click Next on the Welcome screen.
  3. Enter the display name and the application description. The display name is what will be displayed for the clients when they access the application.
  4. Click Next.
  5. Keep Application as the default for the application type, and click Next.
  6. Click Browse under the Command line text field, and then browse to your Rational Application Developer installation path where the eclipse.exe file is located.
  7. Click OK. The Working directory should be filled in automatically.
  8. Click Next and, on the next screen, click the Add button to select the server where Citrix is located.
  9. Click Add, OK, and then Next to proceed. Keep the default selection, "Allow only configured users," on the screen that follows.
  10. Click Add to select the users that will be allowed to use the Citrix clients, and then click Next.
  11. Select whether you want the application shortcut added to the client’s Start menu or desktop. Change the icon if necessary.
  12. Click Next and then Finish.

Configure the Citrix client

  1. There are two client options: Full client and Web client. Choose whichever you prefer to use.
  2. When you are asked during the client installation whether you want to use your local user name and password to log on to Citrix sessions (Figure 1), select No, because local users do not have access to the Citrix machine.
Figure 1. Use Local Name and Password? screen
Citrix Presentation Server Client Setup view
  1. If you are using the Web client, choose the option to grant Full Access for Client File Security when prompted.

Set up IBM Rational Application Developer

WebSphere Application Server profiles

Each user needs a separate WebSphere Application Server profile, because access to WebSphere Application Server is shared, even though the Rational Application Developer workspace is not. Someone with Administrator privileges must create all of the profiles on the Citrix server and then inform all users what their individual profiles are and how they can access them. If any user has a server startup or publishing problem, verify that they are using the correct profile before debugging.

Create WebSphere Application Server profiles

  1. Create folders on the Citrix server for the WebSphere Application Server profiles. This example shows one for each version: 6, 6.1, and 7 (see the folders named "WAS##Profiles" in Figure 2.
Figure 2. Folder creation for WebSphere Application Server profiles
Shows the c:\CitrixUserProfiles folder and subfolders
  1. Give the users group Full Control permission for the top folder (C:\CitrixUserProfiles) by right-clicking on the CitrixUserProfiles folder and then selecting Sharing and Security from the drop-down menu (see Figure 3).
Figure 3. Folder sharing and security
Shows the drop-down (context)
  1. Select the Security tab and then the users group name. You will see that the group does not have Full Control permissions (Figure 4).
Figure 4. Folder security properties
Citrix User Profiles Properties view
  1. Select the Allow check box for Full Control and then click OK. This will also give the subfolders full control.
  2. To create the profiles, launch Rational Application Developer on the Citrix server as an Administrator. Create one profile for each client user. The example in Figure 5 shows profiles for each server version, too. For example, these are the WAS7Profiles (for IBM® WebSphere® Application Server Version 7):
    • AppSvr01
    • AppSrv02
    • AppSrv03
Figure 5. Profiles for each user for each WebSphere Application Server version
Folder structure
  1. Use the Advanced profile creation option to define the names and paths for the profiles (see Figure 6 for descriptions).
Figure 6. Profile Type Selection options: Typical or Advanced
Profile Management Tool view

Click to enlarge

Do not check the box to create the profile as a Windows service (Figure 7).

Figure 7. Windows Service Definition dialog
Box not checked

Click to enlarge

After creating the profiles, select the top folder, where the profiles are created (C:\CitrixUserProfiles), and follow these steps to apply security settings to the folders for the Users group, as well as to the subfolders, or "children" (override):

  1. Select Properties for the top folder.
  2. Click the Security tab.
  3. Select Advanced.
  4. Select the Users entry with Full Control Permission option.
  5. Select the check box for "Replace permission entries on all child objects with entries shown here that apply to child objects," and then click OK.
  6. Click Yes to continue.

Tips for using Rational Application Developer clients

Your client and server are now set up for clients to log in through the Citrix client (using either the full version or Web client), and the application will appear to be running on your local machine. Keep these additional things in mind when using the Citrix client:


Users should create workspaces on the Citrix server rather than on the client workstation. We have found some limitations, such as file permissions issues, when creating workspaces on the client machines.


When choosing to use external Web browsers, you will see browser options from both the local client and the Citrix server in the Web Browser Preferences list (Figure 8.). In this list, you see Internet Explorer listed twice. The first instance has a path starting with "C:" (see Figure 8), which is the path on the Citrix server. The second Internet Explorer item has a path that starts with "V:" (see Figure 9), which is a path on your local workstation.

Figure 8. Citrix server Microsoft® Internet Explorer® browser
Preferences view with Web browser subviews open
Figure 9. Local client Internet Explorer browser
Preferences view with Web browser subviews open

Do not use the browsers from your local workstation. When you select and use the local browser, you get the error message shown in Figure 10: "Could not launch external Web browser for…."

Figure 10. Browser launch error message
Error message with path specified

Do not select a browser that is not installed on the Citrix server. In this example (11), Mozilla Firefox is installed on the client machine but not on the Citrix server.

Figure 11. Local client Firefox browser
'Edit External Web Browser' view, 'Firefox' as Name

If you select and use the local Firefox browser in this situation, you get the "Problem Occurred" error message, saying that Firefox failed to launch (see Figure 12).

Figure 12. "Problem Occurred" error message
Screen capture of error message



Get products and technologies



developerWorks: Sign in

Required fields are indicated with an asterisk (*).

Need an IBM ID?
Forgot your IBM ID?

Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.


All information submitted is secure.

Dig deeper into Rational software on developerWorks

Zone=Rational, Agile transformation
ArticleTitle=Tips for installing and configuring IBM Rational Application Developer on a Citrix Presentation Server