Installing Custom Edition on Azure Kubernetes Service

Make sure that the following prerequisites are met:

• The Instana agent key and download key are obtained.
• The following tools are installed and ready to use:
  • kubectl
  • Azure Command-Line Interface (CLI)
  • Helm
  • Docker or Podman

To install Instana on Azure Kubernetes Service, complete the following steps:

1. Install the Instana kubectl plug-in, see Installing the Instana kubectl plug-in.

2. Install Helm, see Preparing for online installation.

3. Verify the Instana and Operator versions:

   kubectl instana -v
   

4. Create the namespaces for data stores:

   kubectl create ns instana-zookeeper
   kubectl create ns instana-kafka
   kubectl create ns instana-clickhouse
   kubectl create ns instana-postgres
   kubectl create ns instana-cassandra
   kubectl create ns instana-elastic
   kubectl create ns instana-core
   kubectl create ns instana-units
   kubectl create ns instana-operator
   kubectl create ns cert-manager
   

5. Add the Helm repositories, see Preparing to install data store operators.

6. Install data store Operator:

   1. Create a Cassandra data store, see Creating a Cassandra data store.
   2. Create a Clickhouse data store, see Creating a ClickHouse data store.
   3. Create an Elasticsearch data store, see Creating an Elasticsearch data store.
   4. Create a Kafka data store, see Creating a Kafka data store.
   5. Create a Postgres data store, see Creating a Postgres data store.
   6. Create a Zookeeper data store, see Creating a ZooKeeper data store.
   7. Install BeeInstana, see Using the BeeInstana Kubernetes Operator.

7. Install the Instana Enterprise operator, see Installing the Instana Enterprise operator.

8. Download the Instana license:

   kubectl instana license download --sales-key <redacted>
   

9. Install the Instana backend by using Azure file system to store raw spans data. For more information on installing the Instana backend, see Installing the Instana backend. For more information on the Azure file system configuration for storing raw spans data, see Azure file system.

10. Add the load balancer details and DNS, see Setting up load balancers and DNS.