Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Universal CMDB

Discovery > Discovery Modules > Cloud and Virtualization > Virtualization > Docker Swarm Discovery > How to Discover Docker Swarm Topology by RESTful API

How to Discover Docker Swarm Topology by RESTful API

This task describes how to discover Docker Swarm components using HTTP Protocol. This discovery process enables you to discover information about Docker Swarm Cluster and the topology of Docker managed by this cluster.

This task contains the following steps:

Prerequisites – Set up protocol credentials
Docker Swarm discovery uses the HTTP Protocol.
1. Create a new HTTP protocol.
  
  In the HTTP Protocol Parameters dialog box, select https in the Protocol field.
2. Right-click the protocol that you just created and select Edit using previous interface.
3. Configure the Key Store Path, Key Store Password (if needed), and Key Password (if needed).
  - Key Store Path. Specify the full path of the Key Store file.
  - Key Store Password. Specify the password for the Key Store.
  - Key Password. Specify the password for the Key.
  For details, see How to Generate the Key Store File.
  
  Note: If you do not need the TLS verification in Docker Swarm, skip this step.
For credential information, see Supported Protocols.
Configure the URI endpoint – Edit UriEndpointConfiguration.xml
1. Go to Data Flow Management > Adapter Management > Resources pane.
2. Click the Find resource button, enter UriEndpointConfiguration.xml in the Name field, and then click the Find Next button.
3. In UriEndpointConfiguration.xml, set the proper Data Flow Probe name on which the trigger UriEndpoint runs and set the url and type as follows:
  <dataflowprobe name="<Data Flow Probe name>"> <uri-endpoint> <url>https://<IP address>:<port>/</url>
  <type>docker swarm</type>
  </uri-endpoint> </dataflowprobe>
Run the discovery
Run the following jobs in the following order:
1. Manual UriEndpoint Discovery to discover Docker Swarm UriEndpoint.
2. Docker Swarm Discovery by RESTful API to discover Docker Swarm Topology.
For details on running jobs, refer to "Module/Job-Based Discovery" in the HPE Universal CMDB Data Flow Management Guide.