Skip Headers
Oracle® Application Server TopLink Getting Started Guide
10g Release 3 (10.1.3) for HP-UX PA-RISC (64-Bit)
B28118-01
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
 
Next
Next
 

2 Installing and Configuring TopLink

This chapter includes the following information to install and configure Oracle TopLink:

2.1 TopLink Installation Types

The Oracle Universal Installer includes TopLink with the basic Oracle Application Server installation.To install only TopLink, select the Advanced installation type, then choose Oracle TopLink. This will install the TopLink Foundation Library and TopLink Workbench.

2.2 Installing TopLink

Use the following procedures to install TopLink (including TopLink Foundation Library and TopLink Workbench). Before you install TopLink, back up all existing project data.

This section includes information on:

2.2.1 Using Oracle Universal Installer

Use this procedure to start the Oracle Universal Installer and install TopLink 10g Release 3 (10.1.3).

  1. For Unix or other non-Windows operating systems:

    • Ensure that you are not logged in as the root user when you start the Oracle Universal Installer. If you are, then only the root user will have permissions to manage TopLink.

    • Log in as the oracle user.

  2. Insert the TopLink installation disk into the CD-ROM drive to launch Oracle Universal Installer, or download the installer from:

    http://www.oracle.com/technology/products/ias/toplink/index.html
    
    

    For UNIX or other non-Windows operating systems:

    • If your computer supports the auto run feature, the installer will automatically launch on your computer.

    • If your computer does not support the auto run feature, enter: prompt> mount_point/as_1013disk/runInstaller to launch the installer.


      Caution:

      Do not start the installation inside the mount_point directory. If you do, then you may not be able to eject the installation disk.

  3. Insert the TopLink installation disk into the CD-ROM drive to launch Oracle Universal Installer, or download the installer from:

  4. Complete each screen of the installer.

  5. When the installation is complete, you must configure the TopLink Workbench environment.

    For more information, see "Configuring the TopLink Workbench Environment" in the Oracle TopLink Developer's Guide.

  6. Refer to ORACLE_HOME/toplink/doc/index.htm for the latest Oracle TopLink Release Notes.

2.2.2 Installing Silently

Silent installation mode is available for all installation types. You can use the silent installation when you wish to make multiple installations simultaneously or when you perform installations from a remote location. Silent installation eliminates the need to monitor the installation because there is no graphical output and no input by the user.

  1. Insert the TopLink installation disk into the CD-ROM drive.

  2. Open the /Stage/Response directory and select the oracle.as.j2ee.top.toplink.rsp file.

  3. Copy the oracle.as.j2ee.top.toplink.rsp file to a temporary (tmp) location.

  4. Edit the following parameters in the oracle.as.j2ee.top.toplink.rsp file:

    ORACLE_HOME
    ORACLE_HOME_NAME
    GROUP_NAME
    FROM_LOCATION
  5. Start the installer.

    From the command prompt run the following command:

    ./runInstaller -responseFile /tmp/oracle.as.j2ee.top.toplink.rsp -silent
    
    

To check if the installation was successful, search for the following line in the silentInstall.log file:

"The installation of Oracle Application Server 10g was successful."

2.3 Configuring TopLink Runtime Environment

At runtime, the TopLink Foundation Library requires the Java Runtime Environment 1.5 (or higher). By default, the TopLink installation includes the JRE 1.5.0_04.

To configure TopLink for a different version of the JRE, change the ORACLE_HOME/toplink/bin/setenv.sh file to point JAVA_HOME to the alternate directory.

2.4 Configuring TopLink Workbench Environment

After installing TopLink Workbench, you must configure the following:

2.4.1 JRE Version

TopLink Workbench requires the Java Runtime Environment 1.4.2_06 (or higher). By default, the TopLink installation includes the JRE 1.5.

To configure TopLink for a different version of the JRE, change the ORACLE_HOME/toplink/bin/setenv file to point JAVA_HOME to the alternate directory.

Java Cryptography Extension (JCE)

The TopLink Workbench uses JCE to encrypt database login information. JCE is included with JDK 1.4 (or higher).

2.4.2 Online Help and Documentation

By default, TopLink installs only a portion of TopLink Workbench online Help system on your computer. To access the complete documentation from Oracle, ensure that your computer is connected to the internet and the proxy information (if necessary) is correct.

For more information on how to specify the help mode, see the Oracle TopLink Developer's Guide.

From the TopLink Workbench menu, select Tools, Preferences. On the Preferences dialog, select General to configure your proxy information.

2.4.3 Driver Classpath Environment Variable

Depending on the TopLink Workbench project, you are required to update the DRIVER_CLASSPATH environment variable to add the location of the following (if necessary):

  • JDBC drivers – If you are using relational projects.

  • J2EE Connector Architecture (J2C) adapters – If you are using TopLink Workbench Enterprise Information System (EIS) projects.

  • Oracle Database <ORACLE_HOME>/rdbms/jlib/xdb.jar file – If you are using direct to XML type mappings with an Oracle10g or higher database.

  • Custom Collection class that you use to override the default Collection class that TopLink uses with a mapping container policy.

For more information on how to update the DRIVER_CLASSPATH environment variable, see "Configuring the TopLink Workbench Environment" section in the Using TopLink Workbench chapter in the Oracle TopLink Developer's Guide.

2.4.4 Third-party Libraries

If you plan to use additional, third-party libraries (such as XMLType Mappings or EIS with Attunity), when deploying your Oracle TopLink project, you must copy the appropriate JAR file to ORACLE_HOME/toplink/jlib. Additionally, you must include the libraries on the server's classpath.

2.5 Starting TopLink Workbench

To start TopLink Workbench, simply execute the workbench.sh file in the INSTALL_DIR/toplink/bin directory. The TopLink Welcome Screen appears.

If you receive a "Cannot Find Main Class" error, ensure that you have configured JAVA_HOME correctly. See "JRE Version".

2.6 TopLink Tutorial

TopLink provides a tutorial with which you can create an Employment Management System for your company to be deployed in a three-tier environment using JSP servlets. The tutorial shows you how to store data from a Java class into a relational database and access existing database information from Java classes.

Specifically, you will learn how to:

2.7 Installation Troubleshooting

After you install TopLink, if you encounter problems either starting the application or connecting to a database, try the following solutions:

2.8 Installing Patch Sets

When available, you can download the latest patch sets for 10g Release 3 (10.1.3) from OracleMetaLink at:

http://metalink.oracle.com

OracleMetaLink is the Oracle Support Services site where customers can get information about released patches and outstanding bugs.