Installing SQL Clone Agents

Once you have installed SQL Clone Server, you will need to install one or more SQL Clone agents. You will need to install an agent on every machine with SQL Server where the cloned databases will be hosted.

As with any other database, a clone database can only be created on an instance where the SQL Server version is the same or higher than the source image.

The steps  to install an Agent to create a Clone are the same as installing the Agent to create an Image.

The SQL Clone agent installed can be downloaded from the home page of the server's web app. You will need to download a separate agent installer file for every agent (SingleUseSqlCloneAgentInstaller.exe), as each executable file contains a unique key that can only be used once.

The agent installer requires a username and password for the agent service. These credentials will also be used to connect to databases if you choose "windows authentication" within the tool.

See Requirements for more information about what permissions the agent user requires.

The agent must be able to connect to SQL Clone Server on port 14146.

Troubleshooting the install

• "An existing connection was forcibly closed by the remote host" error
• "Could not load file or assembly 'RedGate.SqlClone.Unmanaged.dll' or one of its dependencies" error
• Agent communication problems during install configuration
• An agent doesn't work after using the SERVERURL command line flag during installation ('unauthorized received from server')
• Could not execute "...VCRedist2017": Installation error 1 when running
• Error 1603 Service ... could not be installed. Verify that you have sufficient privileges to install system services.
• Error 1923. Service ... could not be installed.  Verify that you have sufficient privileges to install system services.
• Problems during configuration wizard