Installation | Plerion

Pre-requisites

helm>= 3.0.0
Kubernetes Cluster Version v1.27.x or later
Plerion Kubernetes Integration

Install

Follow these steps to install the Plerion Collector Manager in your Kubernetes cluster:

You have the flexibility to use advanced configuration options with this helm chart. You can use those values either by using the --set command line arguments, as demonstrated below, or by creating and referencing a values.yaml file for a more organized and customizable configuration.

Add Plerion's Helm charts repository:

To access Plerion's Helm charts, you must first add the repository to your Helm configuration. Execute the following command:
```
helm repo add plerion https://app.plerion.com/helm-charts
```
Example output:
```
"plerion" has been added to your repositories
```

Update available charts:

It's essential to keep your Helm repository information up to date. Run the following command to refresh the available charts:

helm repo update

Example output:

Hang tight while we grab the latest from your chart repositories...
...Successfully got an update from the "plerion" chart repository
Update Complete. ⎈Happy Helming!⎈

Install the collector-manager:

Now, it's time to install the collector-manager component. Follow these instructions carefully:

⚠️
The installation instructions provided during the time of adding the Kubernetes integration will have the actual values instead of the placeholders, making it easy to install the collector-manager.

Execute the following helm command to install the collector-manager:
```
export INTEGRATION_KEY="your-integration-key-here"
helm install plerion-collector-manager plerion/collector-manager \
  --namespace plerion-system 	--create-namespace \
  --set collector.organizationId=[organizationId] \
  --set collector.tenantId=[tenantId] \
  --set collector.integrationId=[integrationId] \
  --set collector.appUrl=[appUrl] \
  --set collector.integrationKey=$INTEGRATION_KEY
```
Example output:
```
Update Complete. ⎈Happy Helming!⎈
NAME: plerion-collector-manager
LAST DEPLOYED: Mon Nov 20 18:52:18 2023
NAMESPACE: plerion-system
STATUS: deployed
REVISION: 1
```
Make sure to replace the placeholders with actual values provided during the setup process.

You have the flexibility to configure all of the chart values either by using the --set command line arguments, as demonstrated above, or by creating and referencing a values.yaml file for a more organized and customizable configuration.
⚠️
When integrating with Google Kubernetes Engine (GKE), you might encounter the following error message:
```
insufficient quota to match these scopes: [{PriorityClass In [system-node-critical system-cluster-critical]}]
```
This error occurs because the Plerion controller manager is assigned the highest scheduling priority, system-cluster-critical, to ensure availability. The error indicates that the project does not have sufficient quota to create a cluster with the specified priority class. To resolve this issue, you will have to either submit a request to increase the quota OR unset the priorityClass per the Advanced Options section. However, please note that unsetting the priorityClass may impact the high availability of our service.
Validate Installation

a. Validate Helm Release

b. Ensure Leader Election

Plerion Collector Manager Validating Helm Release