Installing and Configuring the Samples

Before you can run the BI Beans samples, you must perform the following installation and configuration tasks:

Download the latest samples

Oracle Technology Network (http://otn.oracle.com) contains the latest versions of the BI Beans tutorials and samples. These learning materials are continually updated, so ensure that you use the most recent versions.

To download and install the samples:

  1. Create a directory on your computer to store the samples.

  2. Download the zip file that contains the samples from Oracle Technology Network (http://otn.oracle.com/sample_code/products/bib/samples903.zip) into this samples directory.

  3. Unzip the files. The samples are stored in the following subdirectories under the samples directory:

    common
    forecast
    javaclient
    ldapsync
    portal
    rdbmssync
    servlet
    struts

Install the demo database schema

If you have not already done so, then you must install the Oracle9i database schema called BIBDEMO, which is required by the BI Beans samples and tutorials.

Install and configure the BI Beans Catalog

If you have not already done so, then you must install and configure the BI Beans Catalog, which allows end users to save and share analyses.

Update the samples project settings

In JDeveloper, settings in the BI Designer determine how the samples connect to Oracle9i OLAP and to the BI Beans Catalog. To enable the samples to connect correctly, you must update the settings in the common project that you download with the samples. Updating this one project ensures correct connection information for all the samples except the portal, struts and forecasting samples. You must update the individual settings in each of these projects.

To update the samples project settings and build the common project:

  1. Start JDeveloper and open the workspace /common/CommonWorkspace.jws under the samples directory

  2. In the JDeveloper Navigator, open the CommonWorkspace.jws workspace, then open the common.jpr project.

  3. Right-click CommonBIDesigner1 and select Settings from the popup menu.

  4. Specify the Oracle9i OLAP data source connection:

  5. Choose OK to close the BI Beans project settings.

  6. From the File menu, choose Save All.

  7. Right-click common.jpr and select Build Project from the popup menu.

To rebuild the bootstrap project to generate connect and disconnect images for the Java-client applications:

  1. Within JDeveloper, open the workspace /javaclient/javaclient.jws under the samples directory

  2. In the JDeveloper Navigator, open the javaclient.jws workspace, then open the bootstrap.jpr project.

  3. Right-click bootstrap.jpr and select Rebuild bootstrap.jpr from the popup menu.

You are now ready to begin using the samples.

Note: To deploy any of the samples, you must first deploy the common.jpr project under the CommonWorkspace.jws workspace and make sure the runtime settings for the project is going against a BI Beans Catalog in a database. This is because each of the samples reference the following configration files under the common.jpr project for runtime connection to Oracle OLAP and the BI Beans Catalog: commonBIConfig1.xml, commonBIConfig1Catalog.dad, and commonBIConfig1OLAP.dad.