PATH  WebObjects 4.0 Documentation > Post-Install Guide

Table of Contents Previous Section

Setting Up the Sample Databases

WebObjects includes Enterprise Objects Framework database integration technology. If you've installed WebObjects Developer, several examples demonstrate Enterprise Objects Framework programming techniques. In particular, if you work through the tutorials in the book Getting Started With WebObjects, you'll need two sample databases: Movies, which contains background information on all movies available form a store's distributor, and Rentals, which contains the inventory, customer list, and rental transaction records for the store. In addition, WebObjects ships with an example application named Movies, which uses a database of Movies, their ratings, and principal actors. The section Verifying the Installation uses Movies to verify that the installation is working properly.


Warning: None of the data in the sample databases is intended to be accurate.

All of the examples supplied with this release come pre-built, and are runnable directly from their distribution directories. Those that use the Enterprise Objects Framework run "out of the box" against the supplied OpenBaseLite databases. On Mac OS X Server and Windows NT systems, you can invoke the Setup Wizard to reconfigure the example application models to use another supported database, such as Oracle or Sybase, and to optionally load the database for you. The Setup Wizard copies the examples into a directory of your choosing before modifying them.

For WebObjects 4.0, the Setup Wizard doesn't completely perform all operations necessary to get the examples running. In particular, it doesn't convert the models in the BusinessLogicInheritance framework, and it doesn't load the inheritance model data into a database. However, it does work correctly on the BusinessLogic framework; thus, the simpler examples that don't use interitance will work correctly with your database after you run the SetupWizard and perform a few additional manual steps.

Running the Setup Wizard

SetupWizard.app is located in /System/Developer/Examples/EnterpriseObjects (on Windows NT systems, NEXT_ROOT\Developer\Examples\EnterpriseObjects ). After you invoke the wizard, you'll be prompted for a directory into which the examples should be installed. This directory must already exist in order for the wizard to work properly.


Warning: The wizard will delete any existing contents of the directory you specify.

After advancing to the next screen, follow the prompts through the rest of the wizard. Note that you `ll need to select a database adaptor and login to the database twice: once for Movies, and once for Rentals. Finally, the wizard will ask you whether or not you want it to populate the selected databases for you.

After running the Setup Wizard, you'll need to perform a couple of additional steps. These steps are outlined in a separate online document, ExampleGuide.rtfd, which is located in the same directory in which the Setup Wizard itself is located (.../Examples/EnterpriseObjects).

Table of Contents Next Section