Implementing the Repository Diagnostic Tool (RDT)

Objective

After completing this lesson, you will be able to resolve content discrepancies using the Repository Diagnostic Tool (RDT).

Terminology

Repository Diagnostic Tool (RDT)

Repository Diagnostic Tool (RDT) is a command line tool provided on SAP BusinessObjects BI Platform 2025. This tool has to be executed on the application server host only to scan and repair inconsistencies between the CMS system database and the FRS file store directory.

Definition:

Administrators use Repository Diagnostic Tool (RDT) to aid in the identification and resolution of potential problems within the BI repository.

  • Repository Diagnostic Tool (RDT) can scan and diagnose inconsistencies between the CMS system database and Input and Output FRS.
  • Repository Diagnostic Tool (RDT) can also repair scanned inconsistencies.

    Note

    We strongly recommend to backup the CMS system database and the File Story Directory content before running RDT in repair mode. There is no turning back possible in repair mode with RDT.
Inconsistencies:

Incorrect backup restoration (for instance, due to non-synchronized CMS system database and File Story Directory backups) can corrupt or cause inconsistencies with object references in the CMS system database.

The RDT is a command line diagnostic tool. It compares each CMS database objects with the corresponding object in the Input and Output FRS. It also compares each object in the Input and Output FRS with the corresponding object in the CMS system database.

  • The RDT scans for two types of inconsistencies:
    1. Object inconsistency:

      These inconsistencies can happen when an InfoObject in the CMS system database doesn't have the corresponding file in the file store repository.

    2. File Inconsistency:

      These inconsistencies can happen when a file that is located in the file store directory doesn't have the corresponding InfoObject in the CMS system database.

  • A report is generated in a XML format that can be viewed in a web browser (Internet Explorer only supported at this moment):
    • In scan mode: Only the XML report is generated with suggested actions to repair the inconsistencies.
    • In repair mode: After inconsistencies are identified, the RDT will repair what it can and an XML report is generated with suggested actions and what items it repaired.

Note

The RDT doesn't need the CMS service to be running. The RDT runs directly against the CMS database.

Follow the link to know how use the Repository Diagnostic Tool: (To use the Repository Diagnostic Tool).
Follow the link to know all the Repository Diagnostic Tool parameters: (Repository Diagnostic Tool Parameters).
Reposcan Analyzes Inconsistencies.
Repository Scan Report

Inconsistencies Between CMS and FRS

Repository Diagnostic Tool (RDT)

Repository Diagnostic Tool (RDT) scans and repairs inconsistencies between the CMS system database and the FRS file store directory.

Definition:
Inconsistencies can be found between a CMS database and FRS using the the RDT in scan mode or in repair mode.

Note

The following links show you what inconsistencies can be found between a CMS database and FRS using the RDT:

Inconsistencies between the CMS and the FRS

Inconsistencies in CMS Metadata

Files and Objects Inconsistencies

Repository Diagnostic Tool (RDT) scans and repairs inconsistencies between the CMS system database and the FRS file store directory.

Definition:
Inconsistencies can be found between a CMS database and FRS using the the RDT in scan mode or in repair mode.

Note

The following link shows you the inconsistencies that can happen in the metadata of CMS objects found by the RDT:

Inconsistencies in the CMS Metadata

Run the Repository Diagnostic Tool

In this exercise, you will run the Repository Diagnostic Tool.

Summary

  • Repository Diagnostic Tool (RDT) is used by administrators to identify and resolve potential problems within the BI repository.
  • RDT scans, diagnoses, and repairs inconsistencies between the CMS system database and Input and Output File Repository Servers (FRS).
  • Inconsistencies include 'Object Inconsistency' ( InfoObject in CMS without corresponding file in FRS) and 'File Inconsistency' (file in FRS without corresponding InfoObject in CMS).
  • RDT is a command line tool that generates an XML report with suggested actions and repairs inconsistencies when possible.
  • RDT does not require the CMS service to be running as it operates directly against the CMS database.