The CS Citrix Presentation Server (aka. Terminal Server) provides access to an array of Windows applications from the CS Linux systems. This includes common applications like Microsoft Office and Internet Explorer. Please follow these steps to get started using Citrix.

1. Get an account - By default, all CS faculty, staff, and graduate students should already have an account on the Citrix server. However, if you have trouble logging in please use the normal CSG reporting mechanisms to request an account on the CS Citrix server. You will login to the Citrix server using your standard IU ADS username and password.
2. Disable SCIM - There are some incompatibilities between the Linux Smart Common Input Method (SCIM) and Citrix that prevents the keyboard from working in your Windows applications if SCIM is enabled. Please see the SCIM FAQ page for information about how to disable SCIM.
3. Cleanup Citrix Config - If you have used an earlier version of the CS Citrix server, you may have old configuration files that will cause trouble. If you have an old ~/.ICAClient directory from an earlier version of the Citrix client you are urged to just remove that directory and all of the contents. This directory will be recreated for you with the current configuration.
4. Start the Client Application - Start the Citrix client by running wfcmgr
5. Start the Windows Application - Double click on any of the listed applications to start them. You will be prompted to login with your IU ADS username and password.

The default configuration for wfcmgr should work fine, but there are some additional configuration options you may want to make. You can make global configuration changes by going to Settings from the wfcmgr Tools menu. You can make application-specific configuration changes by highlighting an application and then selecting Properties from the Connections menu. Here are some of the configuration changes you may want to make.

1. Add An Application - If applications are added to the server, they may not automatically appear in wfcmgr. To add new applications follow these steps for each application:
   1. Select New... from the wfcmgr Connections menu.
   2. Click on 'Published Application'
   3. Click on the '...' button (located to the right of the Description textbox).
   4. Select the application you wish to add and click OK.

2. Enable or Disable Sound - By default, sound is disabled for all applications. This prevents the playing of the annoying Windows startup sound whenever you start an application. If you need to have sound enabled for a given application, highlight the application, select Properties from the Connections menu, go to the Connection pulldown menu, and click the checkbox to enable sound.

3. Set Username/Password - By default, you will be prompted for your username and password each time you start an application. Use the following procedure to set the username and, optionally, the password for an application.
   1. Highlight the application
   2. Select Properties from the Connections menu
   3. Select Login from the pull-down menu at the top of the Properties page.
   4. Enter your username and use ADS as the Domain. If you enter your ADS password, it will be stored in an encrypted format in your ~/.ICAClient/appsrv.ini file, which is only readable by you. If you are particularly concerned about security, you may want to leave the password blank. If you do leave it blank, you will get an error when you start an application and you will then have to supply your password. If you want the convenience of not having to type a password to start an application, you can go ahead and enter your ADS password.
   5. When you are done, just click OK.

Your My Documents folder will be mapped to the "My Documents" directory of your CS home directory using samba (ie. ~/My Documents). If you need to access files that are outside of this directory, you can either move or copy the files into this directory or you can use symbolic links to provide access. For example, if you had a "doc" directory you wanted to make accessible, you could create a link as follows:

% cd ~/My\ Documents
% ln -s ../doc doc

There are a number of quirky issues with the Citrix client under Linux and here are a couple you may encounter:

• When you start an application, you may find that it runs in full-screen mode and you aren't able to minimize or resize it. If this happens, try to right click on the top bar in the application and select "Restore" from the menu.

• If you find that your keyboard does not work in your Windows applications, be sure to disable SCIM per the SCIM FAQ page.

• When you exit an application it frequently hangs around for about a minute before it dies completely. During this time, you may notice 1) there is a small gray box on your desktop that won't go away and 2) you are unable to restart the application. Just wait for a minute and it will go away.

• When you start an application, you may find that the window showing the progress of the application starting obscures the login window. If this happens, just move this windows out of the way so you can login.

• If you ever find that applications fail to start with errors about the application not being found or applications are missing from the wfcmgr window you can often correct this by just removing your ~/.ICAClient directory and running wfcmgr again. Do note, however, that doing this will cause you to lose any custom settings you have made.

• If you are using a dual-headed system you may get a warning upon startup indicating that the requested video mode was not available. Just ignore this warning and click OK to continue.

[Return to the FAQ index]