Oracle Application Server TopLink Getting Started Guide 10g (9.0.4) Part Number B10315-01 |
|
This chapter includes the following information to install Oracle Application Server TopLink:
The Oracle Universal Installer for OracleAS TopLink provides four different installation types. The installation types is a pre-defined component set within the Oracle Universal Installer that automatically selects which components to install. The Installation types that appear in the Oracle Universal Installer screen depend on the list that the installation developer specified for this particular product.
The four installation types include:
This option installs the entire product, including OracleAS TopLink Foundation Library, OracleAS TopLink Mapping Workbench, OracleAS TopLink Sessions Editor and OracleAS TopLink Examples.
This option installs the OracleAS TopLink Foundation Library, OracleAS TopLink Mapping Workbench and OracleAS TopLink Sessions Editor.
This option installs the OracleAS TopLink Foundation Library for development without the OracleAS TopLink Mapping Workbench and OracleAS TopLink Sessions Editor.
This option installs only the packaged runtime classes.
Use the following procedures to install OracleAS TopLink (including the OracleAS TopLink Foundation Library and OracleAS TopLink Mapping Workbench). Before you install OracleAS TopLink, back up all existing project data.
Note: If you are upgrading from a version previous to Release 2 (9.0.3), you must convert the package names before you open your OracleAS TopLink project(s) in 10g (9.0.4). Refer to "Package Rename" for more information. |
To start the Oracle Universal Installer and install OracleAS TopLink on a Windows Operating System, proceed as follows:
JDBC_CLASSPATH
variable in the <ORACLE_HOME>
\toplink\bin\setenv.cmd
file. The JDBC_CLASSPATH
variable must specify the path to the preferred JDBC driver(s).
Caution: 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, see the Oracle Application Server TopLink Mapping Workbench User's Guide. |
<ORACLE_HOME>
\toplink\doc\index.htm
for the latest Oracle Application Server TopLink Release Notes.
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.
\Stage\Response
directory and select the oracle.toplink.
Installation_Type
.rsp
file.
oracle.toplink.
Installation_Type
.rsp
file to a temp folder.
oracle.toplink.
Installation_Type
.rsp
file:
ORACLE_HOME
ORACLE_HOME_NAME
FROM_LOCATION
setup.exe -responseFile
C:\temp\oracle.toplink.
Installation_Type
.rsp -silent
and press Enter.
silentInstall.log
file contains the following line:
"The installation of OracleAS TopLink was successful."
To start the Oracle Universal Installer and install OracleAS TopLink on UNIX or other non-Windows Operating System, proceed as follows:
JDBC_CLASSPATH
variable in the setenv.sh
file. The JDBC_CLASSPATH
variable must specify the path to the preferred JDBC driver(s).
You can find the setenv.sh
file in the <ORACLE_HOME>
/toplink/bin
directory.
Caution: 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, see the Oracle Application Server TopLink Mapping Workbench User's Guide. |
<ORACLE_HOME>
/toplink/doc/index.htm
for the latest Oracle Application Server TopLink Release Notes.
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.
/Stage/Response
directory and select the oracle.toplink.Installation_Type.rsp
file.
oracle.toplink.Installation_Type.rsp
file to a tmp folder.
oracle.toplink.Installation_Type.rsp
file:
ORACLE_HOME
ORACLE_HOME_NAME
GROUP_NAME
FROM_LOCATION
./runInstaller -responseFile /tmp/oracle.toplink.
Installation_Type
.rsp -silent
and press Enter.
silentInstall.log
file contains the following line:
"The installation of OracleAS TopLink was successful."
The complete OracleAS TopLink installation includes the OracleAS TopLink Examples. These examples help users explore and learn about 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: application server and OracleAS TopLink Foundation Library (non-server) examples.
When you run the examples, useful information is written to standard out, including details about what the example is doing and what SQL is generated. You may find it useful to redirect standard out 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. For more information on how to run and configure the examples, see Configuring the Examples at <ORACLE_HOME>
\toplink\doc\examples\config\config.htm
.
When configuration is complete, each of the OracleAS TopLink Examples has a ReadMe file with specific information on how to build and run the example.
This section contains information on how to configure OracleAS TopLink for Oracle JDeveloper.
Oracle JDeveloper is a J2EE development environment with end-to-end support to develop, debug, and deploy e-business applications and Web Services.
When you use OracleAS TopLink with Oracle JDeveloper, use the following procedures to add the OracleAS TopLink JAR files to your JDeveloper projects:
The Project Settings pane appears.
A list of pre-defined and user-defined libraries appears.
.jar
files.
The New Library dialog box appears.
Ensure that the default choice for Libraries remains as User Libraries.
.jar
files, click the Edit button.
Add the following to the beginning of your Class Path:
<ORACLE_HOME>
\toplink\jlib\toplink.jar<ORACLE_HOME>
\toplink\jlib\antlr.jar
<ORACLE_HOME>
\lib\xmlparserv2.jar
After a user library is created, it can be re-referenced by any other project. Revisit the Libraries window of the Project Settings, and add the OracleAS TopLink Library to any project with which you want to use OracleAS TopLink.
On a Windows-based platform, OracleAS TopLink includes the Java Runtime Environment 1.4.2 from Sun Microsystems for use by the OracleAS TopLink Mapping Workbench.
To configure OracleAS TopLink for a different version of the JRE, change the setenv.cmd
to point JRE_HOME
to the alternate directory.
At runtime, the OracleAS TopLink Foundation Library requires a JVM compatible with JDK 1.3 or higher.
To compile and run the OracleAS TopLink Examples, you must have a Java 2 SDK installed. For more information on how to configure and run the OracleAS TopLink Examples, see "Configuring the OracleAS TopLink Examples".
The OracleAS TopLink Mapping Workbench and OracleAS TopLink Sessions Editor use JCE to encrypt database login information. JCE is included with JDK 1.4. If you use JDK 1.3.1 or higher, select one of the following options:
http://java.sun.com/products/jce/
.
After you install OracleAS TopLink, if you encounter problems either starting the application or connecting to a database, try the following solutions:
.dll
files your driver requires.
The 10g (9.0.4) release includes changes introduced in previously released patch sets for Release 2 (9.0.3.), namely:
When available, you can download the latest patch sets for 10g (9.0.4) from OracleMetaLink at
OracleMetaLink is the Oracle Support Services site where customers can get information about released patches and outstanding bugs.
|
![]() Copyright © 2000, 2003 Oracle Corporation. All Rights Reserved. |
|