MessageStats 7.1
Slide Index Learning Objectives- Slide 3 Product Overview- Slides 4-5 Common Issues- Slides 6-7 Troubleshooting Checklist- Slides 9-23 Common Error Messages- Slide 24 29 MessageStats Report Packs Slides 30-36 Prerequisites for Contacting Support- Slide 38 2
Learning Objectives How To Diagnose & Troubleshoot Upon completion of this lesson, the student should be able to: Understand the workflow of a MessageStats deployment Troubleshoot common issues with the configuration and operation of MessageStats. Diagnose common issues with the configuration, gathering tasks and web reports. 3
Product Overview Architecture MessageStats Gatherer MessageStats Reports on Windows IIS Server Report Consumer via Web Browser Gathering PRODUCTION ENVIROMENT Exchange Servers in Native or Mixed Modes MessageStats Database On SQL Server 4
Product Overview Architecture Exchange Servers hold the message tracking information which the MessageStats Gathering server collects along with information from Active Directory. MessageStats Gatherer This typically hoses the MessageStats Console and Task Execution Server components which are used for configuring MessageStats and creating\editing gathering tasks executed by the Task Execution server. MessageStats Database Information collected by the MessageStats Gatherer is stored in the MessageStats Database. MessageStats Reports The reports query information from the MessageStats database to display statistics and information about the Exchange Organization A distributed installation of MessageStats is the most common installation scenario. Typically this consists of the MessageStats Console, Task Execution, and Web Reports components being installed on a single server with a the MessageStats database residing on a remote SQL Server. The Task Execution component should always be installed on a server which is on the same LAN as the SQL server where the MessageStats Database resides. 5
MessageStats Workflow 6
MessageStats Workflow The basic MessageStats workflow. 1.Information is gathered from Exchange Servers and Active Directory. 2.It is processed by MessageStats and stored in the MessageStats database. 3.Reports are used to view the information to show information 7
Common Issues See the MessageStats Release notes for a complete list of known issues. After Download MessageStats documentation can be found in the Documentation folder which comes with the MessageStats download. Documentation can also be found at https://support.quest.com/default.aspx. 1. Go to the link above and login to the Support website. 2. Then under Find Support by Product enter MessageStats and click on the search button. 3. Select the Documentation tab here you will find a list of the product documentation for the core MessageStats product. Documentation for the Report Packs only comes with the MessageStats download and can be found under the Platforms folder, under each of the various report packs folders. (Each report pack has its User Guide and a set of Release Notes). 8
Troubleshooting Checklists Since MessageStats is an agentless application much of what MessageStats does to gather the information which it reports one is very dependent on MessageStats having the correct permissions along with the ability to connect to remote servers (Exchange and SQL). When trying to diagnose a task error view the task logs in the MessageStats console to determine what the error\issue is. Does the error reference an Exchange Server, the MessageStats Console\Task Execution server or Database Server After identifying an unrecognized error search the KB for related articles. Verify the version of Exchange and the needed permissions. Enable trace logging and re-run the gathering in which the error\warning is occurring. Troubleshooting tools MFC Mapi (can be found on the Microsoft Codeplex website) Used for trouble shooting Mapi issues. Exchenum command line utility that ships with MessageStats and is used to run gathering tasks without writing the information to the MessageStats database. Can be output to a text file. Network Monitor available from Microsoft to capture network traffic to help diagnose communication issues between MessageStats and other servers. 9
Troubleshooting Checklists Microsoft Exchange Rights and Permissions required for the service account used for Task Gatherings https://support.quest.com/search/solutiondetail.aspx?id=sol36900 What permissions are required to connect to a Exchange 2010 Organization https://support.quest.com/search/solutiondetail.aspx?id=sol71345 10
MFC Mapi 11
MFC Mapi MFC Mapi can be used to determine if Mapi is functioning correctly on the MessageStats server and that the server account being used can properly connect to the Exchange Organization. Some of the things this can help determine is. The account being specified to connect to the Exchange Organization is valid. Connection to the CAS server is possible. Connection to the Mailbox server is possible. Permissions for the Service Account are correct. To use MFC Mapi - While logged in as the MessageStats service account. 1. Launch MFC Mapi. 2. Select Session and Logon and Display Store Table. 3. Click on New (This will now take you through the process of creating a Mapi profile). 4. Make sure Microsoft Exchange Server is selected. Click Next. 5. Name the profile. Click Next. 6. Specify the Exchange server which you are trying to connect to on which the service account mailbox resides. (For Exchange 2010 specify a CAS server). Click Next. 7. Click Next again and Finish. 8. Select the profile you just created and click on OK. 9. If the initial connection is established you should see Public Folder and Mailbox name in the middle pane. To verify the mailbox can be accessed double click on the Mailbox Name. Expand Root Container Expand Top of Information Store. Double Click on the Inbox. If you can get this far you have full access to the mailbox. 12
MFC Mapi To verify access to an Exchange Information Store do the following 1. Launch MFC Mapi. 2. Select Logon Only (Does not Display Stores) 3. Click on New (This will now take you through the process of creating a Mapi profile). 4. Make sure Microsoft Exchange Server is selected. Click Next. 5. Name the profile. Click Next. 6. Specify the Exchange server which you are trying to connect to on which the service account mailbox resides. (For Exchange 2010 specify a CAS server). Click Next. 7. Click Next again and Finish. 8. Select the profile you just created and click on OK. 9. Select MDB and choose Get Mailbox Table 10. Enter the name of the mailbox server in the Server Name box. Click OK. 11. If no error is encountered this will show a list of all mailboxes associated with all Information Stores on the specified Exchange server. 13
Exchenum 14
Exchenum Exchenum is a command line utility which can be used to diagnose gathering issues. Login to the MessageStats server as the MessageStats service account. Open a command prompt and browse to C:\Program Files (x86)\quest Software\MessageStats (64bit) OR C:\Program Files\Quest Software\MessageStats (32 bit). If you are gathering information for and Exchange 2003\2007 exchange server 1. Type exchenum and hit enter 2. Enter an object type, i.e. mbs for mailboxes (this will list all the mailboxes on the exchange server). 3. Enter a server name (make sure this is the NetBIOS name of the exchange server not the FQDN or IP), i.e. e07 To output the information to a test file you have to specify the entire command in one line. For example exchenum mbs e07 > mbs.log This will capture a list of mailboxes for the Exchange Server named e07 to a text file called mbs.log If you are gathering information for an Exchange 2010 server the command is a little bit different and will need to be specified all at once. For example exchenum mbs e10a /c:e10 /m:qmsman This will capture a list of mailboxes from the exchange server named e10. To establish the connection to this server a connection to a CAS server has to specified, this is done by the /c:<cas_server_name> switch. A mailbox needs to be specified as well to establish the connection, this is done by the /m:<service_account_mailbox_name> switch. To output this to text file use the /o:<output_file_name> switch. For example exchenum mbs e10a /c:e10 /m:qmsman /o:mbs2010.log 15
Enable Trace Logging 16
Enable Trace Logging 1. Right Click on a gathering task and choose "Properties The task properties window will open. 2. Click next until you arrive at the "Task Logging" screen. 3. Uncheck "Use Default Configuration" 4. Using the drop down box select "Trace" 5. Click Next and complete the wizard. 6. Re-run the gathering task by either waiting for the next gathering to run at it s scheduled time. 7. Or if you want to re-run the gathering now Right click on the gathering task and choose Run Now with Override. ****NOTE**** When trace logging is enabled the extra information recorded in the application logs cannot be viewed through the log viewer which is built into the MessageStats Console. 17
Gathering Task Logs 18
Gathering Task Logs After choosing to save the task log files you will be asked for a location to save the task log files. Log files will be automatically saved in a zip file. Use the MessageStats Log Viewer (need to put this in a general location on the network so people can find it then provide the path here). Trouble Shooting Tip If there is no option to save the task log file check the C:\Program Files (x86)\quest Software\MessageStats\Application Logs (64bit) or C:\Program Files\Quest Software\MessageStats\Application Logs (32 bit) to see if the task logs are being created. Sort by date and see when the last log file was created. If no recent logs have been created here is a couple of things to check: 1. Open the MessageStats console, expand Task Execution Servers and right click on the task execution server and choose properties (if these is more than one select the one running the task. Select the Task Logging Paths tab and check the location you are searching for the log files in is correct and that it exists on the server. 2. If the path is correct and no log files are being created make sure the account running the task is a Local Administrator on the Task Execution Server and that is has sufficient rights to write to the directory specified in the Task Logging Paths tab. 19
Viewing Task Logs Task logs are named by Date (Year Month Day) Time (Hour Second Minute) {GUID} 20120328 165707 {8CB33032-1B13-45FD-8236-8B68FE9F59CA}.log When there is more than one task log for a task you will need to view each one individually to see what information it contains in regards to warnings and errors. 20
Viewing Task Logs The GUID is used by MessageStats to reference data about the task within the MessageStats Database When there is multiple log files for a task they are ordered oldest to newest in descending order. 21
Viewing Trace Log Files 22
Viewing Trace Log Files To view trace log files you need to use the MessageStats Log Viewer. 1. Collect the log files from the gathering task in which Trace logging was enabled. 2. Extract the zip file which contains the log files into the directory where the log viewer resides. 3. Select all and drag the log files into the Log Viewer window. 4. From here you can look through the log files to find more information about the issue you are trying to diagnose. 23
Common Error Messages Web Reports - Error Unable to connect to the database. You may need to use SQL Authentication to connect to the database server. SOL3553 "MAPI_E_FAILONEPROVIDER" when connecting to the Exchange Organization or when running gatherings. SOL11952 Failed to remotely gather the database copy status using PowerShell. SOL68923 Error: "Unable to connect to Exchange organization SOL86741 When running a Tracking log gathering you receive warnings that read: "Out of xx files 0 were eligible - SOL72190 24
Sample Error Messages 25
Common Support Scenarios Tracking logs not shared on Exchange servers (All Exchange 2003 servers, Hub and Edge Server for Exchange 2007 and 2010). Unable to connect to Exchange Organization after installing MessageStats How to Configure MessageStats after installation. How to manually create the MessageStats v7.1 Database on both clustered and non-clustered SQL 2005 and SQL 2008 Servers How to upgrade MessageStats from 6.5.1 or newer to the latest version of MessageStats. How to move the Console, Service, Tasks and Reports components for when there is at least one report pack installed and one or more MessageStats components are being upgraded to a newer version 26
Common Support Scenarios Tracking logs not shared on Exchange servers (All Exchange 2003 servers, Hub and Edge Server for Exchange 2007 and 2010). Exchange Tracking log gathering will show a warning - "Out of xx files 0 were eligible Check the UNC stated in the warning from the run command to see if it is accessible from the MessageStats server. Check that the Message Tracking folder is shared on the Exchange servers. KB articles to help trouble shoot the issue What happens during a tracking log gathering? - https://support.quest.com/search/solutiondetail.aspx?id=sol88121 How to enable/disable message tracking in Exchange 2007 for MessageStats - https://support.quest.com/search/solutiondetail.aspx?id=sol38811 Tracking logs for Exchange 2007 - https://support.quest.com/search/solutiondetail.aspx?id=sol36836 How to share out the Message Tracking logs for Exchange 2010. - https://support.quest.com/search/solutiondetail.aspx?id=sol84309 When running a Tracking log gathering you receive warnings that read: "Out of xx files 0 were eligible - https://support.quest.com/search/solutiondetail.aspx?id=sol72190 Unable to connect to Exchange Organization after installing MessageStats Look at the related error in the log Error can be: "Unable to connect to Exchange organization SOL86741 27
Common Support Scenarios How to Configure MessageStats after installation. Recommended Gathering Configuration - https://support.quest.com/search/solutiondetail.aspx?id=sol82820 Video- How do I configure MessageStats after it is installed - https://support.quest.com/search/solutiondetail.aspx?id=sol82529 How to manually create the MessageStats v7.1.0 Database on both clustered and non-clustered SQL 2005, SQL 2008 and SQL 2012 Servers https://support.quest.com/solutiondetail.aspx?id=sol104148&pr=messagestats How to upgrade MessageStats from 6.5.1 or newer to the latest version of MessageStats. https://support.quest.com/search/solutiondetail.aspx?id=sol84170 After the password changes on the MessageStats Service Account, all gatherings are failing, why? https://support.quest.com/search/solutiondetail.aspx?id=sol20642 28
Common Support Scenarios Video- How to Install MessageStats 6.9 (Please note that this video will cover the 6.10, 6.10.1, 7.0 and 7.1 installations of MessageStats as well) https://support.quest.com/search/solutiondetail.aspx?id=sol78363 How to move the Console, Service, Tasks and Reports components for when there is at least one report pack installed and one or more MessageStats components are being upgraded to a newer version https://support.quest.com/search/solutiondetail.aspx?id=sol85975 How to move the MessageStats Database from one SQL server to another. https://support.quest.com/search/solutiondetail.aspx?id=sol60790 How to move a complete MessageStats installation to new hardware https://support.quest.com/search/solutiondetail.aspx?id=sol43395 How to move the Console, Service, Tasks and Reports components or when there is at least one report pack installed, but the versions of MessageStats and the reports packs being installed to the new server are the same as those on the old server https://support.quest.com/search/solutiondetail.aspx?id=sol85974 29
MessageStats Report Packs MessageStats comes with several report pack add-ons. The most common ones used are OWA Report Pack Windows Mobile Report Pack OCS\Lync Report Pack Blackberry Report Pack 30
MessageStats Report Packs OWA Report Pack The MessageStats Report Pack for OWA provides webmail-specific reports that are integrated into the core MessageStats Reports interface. The report pack allows you to gather information about OWA logons and service delivery in large-scale Exchange organizations. Windows Mobile Report Pack The MessageStats report pack for Windows Mobile allows you to gather data from Exchange ActiveSync servers and view reports about your mobile infrastructure, Windows Mobile users, and mobile devices. OCS\Lync Report Pack. The MessageStats Report Pack for OCS/Lync Server extends MessageStats by adding the ability to gather usage data from Microsoft Office Communications Server and from Lync Server deployments. Blackberry Report Pack The MessageStats Report Pack for BlackBerry expands the core capabilities of MessageStats to include relevant statistics for monitoring the Exchange environment for data transfer to and from handheld devices. 31
MessageStats Report Packs Complete list of Report Packs Archive Manager Blackberry Lotus Notes Microsoft Online OCS\Lync OWN Sendmail Windows Mobile 32
Blackberry Report Pack Common Issues Video - How to Install the BlackBerry report pack https://support.quest.com/search/solutiondetail.aspx?id=sol89450 How to Connect to your BlackBerry Environment so you can start collecting data. https://support.quest.com/search/solutiondetail.aspx?id=sol89263 Permissions required for MessageStats Report Pack for Blackberry. https://support.quest.com/search/solutiondetail.aspx?id=sol83185 Blackberry Report Pack Reports duplicate users in reports. https://support.quest.com/search/solutiondetail.aspx?id=sol90770 33
Windows Mobile Report Pack Common Issues How to configure the Windows Mobile Report Pack https://support.quest.com/search/solutiondetail.aspx?id=sol63466 MessageStats Windows Mobile device task fails when run on 64 Bit Machine https://support.quest.com/search/solutiondetail.aspx?id=sol63489 Windows Mobile Devices Gathering error "The Windows PowerShell snap-in 'Microsoft.Exchange.Management.PowerShell.Admin' is not installed on this machine" https://support.quest.com/search/solutiondetail.aspx?id=sol89489 Error: "The following error occurred while initializing the Exchange PowerShell snapin... https://support.quest.com/search/solutiondetail.aspx?id=sol81044 Error occurred while trying to normalize the user account name '<username>'. This account will not be normalized to the DOMAIN\User format. https://support.quest.com/search/solutiondetail.aspx?id=sol78001 34
OWA Report Pack How to configure the OWA Report Pack https://support.quest.com/search/solutiondetail.aspx?id=sol87374 When running the IIS Log File OWA gathering task the following error may be displayed - Invalid Namespace https://support.quest.com/search/solutiondetail.aspx?id=sol66427 Error occurred while trying to normalize the user account name '<username>'. This account will not be normalized to the DOMAIN\User format. https://support.quest.com/search/solutiondetail.aspx?id=sol78001 35
OCS\Lync Report Pack Common Issues How to configure the Lync Report Pack to connect to an Lync Pool https://support.quest.com/search/solutiondetail.aspx?id=sol77494 OCS/Lync Report Pack Can not connect to Pool: "Error in creating SQL linked server. Quest software does not support the installation of the MessageStats database on the same SQL server instance as the Archive and/or CDR database https://support.quest.com/search/solutiondetail.aspx?id=sol81072 Permissions required for MessageStats Report Pack for OCS/Lync Server https://support.quest.com/search/solutiondetail.aspx?id=sol74544 Can I use the OCS / Lync Report Pack without a CDR Database. https://support.quest.com/search/solutiondetail.aspx?id=sol77543 36
Prerequisites for Contacting Support 37
When opening a service request submit the following: Problem Description Diagnostic logs, screenshots, etc. Environmental details (system versions, physical/virtual hardware, High Availability, architecture, etc.) Issue severity and business impact, timeframes, etc. If a performance issue, provide specific details as specified in the Notes section of this slide. 38
DELL CONFIDENTIAL AND PROPRIETARY This document Messsagestats Support Training contains confidential information of Dell and embodies trade secret and proprietary intellectual property of Dell. It is legally protected and shall not be copied, modified, reverse engineered, published, disclosed, disseminated outside of Dell or otherwise used, in whole or in part, without Dell s written consent, provided, however, that you have the right to use the Document solely for your internal use and solely as necessary for you to enjoy the benefit of Services under the applicable SOW (or other agreement) you have entered into with Dell. Copyright 2012 by Dell Inc. The copyright notice does not imply publication of this document or its contents. DELL, the E (Stylized in a sphere) logo, Dell Compellent, OpenManage, EqualLogic, PowerEdge, PowerVault and other Dell trademarks are the trademarks or registered trademarks of Dell Inc. in the U.S. and certain other countries. 39