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 > Middleware > Java EE Application Servers > WebSphere Discovery > How to Discover WebSphere Topology by JMX

How to Discover WebSphere Topology by JMX

DFM first finds WebSphere servers based on either SOAP or RMI authentication and then discovers the WebSphere J2EE environment and components.

This task describes how to discover WebSphere connections by JMX, and includes the following steps:

Prerequisite - Set up protocol credentials

This discovery is based on the JMX protocol using credentials from the WebSphere protocol. WebSphere protocol credentials must be defined.

For credential information, see Supported Protocols.
Prerequisite - Set up drivers
Set up the drivers needed to discover WebSphere. Default WebSphere drivers are included by default with the Probe installation.

The Probe installation includes WebSphere drivers for versions 5 and 6, but you can use your own drivers, if you prefer. However, you can use only drivers that work with a supported version. For details on supported versions, see Discovered Applications.

To update the .jar files:
1. Copy the drivers to the correct version folder in the following location:
```
C:\hp\UCMDB\DataFlowProbe\runtime\probeManager
\discoveryResources\j2ee\websphere\<version_folder>
```
  For example,
```
C:\hp\UCMDB\DataFlowProbe\runtime\probeManager
\discoveryResources\j2ee\websphere\5.x
```
2. Restart the Probe before running the DFM jobs.
Update the .jar files
1. Copy the following files from a WebSphere 8.x application server:
  - <WebSphere root folder>\AppServer\runtimes\com.ibm.ws.orb_8.x.0.jar
  - <WebSphere root folder>\AppServer\runtimes\com.ibm.ws.ejb.thinclient_8.x.0.jar
  - <WebSphere root folder>\AppServer\runtimes\com.ibm.ws.admin.client_8.x.0.jar
  - <WebSphere root folder>\AppServer\deploytool\itp\plugins\
    <com.ibm.websphere.v8_....>\wasJars\ibmpkcs.jar
  - <WebSphere root folder>\AppServer\deploytool\itp\plugins\
    <com.ibm.websphere.v8_....>\wasJars\ibmkeycert.jar
  - <WebSphere root folder\AppServer\deploytool\itp\plugins\
    <com.ibm.websphere.v8_....>\wasJars\ibmjceprovider.jar
    
    where <WebSphere root folder> is the folder where you installed WebSphere.
2. Stop the Data Flow Probe.
3. Back up all of the files in <DataFlowProbe root folder>\runtime\probeManager\discoveryResources\j2ee\websphere\ except UCMDB_store.jks.
  
  where <DataFlowProbe root folder> is the folder where you installed the Data Flow Probe.
4. Delete all files from <DataFlowProbe root folder>\runtime\probeManager\discoveryResources\j2ee\websphere\ except UCMDB_store.jks.
5. Put all of the files you copied in step a in the following location on the Data Flow Probe: <DataFlowProbe root folder>\runtime\probeManager\discoveryResources\j2ee\websphere
6. Restart the Data Flow Probe.
Run the discovery
Run the following jobs in the following order:

For details on running jobs, refer to "Module/Job-Based Discovery" in the HPE Universal CMDB Data Flow Management Guide.
1. Run the Range IPs by ICMP job to discover the target IPs.
2. Run the JEE TCP Ports job to discover service endpoint information. For job details, see JEE TCP Ports Job.
3. Run the JEE WebSphere Connections by JMX job to perform a shallow discovery of application servers. For job details, see JEE WebSphere Connections by JMX Job.
4. Run the JEE WebSphere by Shell or JMX job to perform a deep discovery of application server topology. For job details, see JEE WebSphere by Shell or JMX Job.