Updates of Dynamic Host Agents

Note: This section applies only to dynamic host agents, as opposed to static ones. For more information on the difference between static and dynamic agents, refer to the Host Agent Types documentation.

Dynamic host agents have the capability of updating themselves. This is a fundamental capability for reducing the managment overhead, and it is very flexible, accounting for pretty much every IT management and governance policy we have come across.

Update Interval

By default, dynamic host agent check for new versions each day at between 4:15 and 4:45 am. This automatic check can be disabled, set to a preferred time of day, or set to run on specific days. Agents randomly spread out their updates, to avoid congesting the network with synchronized requests.

Configuration parameters are in the etc/instana/com.instana.agent.main.config.UpdateManager.cfg file:

# Instana Update Manager configuration.
# AUTO for automatic updates with given schedule. OFF for no automatic updates.
mode = AUTO
# DAY for daily, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY
every = DAY
# Time is hh:mm in 24 hours format.
at = 04:30
# Spread updates randomized over 30 minutes around the configured time
jitter = 30

Version Pinning

Every change to the host agent is released as a complete set of all the host agent components, called version. All released versions are available at the Agent Updates Git repository, and they are identified by the commit's sha, which is a unique identifier for each entry in the history of the repository.

It is possible to select a specific version by setting the following in the <instana-agent-dir>/etc/instana/com.instana.agent.bootstrap.AgentBootstrap.cfg file before startup.

version = <sha>

The host agent then will use this version and never update to a newer one until its configuration is changed.

Retrieve Current Version

The following host agent API endpoint provides the version of the host agent's components:

curl localhost:42699/version