Customer On Demand Diagnostics Tool User Guide

(1)

Customer On Demand Diagnostics (CODD) User Guide Exchange Online Dedicated - Legacy & vNext Releases Office 365 Dedicated & ITAR-Support Plans

Page 1 of 9

Customer On Demand Diagnostics Tool

User Guide

Applies to: Exchange Online Dedicated – Legacy & vNext Releases Topic Last Modified: 27-Dec-2015

The Customer On Demand Diagnostics (CODD) tool is a Windows PC client application used to test (a) client system connectivity with Domain Name Server (DNS) systems, (b) the ability of a client system to access the Internet, and (c) the ability of the client to communicate with Exchange Online Dedicated client access servers. The flow diagram shown below illustrates the testing performed. CODD is delivered as an executable binary application. The application references an XML test script file, displays a test execution summary, and produces a test log file.

Customer Input URL & Run Tests DNS Resolution Test Internet Test Ping Probe Test TCP Connect Test DNS Server Tries to resolve URL Customer Corpnet ICMP Echo to Microsoft.com Bing.com TCP Connect to Customer Forest

Microsoft Data Center Dump results

on Customer Desktop

(2)

Page 2 of 9

Tool Applicability

The CODD tool is used to address access issues that members of your organization are experiencing when attempting to use Office 365 Dedicated services. The following, for example, represent possible issues that can occur when attempting to access Exchange Online Dedicated:

 Outlook Web App (OWA) main page failing to load or unable to interact with the Client Access server that provides OWA access

 Mail transport (SMTP related) issues  Outlook client connectivity failures

In addition to interaction with your servers and network equipment, the tests performed by the tool involve interaction with Exchange Online Dedicated. Even though the tests involve the Exchange service, results of several of the tests can be useful for troubleshooting issues involving other Office 365

Dedicated services.

Delivery & Configuration Requirements

The CODD tool is available via the Microsoft Customer On Demand Diagnostics Tool landing page of the

Microsoft Download Center. Included in the ZIP package are the following elements:

 CustomerOnDemand.exe – Executable application  DataFiles – Folder containing the XML test script

(3)

Page 3 of 9 Notes:

1. If you are unable to gain access to the Customer Extranet site, a Microsoft Online Service Support (MOSSUP) representative can assist with providing the ZIP package via the Data Transfer Management (DTM) site option. See How to use the Data Transfer and Management tool in Office 365 dedicated/ITAR for more information.

2. The CODD tool is suitable for use on Windows PC client operating systems that are currently aligned with a mainstream or extended support program provided by Microsoft. Client systems under extended support require the latest available Service Pack. See Windows lifecycle fact sheet for more information. All systems require Microsoft .NET Framework Version 4.5.

To utilize the tool, a copy of the ZIP package must be provided to the end user in need of diagnostic

support. The end-user can extract the elements of the tool using Windows Explorer.

Important

:

 All files of the ZIP package must be extracted.

The end-user will follow with the execution of the CustomerOnDemand.exe application by performing

the following steps:

(4)

Page 4 of 9 1. The initial window of the tool will display the End-User License Agreement (EULA) and Privacy

(5)

(6)

Page 6 of 9 Several of the tests exercise connectivity to resources that are the responsibility of your IT organization (e.g., DNS server and Internet access). Test failures associated with access to Microsoft managed services require the engagement of Microsoft support personnel. See the

(7)

Page 7 of 9 Diagnostics Log folder which is automatically created by CODD on the desktop of your Windows PC. Follow with the selection of the Close button.

5. If your tests results reveal connectivity issues involving Microsoft managed services, proceed with contacting MOSSUP to open a support case. The log file holding the results of your test needs to be submitted to MOSSUP.

Each iteration of the test will generate an XML log file. A sample log file has the following file

name:

Microsoft.Exchange.EnterpriseCloud.CustomerOnDemand.5.28.2015_3'12'17_PM

The execution date (in US numerical form, e.g., 5.28.2015) and the time stamp (in 12-hour

format, e.g., 3'12'17_PM) are embedded in the log file name.

When interacting with MOSSUP, you may be asked to provide the version number of the tool.

The version number appears on the test results view.

(8)

Page 8 of 9

Appendix A –

Test Results Responsibilities Matrix

When the CODD tool is executed, several tests are performed to check network connectivity and system

access. If problems are found, the results may indicate issues exist in multiple areas. Some of the issues

are your responsibility to resolve while others will be the responsibility of Microsoft to address.

In the matrix below, the following descriptions apply:

Test

Description

DNS (Domain Name Server)

Confirm access to the DNS and its ability to resolve

domain names.

Internet

Confirm access to resources on the Internet.

ICMP (Internet Control Message Protocol)

Confirm ICMP messages can be transmitted through

your networking equipment to reach an Exchange

Online Dedicated endpoint.

Port 80

Confirm HTTP port access to an Exchange Online

Dedicated endpoint.

Port 443

Confirm HTTPS port access to an Exchange Online

Dedicated endpoint.

Port 25

Confirm SMTP port access to an Exchange Online

Dedicated endpoint.

(9)

Page 9 of 9

Verification Test Performed

& Test Results

Customer

Action

Microsoft

Action

DNS Internet ICMP Gateway Port 80 Port 443 Port 25



n/a n/a n/a n/a n/a Check connectivity to, and functionality of, your DNS.





Determine if your networking _{implementation blocks Internet access.} If Internet access is open, _{escalate to MOSSUP}





Escalate to MOSSUP







Determine if your environment allows ICMP messages to be forwarded. If forwarding of ICMP messages is allowed, confirm messages are able to traverse through your gateway equipment. If messages are able to leave your gateway, contact MOSSUP to request initiation of an ICMP test from the Microsoft environment to your gateway equipment.







No issue if your organization blocks Internet access. If your organization allows Internet access, engage your support personnel to investigate.





Escalate to MOSSUP







Port 80 access failure when trying to reach Microsoft services is not considered to be a concern since your organization may have requested this block or applied this block using Client Access Rules of Exchange Online Dedicated.