Skip Headers

Oracle® Application Server TopLink Getting Started Guide
10g (9.0.4.5) for hp HP-UX Itanium, and Linux Itanium
Part No. B15872-01
  Go To Documentation Library
Home
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

2 Installing and Configuring OracleAS TopLink

This chapter contains information about installing OracleAS TopLink. It contains the following topics:

2.1 OracleAS TopLink Installation Types

The Oracle Universal Installer (OUI) for OracleAS TopLink provides four different installation types. Each installation type is a predefined component set within the OUI that automatically selects the components to install. The installation types that appear on the OUI screen depend on the list that the installation developer specifies for the product.

The four installation types are as follows:

2.2 Installing OracleAS TopLink

This section describes the procedures to install OracleAS TopLink including the OracleAS TopLink Foundation Library and OracleAS TopLink Mapping Workbench.

This section contains the following topics:


Note:

Before installing OracleAS TopLink, back up the existing project data.

2.2.1 Setting the Mount Point

The Oracle Application Server CD-ROMs are in RockRidge format. To manually mount or unmount the disk, you must have root privileges. Be sure to unmount the disk before removing it from the drive.

To mount the first disk, log in as the root user and follow the steps in one of the following sections, depending on your platform:

Mounting the First Disk on HP-UX

To mount the first disk, follow these steps:

  1. Insert Oracle Application Server disk 1 into the disk drive.

  2. Create the /SD_CDROM directory if it does not already exist:

    # /usr/bin/mkdir /SD_CDROM
    
    
  3. To mount the disk, enter a command similar to the following:

    # /usr/sbin/mount -F cdfs -o rr /dev/dsk/cxdytz /SD_CDROM
    
    

    In the preceding example, /SD_CDROM is the disk mount point directory and /dev/dsk/cxdytz is the device name for the disk device, for example /dev/dsk/c0d2t0.

Mounting the First Disk on Linux

On most Linux systems, the disk mounts automatically when you insert it into the disk drive. To mount the first disk, follow these steps:

  1. Insert Oracle Application Server disk 1 into the disk drive.

  2. To verify that the disk mounted automatically, enter the following command:

    • Red Hat:

      # ls /mnt/cdrom
      
      
    • SUSE Linux Enterprise Server:

      # ls /media/cdrom
      
      
  3. If the command in step 2 fails to display the contents of the disk, enter the following command:

    • Red Hat:

      # mount -t iso9660 /dev/cdrom /mnt/cdrom
      
      
    • SUSE Linux Enterprise Server:

      # mount -t iso9660 /dev/cdrom /media/cdrom
      

2.2.2 Starting the Installer

  1. If the computer does not mount CD-ROMs automatically, you need to set the mount point manually. See Section 2.2.1, "Setting the Mount Point" for details.

  2. Log in as the oracle user.

  3. Insert Oracle Application Server Disk 1 into the CD-ROM drive.

  4. Run the Oracle Universal Installer using the command shown after the notes:


    Notes:

    • Be sure 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 Oracle Application Server.

    • Do not start the installation inside the mount_point directory. If you do, then you may not be able to eject the installation disk. The cd command changes your current directory to your home directory.

    • The Oracle Universal Installer cannot display Korean or Chinese fonts on Linux systems because the JDK does not support these fonts.


    • For HP-UX and Linux:

      CD-ROM users:

      prompt> cd
      prompt> mount_point/runInstaller
      
      

      This launches Oracle Universal Installer, through which you can install Oracle Application Server.

2.2.3 Installing OracleAS TopLink

