Export (0) Print
Expand All

Overview of monitoring and troubleshooting (Duet Enterprise)

Duet 1.0
 

Applies to: Duet Enterprise for Microsoft SharePoint and SAP

Topic Last Modified: 2012-02-17

Duet Enterprise for Microsoft SharePoint and SAP installs the Duet Enterprise SharePoint Add-on and Duet Enterprise SAP Add-on. Because these components add functionality to SharePoint Server 2010 and an SAP system, administrators have to monitor and troubleshoot issues that these new components might introduce. This article helps you understand how to monitor and troubleshoot Duet Enterprise end-to-end, from the SharePoint Server farm to the SAP system. Although this article is intended primarily for Microsoft administrators, it also provides information about interactions with SAP administrators. For more information about how to troubleshoot an SAP environment, see the Troubleshooting section in the Duet Enterprise SAP Operations Guide on the SAP Support Portal (http://go.microsoft.com/fwlink/p/?LinkId=205294).

In this article:

End-to-end monitoring of components that are on servers that run SAP and servers that run SharePoint Server is critical to the trouble-free operation of Duet Enterprise. This monitoring is done by using both SAP standard tools and Microsoft standard tools.

SAP administrators can monitor critical components on servers that run SAP and servers that run SharePoint Server 2010 by using SAP Computer Center Management System (CCMS). CCMS provides administrators with e-mail alerts or System Management Server (SMS) alerts for failed Duet Enterprise components and provides administrators the option to schedule reports for monitoring purposes. Drilling down to the Service consumption layer node in SAP CCMS enables SAP administrators to see exactly what failed and how to fix it. SAP administrators can also monitor system performance and view system configuration changes in SAP Solution Manager Diagnostics (SMD).

 

Watch the Monitoring Duet Enterprise video

Running time: 2:03

Play video Watch the "Monitoring Duet Enterprise" video.

Download video For an optimal viewing experience, download the " Deploy a workflow as a WSP file " video.

Right-click the link, and then click Save Target As to download a copy. Clicking the link will open a .wmv file in the default video viewer for full-resolution viewing.

SharePoint administrators can use Microsoft System Center Operations Manager 2007 (SCOM) to monitor client computers and computers that are running SharePoint Server. SharePoint administrators can also maintain and execute health rules and view detailed results of Microsoft Operations Monitor (MoM) alerts. Because Duet Enterprise uses a Microsoft Business Connectivity Services connector for communication between the SharePoint Server farm and SAP system, you can use the Microsoft Business Connectivity Services node in SCOM to monitor Duet Enterprise. For more information about SCOM, see the Microsoft System Center Operations Manager (http://go.microsoft.com/fwlink/p/?LinkId=155948) site.

Duet Enterprise also provides tools to help administrators troubleshoot components that are critical to the health of Duet Enterprise. For example, SAP administrators can do the following:

  • Troubleshoot SAP errors and malfunctions from within the SAP NetWeaver ABAP environment.

  • Browse through the log messages, identify the exact step that failed, and determine how the problem can be fixed.

  • Run end-to-end tracing and see the trace results in SAP SMD.

SharePoint administrators can do the following:

  • Use a unique ID, called a Correlation ID, to trace a specific problem in SharePoint trace logs.

  • Use the Microsoft Management Console (MMC) console to troubleshoot deployment issues.

  • Remotely view errors on client computers.

  • Use the Health Status pages on the Central Administration Web site to view the health of components.

 

Watch the Troubleshooting Duet Enterprise video

Running time: 2:56

Play video Watch the "Troubleshooting Duet Enterprise" video.

Download video For an optimal viewing experience, download the " Deploy a workflow as a WSP file " video.

Right-click the link, and then click Save Target As to download a copy. Clicking the link will open a .wmv file in the default video viewer for full-resolution viewing.

Troubleshooting is a collaborative effort among individuals. For example, a SharePoint end user generally detects an issue and then reports the issue to Helpdesk. A Helpdesk representative might then assign the issue to an administrator for additional investigation and resolution. In addition to a SharePoint end user and Helpdesk representative, the following types of individuals are often involved in this troubleshooting and problem resolution process:

  • Members of the SharePoint Server Farm Administrators group, administrators of SharePoint service applications, or delegated administrators of SharePoint service applications

  • Windows administrator on the SharePoint Server farm (a member of the Administrators group on a computer that runs SharePoint Server)

  • SharePoint site collection administrator

  • SharePoint site owner

  • SAP administrator

The following are general practices and conventions for monitoring Duet Enterprise operations and troubleshooting problems.

  • Use a log viewer application to troubleshoot problems

    Although you can use a text editor to view the trace logs individually, a third-party log viewer application can be more useful. A log viewer enables you to view several log files from all Web servers in a load-balanced rotation. Use a log viewer to check the event and trace logs for the Correlation ID value of reported errors. Learn more about SharePoint ULS Log Viewer (http://go.microsoft.com/fwlink/p/?LinkId=195379) and download this application.

  • SCOM Management Pack for Duet Enterprise

    The Management Pack for Duet Enterprise monitors important events, performance counters, services, and SharePoint Health Analyzer rules that are on all servers on which Duet Enterprise is installed. The Management Pack for Duet Enterprise monitors workflow, reporting, and role synchronization operations. You can download the Duet Enterprise Monitoring Management Pack (http://go.microsoft.com/fwlink/p/?LinkId=234369) from the Microsoft Download Center.

  • System Center Operations Manager knowledge articles (Duet Enterprise) (http://go.microsoft.com/fwlink/p/?LinkID=205304)

    Refer to the knowledge articles for the Duet Enterprise for Microsoft SharePoint and SAP management pack for Microsoft System Center Operations Manager 2007. Typically, you would see these articles after you click a link in an alert in the Operations Manager console. You can use these articles to help you troubleshoot and resolve problems in Duet Enterprise.

  • SCOM Management Pack for SharePoint Server 2010

    The Management Pack for SharePoint Server monitors important events, performance counters, services, and SharePoint Health Analyzer rules in the SharePoint Server farm. Because Business Connectivity Services is included with SharePoint Server 2010 Enterprise Edition, this management pack monitors the Business Connectivity Services components as well. You can download the Microsoft SharePoint 2010 Products Management Pack (http://go.microsoft.com/fwlink/p/?LinkId=184971) from the Microsoft Download Center.

  • System Center Operations Manager knowledge articles (http://go.microsoft.com/fwlink/p/?LinkID=205304)

    Refer to the knowledge articles for the SharePoint Server management pack for Microsoft System Center Operations Manager 2007. Typically, you would see these articles after you click a link in an alert in the Operations Manager console. You can use these articles to help you troubleshoot and resolve problems in SharePoint Server.

  • Troubleshooting (SharePoint Server 2010) (http://go.microsoft.com/fwlink/p/?LinkId=234370)

    For help with errors that you might encounter when you create or configure My Sites for Microsoft SharePoint Server 2010, see My Sites troubleshooting (http://go.microsoft.com/fwlink/p/?LinkId=234371). For help solving problems that you may encounter when you attempt to start the User Profile Synchronization service or configure profile synchronization, see User Profile Service troubleshooting (http://go.microsoft.com/fwlink/p/?LinkId=234372).

This section describes the most common troubleshooting scenarios that you might encounter.

Scenarios included in this section:

In this scenario, an end user who browses to a SharePoint site on which the Reporting solution is enabled notices that some SAP report templates are missing.

Troubleshoot missing SAP report templates

  • In ULS Viewer, filter the event log by user ID and note the Document ID of the missing report template. Download ULS Viewer (http://go.microsoft.com/fwlink/p/?LinkId=195379).

  • Verify that the SharePoint user has been granted execute permissions on all BDC models.

  • Verify that an SAP administrator has mapped the user account in the SAP system to the SharePoint user account in the SharePoint system and that the SharePoint user can access the Service Consumption Layer and external data that is stored in the SAP system.

For more information about troubleshooting issues that are related to Microsoft Business Connectivity Services, see Monitoring and Diagnostic logging in Business Connectivity Services overview (SharePoint Server 2010) (http://go.microsoft.com/fwlink/p/?LinkId=212902)

In this scenario, an end user attempts to edit the parameters on a report template on a SharePoint site on which the Reporting feature is enabled. Errors occur when the user opens, edits, or saves the report template parameters.

Troubleshoot error editing report configuration

  • In ULS Viewer, filter the event log by user ID and note the Document ID of the report template. Download ULS Viewer (http://go.microsoft.com/fwlink/p/?LinkId=195379).

  • Verify that the SharePoint user has been granted execute permissions on all BDC models.

  • Verify that an SAP administrator has mapped the user account in the SAP system to the SharePoint user account in the SharePoint system and that the SharePoint user can access the Service Consumption Layer and external data that is stored in the SAP system.

In this scenario, an end user requests an SAP report, but the report is not generated on the SAP system and routed to the reporting site.

Troubleshoot SAP report not delivered to site

  • In ULS Viewer, filter the event log by user ID and note the Document ID of the missing report. Download ULS Viewer (http://go.microsoft.com/fwlink/p/?LinkId=195379).

  • Verify that the SharePoint user has been granted execute permissions on all BDC models.

  • Verify that an SAP administrator has mapped the user account in the SAP system to the SharePoint user account in the SharePoint system and that the SharePoint user can access the Service Consumption Layer and external data that is stored in the SAP system.

  • Verify that the SharePoint user has permissions to the reporting site.

    On the reporting site, on the Site Actions menu, click Site Settings, and then click Permissions.

For more information about metadata-based routing and storage, see Metadata-based routing and storage overview (SharePoint Server 2010) (http://go.microsoft.com/fwlink/p/?LinkId=212903).

Scenarios included in this section:

In this scenario, a batch of SAP workflow tasks fails to be delivered to SharePoint Server. Each unique task in an SAP workflow is implemented as a separate SharePoint Server 2010 declarative workflow, called an SAP workflow task.

Troubleshoot SAP workflow tasks not delivered

  • In ULS Viewer, filter the event log by user ID and note the corresponding Workitem ID and Correlation ID of the task requests that the SAP system sent. Download ULS Viewer (http://go.microsoft.com/fwlink/p/?LinkId=195379).

  • Verify that the SharePoint user has been granted execute permissions on all of the BDC models.

  • Verify that an SAP administrator has mapped the user account in the SAP system to the SharePoint user account in the SharePoint system and that the SharePoint user can access the Service Consumption Layer and external data that is stored in the SAP system.

For more information about troubleshooting workflows in Duet Enterprise, see Troubleshooting (Duet Enterprise) (http://go.microsoft.com/fwlink/p/?LinkId=205296).

In this scenario, a batch of SAP workflow tasks are delivered to SharePoint Server, but failures occur and some SAP workflow tasks do not successfully create declarative SharePoint workflows.

Troubleshoot workflow task delivered with error

  • In ULS Viewer, filter the event log by user ID and note the corresponding Workitem ID and Correlation ID of the task requests that the SAP system sent. Download ULS Viewer (http://go.microsoft.com/fwlink/p/?LinkId=195379).

  • Verify that the SharePoint user has been granted execute permissions on all of the BDC models.

  • Verify that an SAP administrator has mapped the user account in the SAP system to the SharePoint user account in the SharePoint system and that the SharePoint user can access the Service Consumption Layer and external data that is stored in the SAP system.

  • Verify that the workflow site is correctly registered as a Duet Enterprise Workflow site.

    Browse to the top-level site of the site collection for the Duet Enterprise workflow. On the Site Actions menu, click Site Settings, and then click Troubleshoot Duet Enterprise Workflow.

For more information about how to prepare and register a workflow site in Duet Enterprise, see Create a Workflow site (http://go.microsoft.com/fwlink/p/?LinkID=203634).

In this scenario, a SharePoint user is unable to approve or reject a task on a workflow site in SharePoint Server. The user encounters an error message that includes the Correlation ID value for the task, and the task action in the declarative workflow that is running in SharePoint Server is not synchronized with the SAP workflow.

Troubleshoot unable to approve SAP task

  • . In ULS Viewer, filter the event log by user ID and note the corresponding Workitem ID and Correlation ID of the task requests that the SAP system sent. Download ULS Viewer (http://go.microsoft.com/fwlink/p/?LinkId=195379).

  • Verify that the SharePoint user has been granted execute permissions on all of the BDC models.

  • Verify that an SAP administrator has mapped the user account in the SAP system to the SharePoint user account in the SharePoint system and that the SharePoint user can access the Service Consumption Layer and external data that is stored in the SAP system.

  • To verify that the workflow site is correctly registered as a Duet Enterprise Workflow site.

    Browse to the top-level site of the site collection for the Duet Enterprise workflow. On the Site Actions menu, click Site Settings, and then click Troubleshoot Duet Enterprise Workflow.

Scenarios included in this section:

In this scenario, a SharePoint Farm administrator is unable to create a site collection by using the Duet Enterprise Sites site collection template.

Troubleshoot cannot create Duet Enterprise site

  • Use ULS Viewer to look for runtime errors. Download ULS Viewer (http://go.microsoft.com/fwlink/p/?LinkId=195379).

  • Use Duet Enterprise configuration checking tools to identify missing dependencies and repair Duet Enterprise installation.

  • Verify that the certificates that are used to establish a trust relationship with the SAP system are valid and have not expired.

For information on how to verify the health of a security configuration and display a list of the BDC models that you imported, see Check configuration health (http://go.microsoft.com/fwlink/p/?LinkID=205814).

For guidance on how to repair the Duet Enterprise files in the file system of a computer that is running Microsoft SharePoint Server, see Repair Duet Enterprise (http://go.microsoft.com/fwlink/p/?LinkID=205600).

For information about the prerequisites for installing Duet Enterprise, see Hardware and software requirements (http://go.microsoft.com/fwlink/p/?LinkID=205818).

In this scenario, a SharePoint Workspace user is unable to open a collaboration workspace for his customer account.

Troubleshoot cannot open collaboration workspace

  • Verify that the SharePoint user has been granted execute permissions on all of the BDC models.

  • Verify that the user account in the SAP system is mapped to the SharePoint user account in the SharePoint system by an SAP administrator, and that the SharePoint user can access the Service Consumption Layer and external data that is stored in the SAP system.

  • Verify that the SharePoint user has permissions to the collaboration workspace site. On the collaboration workspace site, on the Site Actions menu, click Site Settings, and then click Permissions.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft