Skip Headers
Oracle® Application Server TopLink Getting Started Guide
10g Release 2 (10.1.2)
Part No. B15902-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
 

1 Prerequisites for Installing OracleAS TopLink

This chapter provides information that you should review before installing Oracle Application Server TopLink (OracleAS TopLink). It contains the following topics:

System and Product Requirements

Your computer must meet the following minimum system requirements:

Operating System

OracleAS TopLink will run on any of the following operating systems:

Hardware Requirements

Although OracleAS TopLink hardware requirements are generally less than the requirements for Java or common database applications, your computer should meet the following minimum guidelines:

Product Requirements

OracleAS TopLink requires a Java Virtual Machine (JVM) compatible with Java Development Kit (JDK) 1.4.2. OracleAS TopLink is certified with Sun JDK 1.4.2._06.

OracleAS TopLink Examples

The complete installation of OracleAS TopLink includes examples that require a Java 2 SDK to compile and run.

Supported Databases

OracleAS TopLink is an infrastructure-based solution that simplifies the integration of Java objects to any Java Database Connectivity (JDBC) compliant database. OracleAS TopLink supports JDBC 2.0 drivers that comply with JDBC 2.0 object-relational extensions. Contact your database and JDBC vendor to determine which object-relational extensions they support.

To enable Oracle Application Server TopLink Mapping Workbench to retrieve table information from the database, the database driver must support the following JDBC methods:

License Information

OracleAS TopLink does not require a license file for the Oracle Application Server TopLink or the OracleAS TopLink Mapping Workbench. However, you are not allowed to ship the OracleAS TopLink Mapping Workbench or expose any of the OracleAS TopLink Application Programming Interface (API) as part of an end-user application. Refer to the software license agreement for information about the limitations on including the OracleAS TopLink Foundation Library JAR files, as a part of a packaged end-user application.

Licensing information is available at the following link:

http://oraclestore.oracle.com

Third-Party License Information

OracleAS TopLink uses the following software:

Apache Ant version 1.5.1

Apache Ant contains third-party code from the Apache Software Foundation (Apache). Under the terms of the Apache license, Oracle is required to provide the following license notice:


Note:

The Oracle program license that accompanies this product determines your right to use the Oracle program, including the Apache software, and the terms contained in the notices do not change those rights.

The license information about Apache Ant is available at

http://jakarta.apache.org/ant/index.html

The Apache Software License

/* ====================================================================
 * The Apache Software License, Version 1.1
 *
 * Copyright (c) 2000-2003 The Apache Software Foundation.  All rights
 * reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the preceding copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the preceding copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *
 * 3. The end-user documentation included with the redistribution,
 *    if any, must include the following acknowledgment:
 *       "This product includes software developed by the
 *        Apache Software Foundation (http://www.apache.org/)."
 *    Alternately, this acknowledgment may appear in the software itself,
 *    if and wherever such third-party acknowledgments normally appear.
 *
 * 4. The names "Apache" and "Apache Software Foundation" must
 *    not be used to endorse or promote products derived from this
 *    software without prior written permission. For written
 *    permission, please contact apache@apache.org.
 *
 * 5. Products derived from this software may not be called "Apache",
 *    nor may "Apache" appear in their name, without prior written
 *    permission of the Apache Software Foundation.
 *
 * THIS SOFTWARE IS PROVIDED ''AS IS'' AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * ====================================================================
 *
 * This software consists of voluntary contributions made by many
 * individuals on behalf of the Apache Software Foundation.  For more
 * information on the Apache Software Foundation, please see
 * <http://www.apache.org/>.
 *
 * Portions of this software are based upon public domain software
 * originally written at the National Center for Supercomputing
Applications,
 * University of Illinois, Urbana-Champaign.
 */

Antlr version 2.7.0

OracleAS TopLink uses Another Tool for Language Recognition (Antlr) version 2.7.0 for EJB QL parsing. Antlr is a language tool that provides a framework for constructing recognizers, compilers, and translators from grammatical descriptions containing C++ or Java actions. The Antlr parser and translator generator are fully in the public domain.

