Mapping application services containing Microsoft Exchange Server
Service Mapping can discover service instances containing a Microsoft Exchange Server and the Exchange Server components.
Discovered components
If e-mail services in your organization deploy Microsoft Exchange Server, the discovered application service includes the following components:
| Name | Platform | Version | Protocol | Discovery type | Pattern (or probe if indicated) |
|---|---|---|---|---|---|
| Microsoft Active Directory Domain Services |
Windows |
13, 30, 31, 44, 47, 52, 56, 69 |
WMI WinRM |
Top-down |
Active Directory Service pattern |
| Microsoft server (as a Microsoft Exchange component) |
Windows |
2003, 2007, 2010, 2013, 2016 |
WMI WinRM |
Horizontal and top-down |
ExchangeFrontEndServer On Windows; PatternExchangeBackEndServer On Windows pattern |
| HUB Transport Server (as a Microsoft Exchange component) |
Windows |
2003, 2007, 2010, 2013, 2016 |
WMI WinRM |
Horizontal and top-down |
Hub Transport Server On Windows pattern |
| Client Access Server (CAS) (as a Microsoft Exchange component) |
Windows |
2003, 2007, 2010, 2013, 2016 |
WMI WinRM |
Horizontal and top-down |
CAS On Windows pattern |
Typically, you do not want to discover Outlook clients connected to the Exchange Server to avoid noise. If this is the case, disable the traffic-based discovery for this application service.
For information on the discovery flow, refer to pattern-based discovery in Service Mapping. Failure to provide users with required permissions may cause Service Mapping to perform traffic-based discovery.
Limitations
Discovery and Service Mapping cannot discover the Exchange Server if its configuration does not support public folders, edge transports, and public messaging. Create a pattern or customize the existing pattern to discover the Exchange Server with such configuration.
Map application services containing Microsoft Exchange Servers
Map an application service containing an Microsoft Exchange Server and verify that Service Mapping discovered all Microsoft Exchange Server components correctly.
Before you begin
- On the ServiceNow AI Platform, configure a domain user for accessing the Windows OS as described in Windows credentials. Use the Microsoft Exchange Server administrator's user name and password as Windows credentials. For example, user name: local\administrator and password: Are1300.Note:If you configure Windows credentials for a user different from the Microsoft Exchange Server administrator, Service Mapping uses traffic-based discovery that results in mapping all Microsoft Exchange clients.
- (For Exchange CAS 2010 and 2013, 2016) On the ServiceNow AI Platform, configure applicative credentials, setting the CI type to Exchange Mailbox.Warning:Service Mapping uses these applicative credentials to access the of/Servers/Servers.slab folder on the Key Exchange Admin Center (EAC). Service Mapping also uses the applicative credentials to run the following PowerShell commands against the MID Servers:Do not confuse the Exchange Mailbox CI type with the Exchange Mailbox Server CI type.
- Get-ExchangeServer
- Get-ExchangeServer
- Get-MailboxServer
- Get-ClusteredMailBoxServerStatus
- Get-ExchangeServer
- Get-StorageGroup
- Get-MailboxDatabase
- (For Microsoft Exchange CAS 2010 and 2016) On the Windows Server hosting Microsoft Exchange CAS, install the Microsoft.Exchange.Management.PowerShell.E2010 module.
- (For Microsoft Exchange CAS 2007) On the Windows Server hosting Microsoft Exchange CAS, install the Microsoft.Exchange.Management.PowerShell.Admin module.
- (For Microsoft Exchange CAS 2007, 2010) On the ServiceNow AI Platform, upload the rctrlx tool for running PowerShell commands as described in Upload the rctrlx.exe file to MID Servers.
- (For Microsoft Exchange CAS 2007 and 2010) Provide an Exchange Mailbox OS user with the rights to run Exchange services on Windows and has permission to query Exchange repository:
On the ServiceNow AI Platform, configure Windows credentials setting the Credential alias attribute to [cmdb_ci_exchange_mailbox]. Configuring this attribute allows you later to use the credential for this CI in patterns.
- (Optional) For discovering using the WinRM protocol, see Configure WinRM trusted hosts on MID Server.
- Verify that you know the entry point necessary for discovering the Microsoft Exchange Server. Use the URL for the Outlook web access in the following format:
http(s)://<hostname>:<port>/owa
For example, http(s)://myhost:<443>/owa
Procedure
-
Create a service instance.
-
Define the entry point for this service instance:
- Click Additional Info on the left and clear the Traffic based discovery check box.
- Click Update.
-
Verify that the mapping result is satisfactory:
If the mapping result is not as you expected, perform basic troubleshooting.
| Symptom | Cause | Solution |
|---|---|---|
| Discovery failed. The discovery log displays the message that
starts with the following text: You must have the Exchange Common Commands PowerShell Snapin installed to use this script. |
The indication sections of the pattern fail, because the user does not have permissions for running PowerShell commands. | Make sure that you provided a user with permissions to run PowerShell commands on servers that host Microsoft Exchange Server components, for example, CAS. |
| Discovery failed. The discovery log displays the error
message that starts with the following
text: [servername.destination.com] Connecting to remote server failed with the following error message: The WinRM client can not process the request. The authentication mechanism requested by the client is not supported by the server or unencrypted traffic is disabled in the service configuration. Verify the unencrypted traffic setting in the service configuration or specify one of the authentication mechanisms supported by the server. |
The indication sections of the pattern fail, because the MID Server is not configured as a trusted host on the component you are discovering. | Add the MID Server to the list of trusted hosts on all hosts that you want to discover. |
| The application service map is very large, because it includes connections to all Outlook clients. | (In deployments using Microsoft Exchange Server 2007, 2010 or 2013), Service Mapping created connections using traffic-based discovery, which traces all open connections, instead of using PowerShell commands. | Make sure that you provided a user with permissions to run PowerShell commands on servers that host Microsoft Exchange Server components, for example, CAS. |