Share this page

# Convert scripts to TruClient 2.0

You can upgrade your TruClient - Web scripts to TruClient 2.0 - Web format.

In this topic:

## Overview

Your existing TruClient - Web scripts can be migrated to TruClient 2.0 - Web format, to take advantage of the improved and extended capabilities of TruClient 2.0.

The conversion can be performed on scripts created in TruClient versions 12.53 and later.

You can convert an open script from within the VuGen editor. For details, see Convert a script in the VuGen editor.

You can also use the TruClient Script Converter tool to convert your scripts, without opening them. The Script Converter can be used to convert single or multiple scripts, and can also convert scripts from other OpenText Performance Engineering solutions.

Note: Before using the converted scripts for testing, it is recommended that you replay them once in VuGen, to check that there are no issues.

## Convert a script in the VuGen editor

You can convert a script by opening it in VuGen and selecting the conversion option.

To convert a script in the VuGen editor:

1. Open a TruClient - Web script in the VuGen editor.

2. Select Tools > Convert TruClient Scripts > Convert to TruClient 2.0 Web.

3. In the displayed Convert TruClient script to TruClient 2.0 script dialog box, enter a name for the converted script.

   The default is the original script name with a _TC2 suffix.

4. Enter or browse to a location to save the converted script. By default, the script is saved in the same location as the source script.

5. Click Convert. The converted script is added to the currently open solution in the editor.

## Convert a single script using the Script Converter

You can use the Script Converter tool to convert a single TruClient - Web script, without opening the script.

To convert a script using the script converter tool:

1. Open the TruClient Script Converter from the Windows Start menu.

2. In the Convert a single script area, browse to the location of the Source script.

3. In the Output directory box, browse to the folder where you want to save the converted script.

   Note: The converted script will be given the same name as the source TruClient script.

4. Select the required options for converting the script:

   - Create parent directory for converted script. When selected, creates a new folder named tc2conversion under the selected output directory, and adds the converted script there. If the tc2conversion folder already exists in the output directory, the converted script is added to the existing folder.

     Default mode: Selected

   - If the script already exists in the output directory, overwrite it. When selected, if the output path already contains a script with the same name, the script files are overwritten with the converted script.

     Caution: The overwrite option will overwrite any script in the output directory that has the same name, including the source script. If it overwrites the source script, the conversion may fail.

     Default mode: Not selected

5. Click Convert. A message is displayed when the conversion is complete.

6. If you want to view the converted script, click Open Script. The generated TruClient 2.0 - Web script is opened in a new instance of VuGen.

## Batch convert multiple scripts

You can use the Script Converter tool to convert multiple scripts, without opening the scripts.

To convert multiple scripts using the script conversion tool:

1. Open the TruClient Script Converter from the Windows Start menu.

2. In the Convert multiple scripts area, browse to the Source directory containing the TruClient - Web scripts.

3. In the Output directory box, browse to the folder where you want to save the converted scripts.

4. Select the required options for converting the scripts:

   - Search scripts recursively. When selected, all descendant folders under the source directory are searched for TruClient - Web scripts.

     If it is not selected, the search is performed only in the files under the source directory.

     Default mode: Selected

   - If the script already exists in the output directory, overwrite it. When selected, if the output path already contains a script with the same name, those script files are overwritten with the converted script.

     Default mode: Not selected

5. The discovered TruClient - Web scripts are displayed in the Select scripts box in tree format.

   Use the check boxes in the tree to select or deselect individual scripts, or entire branches.

6. Click Convert. The script converter attempts to convert all scripts that are checked in the Select scripts box.

   When the conversion is complete, the Result area is displayed in the TruClient Script Converter window. This area provides:

   - A summary of the conversion results.

     Tip: You may need to expand the TruClient Script Converter window to view all summary information.

   - A table listing the scripts and their conversion status. Place the cursor over a status to view more information.

7. To view a successfully converted script, click the Edit icon in the Result table . The generated TruClient 2.0 - Web script is opened in a new instance of VuGen.

## Convert downloaded scripts

TruClient - Web scripts on OpenText Enterprise Performance Engineering or OpenText Core Performance Engineering servers can be converted to TruClient 2.0 - Web, using the script converter tool provided with VuGen. (They cannot be converted on the source server.)

You download the scripts to the VuGen machine and run the conversion. Once the scripts are converted to TruClient 2.0 - Web format, they can be uploaded to the original server.

To download scripts to the VuGen machine:

1. Open the TruClient Script Converter from the Windows Start menu.

2. Select the tab for the appropriate product.

3. Connect to the server:

   1. Enter the Host address, including the tenant ID, if relevant. For example: hostname/v1/?TENANTID=xxx

   2. Enter the relevant login information for the server.

   3. Click Authenticate.

4. After successful connection, click the Download tab.
5. Select the Domain (for OpenText Enterprise Performance Engineering) and Project from the dropdown lists.

6. Click Get script list. All the TruClient - Web format scripts in the selected project are listed in the Scripts box.

   Select the scripts you want to download.

   Tip: For OpenText Core Performance Engineering, you can click a column header in the table to sort the scripts.

7. In the Download target field, browse to the target folder for the selected scripts.

8. Select required download options:

   - Overwrite if the script already exists. When selected, if the download target path already contains a script with the same name, those script files are overwritten with the downloaded script files.

   - Stop downloading on error. When selected, the download operation will stop if there is a network error.

9. Click Download. Script download begins, and progress is indicated beside the Download button.

10. Click Go to converter, and use the Conversion tab to convert the scripts. For details, see Batch convert multiple scripts.

To upload scripts from the VuGen machine:

Note: Before uploading your converted scripts, make sure you can replay them successfully in VuGen.

1. Open the TruClient Script Converter from the Windows Start menu, and connect to the relevant server.

   For details, see the To download scripts to the VuGen machine: procedure.

2. After successful connection, click the Upload tab.
3. Select the Domain (for OpenText Enterprise Performance Engineering) and Project from the dropdown lists, to set the target location for the uploaded scripts.

4. In the Source directory field, browse to the folder containing the scripts to upload.

   All the TruClient 2.0 - Web scripts in the folder are displayed in tree format in the Scripts box.

5. Select the scripts you want to upload.

6. If required, select Stop uploading on error. This halts the upload operation if there is a network error.

7. For uploads to OpenText Core Performance Engineering, select required upload options:

   - Overwrite if the script already exists. When selected, if the server path already contains a script with the same name, those script files are overwritten with the uploaded script files.

   - Create parent folder in project. When selected, a parent folder for the uploaded scripts is added to the server. Define the folder name in the displayed box.

8. Click Upload. Script upload begins, and progress is indicated beside the Upload button.

## See also

- TruClient 2.0 - Web protocol

https://admhelp.microfocus.com VuGen,Professional Performance Engineering,Performance Engineering for Developers 8942
Tips to improve your search results... OpenText™ Virtual User Generator Help Center OpenText™ VuGen Help 26.1-26.3 All View Local Help Center View Online Help Center Version: