Skip to main content

RTV administration

RTV administration

RTV profile

For some applications, RTV must be provided with hints in the RTV profile. Each user has a profile file to which these hints can be added.

Hints can also be synchronized by a central profile server. The RTV power users and Tealeaf administrators can update the central profile when the web application changes. The updates are propagated to all RTV users.

Note: The profile server does not maintain a history of revisions to profiles. Tealeaf administrators can manage revision history locally.

You can edit the most common profile elements through the RTV application. Users who are comfortable with XML can edit all profile options in the XML file.

RTV ships with a default profile for providing hints that help RTV replay the session. The Profile consists of a RequestMapping node and zero or more HostProfile nodes.

The RequestMapping node rarely changes. It contains the standard mappings followed by the major web server technologies: Apache and IIS. Each RequestEntry node within the RequestMapping section gives RTV a list of entries for which to search in a Request and from which to retrieve values that are needed to replay the session. It is unlikely that you will require to modify the RequestMapping node.

HostProfile nodes

In the HostProfile nodes, you can customize replay. The rules within each HostProfile node apply to all pages that come from a specified host. The host name is specified in the 'name' attribute. Do not include a protocol identifier, such as HTTP or HTTPS, or a port number in the host name.

If your Tealeaf cxImpact system is capturing many different web applications by using many different HTTP_HOST values, you need to create multiple HostProfile nodes. The host name can contain simple wildcards to allow a set of rules to apply to more than one host. For example, if your websites have one application that responds to www.mybiz.com, mybiz.com, and public.mybiz.com, and another application on www.internalmybiz.com, you would probably setup two HostProfile nodes,*mybiz.com, and *internalmybiz.com.

Be careful when you use wildcards to avoid creating conflicts between multiple HostProfile nodes that operate on the same domain. For example, if you had two HostProfile nodes: www.mycompany.com, and *.mycompany.com, sessions from www.mycompany.comwww.mycompany.comwould always pick up rules from the www.mycompany.com HostProfile node.

Note: When specifying a host, host names that exactly match a non-wildcard value always trump wildcard values. A single HostProfile node named "*" is allowed. This will match every host name, and if supplied, all session pages will use this HostProfile node.

The Rules within the HostProfile node control how RTV replays the session. Most of these rules can be created or modified through dialogs and menus within RTV, so editing the raw XML is not necessary.

The specific Replay Mapping directives are as follows:

Note: You may find it easier to add rules of these types through the view context menus.
Table 1. HostProfile Nodes

REQTEXT
Action Attributes Use
Add IgnoreUrl
  • value="/blank.html"
  • reqVar=(optional)
  • reqVarValue=(optional)
 Tells RTV that this is not a viewable page. If a matching page is displayed in the session, it is not inserted into the navigation list and cannot be opened during replay.
  • If the page is requested by an Ajax call or contains static content that is requested, it is used during replay.
  • The optional reqVar/reqVarValue attributes cause the page to be ignored only when the page contains either the reqVar, or the reqVar with a specific value.
Add Host/Port Remap (remap host)
  • mode=(on, off, null)
  • value=Yourserver.com
 Replaces the host name of the page with the specified host. There can be only one RemapHost node within a HostProfile node.
Add Host/Port Remap (remap port)
  • valueIn="1024"
  • valueOut="80"
 Changes any page by using the port in valueIn to the port number in valueOut. There can be multiple RemapPort nodes within a HostProfile node.
Add Host/Port Remap (protocol) value=(auto, http, https) Overrides the captured protocol of the all pages to specified type. There can be only one Protocol node within a HostProfile node.
Add FrameRule
  • url="olpeckLookupPage.jsp"
  • frame="lookup"
 Places any matching URLs into the named frame.
Add ResponseMod
  • url=(regex pattern for matching for urls)
  • pattern=(regex pattern to be replaced)
  • replacementString=(string to replace the pattern)
  • occurrences=(first, all)
 Used to do special processing to pages before replay, generally to nullify any page execution that is undesirable in replay.
