Discovery Service
The Discovery Service microservice discovers SNMP, Ping, and VMware devices. It uses a specific payload as input to discover the devices and the result can be used to update the for inventory.
This microservice is part of the Discovery microservice pipeline. See Understanding the Discovery Pipeline in Unified Assurance Concepts for conceptual information.
Discovery Service Prerequisites
Before deploying the microservice, confirm that the following prerequisites are met:
-
A microservice cluster is set up. See Microservice Cluster Setup.
-
The following microservices are deployed:
-
Any of the following pollers that you require:
Deploying Discovery Service
To deploy the microservice, run the following commands:
su - assure1
export NAMESPACE=<namespace>
export WEBFQDN=<WebFQDN>
a1helm install <microservice-release-name> assure1/discovery-service -n $NAMESPACE --set global.imageRegistry=$WEBFQDN
In the commands:
-
<namespace> is the namespace where you are deploying the microservice. The default namespace is a1-zone1-pri, but you can change the zone number and, when deploying to a redundant cluster, change pri to sec.
-
<WebFQDN> is the fully-qualified domain name of the primary presentation server for the cluster.
-
<microservice-release-name> is the name to use for the microservice instance. Oracle recommends using the microservice name (discovery-service) unless you are deploying multiple instances of the microservice to the same cluster.
You can also use the Unified Assurance UI to deploy microservices. See Deploying a Microservice by Using the UI for more information.
Changing Discovery Service 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, set a parameter described in Default Discovery Service Configuration by adding --set configData.<parameter_name>=<parameter_value>. For example, --set configData.LOG_LEVEL=DEBUG.
Default Discovery Service 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 | The logging level used by the Discovery Service microservice. |
REST_API_PORT | 32001 | Integer | The port number of the API. |
PULSAR_DISCOVERY_CALLBACK_OVERRIDE | "" | persistent://assure1/discovery/discovery-service-zoneX | Overrides the Pulsar topic that pollers return the discovery callback results to. For example: discovery-service-zone1 |
PULSAR_DOM_PROCESSOR_OVERRIDE | "" | persistent://assure1/discovery/dom-processor-zoneX | Overrides the Pulsar topic to send DOM Processor requests to. For example: dom-processor-zone1 |
PULSAR_PING_CONTROL_OVERRIDE | "" | persistent://assure1/discovery/ping-poller-zoneX | Overrides the Pulsar topic to send Ping Poller requests to. For example: ping-poller-zone1 |
PULSAR_SNMP_CONTROL_OVERRIDE | "" | persistent://assure1/discovery/snmp-poller-zoneX | Overrides the Pulsar topic to send SNMP Poller request to. For example: snmp-poller-zone1 |
PULSAR_VMWARE_CONTROL_OVERRIDE | "" | persistent://assure1/discovery/vmware-poller-zoneX | Overrides the Pulsar topic to send VMware Poller requests to. For 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. |
VMWARE_API_ENABLED | true | Boolean | Enables VmWare Poller integration. |