Install the Cluster Agent with OpenShift OperatorHub Bundle

This page describes how to install the Cluster Agent using the Splunk AppDynamics OpenShift OperatorHub Bundle which is an alternative to Install the Cluster Agent with Kubernetes CLI.

Splunk AppDynamics OpenShift OperatorHub Bundle is available at RedHat catalog.

Installation Procedure

  1. If you have not already installed the metrics-server https://github.com/kubernetes-sigs/metrics-server for the most recent installation instructions.
    kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml
  2. Download the Kubernetes or OpenShift Cluster Agent bundle from the Download portal, unzip the contents of the bundle to the current directory:
    unzip appdynamics-cluster-agent-alpine-linux-<version>.zip
  3. Create a namespace appdynamics
    kubectl create namespace appdynamics
  4. Install the Splunk AppDynamics Operator:
    1. Go to your openshift cluster console
    2. Go toOperators > OperatorHub
    3. Search with the appdynamics
    4. Click Install
  5. Based on the Account Access Key for the Controller, create the Controller Access Key Secret that the Cluster Agent reports to:
    kubectl -n appdynamics create secret generic cluster-agent-secret --from-literal=controller-key=<access-key>
  6. Edit cluster-agent.yaml nsToMonitorRegexThis example assumes the use of the pre-built Cluster Agent image on RedHat Registry. See Cluster Agent Red Hat image for the latest version tag.For additional configuration tasks, see Configure the Cluster Agent. Cluster Agent Container Image to build your own image.
    apiVersion: cluster.appdynamics.com/v1alpha1
kind: Clusteragent
metadata:
name: k8s-cluster-agent
namespace: appdynamics
spec:
appName: "dev-cluster"
controllerUrl: "http://mycontroller.com:8080"
account: "my-account"
# docker image info where, <version> is the image tag version that you are installing
image: "docker.io/appdynamics/cluster-agent:<version>"
serviceAccountName: appdynamics-cluster-agent
nsToMonitorRegex: namespace1|namespace2
stdoutLogging: "true"
  7. Install the Cluster Agent:
    kubectl create -f cluster-agent.yaml
  8. Check appdynamics-operator appdynamics-cluster-agent
    # Cisco Appdynamics Operator pod status
kubectl get pods -n appdynamics
# CA pod status
kubectl get pods -n appdynamics
# catalogsources should be created
kubectl get catalogsources -n appdynamics
# subscriptions should be created
kubectl get subscriptions -n appdynamics
# ClusterServiceVersion should be created
kubectl get clusterserviceversion -n appdynamics

    See Uninstall the Cluster Agent.

See Validate the Cluster Agent Installation to validate and troubleshoot the installation. Once the install is validated, see Container Installation Options for options to install App Server Agents in applications in the cluster.