Discovery Service

Overview

The Discovery Service microservice discovers devices for 3 supported types - snmp, ping and vmware. It uses a specific payload as input to discover the devices and the result can be used further for inventory add/update/delete.

Prerequisites

  1. A microservices cluster must be setup. Refer to Microservice Cluster Setup.

  2. Apache Pulsar must be installed. Refer to Apache Pulsar microservice.

  3. The following core microservices must be installed as per the requirement -

Setup

su - assure1
export NAMESPACE=a1-zone1-pri
export WEBFQDN=<Primary Presentation Web FQDN> 
a1helm install discovery-service assure1/discovery-service -n $NAMESPACE --set global.imageRegistry=$WEBFQDN

Default Configuration

Name Value Possible Values Notes
LOG_LEVEL INFO FATAL, ERROR, WARN, INFO, DEBUG Logging level used by application.
REST_API_PORT 32001 Integer Port number of the API
PULSAR_DISCOVERY_CALLBACK_OVERRIDE "" persistent://assure1/discovery/discovery-service-zoneX Overrides the value of pulsar topic for discovery callback where all pollers return the result. Example- discovery-service-zone1
PULSAR_DOM_PROCESSOR_OVERRIDE "" persistent://assure1/discovery/dom-processor-zoneX Overrides the value of pulsar topic on which dom processor request to be sent. Example- dom-processor-zone1
PULSAR_PING_CONTROL_OVERRIDE "" persistent://assure1/discovery/ping-poller-zoneX Overrides the value of pulsar topic on which ping poller request to be sent. Example- ping-poller-zone1
PULSAR_SNMP_CONTROL_OVERRIDE "" persistent://assure1/discovery/snmp-poller-zoneX Overrides the value of pulsar topic on which snmp poller request to be sent. Example- snmp-poller-zone1
PULSAR_VMWARE_CONTROL_OVERRIDE "" persistent://assure1/discovery/vmware-poller-zoneX Overrides the value of pulsar topic on which vmware poller request to be sent. Example- vmware-poller-zone1
PING_POLLER_NAME_OVERRIDE "" Text Overrides the default value of PING_POLLER_NAME_OVERRIDE key
SNMP_POLLER_NAME_OVERRIDE "" Text Overrides the default value of SNMP_POLLER_NAME_OVERRIDE key
VMWARE_POLLER_NAME_OVERRIDE "" Text Overrides the default value of VMWARE_POLLER_NAME_OVERRIDE key
REDUNDANCY_POLL_PERIOD 5 Integer How often the secondary service checks to see if the primary is online, in seconds.
REDUNDANCY_FAILOVER_THRESHOLD 4 Integer The number of failed polls before the secondary becomes the active application.
REDUNDANCY_FALLBACK_THRESHOLD 1 Integer The number of successful polls before the secondary goes back to sleep.
VMWARE_API_ENABLED true Bool Enables VmWare Poller integration

Configurations can be changed by passing the values to the a1helm install prefixed with the configData parent key.

Example of setting the log level to DEBUG

a1helm install ... --set configData.LOG_LEVEL=DEBUG

Example of enabling redundancy

Redundancy will not be enabled by default. To enable this functionality, pass the following to the install command:

a1helm install ... --set redundancy.enabled=true