1
Before You Install

This chapter includes the following information that you should review before you install Oracle Application Server TopLink:

System and Product Requirements

Your system must meet the following minimum requirements:

Operating System

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

Windows 2000
Windows NT 4.0 (Service Pack 6) or newer
Any fully Java-compatible UNIX operating system (Solaris)

Hardware Requirements

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

Pentium class processor running at a minimum of 300 MHz
192 MB of random access memory (RAM)
128 MB free on your hard drive

Product Requirements

OracleAS TopLink requires a Java Virtual Machine (JVM) compatible with JDK 1.3 or higher.

OracleAS TopLink Examples

The OracleAS TopLink complete installation option 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 JDBC (Java Database Connectivity) compliant database. OracleAS TopLink supports JDBC 2.0 drivers that comply with JDBC's 2.0 object-relational extensions. Contact your database and JDBC vendor to determine which object-relational extensions they support.

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

getTables ( )
getTablesTypes ( )
getImportedKeys ( )
getCatalogs ( )
getPrimaryKeys ( )

License Information

OracleAS TopLink does not require a license file for the OracleAS TopLink Foundation Library 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 APIs as part of an end-user application. Refer to the software license agreement for information about the limitations on including the Oracle Application Server TopLink Foundation Library JAR files, as part of a packaged end-user application.

Licensing information is available at

http://oraclestore.oracle.com

Third-Party License Information

OracleAS TopLink uses the following software:

Apache Ant v 1.5.1

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

This program contains third-party code from the Apache Software Foundation ("Apache"). Under the terms of the Apache license, Oracle is required to provide the following notices. Note, however, that the Oracle program license that accompanied this product determines your right to use the Oracle program, including the Apache software, and the terms contained in the following notices do not change those rights.

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 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.
 *
 * 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 v 2.7.0

http://www.antlr.org

OracleAS TopLink uses ANTLR for EJB QL parsing. Antlr (ANother Tool for Language Recognition), 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 is fully in the public domain.

DOM

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

The Document Object Model (DOM) is a specification that defines some programming language-neutral interfaces that can be used to manipulate XML and HTML documents. W3C maintains this specification. W3C 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 World Wide Web Consortium ("W3C"). Under the terms of the W3C license, Oracle is required to provide the following notices. Note, however, that the Oracle program license that accompanied 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.

This work (and included software, documentation such as READMEs, 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 following 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, 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 at all times remain with copyright holders.

Java Runtime Environment v 1.4.1

http://java.sun.com/j2se/1.4.1

The Java Runtime Environment is maintained by Sun Microsystems, Inc. The OracleAS TopLink Mapping Workbench runs in a Windows JDK 1.4.1 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.

Certification Information

The latest certification information for 10g (9.0.4) is available at

http://metalink.oracle.com

1 Before You Install