Check configuration health (Duet Enterprise)

  • Article

 

Applies to: Duet Enterprise for Microsoft SharePoint and SAP

This article describes how to verify the health of a security configuration and display a list of the BDC models that you imported by using the procedure in Import models (https://go.microsoft.com/fwlink/p/?LinkId=205813).

Verify the health of a security configuration

Before you can complete the health check, you must ensure that the BDCServiceApplicationProxyName key in the DuetConfig.exe.config.xml file lists the name of the Business Data Connectivity service application that you will use for Duet Enterprise.

BatonHandoffIcon

If you are using the Deployment worksheet (https://go.microsoft.com/fwlink/p/?LinkId=205392), this name is listed in the “BDC service name” row of Table 1 of the worksheet.

You must also ensure that the account that you will use to run the Configuration Health Check was granted full permissions on both the SAPRoles and SAPUsers external content types.

To verify the value of the BDCServiceApplicationProxyName key

  1. Open a Command Prompt window and go to the <drive>:\Program Files\ Duet Enterprise\1.0 folder.

    Where:

    <drive> is the drive on which the Duet Enterprise files are stored.

  2. At the prompt type notepad DuetConfig.exe.config and press Enter.

  3. In the DuetConfig.exe.config file, verify that the value of the BDCServiceApplicationProxyName key matches the name of the Business Data Connectivity service application that you will use for Duet Enterprise. If it does not match, update the value of the key to match and then save the DuetConfig.exe.config file.

To verify permissions on the SAPRoles and SAPUsers external content types

  1. In Central Administration, on the Quick Launch, click Application Management.

  2. In the Service Applications section, click Manage service applications.

  3. In the Type column, click the Business Data Connectivity service application that you want to use.

  4. In the Operations group of the ribbon, click Properties.

  5. Select the check box next to SAPRoles.

  6. In the ribbon, click Set Object Permissions.

  7. If the user account that you will use to run the Configuration Health Check does not appear in the middle box, type the account name in the top box, and then click Add. Otherwise, go to step 8.

  8. In the middle box, select the user account that you will use to run the Configuration Health Check, and then ensure that all check boxes in the Permissions (bottom) box are selected.

  9. Click OK.

  10. On the View External Content Types page, click to clear the check box next to SAPRoles, and then select the check box next to SAPUsers.

  11. In the ribbon, click Set Object Permissions.

  12. If the user account that you will use to run the Configuration Health Check does not appear in the middle box, type the account name in the top box, and then click Add. Otherwise, go to step 8.

  13. In the middle box, select the user account that you will use to run the Configuration Health Check, and then ensure that all check boxes in the Permissions (bottom) box are selected.

  14. Click OK.

To check configuration health

  1. Open a Command Prompt window and go to the <drive>:\Program Files\Duet Enterprise\1.0 folder.

    Where:

    <drive> is the drive on which the Duet Enterprise files are stored.

  2. At the prompt type DuetConfig /checkconfiguration.

  3. You can also choose to append /out <outputfile> to the command to specify the location and name of the xml file in which the configuration report is written. Where <outputfile> is the location and file name of the file to which you want the configuration health report written. If you do not specify this parameter, the output file is written to the location that is specified by the Windows %Temp% environment variable.

  4. Press Enter.

    An XML file that contains the configuration information and an XSL file that is used to format the display of the report in your browser are created in either the location that was specified by the Windows %Temp% environment variable or by the value that you assigned to the /out parameter.

  5. When the message “Successfully written configurations to file <drive>:\path\filename appears, in Windows Explorer go to the folder in which the file was written and double-click the .xml file to display the configuration health report.