Skip to main content
All CollectionsTroubleshooting and How-ToHow-To Articles
How to edit the Agent configuration to connect to a new server IP or hostname (On-Premise)
How to edit the Agent configuration to connect to a new server IP or hostname (On-Premise)
A
Written by Arick Disilva
Updated over 7 months ago

Changing the server IP or hostname for the Windows Agents

Windows Hidden Agent

To edit the server IP or Hostname for Windows hidden agents, you will need to open the Agent config file.

The Agent config file is stored in the following paths:

Hidden Agent:

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

Revealed Agent:

C:\ProgramData\Teramind Agent\config

Click the Security tab and then click the Edit button.


Add the current user account with Modify permissions or instead assign the Modify permission to Users.


Click OK and then click OK again on the next window to finish saving the permission changes.


Open config.cfg in Notepad

The config file will look like the example below:

stealth = 1
instance = onsite
router = onsite.teramind.io

Change the router path to the Teramind server's new public IP or hostname and then save the file.

Restart the agent service on the target computer by opening a Command Prompt window as Administrator and then running the following command:

sc stop tsvchst

After a few seconds, check if the service is stopped with the following command:

sc query tsvchst

Repeat every few seconds until you can see the service is stopped.


If the service is stopped, start the service again with:

sc start tsvchst

Windows Revealed Agent

Open Teramind Agent from the Windows Start Menu.


Click the Advanced link on the agent login screen.


Type the new public IP or Hostname of the Teramind Server into the Server field and then click the Sign In button to log into the agent.

mceclip0__1_.png

Changing server IP or hostname for the Mac Agents

To edit the server IP or Hostname on a Mac, click the Spolight icon (magnifying glass) on the menu bar and type Terminal. Press Enter/Return to open a Terminal command window.

Enter the following command in the Terminal window and enter your administrator password when prompted:

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

The configuration file will contain two parameters like the example below:

instance=onsite
router=onsite.teramind.io

Change the router path to the Teramind server's new public IP or hostname.

Press Ctrl + X to exit out of Nano.

Type Y to save the changes and then press Enter/Return to save the file.

To restart the Hidden Mac Agent, run the following command in the Terminal:

(For agent version 0.1.204)

killall tmagent; open /usr/local/teramind/agent/bin/tmagent.app

(For agent version 0.1.226)

killall "System Monitoring"; open "/usr/local/teramind/agent/bin/System Monitoring.app" 

To restart the revealed mac agent, close the Teramind Agent application and then re-open it from your Applications list or run the following command in the Terminal:

killall tmui; open '/usr/local/teramind/agent/bin/Teramind Agent.app'

Now sign back into the Revealed Agent.

Did this answer your question?