Oracle9iAS Internet Hosting Kit v 9.0.2.0.0
Release Notes



Latest information can be found on Oracle Technology Network ().
For detailed information on the product, please refer to the whitepaper and the developer's guide.

Table Of Contents:

Preface
i.  Audience
ii.  Support
iii  System Requirements
1. Introduction
2. Installation Instructions
3. Other Topologies.

A.  Accessibility


Preface

i.  Audience

Oracle9iAS Internet Hosting Kit Release Notes is intended for application service providers (ASPs), developers and administrators who want an understanding of Oracle9iAS Internet Hosting Kit installation process and system topologies.


ii.  Support

Support is handled through the following:
  • Send registration information to ihkteam_us@oracle.com. The email should contain the following information:
    • User name (First, Last)
    • email contact and telephone number
    • company name
    • company address
    • brief description of how you plan to use IHK
  • After sending email to register, questions can be posted on the OTN Forum, under Application Server->Internet Hosting Kit (IHK).
  • IHK team will answer the questions on the forum.


iii. System Requirements

  • Oracle9iAS 9.0.2.0.0 Infrastructure
  • Oracle9iAS 9.0.2.0.0 Application Server
  • Solaris OS

  • Installation and System Topologies

    1. Introduction

    Oracle9iAS Internet Hosting Kit(IHK) provides a set of services and guidelines for application service providers (ASPs), independent software vendors (ISVs), and company information technology (IT) staff to develop, deploy, and manage applications in a hosted Web environment.
    • Applications written using Oracle9iAS Internet Hosting Kit are deployed in a J2EE Container.
    • Oracle9iAS Internet Hosting Kit uses Oracle Internet Directory(OID), an LDAP server, to manage its entities.
    • Oracle9iAS Internet Hosting Kit is integrated with Oracle Single Sign-On(SSO).
    The following is the recommended system topology for using Oracle9iAS Internet Hosting Kit:
     
    This image shows the topology of the recommended system


    In this configuration, Oracle9iAS Infrastructure provides the common backend infrastructure necessary for Single Sign-On for authentication and OID, LDAP directory for datastore.

    Oracle9iAS Application Server provides the necessary J2EE environment for hosting web applications.  In addition, different types of Oracle9iAS Application Server install types may be taken advantage of to provide further value (in the diagram above, Oracle9iAS Wireless is shown to provide access to IHK application to mobile devices).  By separating the middle tier from the backend, scalability can also be achieved.  The number of Oracle9iAS Application Server depends on performance requirements.  In this example, we show only two.

    In the installation instructions that follow, we assume the above topology.  Specific configuration instructions (such as configuring SSO for use by IHK) is given in detail in the developer's guide and FAQ(frequently asked questions).  At the end of this document, we will also provide various other topologies that may be used for IHK.



    2. Installation Instructions

    If this is the first time:
    1. Install Oracle9iAS Infrastructure
      • see Oracle9iAS Administrator Guide for details

    For each Oracle9iAS Internet Hosting Kit installation:
    1. Install Oracle9iAS Application Server
      • Install on a different machine from Oracle9iAS Infrastructure
      • Install Type:
        • IHK only requires a J2EE container to run.  Since all install types include J2EE & WebCache, any install type will do.  For example, if you plan to provide wireless access to the web application written in IHK, you may want to choose Portal and Wireless Install Type.
    2. Install Oracle9iAS Internet Hosting Kit on Oracle9iAS Application Server.
      1. Download / Copy "eservices.tar" to $ORACLE_HOME.
      2. Untar eservices.tar
        • tar -xvf eservices.tar
      3. You should have the following directory structure:
        • $ORACLE_HOME/eservices/lib - contains all class libraries for IHK and other dependent products
        • $ORACLE_HOME/eservices/admin - contains all LDAP scripts for IHK LDAP schema
        • $ORACLE_HOME/eservices/config - contains configuration files
        • $ORACLE_HOME/eservices/doc - contains product documentation(developer's guide), Javadoc, FAQ, and Readme(this file)
        • $ORACLE_HOME/eservices/samples - contains the IHK sample Java files
        • $ORACLE_HOME/eservices/log - default directory for event and system logs
    3. Configure Oracle9iAS Internet Hosting Kit
      • Set appropriate classpath and environment variables.  A sample is given in $ORACLE_HOME/eservices/config/setpath.source
      • Edit eservices.properties(change permissions first if necessary: "chmod 644 eservices.properties").  Replace appropriate substitution variables and defaults to correct variables:
        • e.g %ORACLE_HOME%, %s_OIDHost%, %s_OIDPort%, %s_OIDPassword%
      • Run post-installation utility (this relies on LDAP properties in eservices.properties, even if 'useRepositoryAPI=true')
        • java oracle.eserv.hosting.tools.PostInstallUtil
    4. Test installation:
      • Compile and run $ORACLE_HOME/eservices/samples/IHK/IHKSamples.java
      • If, for some reason the samples only run halfway and need to cleanup, run "java ihkclean", located in the same directory.


    3. Other topologies

    The above topology is not the only possible topology.

    Minimal Topology:

    minimal configuration topology using only Oracle9iAS Infrastructure


    The above shows a situation where everything is hosted on a single machine which is running Oracle9iAS Infrastructure.  This is possible because Oracle9iAS Infrastructure does contain a J2EE Container.  However, this does not take advantage of various features offered by the Oracle9iAS Application Server, and it does not scale very well, because all the load is concentrated on a single machine.


    Multiple Infrastructures

    topology showing use of dedicated Oracle9iAS Infrastructure for SSO and OID each

    In this diagram the backend Oracle9iAS Infrastructure is split into a dedicated SSO server and a dedicated LDAP Server, each residing on different machine for performance purposes.


    A.  Accessiblity

    Documentation Accessibility

    Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle Corporation is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/

    Accessibility of Code Examples in Documentation

    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.

    Accessibility of Links to External Web Sites in Documentation

    This documentation may contain links to Web sites of other companies or organizations that Oracle Corporation does not own or control. Oracle Corporation neither evaluates nor makes any representations regarding the accessibility of these Web sites.


    Copyright © 2002 Oracle Corporation. All rights reserved.
    E-mail this page
    Printer View Printer View
    Oracle Is The Information Company About Oracle | Oracle RSS Feeds | Careers | Contact Us | Site Maps | Legal Notices | Terms of Use | Privacy