Record a Script via a Proxy

This topic describes various methods for recording a script using a proxy server. In all use cases, the client machine and VuGen machine are in the same network.

Use Case 1

You want to record a business process but you cannot install VuGen on the client machine or device.

  1. Create a new Web - HTTP/HTML script.

  2. Start Recording.

    1. From the Start Recording dialog box, select Recording Mode > Record > Remote Application via LoadRunner Proxy. For details, see Start Recording Dialog Box.

    2. Specify the port on which the LoadRunner proxy will listen, by default, port 8888.
    3. Check the Display recording toolbar on client machine. This allows you to see and interact with the recording toolbar on the client machine.
    4. Click Start Recording.
  3. On the client machine, delete the browser cache.

  4. Configure the proxy settings to specify the VuGen machine as the proxy server.

    Specify the machine address and port on which the LoadRunner proxy will listen.

  5. Record the business process.

    1. Navigate to your application.
    2. Perform the steps of your business process you want to record.

  6. Generate the script.

    Select Stop Recording from either the Recording Toolbar on the client machine or the Floating Recording Toolbar on the VuGen machine. VuGen generates the script.

    Note: It is common for business processes to use SSL communication even when not explicitly displaying a URL with HTTPS. In this case, a certificate may be required. Refer to Use Case 3 for more information on obtaining the certificate.

Back to top

Use Case 2

You want to record a business process but you cannot install VuGen on the machine (or device) running the application. The client machine requires a proxy to access the Internet.

  1. Create a new Web - HTTP/HTML script.

  2. Start recording.

    1. From the Start Recording dialog box, select Recording Mode > Record > Remote application via LoadRunner Proxy.

    2. If necessary, change the port on which the LoadRunner proxy listens. The default is port 8888.
    3. Select Display recording toolbar on client machine. This allows you to see and interact with the recording toolbar on the client machine.
    4. Set the VuGen Internet Explorer proxy details:

      In Internet Explorer, select Tools > Internet Options > Connections. Click LAN settings and enter the port and address of the client machine's Internet proxy.

      Note: The Use automatic configuration script option is not supported.

    5. Select Start Recording.
  3. On the client machine, delete the browser cache.

  4. Configure the browser settings to use the VuGen's machine IP and port.

  5. Record the business process.

    1. Navigate to your application.
    2. Perform the steps of your business process you want to record.

  6. Generate the script.

    Select Stop Recording from the either the Recording Toolbar on the client machine or the Floating Recording Toolbar on the VuGen machine. VuGen generates the script .

    Note: It is common for business processes to use SSL communication even when not explicitly displaying a URL with https. In this case, a certificate may be required. See Use Case 3 for details on obtaining the certificate.

Back to top

Use Case 3

Your application communicates using SSL.

  1. Prepare to import the LoadRunner SSL certificate to the client machine.

    Note: As an application developer, you can set certain policies on the server certificate when using SSL. However, only if the LoadRunner certificate conforms to the policy, can the client trust the server and the SSL connection be set.

  2. Download the certificate, by navigating to http://<computer name of VuGen machine>:port/proxyroot.cer or http://<ip address of VuGen machine>:port/proxyroot.cer.

    Note: If you experience security restrictions, navigate to http://<computer name VuGen machine>:port/proxyroot.dat or http://<ip address of VuGen machine>:port/proxyroot.dat. After downloading the certificate, change the .dat extension back to .cer to import the certificate.

  3. Import the SSL certificate. The following table provides examples of the path for various browsers.

    • For Internet Explorer, select Internet Options > Content > Trusted Root Certificate Authorities > Import.
    • For Firefox, select Tools > Options > Advanced > Certificates tab > View Certificates > Authorities > Import.

Back to top

Use Case 4

You want to do a proxy recording of a local application that uses the system proxy, where VuGen and the client application are on the same machine.

  1. Create a new Web - HTTP/HTML script.

  2. Set the recording option.

    Open the recording options (Recording > Recording Options) and select the HTTP Properties > Advanced node. Enable the Use the LoadRunner Proxy to record a local application.

  3. Start recording.

    1. Open the Start Recording dialog box.

    2. In the Recording mode section, select Record: Web Browser.
  4. Perform the business process.

    1. Navigate to your application.

    2. Perform the steps of your business process you want to record.

Back to top

After recording

VuGen automatically resets the proxy back to its original setting after the recording. If the recording did not end in the normal way, for example, if your application crashed during recording, you may need to manually set the proxy back to its original value. To do so, go to Internet Options > Connections > LAN Settings > Proxy server.

If you are recording a Java application or a browser other than Internet Explorer, and the application is not using the system proxy settings, you will need to manually set the proxy of the application.

Back to top