Skip Headers

Oracle Content Management Software Development Kit (Oracle CM SDK) Installation Guide
Release 9.0.3 for Windows NT/2000

Part Number B10053-01
Go To Table Of Contents
Contents
Go To Index
Index

Go to previous page Go to next page

2
Requirements

This chapter provides information about system hardware and software requirements and how to prepare your system with the necessary Oracle software. Topics in this chapter include:

For additional information about any of the requirements or pre-installation steps involving Oracle9i Application Server, or components such as Oracle Internet Directory, see the appropriate guide from those listed under "Related Documents" in the Preface.

Hardware Requirements

Table 2-1 requirements are based on using the Oracle9i Application Server, A. J2EE and Web Cache installation type from the Oracle9i Application Server, Release 2 CD.

Table 2-1 Minimum Hardware Requirements
Single Machine Deployment for Developers Only Multiple Machine Deployment for Production Environment

Machines required

1

2

Oracle Content Management SDK users supported

2 concurrent users

50 concurrent users

Machine 1:

CPUs

Not applicable.

2 (which includes 1 CPU for Oracle Text indexing)

RAM, disk, and swap space

Not applicable.

See Oracle9i Database Server Installation Guide and Release Notes for requirements for the database machine.

Machine 2:

Not applicable.

To use Oracle Internet Directory, you must install and configure Oracle Internet Directory on a separate database instance (using the Oracle9iAS, Infrastructure install type from the Oracle9i Application Server, Release 2 CD) on a separate machine. See "Using Oracle9iAS, Infrastructure and Oracle Internet Directory" for more information.

Machine 3:

Number of CPUs

1 (add 1 CPU if Oracle Text is being used for indexing)

1

Minimum processor type

Intel Pentium III, 500-Mhz (or higher)

Intel Pentium III, 800-Mhz (or higher)

RAM

1 gigabyte

2 gigabyte

Hard-disk drive space and swap space

7 gigabytes minimum total free hard-disk drive space required, which includes 5 gigabytes of space required by the Oracle database and Oracle9i Application Server, A. J2EE and Web Cache installation type, and 2 gigabytes of swap space.

3 gigabytes minimum total free hard-disk drive space required, which includes 1 gigabyte of space required by Oracle9i Application Server, A. J2EE and Web Cache installation type, and 2 gigabytes of swap space

The hardware requirements for "Multiple Machine Deployment for Production Environment" support a workgroup of about 50 Oracle Content Management SDK users accessing all protocols moderately. The hardware requirements for "Single Machine Deployment for Developers Only" are not intended for production deployments, but can support approximately two Oracle CM SDK users accessing two protocols concurrently.

Table 2-1 does not include requirements for Oracle Internet Directory. If you want to use Oracle Internet Directory for Oracle CM SDK credential management, it is recommended that you install, configure, and run it on a completely separate machine (although if your machine is powerful enough, it is possible to run Oracle CM SDK in an iAS middle tier Oracle home and Oracle Internet Directory in an iAS infrastructure Oracle home on the same machine). See "Deployment Configuration Options and Requirements" in this chapter for more information.

Operating System Requirements

Oracle CM SDK requires Windows NT Server 4 (Service Pack 6a or higher) or Windows 2000 Professional or Server (Service Pack 2 or higher).

See the Oracle9i Application Server Installation Guide for additional service pack requirements.

Oracle Database Requirements and Recommendations

To use an Oracle9i Database Server, Release 1 (9.0.1) database with Oracle CM SDK release 9.0.3, it is recommended that you create a separate Oracle home for Oracle9i Application Server (Oracle9iAS A, B, or C) on a different machine, and into this Oracle home install and configure Oracle CM SDK (see Chapter 1., Concepts, in the Oracle Content Management SDK Administration Guide for information about Oracle9i Application Server). See "Multiple Machine Deployment for Production Environment" for details.

If you have an existing Oracle production database that you want to use as the database tier for Oracle CM SDK, be sure that it meets these requirements:

Initialization Parameter Requirements

Oracle9i Database Server should be configured using the parameters shown in Table 2-2. (These parameters affect Oracle CM SDK installation and performance.)

Table 2-2 Oracle9i Initialization Parameters
Parameter Minimum Setting or Space Available

java_pool_size

30 MB

open_cursors

300

processes

100

session_max_open_files

50

shared_pool_size

50 MB (52428800 bytes)

