Recording a test with the Citrix Web Interface

You can record a Citrix session from the Citrix Web Interface to use the load balancing feature provided by this connection method.When you have finished recording the session, the wizard generates a Citrix test.

Before you begin

By default, IBM® Rational® Performance Tester Agent starts as a service. If you run a Citrix test on an agent, you must start Rational Performance Tester Agent as a process.
To start an agent as a process:
1. Open the Windows Services window.
2. For the Majordomo service, change the Startup Type to Manual and then change the Status to Stop.
3. From the agent's installation directory, open the Majordomo folder, and double-click the Majordomo.exe file.

Procedure

Click File > New > Test from Recording, and then select Citrix Recording, and click Next.
On the Select Location for Test Suite page, select a project.
In Test file name, type a name for the Citrix test, and then click Next.
On the Citrix Connection Settings page, select Through a Web interface, and click Next.
On the Select Client Applications page, select the web browser to use and click Next.
Depending on your selection, take one of the following steps. On the Recorder Settings page, depending on the browser that you selected, specify these details:
- Click Record traffic with the proxy recorder to record HTTP or SOCKS traffic through a proxy or click Record traffic with the socket recorder to record low-level network traffic for applications where a proxy cannot be used. Use this option primarily when you are not using Mozilla Firefox or Microsoft Internet Explorer.
  Note: When using proxy recording, you can filter out HTTP or HTTPS requests to specific endpoints so that any requests to those endpoints are not recorded. See Proxy recording preferences.
- If the server requires client SSL authentication, provide the client certificate keystore for the proxy recorder to be authenticated by the server as though the proxy recorder were the client. Select the The server requires a specific client certificate check box. Specify the file name and password of the server certificate keystore. If multiple certificates are required, click Multiple certificates, and click Add to specify a certificate keystore file name and password for each host name and port.
- If you selected Mozilla Firefox, you can choose to use a temporary Firefox profile. Doing so starts Firefox without any bookmarks, plug-ins, or toolbars that might be associated with your usual profile. Select the Use an alternate Firefox profile check box, and then select Use a temporary Firefox profile.
- If you clicked Record traffic with the proxy recorder, click Advanced to specify whether to use an HTTP or SOCKS proxy recorder to review and edit network connection settings that the browser uses or to specify advanced SSL authentication settings. If you clicked Record traffic with the socket recorder, specify advanced SSL authentication settings.
To start the recording, click Finish. The web browser opens.
In the web browser, specify the Citrix Web Interface server URL
On the Citrix Web Interface page, type your user name, password, and domain to open a session. The Citrix Web Interface displays the list of applications published on a server and available to the user. Select the application to test. The Citrix Recording window opens. You can use the recorder controls in the toolbar to add comments, record synchronizations, or take screen captures during the recording.
1. To add a user comment to the recorded test, click the Insert user comment icon . Because Citrix tests can be long and difficult to read, meaningful comments can help you locate important elements.
2. To add an image synchronization to the recorded test, click the Insert image synchronization icon , select an area of the screen that will be used for synchronization, and then click the Insert image synchronization icon again. Image synchronizations enable the test to keep track of the contents of a screen area during the replay instead of focusing only on window events. You can use image synchronizations to maintain synchronization of a test in applications that do not create or modify many windows, but update the contents of a window regularly. The contents of an image can be evaluated either as a bitmap hashcode or as a text value obtained by optical character recognition. You can also add verification points to image synchronizations in the test editor.
3. To add a screen capture to the recorded test, click the Capture screen icon . Screen captures make your tests easier to read and help you visualize the recorded test.
4. To change the settings for screen captures, click Screen capture preferences icon , and then select one of these options:
  No automatic screen capture
  
  Select this option if you do not want the test recorder to record screen captures automatically. When this option is selected, you can still record screen captures manually. This option is selected by default.
  
  Capture screen every
  
  Select this option to automatically record a periodic screen capture and specify the time between captures.
  
  Capture screen on window creation
  
  Select this option to record a screen capture each time a window object is created in Citrix.
  
  Exclude tooltips
  
  When Capture screen on window creation is selected, enable this option to prevent creating a screen capture each time a tooltip event is displayed during the recording. If this option is disabled, screen captures are recorded when tooltips are displayed.
When you complete the sequence of actions to be tested, close the session and stop the recorder by clicking the Stop recording () or close the Citrix application and web browser.. A progress window opens while the test is generated. On completion, the Recorder Control view displays the Test generation completed message, the Test Navigator lists your test, and the test opens in the test editor.

Results

The Test editor displays both the HTTP pages and the Citrix user actions.

What to do next

To run the Citrix Web Interface test, click Run Test in the Test editor.

Feedback