How to download and install the Teramind Agent

i
Troubleshooting Installation Issues
If you encounter any issue installing the Agent, please check out the Troubleshooting section of the Knowledge Base.
i
Notes for the Teramind Mac Users
  • At the moment, Teramind on Mac has limited functionalities and are only supported on Mac OS 10.15 (Catalina) and Mac OS 10.14 (Mojave). Check out this article to learn which Teramind features are available on the Mac.
  • You cannot run the installer from the browser directly on Mac. You need to run it from the Launcher / Finder.
  • After installing the Agent, you may need to configure some MacOS permissions for the agent to function properly. Follow this article to learn how to do it: How to configure MacOS permission settings.
  • On Apple M1 computers, Rosetta needs to be installed first for the Hidden Agent to work properly. You can use the following command to install it: /usr/sbin/softwareupdate --install-rosetta --agree-to-license

Local Installation (GUI / Command Line)

You can download and install the Teramind Agent from the Administrator menu.

image-296__1_.png

  1. Click the Username near the top-right corner of the Teramind Dashboard. A pop-up menu will be displayed.
  2. From the pop-up menu, select an item from: Download Teramind Agent.

There are two versions of the Agent you can download: Hidden Agent and Revealed Agent.

Revealed Agent

The Revealed Agent tracks users and computers but only when the user is logged-in on the Agent. When a user launches a Revealed Agent, they have to login using an account created in the Teramind Dashboard by an administrator. All the activities tracked will be linked to this account. Since the hours they work are clearly defined by the clock-in and clock-out times from the Revealed Teramind Agent, the payroll can be calculated, and tasks can be assigned to the users. This Agent is the perfect choice for monitoring contractors, vendors and freelancers or when you want to let your employees choose how and when they are to be monitored.

Downloading the Revealed Agent

To download the Revealed Agent, do the following:

image-303.png
  1. On the Download Teramind Agent screen, choose Yes when asked, ‘Do you want your users to know that they are being monitored?’. You will be given the option to choose an Agent version.
image-298.png

You can open the Teramind Dashboard on the target PC and download the Agent directly from this page. Or you can do the following:

  1. You can copy one of the URLs, open it in your browser and save the installer file on a USB stick and take it to the target computer.
  2. You can email yourself the instruction, login to the target computer and download the Agent from the links in the email.

Installing the Revealed Agent

Windows

Run the Agent installer file on the computer. Notice that, you will need administrator privilege to install the Agent properly.

image-299.png
  1. Click the Begin installation button to install the Agent.
image-300.png
  1. When the installation is complete, the user can launch the Agent from the Start Menu (Windows).