To check the value of the parameters, connect to the database using SQL*Plus and query the v$parameter view, as follows:

prompt>ORACLE_HOME\bin\sqlplus /nolog 
SQL>connect sys/sys_password as sysdba;
Connected.
SQL>SELECT name, value FROM v$parameter WHERE name = 'processes';

The value of the processes parameter displays. Repeat the command above, replacing the word processes with the appropriate parameter name to check the other parameter values as listed in Table 2-2.

If you need to change any parameters, be aware that initialization parameter settings are managed differently in Oracle9i than in prior releases. See the Oracle9i Database Administrator's Guide for your release for specific instructions before attempting to change any settings.

Oracle JVM Option ("JServer") Requirement

The Oracle CM SDK configuration will fail if the Oracle JVM option (also known as "JServer") is not installed and running in the database. The simplest way to verify that the Oracle JVM option exists is to connect to the database instance using SQL*Plus and run this query:

prompt>ORACLE_HOME\bin\sqlplus /nolog 
SQL>connect sys/sys_password as sysdba;
Connected.
SQL>select count(*) from all_objects where object_name = 'DBMS_JAVA';

Example 2-1 The query should return a count of 3, as shown in the sample below. If it does not, JServer is not installed, and the Oracle Content Management SDK configuration will fail.

  COUNT(*)
----------
         3

See the Oracle9i Installation Guide for information about correctly installing the database with this option.

Oracle Software Requirements

Oracle CM SDK requires an Oracle home, based on Oracle9i Application Server release 9.0.2.0.1.

Oracle Home Requirement

Oracle CM SDK requires an Oracle home based on Oracle9i Application Server (9.0.2.0.1) software, specifically using one of these install types:

Oracle recommends using the Oracle9i Application Server, A. J2EE and Web Cache installation type for the middle-tier supporting Oracle CM SDK. Unlike the other two installation types (B and C), the Oracle9i Application Server, A. J2EE and Web Cache installation type does not require Oracle9iAS, Infrastructure, if you don't need to use Oracle Internet Directory.

The Oracle9iAS, Infrastructure creates an Oracle database and installs a Metadata Repository for the Oracle9iAS instance; Oracle9iAS, Infrastructure also includes Oracle Internet Directory. If you want to use Oracle Internet Directory for user credential management, you must install and configure Oracle9iAS, Infrastructure on a separate machine (although if your machine is powerful enough, it is possible to run Oracle CM SDK in an iAS middle tier Oracle home and Oracle Internet Directory in an iAS infrastructure Oracle home on the same machine).

See "Deployment Configuration Options and Requirements" for additional recommendations.

Deployment Configuration Options and Requirements

In a production environment, Oracle recommends that you deploy Oracle CM SDK and Oracle9i Application Server according to these guidelines:

See the Oracle9i Application Server Installation Guide for complete information.

Using Oracle9iAS, Infrastructure and Oracle Internet Directory

Oracle CM SDK does not require Oracle9iAS, Infrastructure unless you want to use Oracle Internet Directory. If you do want to use Oracle Internet Directory with Oracle CM SDK, follow these guidelines:

See the Oracle9i Application Server Installation Guide and Oracle Internet Directory Administrator's Guide for additional recommendations and requirements.

Multiple Machine Deployment for Production Environment

Oracle CM SDK is designed to run as middle-tier application server software supported by Oracle9i Application Server. For optimal performance, the tiers should be located on different physical machines: specifically, the database should run on one machine, the Oracle9i Application Server and Oracle CM SDK software should run on another machine.

To use Oracle Internet Directory for managing Oracle CM SDK user credentials, you must also install and configure Oracle9iAS, Infrastructure on a third machine that meets the requirements for running Oracle Internet Directory and Oracle9iAS, Infrastructure. See the Oracle9i Application Server Administrator's Guide for more information.

Here's an overview of the process.

Database Tier [Machine 1 in Table 2-1]:

You must use Oracle9i 9.0.1.x (or higher) database for the database tier. Your database instance must meet the requirements listed in "Oracle Database Requirements and Recommendations".

To create a new database, see Appendix A, "Creating an Oracle Database" for settings.

Oracle iAS Infrastructure Tier [Machine 2 in Table 2-1]:

  1. Install and configure Oracle9iAS, Infrastructure.

  2. Configure Oracle Internet Directory if you plan to use it for authentication of Oracle CM SDK users (and any other Oracle applications as well).