The license information about Antlr version 2.7.0 is available at

http://www.antlr.org/rights.html

DOM

Document Object Model (DOM) is a specification that defines some programming language-neutral interfaces that can be used to manipulate XML and HTML documents. World Wide Web Consortium (W3C) maintains this specification. It also provides a Java binding for these interfaces. OracleAS TopLink uses this binding to parse and manipulate XML documents.

This program contains third-party code from the W3C. Under the terms of the W3C license, Oracle is required to provide the following notices.


Note:

The Oracle program license that accompanies this product determines your right to use the Oracle program, including the W3C software, and the terms contained in the following notices do not change those rights.

The license information about DOM is available at

http://www.w3.org/Consortium/Legal/copyright-software.html

This work (and included software, documentation such as readme files, or other related items) is being provided by the copyright holders under the following license. By obtaining, using, and/or copying this work, you (the licensee) agree that you have read, understood, and will comply with the terms and conditions.
Permission to copy, modify, and distribute this software and its documentation, with or without modification, for any purpose and without fee or royalty is hereby granted, provided that you include the following on all copies of the software and documentation or portions thereof, including modifications:
The full text of this NOTICE in a location viewable to users of the redistributed or derivative work. 
Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, the W3C Software Short Notice (http://www.w3.org/Consortium/Legal/2002/copyright-software-short-notice-20021231.html) should be included (hypertext is preferred and text is permitted) within the body of any redistributed or derivative code.
Notice of any changes or modifications to the files, including the date changes were made. (We recommend you provide URLs to the location from which the code is derived.) 
THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.
The name and trademarks of copyright holders may not be used in advertising or publicity pertaining to the software without specific, written prior permission. Title to copyright in this software and any associated documentation will remain with copyright holders all the time.

JRE version 1.4.2

The Java Runtime Environment (JRE) is maintained by Sun Microsystems, Inc. OracleAS TopLink is certified with Sun JDK 1.4.2_06 version. The OracleAS TopLink Mapping Workbench runs in Microsoft Windows JDK 1.4.2 Virtual Machine (VM) by default, and may also be configured to run using other compliant Java 2 VMs. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc., in the U.S. and other countries.

The license information about JRE 1.4.2 is available at

http://java.sun.com/j2se/1.4.2/j2se-1_4_2-thirdpartylicensereadme.txt

A) The following software may be included in this product:
CS CodeViewer v1.0; Use of any of this software is governed
by the terms of the license below:
 
Copyright 1999 by CoolServlets.com.
 
Any errors or suggested improvements to this class can be
reported as instructed on CoolServlets.com. We hope you
enjoy this program... your comments will encourage further
development!  This software is distributed under the terms
of the BSD License.  Redistribution and use in source and
binary forms, with or without modification, are permitted
provided that the following conditions are met:
 
1. Redistributions of source code must retain the above
copyright notice, this list of conditions and the following 
disclaimer.
 
2. Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following 
disclaimer in the documentation and/or other materials 
provided with the distribution.
 
Neither name of CoolServlets.com nor the names of its
contributors may be used to endorse or promote products
derived from this software without specific prior written
permission.
 
THIS SOFTWARE IS PROVIDED BY COOLSERVLETS.COM AND
CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE."
 
 
B) The following software may be included in this product:
DES and 3xDES ; Use of any of this software is governed by
the terms of the license below:
 
"Copyright  2000 by Jef Poskanzer <jef@acme.com>. All
rights reserved.
 
Redistribution and use in source and binary forms, with or
without modification, are permitted provided that the
following conditions are met:
 
1. Redistributions of source code must retain the above
copyright notice, this list of conditions and the following 
disclaimer.
 
2. Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following 
disclaimer in the documentation and/or other materials 
provided with the distribution.
 
THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS
``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGE."

JAWS Screen Reader

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

Due to limitations in JAWS 4.5.1, input field labels in the OracleAS TopLink Mapping Workbench are not read properly. Oracle recommends using JAWS 3.7 and version 103 Access Bridge for maximum accessibility.

Certification Information

The latest certification information for 10g Release 2 (10.1.2) is available at

http://metalink.oracle.com