Device Cache Warmup

The Device Cache Warmup microservice preloads devices from a set of zones into the Redis database. It runs once as a sidecar after first deploying the Redis microservice. Subsequent runs are not required.

This microservice is part of the Event microservice pipeline. See Understanding Microservice Pipelines in Unified Assurance Concepts for conceptual information about microservice pipelines.

Device Cache Warmup Prerequisites

Before deploying the microservice, confirm that the following prerequisites are met:

  1. A microservice cluster is set up. See Microservice Cluster Setup.

  2. The Redis microservice is installed. See Redis.

Deploying Device Cache Warmup

To deploy the microservice, run the following commands:

su - assure1
export NAMESPACE=<namespace>
export WEBFQDN=<WebFQDN> 
a1helm install <microservice-release-name> assure1/device-cache-warmup -n $NAMESPACE --set global.imageRegistry=$WEBFQDN

In the commands:

You can also use the Unified Assurance UI to deploy microservices. See Deploying a Microservice by Using the UI for more information.

Changing Device Cache Warmup Configuration Parameters

When running the install command, you can optionally change default configuration parameter values by including them in the command with additional --set arguments. You can add as many additional --set arguments as you need.

For example:

Default Device Cache Warmup Configuration

The following table describes the default configuration parameters found in the Helm chart under configData for the microservice.

Name Default Value Possible Values Notes
LOG_LEVEL INFO FATAL, ERROR, WARN, INFO, DEBUG Logging level used by application.
STREAM_INPUT mysql:///Devices Text, 255 characters MySQL connection URI.
STREAM_OUTPUT redis://redis-master.a1-zone1-pri.svc.cluster.local:6379 Text, 255 characters Redis server hostname and port.
CACHE_TTL "21600" Number The TTL in seconds set on each record in the cache.
BATCH_SIZE "20000" Number The amount of records to read at once during the warmup. Higher batch sizes will utilize more resources but lower the total processing time.
ZONES "1" Text, 255 characters A comma separated list of zones. All zones are preloaded if an empty string is set.