SAP BusinessObjects Enterprise XI 4.0 Diagnostic Tool User's Guide
SAP BusinessObjects Enterprise Repository Diagnostic Tool User's Guide
■ SAP BusinessObjects Enterprise XI 4.0
2011-01-12
Copyright
© 2011 SAP AG. All rights reserved.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP
Business ByDesign, and other SAP products and services mentioned herein as well as their respective
logos are trademarks or registered trademarks of SAP AG in Germany and other countries. Business
Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web
Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well
as their respective logos are trademarks or registered trademarks of Business Objects S.A. in the
United States and in other countries. Business Objects is an SAP company.All other product and
service names mentioned are the trademarks of their respective companies. Data contained in this
document serves informational purposes only. National product specifications may vary.These materials
are subject to change without notice. These materials are provided by SAP AG and its affiliated
companies ("SAP Group") for informational purposes only, without representation or warranty of any
kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The
only warranties for SAP Group products and services are those that are set forth in the express
warranty statements accompanying such products and services, if any. Nothing herein should be
construed as constituting an additional warranty.
2011-01-12
Contents
Repository Diagnostic Tool.....................................................................................................5Chapter 1
Using the Repository Diagnostic Tool.....................................................................................7Chapter 2
2.1
2.2
Index 21
To use the Repository Diagnostic Tool.....................................................................................7
Repository Diagnostic Tool Parameters...................................................................................8
Inconsistencies between the CMS and the FRS...................................................................13Chapter 3
Inconsistences in the CMS metadata...................................................................................15Chapter 4
More Information...................................................................................................................19Appendix A
2011-01-123
Contents
2011-01-124
Repository Diagnostic Tool
Repository Diagnostic Tool
The Repository Diagnostic Tool (RDT) is a command-line tool that scans, diagnoses, and repairs
inconsistencies that may occur between your Central Management Server (CMS) system database
and the File Repository Servers (FRS) filestore, or inconsistencies that can occur in the metadata of
InfoObjects stored in the CMS database.
During normal operations, it is unusual for the CMS system database to have inconsistencies. However,
inconsistencies may occur during unexpected events such as disaster recovery, back-up restoration,
or network outages. During these events, the CMS system database may be interrupted while performing
a task. This can cause inconsistencies with objects in the CMS system database.
The RDT scans the CMS system database and identifies inconsistencies in such objects as reports,
users, user groups, folders, servers, universes, universe connections, and other objects.
The RDT scans for two types of inconsistencies.
• Object to file inconsistencies.
These are inconsistencies that can occur between InfoObjects in the CMS database and the
corresponding files in the File Repositories. For example, a file that is stored in the FRS may be
missing a corresponding object in the CMS system database.
• InfoObject metadata inconsistencies.
These are inconsistencies that may exist in an InfoObject's object definition (metadata) in the CMS
database. For example, an InfoObject may reference another InfoObject that does not exist in the
CMS database.
The RDT peforms two functions, depending on the parameters that you provide when you run the tool:
• It scans the CMS system database and FRS filestore, reports inconsistencies, and outputs a log file
in XML format with suggested actions to repair the inconsistencies.
• It scans and repairs the inconsistencies identified in the CMS system database and FRS, and outputs
the actions taken to a log file in XML format.
2011-01-125
Repository Diagnostic Tool
2011-01-126
Using the Repository Diagnostic Tool
Using the Repository Diagnostic Tool
The Repository Diagnostic Tool (RDT) is available on any machine with a Central Configuration Manager
(CCM) installed on it. This command-line tool scans, diagnoses, and repairs inconsistencies that may
occur between the Central Management Server (CMS) system database and the File Repository Servers
(FRS) filestore, or inconsistencies that may occur in an InfoObject's metadata.
Do not run the RDT against a live CMS database and FRS. Changes that your users make to the CMS
or FRS while the RDT is running can create new inconsistencies in your deployment. Repair actions
that the RDT takes while users are accessing your deployment can create further inconsistencies.
Instead, it is recommended that you back up your CMS database and FRS filestore, and run the RDT
against the backed-up version while your SAP BusinessObjects Enterprise services are down.
The RDT does not require the CMS service to be running. The RDT runs directly against the CMS
database.
2.1 To use the Repository Diagnostic Tool
1.
If you are running the tool on a Windows computer, open a command window and run the following
command.
<INSTALLDIR>\SAP BusinessObjects Enterprise XI 4.0\win64_x64\reposcan.exe
<arguments>, where <arguments> is the list of parameters that you want to specify.
2.
If you are running the tool on a UNIX computer, open a /usr/bin/sh compatible shell, and run the
following command.
.<INSTALLDIR>/sap_bobj/enterprise_xi40/<platform>/boe_reposcan.sh <argu
ments> where <platform> is either “linux_x64”, “solaris_sparcv9”, “hpux_ia64”, or “aix_rs6000_64”,
and <arguments> is the list of parameters that you want to specify.
The Repository Diagnostic Tool scans your repository for inconsistencies. Depending on the parameters
that you specify, it either diagnoses and logs inconsistencies, or it repairs inconsistences and logs the
action that it takes.
Repo_Scan_yyyy_mm_dd_hh_mm_ss.xml lists the inconsistencies that the tool finds. If you had the
tool repair the discrepancies that it finds, it also creates the file Repo_Re
pair_yyyy_mm_dd_hh_mm_ss.xml.
2011-01-127
Loading...