Run a Vuser script from a Linux command line

When using VuGen to develop Linux-based Vusers, you must check that the recorded script runs on the Linux platform. This task describes how to perform this check and run a Vuser script from a Linux command.

To run a Vuser script on Linux:

  1. It is recommended to check the script in VuGen, before attempting to run it in Linux, because it is easier to edit and debug the script in VuGen.

    • Replay the script in VuGen to verify that the script works in Windows. For details, see Replay a Vuser script.
    • Run the Linux compatibility tool to check the compatibility of your script to run on Linux-based load generators. For details, see Check Linux compatibility.

  2. Transfer the script files to the Linux server.

  3. If you intend to run all of the Vusers on one host, type: 

    verify_generator

    The verify_generator either returns OK when the setting is correct, or Failed and a suggestion on how to correct the setup.

    For detailed information about the verify checks type:

    verify_generator [-v]

    The verify utility checks the local host for its communication parameters and its compatibility with all types of Vusers. It checks the following items in the Vuser environment:

    • at least 128 file descriptors

    • proper .rhost permissions: -rw-r--r--

    • the host can be contacted using rsh to the host. If not, checks for the host name in .rhosts

    • M_LROOT is defined

    • .cshrc defines the correct M_LROOT

    • .cshrc exists in the home directory

    • the current user is the owner of the .cshrc

    • a VuGen installation exists in $M_LROOT

    • the executables have executable permissions

    • PATH contains $M_LROOT/bin, and /usr/bin

  4. Run the script in standalone mode from the Vuser script folder, using the run_db_vuser shell script:

    run_db_vuser.sh <commands> script_name.usr

    The run_db_vuser shell script has the following command line options:

    Command
    Description
    --help
    Display the available options. (This option must be preceded by two dashes.)
    -cpp_only
    Run cpp only (pre-processing) on the script.
    -cci_only
    Run cci only (pre-compiling) on the script to create a file with a .ci extension. You can run cci only after a successful cpp.
    -driver driver_path

    Use a specific external driver. Each database has its own driver located in the /bin folder.
    -exec_only
    Execute the Vuser .ci file. This option is available only when a valid .ci file exists.
    -ci ci_file_name
    Execute a specific .ci file.
    -out output_path
    Place the results in a specific folder.

    By default, run_db_vuser.sh runs cpp, cci, and execute in verbose mode. It uses the driver in the VuGen installation\bin folder, and saves the results to an output file in the Vuser script folder. You must always specify a .usr file. If you are not in the script folder, specify the full path of the .usr file.

    For example, the following command line executes a Vuser script called test1, and places the output file in a folder called results1. The results folder must be an existing folder—it is not created automatically:

    run_db_vuser.sh -driver mdrv -out /u/joe/results1 test1.usr

Back to top

See also: