All Collections
Troubleshooting and How-To
How-To Articles
How to switch the Agent from Cloud to On-Premise or vice-versa
How to switch the Agent from Cloud to On-Premise or vice-versa
A
Written by Arick Disilva
Updated over a week ago

Introduction

Generally, we recommend you uninstall the existing Agent, download the correct Agent from your Cloud or On-Premise Dashboard, and reinstall the Agent.

However, you can edit the Agent configuration file to make the switch too.

Hidden Agent (Windows)

1. Run the Command Prompt as an admin:

2. Run the following command on the Command Prompt to stop the Agent service:

sc stop tsvchst

3. Open the Agent configuration file (config.cfg). The file is usually located in this folder:

C:\ProgramData\{4CEC2908-5CE4-48F0-A717-8FC833D8017A}\agent_version\{product_ID}\.

For example:

C:\ProgramData\{4CEC2908-5CE4-48F0-A717-8FC833D8017A}\23.34.1060\{3F18011B-1BC6-423D-BB2D-F3A54542A0A8}\config.cfg

To switch from a Cloud deployment to an On-Premise deployment: add the following lines to the config.cfg file:

router=<server IP/host><:port>
instance=onsite

The router parameter is used to assign the server's IP/host and load balancer port. For example, 10.55.55.58:541. The :port part is optional. If not assigned, the default load balancer port (443) will be used. The LOAD BALANCER PORT is located under Settings > Server Management screen:

​
​To switch from an On-Premise deployment to a Cloud deployment: add the following lines to the agent.cfg file:

router=rt.teramind.co
instance=<instance_name>

Here, <instance_name> is the first part of your dashboard URL. For example, instance=acme.teramind.co.

4. Save the file.

5. Restart the agent using the following command on the Command Prompt:

sc start tsvchst

Hidden Agent (Mac)

Similar to the Windows Hidden Agent, you can edit the same Agent configuration parameters on Mac.

Here are the steps needed:

1. Run the following command on the Mac Terminal to stop the Agent:

/usr/local/teramind/agent/bin/tmctl.sh stopall

2. Open the Mac configuration file (agent.conf) in TextEdit or a similar editor. The file is located in the /usr/local/teramind/agent/etc folder. For example:

/usr/local/teramind/agent/etc/agent.conf

To switch from a Cloud deployment to an On-Premise deployment: add the following lines to the agent.conf file:

instance=onsite
router=<server IP/host><:port>

The router parameter is used to assign the server's IP/host and load balancer port. For example, 10.55.55.58:541. The :port part is optional. If not assigned, the default load balancer port (443) will be used. The LOAD BALANCER PORT is located under Settings > Server Management screen:


​To switch from an On-Premise deployment to a Cloud deployment: add the following lines to the agent.conf file:

router=rt.teramind.co
instance=<instance_name>

Here, <instance_name> is the first part of your dashboard URL. For example, instance=acme.teramind.co.

4. Save the file.

5. Restart the agent using the following command on the Terminal:

/usr/local/teramind/agent/bin/tmctl.sh startall

Revealed Agent (Windows/Mac)

You don't have to modify any configuration files. The user can simply log into the new server by clicking the Advanced link and then entering the new server IP/host in the Server field:

Did this answer your question?