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.
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
# 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
Every change to the host agent is released as a complete set of all the host agent components, called
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.
The following host agent API endpoint provides the version of the host agent's components: