5 - C H A P T E R -

C H A P T E R 5

Customizing Your Installation

This chapter contains information to assist you in customizing your installation of Sun ONE Studio 4, Community Edition. It includes information about the PointBase Server 4.2 Restricted Edition.

The PointBase Server 4.2 Restricted Edition is available for installation with the Sun ONE Studio IDE. You can use other databases with the IDE by configuring the JDBC enabled database drivers for those databases.

Note - The following instructions assume you have already installed the PointBase Server 4.2 Restricted Edition during the IDE installation.

Using a PointBase Database

PointBase Server 4.2 Restricted Edition is the default database that is provided with the Sun ONE Studio IDE installation. For information on using this database and database tables, see the PointBase documentation at either of these locations:

s1studio-install-dir/pointbase/server/GettingStarted.html

s1studio-install-dir/pointbase/client/GettingStarted.html.

Starting the PointBase Database Server

You have to start the PointBase database server before you can use it, whether you want to access a PointBase database from an application you developed using the IDE or you want to create your own tables or database with PointBase software.

To start the PointBase database server:

Choose Tools right arrow PointBase Network Server Start Server from the main menu of the IDE.

The PointBase 4.2 window appears.

Stopping the PointBase Database Server

Note - The following action stops only the PointBase database server that was started by choosing Tools right arrow PointBase Network Server Start Server.

To stop the PointBase database server:

Choose Tools right arrow PointBase Network Server Stop Server from the main menu of the IDE or choose Server Shutdown! from the PointBase 4.2 window.

Starting the PointBase Client Console

To start a PointBase console, do the following:

On Microsoft Windows systems, start the PointBase client console by choosing Programs right arrow Sun Microsystems Sun ONE Studio 4 CE PointBase Console from the Start menu.

A Connect to Database dialog box appears. Click OK to continue.

In a supported Solaris or Linux environment, type:

$ sh s1studio-install-dir/pointbase/client/Console

A Connect to Database dialog box appears. Click OK to continue.

Stopping the PointBase Client Console

To stop the client console, close the window from which it is running.

Starting the PointBase Server Outside the Sun ONE Studio IDE

On Microsoft Windows 2000 and XP systems, follow these steps.

1. Type the following at a command line prompt:

cd s1studio-install-directory\pointbase\server

2. Then type:

netserver.bat "-Dpointbase.ini=s1studio-user-directory\pointbase\pointbase.ini" /win

On Microsoft Windows NT and 98 systems, follow these steps.

1. Type the following at a command line prompt:

cd s1studio-install-dir\pointbase\server

2. Then type:

netserver.bat "-Dpointbase.ini=s1studio-install-directory\pointbase\pointbase.ini" /win

On a Solaris or Linux system, follow these steps.

1. Define the environment variable PB_JAVA_OPTS to be "-Dpointbase.ini=s1studio-user-directory/pointbase/pointbase.ini" For example, type:

$ setenv PB_JAVA_OPTS "-Dpointbase.ini=s1studio-user-directory/pointbase/pointbase.ini"

2. Then go to the PointBase server directory, by typing:

$ cd s1studio-install-dir/pointbase/server

3. Start the server by typing:

$ Server /win

Using Other JDBC Enabled Databases

The following information applies to database drivers other than the driver for the PointBase Server 4.2 Restricted Edition database.

You must place database driver files in the Sun ONE Studio lib/ext directory before you start the Sun ONE Studio IDE. If you do not do this, the dbschema wizard does not enable you to select the proper database driver when you create a new schema. You cannot mount the driver file in the IDE's Explorer, nor can you simply place the driver file in the CLASSPATH environment variable. You must copy the driver file into the lib/ext folder.