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
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).
Install this component by using the Windows Components wizard before installing the Citrix Presentation Server components.
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.
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.
When Citrix clients log on to the Citrix server, the logon script runs the user logon command (
- Add any network-mapped drives that are needed for Rational Application Developer to the
C:\WINDOWS\system32\usrlogon.cmdfile. If you do not want to edit this file, use this command:
Usrlogn1.cmdis 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.
- Have both users create a mapped drive and use the same letter for that drive, such as
- Edit the
C:\Windows\system32\Usrlogn1.cmdfile 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.
See the Citrix Presentation Server Administrator’s Guide for installation, deployment and publishing instructions. These steps give you additional guidance:
- After creating your server setup, right-click on it and select New > Publish Application.
- Click Next on the Welcome screen.
- Enter the display name and the application description. The display name is what will be displayed for the clients when they access the application.
- Click Next.
- Keep Application as the default for the application type, and click Next.
- 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.
- Click OK. The Working directory should be filled in automatically.
- Click Next and, on the next screen, click the Add button to select the server where Citrix is located.
- Click Add, OK, and then Next to proceed. Keep the default selection, "Allow only configured users," on the screen that follows.
- Click Add to select the users that will be allowed to use the Citrix clients, and then click Next.
- Select whether you want the application shortcut added to the client’s Start menu or desktop. Change the icon if necessary.
- Click Next and then Finish.
- There are two client options: Full client and Web client. Choose whichever you prefer to use.
- 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
- If you are using the Web client, choose the option to grant Full Access for Client File Security when prompted.
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 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
- 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
- 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
- Select the Allow check box for Full Control and then click OK. This will also give the subfolders full control.
- 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):
Figure 5. Profiles for each user for each WebSphere Application Server version
- 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
Do not check the box to create the profile as a Windows service (Figure 7).
Figure 7. Windows Service Definition dialog
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):
- Select Properties for the top folder.
- Click the Security tab.
- Select Advanced.
- Select the Users entry with Full Control Permission option.
- 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.
- Click Yes to continue.
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
Figure 9. Local client Internet Explorer browser
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
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
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
See Presentation Server 4.5 and Components Documentation page on the Citrix Web site for administrators’ and installation guides.
Consult The Ultimate Guide to Windows 2003 Terminal Server Licensing for Terminal Server Licensing information.
For relevant problems, check the Terminal Server + Citrix Troubleshooting site.
Find more information in the Mapped client drives section of the Citrix forum.
Learn about other applications in the IBM Rational Software Delivery Platform, including collaboration tools for parallel development and geographically dispersed teams, plus specialized software for architecture management, asset management, change and release management, integrated requirements management, process and portfolio management, and quality management.
Visit the Rational software area on developerWorks for technical resources and best practices for Rational Software Delivery Platform products.
Explore Rational computer-based, Web-based, and instructor-led online courses. Hone your skills and learn more about Rational tools with these courses, which range from introductory to advanced. The courses on this catalog are available for purchase through computer-based training or Web-based training. Additionally, some "Getting Started" courses are available free of charge.
Subscribe to the Rational Edge newsletter for articles on the concepts behind effective software development.
Subscribe to the IBM developerWorks newsletter, a weekly update on the best of developerWorks tutorials, articles, downloads, community activities, webcasts and events.
Browse the technology bookstore for books on these and other technical topics.
Get products and technologies
Download trial versions of IBM Rational software.
- Download these IBM product evaluation versions and get your hands on application development tools and middleware products from DB2®, Lotus®, Tivoli®, and WebSphere®.