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

• Install the demo database schema

• Install and configure the BI Beans Catalog

• Update the samples project settings

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/samples904.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:

• Choose Edit.

• On the Authentication tab, change the ID and password, if necessary. You must perform this step if you changed the ID and password when you installed the BIBDEMO schema.

• Select the Connection tab and change the Hostname, Port, and SID appropriately.

• On the OLAP Server Instance tab, select an OLAP server instance.

• Choose Test to test your connection.

• If the connection test succeeds, then choose OK to save the Oracle9i OLAP connection information.

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 reference a BI Beans Catalog in a database. This is necessary because each of the samples references the following configration files (under the common.jpr project) to establish runtime connections to Oracle OLAP and the BI Beans Catalog: commonBIConfig1.xml, commonBIConfig1Catalog.dad, and commonBIConfig1OLAP.dad.