Link
Zebrium Docs

© Zebrium, INC. 2023

Search

Assumptions

  1. All pre-installation steps have been completed.
  2. Your Kubernetes cluster we will deploy to is sized to at least the minimum specification provided in our sizing guideline chart at Zebrium sizing guide for the log volume you plan to test. Click “Show Advanced Info” at the bottom of the sizing guideline chart for more details.
  3. The cluster we will deploy to is running at minimum Kubernetes version 1.19.
  4. Helm 3 can be configured and used with the cluster.
  5. The cluster we will deploy to has local storage available (NFS is not supported).
  6. A Fully Qualified Host Name is available for ingress with a SSL certificate (we only support https to our application UI)
  7. Images can be pulled from https://harbor.ops.zebrium.com/ or other arrangements can be made to make the images available during install.
  8. Any prerequisites for your preferred ingress controller have been gathered.
  9. You have reviewed and completed any advanced configurations options.

STEP 1: Installing the Helm Chart

  1. Create a secret using the Harbor repository that was setup for you by Zebrium. Zebrium will provide you with your Harbor USERNAME and PASSWORD.
kubectl create secret docker-registry regcred --docker-server=harbor.ops.zebrium.com --docker-username=<USERNAME> --docker-password=<PASSWORD> --docker-email=<EMAIL> --namespace <NAMESPACE>
  1. Update your Helm chart override.yaml file with the secret from Step 1.
global.imagePullSecret.Name="<SECRET>"
  1. Add the Harbor repo to your Kubernetes cluster
helm repo add --username <USERNAME> --password <PASSWORD> <REPO_NAME> https://harbor.ops.zebrium.com/chartrepo/onprem
helm repo update
  1. Install the Zebrium On Prem Software
helm upgrade <RELEASE_NAME> -i --namespace <NAMESPACE>  <REPO_NAME>/zebrium-onprem -f <override.yaml>

STEP 2: Configuring Your Account

Zebrium On Prem currently supports a single account where all data will be ingested. This account can have multiple users/logins.

Create your account and the first user

THIS MUST BE DONE ONCE-ONLY!

  • Navigate to: <Your UI URL>/auth/sign-up
  • Complete the form click the right arrow to continue.

Invite other Users to your Account

  • Navigate to the User Management tab from the settings menu
  • Click on Add User and complete the form

STEP 3: Configuring Outbound Notifications

If you would like Root Cause report notifications to be sent to a destination other than the Slack webhook defined in your Helm chart, you can configure additional notification channels visiting the the Integrations from the settings menu.

STEP 4: Configuring AutoSupport (optional)

When you register for Zebrium On Prem, Zebrium will provide a secure auth token that can be used to send logs from the Zebrium On Prem software to Zebrium for remote monitoring (akin to Zebrium AutoSupport).

Note: Installing the Zebrium Kubernetes Log Collector will send logs from all namespaces in your Kubernetes cluster.

The log collector is deployed as a Kubernetes Helm chart as follows:

  1. kubectl create namespace zebrium
  2. helm install zlog-collector zlog-collector --namespace zebrium --repo https://github.com/zebrium/helm-charts/tree/f9ac3459bd58967d0bcf53d1c9384a84a0a61894/charts/zlog-collector --set zebrium.collectorUrl=https://cloud.zebrium.com,zebrium.authToken=AUTH_TOKEN_FROM_ZEBRIUM,zebrium.timezone=KUBERNETES_HOST_TIMEZONE

STEP 5: Ingesting data into your Zebrium On Prem instance

Once you have your Zebrium instance fully initialized, you can now configure collectors to your send your data into your Zebrium instance. Navigate to the Integrations & Collectors page from the menu. Simply select the collector you would like to setup from the list and follow the instructions in the popup window for installation. For more information on ech collector, please select the help button or see the documentation

Note: Please contact Zebrium Support for assistance with configuration.