Note: Detailed requirements information regarding this machine does not appear in Table 2-1, "Minimum Hardware Requirements."

Application Server Tier [Machine 3 in Table 2-1]:

  1. Install and configure Oracle9iAS (Type A, B, or C), Release 2. Oracle recommends using Oracle9iAS, Type A. J2EE and Web Cache.

Into this same Oracle home where the Oracle9iAS (Type A, B, or C) is configured, install and configure Oracle CM SDK. During configuration, select Create a new Oracle CM SDK domain, using the database instance on the Database Tier.


Note:

If you select "Oracle9iAS Infrastructure Use" during Oracle9iAS (Type A, B, or C) configuration and identify an Oracle Internet Directory instance, the Oracle Internet Directory must be available when you run the ifsca tool.


Single Machine Deployment for Developers Only

Oracle CM SDK can be installed on a single machine if the machine meets all hardware and software requirements. Oracle supports single machine deployment for development purposes only, or to evaluate the product in pre-production environment, because performance in this configuration can be less than satisfactory.

  1. Install and configure the Oracle9i Database Server (release 9.0.1 or higher) into one Oracle home.

  2. Install and configure Oracle9iAS, Type A. J2EE and Web Cache into a new, separate Oracle home, accepting all the defaults.

  3. Install Oracle CM SDK in the same Oracle home that contains Oracle9iAS.

  4. Be sure to copy over any custom classes from a previous Oracle 9iFS install to the following directory:

     ORACLE_HOME\ifs\cmsdk\custom_classes
    
    
  5. Using Oracle CM SDK Configuration Assistant, configure Oracle CM SDK following the instructions in Chapter 3, "Installation and Configuration".

If you want to use Oracle Internet Directory for Oracle CM SDK in this single machine configuration, you must do so on a second machine, using Oracle9i Application Server, Infrastructure.

Upgrade Requirements and Process Overview

The process for upgrading an existing Oracle Internet File System to Oracle CM SDK depends on the release you are attempting to upgrade from, and on the release number of the Oracle database. Oracle CM SDK requires:

Each product must be in its own Oracle home. In addition, because of the respective resource requirements of each of these platforms, Oracle CM SDK typically requires multiple-machine deployment for production environments. Table 2-3 summarizes the process for several different Oracle Internet File System releases.

Table 2-3 Overview of Steps for Various Upgrade Paths
Release Number Process Summary

Oracle Internet File System 1.1.x

  1. Upgrade the database to at least Oracle9i Database Server Release 9.0.1.

  2. Use the Oracle Database Migration Assistant to migrate the pre-9.0.1 database instance (includes the Oracle Internet File System schema and all contents) to the new database instance.

  3. Install and configure Oracle9i Application Server (release 9.0.2) in a different Oracle home (preferably on a different machine).

  4. Install Oracle CM SDK into the Oracle9i Application Server-based Oracle home.

  5. Copy over any custom classes from your old Oracle Internet File System 1.1.x installation to the following directory:

    ORACLE_HOME\ifs\cmsdk\custom_classes
    
  6. Upgrade to and configure Oracle CM SDK using the Configuration Assistant.

Oracle Internet File System 9.0.1

  1. Install and configure Oracle9i Application Server (release 9.0.2) in a different Oracle home (preferably on a different machine).

  2. Install Oracle CM SDK into the Oracle9i Application Server-based Oracle home.

  3. Copy over any custom classes from your old Oracle Internet File System 9.0.1 installation to the following directory:

    ORACLE_HOME\ifs\cmsdk\custom_classes
    
  4. Upgrade to and configure Oracle CM SDK using the Configuration Assistant.

Oracle Internet File System 9.0.2

  1. Install Oracle CM SDK into the Oracle9i Application Server-based Oracle home.

  2. Copy over any custom classes from your old Oracle 9iFS installation to the following directory:

    ORACLE_HOME\ifs\cmsdk\custom_classes
    
  3. Upgrade to and configure Oracle CM SDK using the Configuration Assistant.

To use an existing Oracle database instance, see the "Oracle Database Requirements and Recommendations" to ensure your instance meets all requirements.


Go to previous page Go to next page
Oracle
Copyright © 1999, 2002 Oracle Corporation.

All Rights Reserved.
Go To Table Of Contents
Contents
Go To Index
Index