Install Recast Agents

Recast Agents are installed on a computer and run Right Click Tools actions on that computer as the local system account. Recast Agents are useful for running actions against workgroup devices or devices in untrusted domains. In this scenario, a Recast Agent would be installed on each workgroup computer you want to run Right Click Tools Actions against.

After installing Recast Agents, you can configure them to run Right Click Tools actions or for Fast Channel Support.

NOTE: If deploying 5000+ Recast Agents, follow the 503.2 IIS Error instructions before proceeding. 

Prerequisites

  • Download the Recast Agent installer from the Recast Portal.
  • If your Recast Management Server is using a self-signed certificate, import the certificate into the Trusted Root Certificate Authorities Store on all devices that will have Agents. For instructions on importing a certificate to a local machine, see Certificate used by Recast Management Server is not trusted.

Install Recast Agent Connected to Recast Management Server

To install a Recast Agent connected to your Recast Management Server:

1. Run the Agent installer you downloaded from the Recast Portal.

2. Under Recast Agent Configuration, enter the Server Name and Server Port number for the Recast Management Server.

3. Click Test Connection to confirm that the Agent can connect to the Recast Management Server. 

NOTE: If the installer does not connect to the Recast Management Server, troubleshoot any error messages that appear in the installer before continuing with the install.

4. Click Install.

5. After Agent installation completes, click Finish to exit the installer.

Silent Install for Agent with Recast Management Server

Add the RCTENTERPRISESERVER=https://<FQDN>:<Port> parameter to your install string, substituting the FQDN and port number for your Recast Management Server.

Example:

msiexec.exe /i "Recast Agent.msi" /qn /norestart RCTENTERPRISESERVER="https://RMS.RecastDomain.com:444" /L*V "%temp%\RecastAgentMSI.log"

NOTE: The default Recast Management Server port is 444. Inbound and outbound traffic over port 444 (or an alternative port you specify) must be enabled between the Recast Management Server and any device that has a Recast Agent in order for the Agent to be able to communicate with the server.

Install Agent for Fast Channel Support

Select this Agent installation option to deploy the Agent for Fast Channel use only. The Agent won't connect to the Recast Management Server and won't be visible in the Recast Agents section of the Recast Management Server interface.

For more information, see Configure Fast Channel Support.

To install an Agent for Fast Channel Support:

1. Run the Agent installer you downloaded from the Recast Portal.

2. Under Recast Agent Configuration, enable Install without connecting to RMS.

3. Click Next and Install

Connecting to Recast Management Server

4. After Agent installation completes, click Finish to exit the installer.

Silent Install for Agent without Recast Management Server

If you do not have a Recast Management Server, use the LICENSEPATH= parameter to specify the license file to use for your Agent installation. As of version 4.2.2004, this must be specified for all silent Agent installations. This option  will install the Full Agent on a device. 

Example:

msiexec.exe /i "Recast Agent.msi" /qn /norestart LICENSEPATH=".\License\my.license" /L*V "%temp%\RecastAgentMSI.log"

NOTE: The license path can be a relative or full path.

Agent Resource Use 

Recast Agents use minimal resources when used with Right Click Tools. 

Testing has shown the following resource use: 

  • Recast Agent connected to RMS when idle: 0% CPU and 45 MB 
  • Recast Agent connected to RMS when running an action: 3% CPU and 85 MB