To start the OUI and install OracleAS TopLink:

  1. Mount the disk as described in Section 2.2.1, "Setting the Mount Point"


    Note:

    When you configure OracleAS TopLink for use with (Java 2 Platform, Enterprise Edition) J2EE containers, you need to modify the system variables, not the User Variables.

    Java package names are case-sensitive.


  2. Start the installer as described in Section 2.2.2, "Starting the Installer".

    The Oracle Universal Installer Welcome screen is displayed as shown in Figure 2-1. It provides information about the OUI.

    Figure 2-1 Oracle Universal Installer Welcome Screen

    Description of welcome.jpg follows
    Description of the illustration welcome.jpg

  3. Click Next. The Specify File Locations screen is displayed.

  4. Enter the following information in the fields provided:

    1. Source Path: The default value is displayed. Do not change this value.

    2. Destination Name: Enter the required Oracle home name.

    3. Destination Path: Browse or enter the path to the directory where you want to install the Oracle Application Server Middle Tier.

  5. Click Next. The Select Installation Type screen is displayed as shown in Figure 2-2.

    Figure 2-2 Select Installation Type Screen

    Description of install_type.jpg follows
    Description of the illustration install_type.jpg

  6. Select Complete to install the entire package. The other options available on the screen allow you to perform a partial install. The products that can be installed are mentioned with the options.

  7. Click Next. The Summary screen is displayed.

  8. After reviewing the Summary screen, click Install. This completes the installation and displaying the End of Installation screen as shown in Figure 2-3.

    Figure 2-3 End of Installation Screen

    Description of end_of_install.jpg follows
    Description of the illustration end_of_install.jpg

  9. Click Exit and then click Yes. This completes the installation.

  10. When the installation is complete, verify and if necessary, edit the JDBC_CLASSPATH variable in the ORACLE_HOME\toplink\bin\setenv.sh file. The JDBC_CLASSPATH variable must specify the path to the preferred JDBC drivers.


    Note:

    The JDBC_CLASSPATH variable must not include any Java classes for your persistent business objects that are specified in an OracleAS TopLink Mapping Workbench project. Paths for persistent business objects are set within an OracleAS TopLink Mapping Workbench project.

    For more information on how to set up a path for a project, refer to Oracle Application Server TopLink Mapping Workbench User's Guide.



    See Also:

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

2.2.4 Performing Silent Installation

The silent installation mode is available for all installation types. You can make use of 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.

To perform a silent installation:

  1. Insert the OracleAS TopLink installation disc into the CD-ROM drive.

  2. Open the /Stage/Response directory and select the oracle.toplink.Installation_Type.rsp response file. For example, if you select the Complete installation type, then the response file would be complete.rsp.

  3. Copy the oracle.toplink.Installation_Type.rsp file to a temp folder.

  4. Edit the following parameters in the oracle.toplink.Installation_Type.rsp file:

    • ORACLE_HOME

    • ORACLE_HOME_NAME

  5. Enter the following command:

    prompt> runInstaller -silent -responseFile absolute_path_and_filename
    
    
  6. If your installation is successful, then the log file for the silent installation will contain the following line:

    The installation of OracleAS TopLink was successful.

2.3 Configuring the OracleAS TopLink Examples

The complete OracleAS TopLink installation includes the OracleAS TopLink examples. These examples help you explore and learn how to use the OracleAS TopLink features with different architectures and different technologies. They are designed to be as simple as possible while still effectively demonstrating the target architecture, technology, or feature.

There are two types of examples, Oracle Application Server and OracleAS TopLink Foundation Library (non-server) examples.

When you run the examples, useful information is written to standard output, including details about what the example is doing and what SQL is generated. You may find it useful to redirect standard output to a file when you run an example.

Although the OracleAS TopLink examples require little configuration, ensure that you read and verify the configuration details included in the Configuring the Examples document before you run the examples.


See Also:

Configuring the Examples document, which can be accessed at ORACLE_HOME/toplink/doc/examples/config/config.htm

When the configuration is complete, each of the OracleAS TopLink examples has a readme file with specific information on how to build and run the example.

2.4 JDK and JRE

On HP-UX Itanium and Linux Itanium platforms, OracleAS TopLink includes the Java Runtime Environment (JRE) 1.4.2. OracleAS TopLink is certified with JRE 1.4.2.05 for HP-UX Itanium systems, and with JRE 1.4.2.04 for Linux Itanium systems, for use by the OracleAS TopLink Mapping Workbench. .

To configure OracleAS TopLink for a different version of the JRE, change the setenv.sh file to point JRE_HOME to the alternate directory.

At run time, the OracleAS TopLink Foundation Library requires a JVM compatible with JDK 1.4.2 or later.

To compile and run the OracleAS TopLink Examples, you must have a Java 2 SDK installed.


See Also:

Section 2.3, "Configuring the OracleAS TopLink Examples" for more information about how to configure and run the OracleAS TopLink Examples

JCE

The OracleAS TopLink Mapping Workbench and OracleAS TopLink Sessions Editor use Java Cryptography Extension (JCE) to encrypt database login information. JCE is included with JDK 1.4.2. If you use JDK 1.4.2 or higher, then select one of the following options:

2.5 General Troubleshooting

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