Install Distributed Replay from the Command Prompt

  • Article

Installing a new instance of Distributed Replay at the command prompt enables you to specify the features to install and how they should be configured. The command prompt installation supports installing, repairing, upgrading, and uninstalling of the Distributed Replay components. When installing through the command prompt, SQL Server supports full quiet mode by using the /Q parameter.

Note

For local installations, you must run Setup as an administrator. If you install SQL Server from a remote share, you must use a domain account that has read and execute permissions on the remote share.

Installation Parameters

The list of top-level features include SQL Server, Analysis Services, Reporting Services, Integration Services, and Tools. The Tools feature will install SQL Server Management Tools, SQL Server Books Online, SQL Server Data Tools (SSDT), and other shared components. To install the Distributed Replay components, specify the following parameters:

Component

Parameter

Distributed Replay controller

DREPLAY_CTLR

Distributed Replay client

DREPLAY_CLT

Administration Tool

Tools

Important

After you install Distributed Replay you must create firewall rules on the controller and client computers, and grant each client computer permissions on the target server. For more information, see Complete the Post-Installation Steps.

Use the parameters in the following table to develop command line scripts for installation.

Parameter

Description

Supported Values

/CTLRSVCACCOUNT

Optional

Service account for the Distributed Replay controller service.

Checks account and password

/CTLRSVCPASSWORD

Optional

Password for the Distributed Replay controller service account.

Checks account and password

/CTLRSTARTUPTYPE

Optional

Startup type for the Distributed Replay controller service.

  • Automatic

  • Disabled

  • Manual

/CTLRUSERS

Optional

Specify which users have permissions for the Distributed Replay controller service.

Set of user account strings using “ ” (space) for delimiter

Important: When you configure the Distributed Replay controller service, you can specify one or more user accounts that will be used to run the Distributed Replay client services. The following is the list of supported accounts:

  • Domain user account

  • User created local user account

  • Administrator

  • Virtual account and MSA (Managed Service Account)

  • Network Services, Local Services, and System

Group accounts (local or domain) and other built-in accounts (like Everyone) are not accepted.

/CLTSVCACCOUNT

Optional

Service account for the Distributed Replay client service.

Checks account and password

/CLTSVCPASSWORD

Optional

Password for the Distributed Replay client service account.

Checks account and password

/CLTSTARTUPTYPE

Optional

Startup type for the Distributed Replay client service.

  • Automatic

  • Disabled

  • Manual

/CLTCTLRNAME

Optional

The computer name that the client communicates with for the Distributed Replay Controller service.

/CLTWORKINGDIR

Optional

The working directory for the Distributed Replay Client service.

Valid path

/CLTRESULTDIR

Optional

The result directory for the Distributed Replay Client service.

Valid path

Sample Syntax:

To install the Distributed Replay controller component

setup /q /ACTION=Install /FEATURES=DREPLAY_CTLR /IAcceptSQLServerLicenseTerms /CTLRUSERS="domain\user1" "domain\user2" /CTLRSVCACCOUNT="domain\svcuser" /CTLRSVCPASSWORD="password" /CTLRSTARTUPTYPE=Automatic

To install the Distributed Replay client component

setup /q /ACTION=Install /FEATURES=DREPLAY_CLT /IAcceptSQLServerLicenseTerms /CLTSVCACCOUNT="domain\svcuser" /CLTSVCPASSWORD="password" /CLTSTARTUPTYPE=Automatic /CLTCTLRNAME=ControllerMachineName /CLTWORKINGDIR="C:\WorkingDir" /CLTRESULTDIR="C:\ResultDir