Add ExternalFileMod
  • url=(regex pattern for matching for urls)
  • pattern=(regex pattern to be replaced)
  • replacementString=(string to replace the pattern)
  • occurrences=(first, all)
 Used to do special processing of external files, such as js files, before replay, generally to nullify any page execution that is undesirable in replay.
Add IgnoreReqVarForURLMatch
  • url=(regex pattern for matching for urls)
  • reqVar=(var to ignore)
 Used for Ajax replay. When matching requests generated during replay to captured hits in the session, some entries must be ignored, for example, a timestamp parameter.
Add PopupUrl value="/popup.html" All pages that match the pattern are treated as Pop-up pages. These items are displayed in the NavList, and when you browse to them, they are displayed in a pop-up window.
Add HighlightOnlyUrl
  • value="/blank.html"
  • reqVar=(optional)
  • reqVarValue=(optional)
 (AJAX pages) When UI Capture is not deployed, these rules mark the response of the specified URL as highlight only. In these cases, the response is treated as modifying the appearance of the preceding page, instead of replacing it.
Add BlockUrl url="http:///www.example.com/somepage.html"
Note: The protocol identifier (http:// in the example) is required for this rule type only.
 Specify a rule to block specific URLs or URL patterns from reaching out to the origin server. If the matching response is not in the session, no request is made to the origin server for the content, and the response is not displayed in RTV.

Ignore profiles stored in TLS

When you load a TLS, if a profile and options are stored within it, they are applied when the session is loaded and replayed. Any changes that you make to the profile or options apply only to the loaded session. Those changes are lost if you close the TLS without saving and are not applied to the global profile.

Note: This option is disabled by default.

If this option is enabled, any profile or options that are stored within the TLS are ignored when the file is loaded and replayed. The global options and profile settings are used instead. You might choose to ignore the settings that are stored in the TLS if they are known to be incorrect and are sure of the global settings.

Note: After you change this option, you must close and reopen any currently open TLS files for the change to take effect.

Enable and disable profile rules

As profiles become more sophisticated, you might find it useful to be able to disable individual rules for troubleshooting purposes.

In the Edit Profile dialog, you can enable or disable individual profile rules or groups of profile rules by selecting the appropriate check box.

Create a profile rule

To create a profile rule, select any displayed profile rule and then click New.

Note: You can also create new profile rules from the context menus from the Request, Response, and Replay views in RTV. Using the context menu options often pre-populates the rule with relevant settings, which greatly simplifies the process.

Select the type of rule from the displayed list:

Rule Description
New Host Add a host to monitor. The name of the host must be the full domain name of it (for example, www.example.com. Each host has its own set of profile rules, so you may need to add or copy rules from any existing host to the new one.
Add IgnoreURL Specify a URL for a page or pages that must not be included in replay. You can apply wildcards * or ? to the string.
Add Host/Port Remap If needed, you can remap detected host names and port numbers in the captured session data to redirect to other host/port combinations. This type of rule is useful for forcing replay to not use a production server.
Add FrameRule If IFRAMES are used for the web application, you can specify these rules to place URLs or patterns of URLs into specified frames.
Add ResponseMod These rules modify the response data based on detected patterns for one or more URLs.
Add ExternalFileMod For files that are referenced in session data, these rules modify the response data based on detected patterns so that unwanted effects are not applied to the session replay.
Add IgnoreReqVarforUrlMatch These rules can be used to specify [urlfield] values or query parameters that must be ignored when matching replay requests to captured pages within the session.
Add DynResponseMod Dynamic response modification rules are used to modify the response data by using parameterized event identifiers.
Add DynExternalFileMod Dynamic external file modification rules are used to modify external files that are referenced in the session pages by using parameterized event identifiers.

Related articles

community icon

Join the community

Ask questions, share best practices, and connect with fellow marketers.

Ask a question

Academy

Read how-to articles, guides, and more to help you on the path to success.

Learn more