Install RML Utilities - SQL-FineBuild/Common GitHub Wiki

Previous Install Process Monitor Manual Install Install SQL Nexus Next

FineBuild can install and configure the Replay Markup Language (RML) Utilities as part of the SQL Server install process. If you do not want to include RML Utilities in your FineBuild install, then do not download it.

RML Utilities is written by Microsoft. It was chosen to be included in FineBuild because it is an important SQL Support Team tool for providing analysis of SQL Server dump information.

RML Utilities is supported up to SQL Server 2014. However, for SQL Server 2012 and above you should Setup Distributed Replay.

If you install the RML Utilities, you must also Install Report Viewer component.

Item Location
RML Utilities home page https://support.microsoft.com/kb/944837
RML Utilities download x86 The x86 download for RML utilities is no longer available
RML Utilities download x64 https://www.microsoft.com/en-gb/download/details.aspx?id=4511
RML Utilities introduction https://www.sqlservercentral.com/blogs/replaying-workloads-with-the-rml-utilities

FineBuild RML Utilities Install

Automated silent installation of RML Utilities is performed by Process Id 4TF and is controlled by the parameters below:

SQL Version Parameter FULL Build WORKSTATION Build CLIENT Build
SQL2019 /SetupRMLTools: N/A N/A N/A
/SetupSQLTools: No Yes Yes
SQL2017 /SetupRMLTools: N/A N/A N/A
/SetupSQLTools: No Yes Yes
SQL2016 /SetupRMLTools: N/A N/A N/A
/SetupSQLTools: No Yes Yes
SQL2014 /SetupRMLTools: Yes Yes Yes
/SetupSQLTools: No Yes Yes
SQL2012 /SetupRMLTools: Yes Yes Yes
/SetupSQLTools: No Yes Yes
SQL2008R2 /SetupRMLTools: Yes Yes Yes
/SetupSQLTools: No Yes Yes
SQL2008 /SetupRMLTools: Yes Yes Yes
/SetupSQLTools: No Yes Yes
SQL2005 /SetupRMLTools: Yes Yes Yes
/SetupSQLTools: No Yes Yes

In order to maintain compatibility with older versions of SQL FineBuild, the parameters /InstRMLTools: and /InstSQLTools: can also be used.

FineBuild also uses the following parameters to help install RML Utilities:

Parameter Platform Default Value Description
/RMLToolsX86msi: 32-bit RMLSetup_X86.msi Name of RML Utilities install file
/RMLToolsX64msi: 64-bit RMLSetup_AMD64.msi Name of RML Utilities install file

RML Utilities will be installed with CLIENT and WORKSTATION builds, but not with a FULL build. If you want to install it with a FULL build, the following parameter should be added at run time:

  /SetupSQLTools:Yes

The FineBuild install for RML Utilities includes the following:

Top

Manual RML Utilities Install

The following steps show what you would have to do to install RML Utilities manually. FineBuild does all of this work for you automatically.

Install RML Utilities

  1. Navigate to the Additional Components folder

    Double-click on the relevant install file

    OS Type File
    32-bit RMLSetup_X86.msi
    64-bit RMLSetup_AMD64.msi

    ![Explorer](https://raw.githubusercontent.com/wiki/SQL-FineBuild/Commonhttps://github.com/SQL-FineBuild/Common/blob/master/Blob/ExtraComponents/ToolsExtras/RMLUtilities/RML Utilities Explorer.png)

  2. The Welcome window is displayed

    Click Next to continue

    ![Welcome](https://raw.githubusercontent.com/wiki/SQL-FineBuild/Commonhttps://github.com/SQL-FineBuild/Common/blob/master/Blob/ExtraComponents/ToolsExtras/RMLUtilities/RML Utilities Welcome.png)

  3. Accept the License Agreement

    Click Next to continue

    ![License](https://raw.githubusercontent.com/wiki/SQL-FineBuild/Commonhttps://github.com/SQL-FineBuild/Common/blob/master/Blob/ExtraComponents/ToolsExtras/RMLUtilities/RML Utilities License.png)

  4. Accept the installation Folder location

    Click Next to continue

    ![Install Location](https://raw.githubusercontent.com/wiki/SQL-FineBuild/Commonhttps://github.com/SQL-FineBuild/Common/blob/master/Blob/ExtraComponents/ToolsExtras/RMLUtilities/RML Utilities Location.png)

  5. Setup is now ready to install

    Click Next to continue

    ![Ready to Install](https://raw.githubusercontent.com/wiki/SQL-FineBuild/Commonhttps://github.com/SQL-FineBuild/Common/blob/master/Blob/ExtraComponents/ToolsExtras/RMLUtilities/RML Utilities Ready.png)

  6. The installation has completed successfully

    Click Close to end

    ![Complete](https://raw.githubusercontent.com/wiki/SQL-FineBuild/Commonhttps://github.com/SQL-FineBuild/Common/blob/master/Blob/ExtraComponents/ToolsExtras/RMLUtilities/RML Utilities Complete.png)

Setup Menu Item

Move the menu for RML Utilities for SQL Server to the Microsoft SQL Server menu structure, so that all tools for SQL Server are found in one place.

  1. Navigate to Start -> All programs

    Right-click on RML Utilities for SQL Server and select Explore

    ![Menu Explore](https://raw.githubusercontent.com/wiki/SQL-FineBuild/Commonhttps://github.com/SQL-FineBuild/Common/blob/master/Blob/ExtraComponents/ToolsExtras/RMLUtilities/RML Utilities Menu Explorer.png)

  2. Drag the RML Utilities for SQL Server folder to the Microsoft SQL Server\Configuration Tools folder

    ![Menu Drag](https://raw.githubusercontent.com/wiki/SQL-FineBuild/Commonhttps://github.com/SQL-FineBuild/Common/blob/master/Blob/ExtraComponents/ToolsExtras/RMLUtilities/RML Utilities Menu Drag.png)

Copyright FineBuild Team © 2011 - 2021. License and Acknowledgements

Previous Install Process Monitor Top Install SQL Nexus Next