Space banner

   

This documentation supports the 19.11 version of Remedy Smart Reporting, which is available only to BMC Helix subscribers (SaaS).
To view an earlier version, select the version from the Product version menu of the documentation at IT Service Management Suite .

Troubleshooting user onboarding and content import

This topic describes the issues related to onboarding and importing content in Remedy Smart Reporting.

Onboarding issues

The following errors may occur during the Remedy Smart Reporting onboarding process.

Issue symptomIssue causeIssue workaround

The onboarding process in Remedy Smart Reporting fails with the following error:

A system error has occurred, please contact your administrator for more information". Below errors are found in SR log file:

ERROR (303): Form does not exist on server

ERROR: SmartReporting_ClientOrg_Content_Info 

ERROR (303): Form does not exist on server : SmartReporting_Contents

During the Remedy AR System server installation, the SmartReportingApplication.def file does not get imported at the following location:

  • For Windows: C:\Program Files\BMC Software\ARSystem\Arserver\installforms\en
  • For Linux: opt\BMC\ARSystem\Arserver\installforms\en

Because of this, all the Remedy Smart Reporting objects (such as forms and links) do not exist on the Remedy AR System server, and the user onboarding process fails.

  1. Open Remedy Developer Studio.
  2. Navigate to the Remedy AR System server installation directory, and manually import the RemedySmartReporting.def file.
    All the Remedy Smart Reporting objects are imported.

Onboarding process fails and displays the following error:

Failed to get Smart Reporting version.

During the Remedy Smart Reporting installation, the installer defines the system environment variable. If the installer fails to set this system variable, the onboarding process fails.

Manually set the following system environment variable, and restart the computer where you have installed the Remedy Smart Reporting server:

BMC_SMART_REPORTING_HOME=/opt/remedy/ars/SmartReporting

The onboarding process fails with the following error message:

An error has occurred during operation, please try again later or contact your administrator

Multiple reasons can cause this error.
  1. Ensure that you have installed the same version of the Remedy AR System server and Remedy Smart Reporting.
  2. Navigate to C:\Program Files\BMC Software\ARSystem and validate the version details in the ARSystemInstalledConfiguration.xml file.
  3. Ensure that the Remedy AR System server database is in Read/Write mode.
  4. Onboard users from the Remedy AR System server.

The IT Service Management multicompany user onboarding fails with the following error message:

The Selected company does not contain the user, so unable to make as Reporting Administrator.

The user is not part of the selected company.

For multicompany user onboarding (one-company-at-a-time option), ensure that the user belongs to the company for which you are onboarding. By default, users are assigned to the company that is defined in the Company field under the Organization section of the People form. For more information, see How multicompany user onboarding works.

If you enter an incorrect user name, the onboarding process fails with the following error message:

Provided user, entered for admin is either not present in AR or not qualify the user creation filter criteria.

The user onboarding utility does not onboard users if:

  • You have entered an incorrect user name.
  • You have entered a user name that does not belong to the AR Groups or the Smart Reporting Custom App Users group.
Ensure that you enter the correct user name and that user belongs to the AR Groups or the Smart Reporting Custom App Users group.
You cannot onboard more than seven users that are a part of the Smart Reporting Custom App Users group into Remedy Smart Reporting.

By default, you can onboard only up to seven users that are a part of the Smart Reporting Custom App Users group into Remedy Smart Reporting. 

Contact BMC Customer Support.

No data is found for onboarded users that are a part of the Smart Reporting Custom App Users group.

For users that are a part of the Smart Reporting Custom App Users group, the onboarding process does not import the data. Only the users are onboarded.

For importing and accessing data for users that are a part of the Smart Reporting Custom App Users group, see Creating a view of database tables and fields.

Importing content issues

The following errors may occur during the Remedy Smart Reporting importing content process.

Issue symptomIssue causeIssue workaround

Importing the out-of-the-box content process in Remedy Smart Reporting fails with the following error message:

An error has occurred during operation, please try again later or contact your administrator

The following error is logged in the Smart Reporting logs:

javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

Multiple reasons can cause this error.

Ensure that the content for all modules exists in the SmartReporting_Contents form. If the content is missing, import the content manually. See the example steps below.

To import the CMDB content in the SmartReporting_Contents form:

  1. On the computer where you have installed BMC CMDB, go to the following installation path:
    CMDBInstallationDirectory\Program Files\BMC Software\AtriumCore\cmdb\en\workflow
  2. Copy the following files:
    • CMDB_FreshContent_9.1.00.xml
    • CMDB_UpgradeContent_9.1.00.xml
  3. Log in to Remedy Mid Tier, and open the SmartReporting_Contents form.
  4. Create a new request with the following parameters:

    • Product Name—CMDB 

    • Content Version—Product version
      Note: For CMDB, ensure that the version on the SHARE:Application_Properties form and the SmartReporting_Contents form is the same. For example, if the CMDB version is 9.1.00.001, then the content version must also be 9.1.00.001, even if there are no content updates for that version.
  5. Import or add the .xml files copied in step 2.
  6. Import the content in Remedy Smart Reporting.

The Import Content process displays the following error message:
Error in fetching Clientorg content details

Inconsistencies in the onboarding tenant process.
  1. Delete the records from the SmartReporting_ClientOrg_Content_Info form.
  2. Offboard the existing client org, and rerun the onboarding process.
  3. Run the Content Import process for all available applications.
Was this page helpful? Yes No Submitting... Thank you

Comments