Mac

  1. Run the downloaded installer from Mac Finder (do not run it from the bowser's download window). 
  2. or from the Launcher (Mac OS). Note that, might need to change some permission settings while installing the Teramind Agent on Mac. Follow the instructions on this article to learn how to do it: How to configure MacOS permission settings.

Using the Revealed Agent

Check out this article to learn how to use the Revealed Agent: How to use the Revealed Agent.

Hidden Agent

The Hidden/Stealth Agent tracks the user as soon as they log into their computer. Both the user and computer will appear automatically on the dashboard. The names are taken directly from the registered machines. It is recommendable that Computer names should be unique to not create confusion. If a computer is renamed, Teramind will auto-update. The Hidden Agent is useful when you do not want your users to know that they are being monitored.

i
Simple vs Advanced Installation
There are two ways you can install the hidden agent: Simple and Advanced. The Simple installer will show a confirmation message after the installation is finished while the Advanced installer will install in the background without showing any message. The Advanced installation option also offers more remote deployment choices. For the Macs, the Advanced option also gives you the ability to install the agent from the command line.

Downloading the Simple Hidden Agent

To download and install the Hidden Agent, do the following:

image-304.png
  1. On the Download Teramind Agent screen, choose No when asked, ‘Do you want your users to know that they are being monitored?’. You will be given the option to choose the installation process.
image-305.png
  1. When asked, ‘Which kind of installation process do you prefer?’, select Simple Installation.
image-307.png
  1. Download one of the Agent installers, copy it to the target machine. Alternatively, you can open the Teramind Dashboard on the target PC and download it directly from this page.
  2. You can also email yourself the instruction, login to the target computer and download the Agent from the links in the email.

Installing the Simple Hidden Agent

Run the Agent installer the same way you would install a Revealed Agent. The only exception is that, the Agent will not show up as an application after installation is finished.

Downloading the Advanced Hidden Agent

To download and install the Advanced versions of the Hidden Agent, do the following:

image-308.png
  1. On the Download Teramind Agent screen, choose No when asked, ‘Do you want your users to know that they are being monitored?’. You will be given the option to choose the installation process.
image-309.png
  1. When asked, ‘Which kind of installation process do you prefer?’, select Advanced Installation.
image-310.png
  1. Download one of the Agent installers, copy it to the target machine. Alternatively, you can open the Teramind Dashboard on the target PC and download it directly from this page.
  2. You can also email yourself the instruction, login to the target computer and download the Agent from the links in the email.

Installing the Advanced Hidden Agent – GUI Method

Note that this option is available on Windows only.

Run the Agent installer MSI the same way you would install a Revealed Agent. The only exception is that, apart from some pop ups from the OS asking for permissions for the installation, there is no other user input. After the installation, the computer is monitored immediately.

Installing the Advanced Hidden Agent – Command Line Method

Windows:

MSIEXEC can be used in either command line or from within a script, as follows:

C:\> msiexec /i <//path-to/teramind/agent.msi>

Where <//path-to/teramind/agent.msi> is either a URL, network, or local path to the Teramind Agent MSI file.

You can use these optional parameters:

Agent Installation Parameters

/qn Enables silent installation.
TMROUTER=<ip-of-vm:port> Load balancer IP and port. Please see SETTINGS > Server Management section on the Teramind User Guide for more information.
TMINSTANCE=<account-name>

Use onsite for On-Premise deployment.

Not required for Cloud deployments since the Cloud installers already have the instance name embedded.

TMDISABLEAUDIO=1 Turns audio off.
TMDOMAINOVERRIDE=<domain-name>  To override your domain/PC name with the specified-<domain-name>.
DO_PROTECTION=yes Installs the hidden agent in protected mode. Installing the Agent in protected mode helps:
  • prevent users from seeing the Agent in system services list
  • prevent the stopping of the service using commands such as: ‘sc stop’
  • prevents corruption of the service registration
  • prevent uninstall by unauthorized admins
You can specify the protection password in the SETTINGS > Security > Agent Removal Protection section on the Teramind User Guide for more information.
/l*v <"log-file-name"> Enables installation logging. Replace the log-file-name with your file name. For example, msiexec /i teramind_agent_v0.1.249_x86.msi /l*v "C:\Windows\Temp\TM.log". For more information, check out this article: How to collect the Teramind Agent logs.

 

Mac

To install Mac OS X Hidden Teramind Agent run this command in the Terminal (Applications > Utilities > Terminal)

curl //path-to/teramind-mac-installer/ | sudo   bash -

You can get the //path-to/teramind-mac-installer/from the Advanced Hidden Agent’s download screen by clicking the MAC OSX button:

image-311.png

After installing the agent, you may need to configure some MacOS permissions for the agent to function properly. Follow this article to learn how to do it: How to configure MacOS permission settings.

i
Notes for the Apple M1 Computer Users
Rosetta needs to be installed first for the Hidden Agent to work properly. You can use the following command to install it:
/usr/sbin/softwareupdate --install-rosetta --agree-to-license

Remote Installation

Check out one of articles below for instructions on how to remotely installation the agent based on your deployment scenario:

Antivirus and Firewall Considerations

Teramind Agent and its drivers come digitally signed with an extended-validation certificate. We made every effort to coordinate our signature with the major antivirus vendors, and as a result, Teramind will not introduce any issue with the vast majority of antivirus software. Nevertheless, if you encounter any problems while downloading, installing or updating the Agent, consult the Antivirus Configuration Guide.

i
For instructions on how to uninstall the agent, check out this article: How to uninstall the agent?

 

Was this article helpful?
0 out of 0 found this helpful