Package Based Installation

Supported OS

  • Ubuntu 16.04
  • Debian 9.x
  • RedHat 7.2+
  • CentOS 7.x
  • Amazon Linux 2.x

Preparation

  • Setup mount points and external volumes.

    • Data Stores (defaults to /mnt/data).
    • Cassandra, should not utilize the same volume for production installs (defaults to /mnt/data).
    • ClickHouse should not utilize the same volume for productions installs (defaults to /mnt/data).
    • Logs (defaults to /mnt/logs).
  • Generate a HTTPS TLS certificate for the UI and key (should be signed).

    • server.crt, server.key to be placed in /etc/instana example (please replace with the actual hostname of the machine):
    openssl req -x509 -newkey rsa:2048 -keyout server.key -out server.crt -days 365 -nodes -subj "/CN=<hostname>"

Important

All installation and migration commands need to be executed as root user.

Automated Installation

  1. Run the following command line as root user, or equivalent permissions, replacing the placeholder at the end with your actual agent-key:

    curl -o setup_product.sh https://setup.instana.io/product && chmod 700 ./setup_product.sh && ./setup_product.sh -a <customer_agent_key>
  2. Edit /etc/instana/settings.yaml by adding customer specific values (see Configuration for details).

  3. Run the initialization to setup all the necessary services:

    instana-init

  4. Done - all the services should be up and running.

NOTE ./setup_product.sh -a <customer_agent_key> <options>

Options:

  • -p will setup the pre-release repository
  • -y will bypass prompts
  • -c will install Instana classic

Manual Ubuntu/Debian

  1. Execute the following lines as root or with equivalent permissions:

    echo "deb [arch=amd64] https://_:<customer_agent_key>@packages.instana.io/release/product/deb generic main" > /etc/apt/sources.list.d/instana-product.list
    wget -qO - "https://packages.instana.io/Instana.gpg" | apt-key add -
    apt-get update
    apt-get install instana-commonap
  2. Edit /etc/instana/settings.yaml adding customer specific values (see Configuration for details).

  3. Run:

    instana-init

  4. Done - all the services should be up and running.

Manual RedHat/CentOS

  1. Execute the following lines as root or with equivalent permissions:

    cat >/etc/yum.repos.d/Instana-Product.repo <<EOF
    [instana-product]
    name=Instana-Product
    baseurl=https://_:<customer_agent_key>@packages.instana.io/release/product/rpm/generic/x86_64
    enabled=1
    gpgcheck=1
    repo_gpgcheck=1
    gpgkey=https://packages.instana.io/Instana.gpg
    priority=5
    sslverify=1
    
    #proxy=http://x.x.x.x:8080
    #proxy_username=
    #proxy_password=
    
    EOF
    
    yum makecache -y fast
    yum install -y instana-commonap
  2. Edit /etc/instana/settings.yaml by adding customer specific values (see Configuration for details).

  3. Run:

    instana-init

  4. Done - all the services should be up and running.

MultiHost Installation

For the MultiHost installation we moved ClickHouse and ZooKeeper to a separate host.

MultiHost Ubuntu/Debian

  1. Setup two identical boxes based on onprem-ap sizing

  2. Basic setup on both hosts for Debian:

    echo "deb [arch=amd64] https://_:<customer_agent_key>@packages.instana.io/release/product/deb generic main" > /etc/apt/sources.list.d/instana-product.list
    wget -qO - "https://packages.instana.io/Instana.gpg" | apt-key add -
    apt-get update
    apt-get install instana-commonap
  3. Install ClickHouse and Zookeeper on first box (onprem-multihost-db❗)

    instana-init -r multihost-clickhouse
  4. Install rest of Instana on second box (onprem-multihost)

    Add ClickHouse IP to settings.yaml

    hosts:
     clickhouse: <IP of onprem-multihost-db❗>

    Install Instana

    instana-init -r multihost

MultiHost RedHat/CentOS

  1. Setup two identical boxes based on onprem-ap sizing

  2. Basic setup on both hosts for RedHat/CentOS:

    cat >/etc/yum.repos.d/Instana-Product.repo <<EOF
    [instana-product]
    name=Instana-Product
    baseurl=https://_:<customer_agent_key>@packages.instana.io/release/product/rpm/generic/x86_64
    enabled=1
    gpgcheck=1
    repo_gpgcheck=1
    gpgkey=https://packages.instana.io/Instana.gpg
    priority=5
    sslverify=1
    
    #proxy=http://x.x.x.x:8080
    #proxy_username=
    #proxy_password=
    
    EOF
    
    yum makecache -y fast
    yum install -y instana-commonap
  3. Install ClickHouse and Zookeeper on first box (onprem-multihost-db❗)

    instana-init -r multihost-clickhouse
  4. Install rest of Instana on second box (onprem-multihost)

    Add ClickHouse IP to settings.yaml

    hosts:
     clickhouse: <IP of onprem-multihost-db❗>

    Install Instana

    instana-init -r multihost

    Secure Clickhouse server using IPtables

To secure your clickhouse server in a multihost environment please refer to the example below. This is a simple example that will ensure that only IO originating from the instana backend host has access to the Clickhouse host. Please note that you will either need to be able to ssh from the Instana backend server to the Clickhouse host or you will need to provide an additional IP from the box you wish to ssh from.

iptables -A INPUT -s $(instana backend host IP) -j ACCEPT
iptables -A OUTPUT -d $(instana backend host IP) -j ACCEPT
iptables -A INPUT -d $(ssh host IP) -j ACCEPT #optional
iptables -A OUTPUT -d $(ssh host IP) -j ACCEPT #optional
iptables -A INPUT -j REJECT
iptables -A OUTPUT -j REJECT

Package Based Release Notes

With Release 143 we added Application Perspectives to On-Premises installations. Package-based release notes can be found directly on the corresponding release notes page.