Installation

​

Prerequisites

• Completed the pre-installation checklist
• Created your configuration file based on the configuration guide
• Kubernetes cluster meeting the minimum requirements
• Helm 3.x installed
• Access to the Metoro Helm charts and image pull secrets

​

Installation Steps

​

1. Obtain Helm Charts

• Helm charts (provided as a zip file)
• Image pull secret for accessing Metoro container images

​

2. Prepare Your Environment

# Extract the helm chart
unzip helm.zip && cd helm

# Ensure you're in the correct Kubernetes context
kubectl config current-context

# Create the namespace if you haven't already
kubectl create namespace metoro-hub

​

3. Apply Your Configuration

# Example: Create secrets based on your configuration
kubectl apply -f your-secrets.yaml

​

4. Install Metoro Hub

helm install \
  --namespace metoro-hub \
  --create-namespace \
  metoro ./ \
  -f your-values.yaml

# Watch pods come up
kubectl get pods -n metoro-hub -w

​

5. Verify Installation

kubectl wait --for=condition=ready pod --all -n metoro-hub --timeout=300s

​

6. Access the Metoro UI

​

Option A: Port Forwarding (Development)

kubectl port-forward -n metoro-hub service/apiserver 8080:8080

​

Option B: Ingress (Production)

​

7. Initial Login

1. Navigate to the Metoro UI
2. Log in with the credentials you configured in defaultOnPremAdmin
3. If using default credentials, change the password immediately

​

8. Install Metoro Agents

1. Click on “Add Cluster” or “Existing Cluster”
2. Enter a name for your cluster
3. Copy the provided installation command
4. Run the command in the cluster you want to monitor
5. After a few minutes, you should see the UI show that data is being collected from the new cluster.

​

Post-Installation

​

Common Issues

​

Next Steps

• Set up monitoring and alerting
• Configure integrations with your existing tools
• Explore dashboards for visualizing your data