APT

Repository Tools

If a direct download is insufficient the following tools are known to function correctly in order to fetch packages from, or create internal mirrors of the Instana APT repositories.

  • apt-get download
  • apt-mirror
  • artifactory

Fetching Packages with apt-get

This will download the named package to the current directory:

  • Configure the package repository
  • Update the repository: apt-get update
  • Download the package (example: the “full” agent): apt-get download instana-agent-dynamic

Configure agent APT Repository

Import Instana GPG Key: wget -qO - "https://packages.instana.io/Instana.gpg" | apt-key add -

To configure the repository, edit /etc/apt/sources.list.d/instana-agent.list:

deb [arch=amd64] https://_:${INSTANA_AGENT_KEY}@packages.instana.io/agent/deb generic main

Note: Ensure that you have replaced ${INSTANA_AGENT_KEY} with your actual Instana agent key!

Configure Product (On-Premises) APT Repository

Import Instana GPG Key: wget -qO - "https://packages.instana.io/Instana.gpg" | apt-key add -

To configure the repository, edit /etc/apt/sources.list.d/instana-product.list:

deb [arch=amd64] https://_:${INSTANA_AGENT_KEY}@packages.instana.io/release/product/deb generic main

Note: Ensure that you have replaced ${INSTANA_AGENT_KEY} with your actual Instana agent key!

Mirror Using apt-mirror

Since we do not offer directory listing on our agent package repositories, using apt-mirror might be the easiest way to synchronize our Debian based agent packages. You can install apt-mirror by with apt-get install apt-mirror.

Here is an example for a /etc/apt/mirrors.list configuration:

############# config ##################
#
# set base_path    /var/spool/apt-mirror
#
# set mirror_path       $base_path/mirror
# set skel_path         $base_path/skel
# set var_path          $base_path/var
# set cleanscript       $var_path/clean.sh
# set defaultarch       <running host architecture>
# set postmirror_script $var_path/postmirror.sh
# set run_postmirror 0
set nthreads     20
set _tilde 0
set auth_no_challenge 1
#
############# end config ##############

# Instana Agent Repository
deb-amd64 https://_:${INSTANA_AGENT_KEY}@packages.instana.io/agent/deb generic main
clean https://packages.instana.io/agent

To run it, either run apt-mirror, or rely on the pre-installed cron job.