XCOPY deployment | Ranorex
Help CenterUser GuideXCOPY deployment

XCOPY deployment


The deployment of test cases and test projects without a Ranorex installation is possible, but not recommended. But in some cases, this method is necessary to overcome internal policies and restrictions inhibiting installations on runtime environments. This chapter describes how to deploy libraries, assemblies, and the license information in this way.

In this chapter


    The machine you want to deploy to must fulfill the following requirements:

    Operating system

    32- or 64-bit edition

    • Windows Vista
    • Windows 7
    • Windows 8
    • Windows 8.1
    • Windows 10
    • Windows Server 2008
    • Windows Server 2008 R2
    • Windows Server 2012
    • Windows Server 2012 R2

    Software requirements

    • Microsoft Visual C++ 2008 x86
    • Microsoft Visual C++ 2008 x64 (required for 64 bit Windows versions only)
    • Microsoft Visual C++ 2010 x86
    • Microsoft Visual C++ 2010 x64 (required for 64 bit Windows versions only)
    • Microsoft Visual C++ 2015 x86
    • Microsoft Visual C++ 2015 x64 (required for 64 bit Windows versions only)
    • Microsoft .NET Framework 4.5.2 or higher

    Deploy Ranorex Libraries and Assemblies

    The required files for executing Ranorex tests on runtime machines are located in the “bin” folder of the Ranorex installation path. These files can be found easily on machines having a valid Ranorex Installation using the environment variable %RANOREXPATH%. Please copy the whole content of the “bin” folder (including all subdirectories) to a target folder () on the runtime machine.
    xcopy "%RANOREXPATH%bin*.*" 
    tipp icon


    It is crucial to deploy the Ranorex Assemblies with exactly the same version that was used to compile the test executable.

    Deploy Ranorex License Information

    In the runtime environment a valid license information needs to be available. Most likely the runtime machine will use a floating license, so the only information necessary can be provided by the license file (Ranorex3_Server.lic). This file can be copied easily from any machine having a floating license installed to the target machine and is located in the path of the environment variable %ALLUSERSPROFILE%. For more information please refer to chapter ⇢ Install Ranorex License in the section Silent Installation of Ranorex.


    Deploy Your Ranorex Test

    Ranorex generates the files needed to run automated tests in the “Output Folder” (by default binDebug) of a test suite project. To access this folder quickly, right-click your current project in Ranorex Studio and select Open output folder.
    Next to files needed for test execution, additional files are created in the output folder during test execution (e.g. Reports, Screenshots etc.). Those files do not have to be copied. It’s recommended to clear your output folder before and then trigger a new build (Build -> “Build Solution” or hot key F8).

    Required files for executing Ranorex test automation:

    • Executable file (*.exe)
    • Test Suite File (*.rxtst)

    Additionally required on the base of your project needs:

    • Ranorex Module Group (*.rxtmg), only necessary if modules groups are in use
    • Test Data (*.xlsx, *.xlsb, *.xls, *.csv, *), only necessary for data driven tests and if data source files were added to project
    • Module Libraries (*.dll), only necessary if module libraries are linked and embedded functionality is referenced in the Test Suite
    • Sub folder “RepositoryImages” including all files, if exists

    Finally copy the files needed to the target machine and place them in the folder where all Ranorex Libraries and Assemblies are already located (). Of course, by copying the whole output folder (“bindebug” by default), you will ensure you have everything possibly required for running your test.

    xcopy "bindebug*.*" 
    Note icon


    For executables being explicitly compiled against 64bit CPUs, place these files in the sub folder “x64” of the target folder.