Forms of output from the utility Description of output from the utility

Configuring Discoverer Plus OLAP 5-13 To configure the look-and-feel for Discoverer Plus OLAP: 1. Go to the Fusion Middleware Control Discoverer Home page. For more information, see Section 4.1.3, How to display the Fusion Middleware Control Discoverer Home page and Discoverer component Home pages .

2. Click the Discoverer Plus component.

3. Click Configure.

The Discoverer Plus Configuration page is displayed. 4. Use the fields on this page to specify configuration settings.

5. Click OK to apply the changes.

5.5 Information to be provided to end users

After you have configured the Discoverer Catalog and Discoverer Plus OLAP, you should ensure that users have the following information, which enables them to use Discoverer Plus OLAP: ■ The URL to the Discoverer Connections page. Users supply information on this page to connect to Discoverer Plus OLAP, such as the user name and password. For more information about the Discoverer Connections page, see Chapter 3, Managing Oracle BI Discoverer Connections . ■ The information that users enter in the Database field of the Discoverer Connections page. They must enter the following string: HOST :PORT:SID ■ The version of Microsoft Excel that worksheet consumers must have to view a worksheet exported from Discoverer Plus OLAP. Worksheet consumers must have Excel 2000 or later. ■ The information about the configuration diagnostic utility, if users have trouble connecting to the database when they run Discoverer Plus OLAP. See Section 5.6, Configuration diagnostic utility for Discoverer Plus OLAP for information about this utility.

5.6 Configuration diagnostic utility for Discoverer Plus OLAP

Discoverer Plus OLAP includes a utility that examines and reports on the configuration of the OLAP environment. Its purpose is to gather information about the configuration, to help you and Oracle Support diagnose problems that end users experience when running Discoverer Plus OLAP. For more information about how users run the diagnostic utility, see the Discoverer Plus OLAP Help. Users simply click a button in an error dialog or choose a menu option. The dialog that is displayed provides basic output from the utility and allows end users to run another test that provides more detailed output. The Help topics instruct users to share the output with their database administrator if they need assistance.

5.6.1 Forms of output from the utility

The utility produces two forms of output, as described in the following list: 5-14 Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer ■ Output that is written directly to the dialog in which users run the utility -- For details, see Section 5.6.2, Description of output from the utility . ■ An XML file -- Users name and store this file as they like, after running the utility and viewing the results in the dialog. The file contains the output that was displayed in the dialog, including version information for various components, the detailed stack trace of any errors, and a list of the folders, measures, and dimensions that were found in the database that is, the metadata. You can send this file to Oracle Support Services as an e-mail attachment to get help in diagnosing problems.

5.6.2 Description of output from the utility

The following labels describe the items that the utility displays in the dialog and in the XML file. These labels are listed according to the sequence in which the utility performs the various checks. Many items relate to version numbers. See the installation guide that you used when installing Discoverer for information on the appropriate version numbers.

5.6.2.1 JDK version

The version number of the JDK that is being used, such as 1.5.0.

5.6.2.2 BI Beans internal version

The internal version number of BI Beans that is installed.

5.6.2.3 Discoverer Plus OLAP version

The internal version number of the Discoverer server that is installed.

5.6.2.4 Discoverer version

The internal version number of the Discoverer Plus component that is installed.

5.6.2.5 Connect to database

Whether the utility was able to establish a database connection. If a connection was established, then the result is Successful. Otherwise, the result is Unsuccessful. If the utility cannot connect to the database, then you can: ■ Examine the errors that are shown in the dialog for more information. ■ Verify that all the connection information such as user name and password is correct. ■ Verify that the database is running and accepting connections.

5.6.2.6 JDBC driver version

The version of the JDBC driver that is being used.

5.6.2.7 JDBC JAR file location

The full path name to the directory that contains the JDBC driver JAR file.

5.6.2.8 Database version

The version of the Oracle database to which Discoverer Plus OLAP is connected. Configuring Discoverer Plus OLAP 5-15

5.6.2.9 OLAP Catalog version, OLAP AW Engine version, OLAP API Server version

The versions for various OLAP components. The returned values might not exactly match the Database version, due to database patch releases. Under certain circumstances, these versions are returned as NA, which is not a problem that you must resolve.

5.6.2.10 BI Beans Catalog version

The internal version of the BI Beans Catalog that is installed. If the BI Beans Catalog is not installed, then this value is NA; not installed in schema-name.

5.6.2.11 Discoverer Catalog version

The internal version of the Discoverer Catalog that is installed. If the Discoverer Catalog is not installed, then this value is NA; not installed in schema-name. Discoverer Plus OLAP requires that the Discoverer Catalog be installed.

5.6.2.12 Authorized for Discoverer Plus OLAP

Whether the user who is running the utility is authorized to run Discoverer Plus OLAP.

5.6.2.13 OLAP API JAR file version

The version of the OLAP API client JAR file.

5.6.2.14 OLAP API JAR file location

The full path to the directory in the users installation that contains the OLAP API client JAR files.

5.6.2.15 Load OLAP API metadata

Whether the utility was able to load the metadata from the database. If the metadata was loaded, then the result is Successful. Otherwise, the result is Unsuccessful. The database administrator must define appropriate metadata in the Oracle database to support business intelligence applications. For information about defining OLAP metadata, see Oracle OLAP Users Guide. If the metadata was not loaded, then verify that the metadata is correct. If you continue to have problems, then consult the OLAP forum on Oracle Technology Network or contact Oracle Support Services.

5.6.2.16 Number of metadata folders

The number of folders that were detected in the metadata from the database.

5.6.2.17 Number of metadata measures

The number of measures that were detected in the metadata from the database.

5.6.2.18 Number of metadata dimensions

The number of dimensions that were detected in the metadata from the database.

5.6.2.19 Metadata description

The full description of all the metadata from the database. 5-16 Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer

5.6.2.20 Error message description

If any errors occurred, then brief information about them is displayed at the appropriate location in the output in the dialog. For example, if the user entered an incorrect name or password, then information to this effect is noted immediately after the Connect to database label and no further output is included. The XML file of the output includes more detailed information than is provided in the dialog output.

5.7 URL parameters for the Discoverer Plus OLAP