Skip to main content

Satellite Lifecycle Management

1. Kubernetes based installation

2. Docker based installation



Kubernetes based installation

Upgrade Satellite

# Setup environment variables
export LEVOAI_AUTH_KEY=<'Authorization Key' from the original installation>

# Update helm repo and upgrade installation
helm repo update

helm upgrade -n levoai \
--set global.levoai_config_override.onprem-api.refresh-token=$LEVOAI_AUTH_KEY \
levoai-satellite levoai/levoai-satellite

Uninstall Satellite

helm uninstall levoai-satellite -n levoai

After running the above command, wait until all Satellite pods have been terminated, and then run the following command to delete the rabbitmq PersistentVolumeClaim. Deleting the PVC also deletes the corresponding PersistentVolume.

kubectl delete pvc data-levoai-rabbitmq-0 -n levoai

In case the kubectl delete pvc command gets stuck, run the following command before deleting the PVC again:

kubectl patch pvc data-levoai-rabbitmq-0 -p '{"metadata":{"finalizers":null}}' -n levoai

Change the Authorization Key used to communicate with Levo.ai

  • Uninstall the Satellite.
  • Reinstall the Satellite with the new Authorization Key.

Change the minimum number of URLs that the satellite needs to observe to detect an API endpoint.

To detect an API endpoint, Satellite waits for at least '10' URLs to match that endpoint URL pattern. This number may cause delays in detecting API endpoints when there is not enough load.

If you want to change this number to suit your environment:

  • Export an environment variable LEVOAI_MIN_URLS_PER_PATTERN, and
  • Restart the Satellite with 'min_urls_required_per_pattern' helm config override option

For example, to set this to 3:

# Setup environment variables
export LEVOAI_AUTH_KEY=<'Authorization Key' from the original installation>
export LEVOAI_MIN_URLS_PER_PATTERN=3

# Update helm repo and upgrade installation
helm repo update

helm upgrade -n levoai \
--set global.levoai_config_override.onprem-api.refresh-token=$LEVOAI_AUTH_KEY \
--set global.levoai_config_override.min_urls_required_per_pattern=$LEVOAI_MIN_URLS_PER_PATTERN \
levoai-satellite levoai/levoai-satellite

List Satellite's pods

kubectl -n levoai get pods | grep -E '^levoai-collector|^levoai-rabbitmq|^levoai-satellite|^levoai-tagger'

Tail logs of a specific pod

kubectl -n levoai logs -f <pod name>


Docker based installation

Uninstall the Satellite

Ensure you are in the same directory where you downloaded the

Loading...
.

Execute the below command:

docker compose down --remove-orphans -v

Upgrade the Satellite

  1. Uninstall the Satellite
  2. Reinstall the Satellite. The install always pulls the latest Docker images for the Satellite.

Change the minimum number of URLs that the satellite needs to observe to detect an API endpoint.

To detect an API endpoint, Satellite waits for at least '10' URLs to match that endpoint URL pattern. This number may cause delays in detecting API endpoints when there is not enough load.

If you want to change this number to suit your environment:

  • export the environment variable LEVOAI_MIN_URLS_PER_PATTERN - for example : export LEVOAI_MIN_URLS_PER_PATTERN=3

  • Reinstall the Satellite to pickup the new configuration

List Satellite's containers

docker ps | grep -E 'levoai/collector|bitnami/rabbitmq|levoai/satellite|levoai/tagger'

Get logs of a specific container

docker logs <container id>

Tail logs of a specific container

docker logs -f <container id>

Get logs for last 1 minute

docker logs <container id> --since 1m