Convert Functional to Load Test

This aspect of the Rapise-NeoLoad integration describes the process for taking an existing test script written in Rapise and converting it seamlessly into a performance scenario in the NeoLoad load testing system. This feature allows you to convert Rapise tests for HTTP/HTTPS based applications into protocol-based NeoLoad scripts that can be executed by a large number of virtual users (VUs) that simulate a load on the application being tested.

Prerequisites

In order to use the integration with NeoLoad, you need to have the following:

Both tools must be installed on the same Windows host. NeoLoad must have a license with Recording API enabled. The default trial version does not have this capability. The Rapise test needs to be testing an application that uses HTTP/HTTPs or other NeoLoad supported protocols.

The Steps for Converting a Rapise Test

Launch NeoLoad

Open NeoLoad via the Start menu or using a command line:

c:\Program Files (x86)\NeoLoad 5.1\bin\NeoLoadGUI.exe

neoload ui

Create or Open Existing Load Project

Use menu File > New or File > Open.

neoload project

Open a Test Script in Rapise to be Converted

Inside Rapise, open the script you want to convert. Make sure the application it is testing is a web-based application using the HTTP/HTTPS protocols:

rapise test

Ensure that the Internet Explorer HTML library is set in the test parameters.

ie browser

Open Conversion Dialog

From the main menu select Tools > Convert to NeoLoad.

This will display the NeoLoad convertor dialog. On this dialog box, set the following parameters:

neoload-conversion-dialog

Virtual User

In this field, you need to enter the name of the virtual user to create in NeoLoad:

Base Container

This specifies the base container  where we want to start the recording (Init / Actions / End).

Container/Business Transaction

This is used to specify the current recording container in NeoLoad. It is just based on a single level. There is no way to specify a tree of containers.

Detect Dynamic Parameters

When you check this box, Rapise tells NeoLoad to scan the protocol traffic to look for known dynamic parameters (e.g. Session IDs, ASP.NET ViewState) that change on each HTTP request and need to be parameterized by NeoLoad to ensure the performance scripts are robust and well-defined (v.s. having a hardcoded Session ID).

In the NeoLoad tree it looks this way:

neoload tree

Press Convert Button

After pressing Convert button Rapise will launch the test and NeoLoad will start capturing network traffic. When test playback is finished you’ll see the dialog:

convertion completed

Troubleshooting

During conversion you may get a few error messages. This section provides a list of common messages and their solution.

Unable to connect to the remote server

clip0053

If you get this message, check that NeoLoad is running. Usually this message means that NeoLoad is not started or another application is using port 7400, preventing NeoLoad binding to it.

No project is open

clip0054

If you get this message, check that a project is opened in NeoLoad.

NeoLoad is not ready for recording

clip0055

If you get this message, it means that NeoLoad is in the recording state. To fix the issue, you need to stop the existing recording in NeoLoad.

NeoLoad Integration Settings

There are a few global options for the Rapise – NeoLoad integration. To reach them use menu Settings > NeoLoad Integration.

clip0057

This is the NeoLoad Settings dialog. Normally there is no any reason to change these settings, but for completeness they are described below: