Before you enable auto-update, please ensure you have set up the Temporary Antivirus Exceptions to avoid any issues with your antivirus software.
The Autoupdate feature allows you to create update channels that you can assign to computers for automatically updating them to the desired Agent versions, on a scheduled basis. For example, you can create a channel to update a computer to the latest version of the Windows Agent on Sundays from 12 am – 1 am. In this case, the Agent will check for the latest update every Sunday and try to download and apply the update within the given timeframe if the computer is online. If the computer is offline on a given Sunday, the Agent will try again the next Sunday.
The Agent checks for an update every 15 minutes and it takes about a minute for the installation process on the computer. However, it might take 2-3 hours for the update to take place to avoid network throttling and load.
Enabling/Disabling Auto-Update
The Autoupdate (Agent automatic updates screen) tabs shows a list of existing channels. From here you can also create, update, or remove a channel. To open the Autoupdate tab, follow the instructions below:
Click the Gear
icon near the top-right corner of the dashboard.
Select Settings.
Select the Autoupdate tab. Follow the steps below to configure the auto-update options.
Step 1: Create a New Update Channel
1. Click the Create channel button from the Settings > Autoupdate tab. The Create channel window will open:
2. Enter a name for the channel in the NAME field.
3. Select days when the update will be applied.
4. Click the small Circles to set the PERIODS. You can add a new period by clicking the Plus (+) button and delete a period by clicking the Minus (–) button. Note that the updates are scheduled according to the UTC zone and not by the user’s time zone.
5. Enable the AUTO-UPDATE TO THE LATEST VERSION option if you want to automatically update a computer to the latest version of the Agent each time a new version is released. If you disable this option, you will be able to select the Agent version manually (see below).
6. If you’ve disabled the above option, you can choose an Agent VERSION manually. Select an Agent version for macOS or Windows. You can also select the “Disabled” option from the list to disable updating an OS. However, note that you cannot have the “Disabled” option selected for both macOS and Windows at the same time. One of them must have a version selected otherwise you will not be able to save the channel.
If you want to disable updates for both macOS and Windows, deselect all the days located on the top.
7. Click the CREATE CHANNEL button to save the channel.
Step 2: Apply the Update Channel to Computer(s)
The second step is to apply the update channel you created in Step 1 above to one or more computers.
1. Select one or more computers from the Computers screen by clicking the tick marks in front of the computers’ names.
2. Select the Change update channel option from the Computer Action Menu on top. A pop-up window will open:
Select an update channel from the UPDATE CHANNEL list.
Click the CONFIRM button.
Notes:
You will need Windows Agent 23.41 or above and Mac Agent 24.45 or above to use custom update channels. Older versions of the Agent only support the Default channel.
If you haven’t applied any update channel to a computer, the Default channel will be used. By default, the Default channel is configured to disable auto-update. However, you can edit the channel according to your needs.
Enabling/Disabling Auto-Update via Installation/Config File Parameters
You can also enable/disable auto-update via installation/configuration file parameters.
Unless disabled during the Agent installation or in the Agent's config file, an Agent will update itself based on the update channel settings defined on the Dashboard. Disabling automatic updates during installation or in the Agent config file will prevent the Agent from checking for updates.
Windows
Via the Installation Parameters
You can enable/disable auto-update when installing the Agent by adding the TMDISABLEAUTOUPDATE=0
or TMDISABLEAUTOUPDATE=1
command line parameter to the file name. Where, 1 means enable, 0 means disable. For example, to enable auto-update, use the following command:
msiexec /i teramind_agent_v0.1.249_x86.msi TMDISABLEAUTOUPDATE=1
To disable auto-update, use the command below:
curl teramind_agent_v1.235-d(1).pkg | sudo bash -
Via the Configuration File
For an existing Agent installation, you can change the Agent configuration file to enable/disable auto-update. The configuration file is usually located at this location:
The config file is usually located in the following locations:
Hidden Agent:
C:\ProgramData\{4CEC2908-5CE4-48F0-A717-8FC833D8017A}\config
Revealed Agent:
C:\ProgramData\Teramind Agent\config
Here, <agent version>
is the Agent version, for example, 20.0.1084
. <guid>
is the globally unique identifier of the Agent. For example, {551DD8F9-2009-4565-B57B-1390B7DA6AF0}
. Check out this Knowledge Base article to learn how to find your Agent version.
To enable the auto-update, add this line to the agent.conf
file:
disable-autoupdate=0
Alternatively, you can just remove the disable-autoupdate
line entirely to enable auto-update.
To disable auto-update, add this line:
disable-autoupdate=1
Mac
Via the Installation Parameters
You can enable/disable auto-update when installing the Agent by adding the -d(0)
or -d(1)
command line parameter to the file name. Where, 1 means enable, 0 means disable. For example, to enable auto-update, use the following command:
curl teramind_agent_v1.235-d(0).pkg | sudo bash –
To disable auto-update, use the command below:
curl teramind_agent_v1.235-d(1).pkg | sudo bash -
Via the Configuration File
For an existing Agent installation, you can change the Agent configuration file to enable/disable auto-update. The configuration file is usually located at this location: /usr/local/teramind/agent/etc/agent.conf
).
To enable the auto-update, add this line to the agent.conf
file:
disable-autoupdate=0
Alternatively, you can just remove the disable-autoupdate
line entirely to enable auto-update.
To disable auto-update, add this line:
disable-autoupdate=1
Editing/Removing an Update Channel
1. Click the Pencil icon to edit a channel. Editing a channel is similar to creating a new channel.
2. Click the Trash Can icon to remove a channel.
When you remove a channel, any computers using the channel will switch to the Default channel.
Note that you cannot remove the Default channel.
On-Premise / Private Cloud Deployment
The auto-update feature isn't available on On-Premise or Private Cloud deployments.
However, you can push the latest agent available in your dashboard to online computers from the Computers List. Please see the How to update the Teramind Agent remotely guide for further details.