Copyright (c) Oracle Corporation 1997, 1998. All Rights Reserved.

NAME

README.txt - ORACLE8 IMAGE CARTRIDGE RELEASE INFORMATION

VERSION=8.0.5 README FILE

ORACLE8 IMAGE CARTRIDGE RELEASE INFORMATION

=======================

Contents

=======================

Upgrade Notes

Warnings

Installation Procedures

Installing the Demo

Problems fixed in this release

Features added in this release

Known problems in this release

Upgrade Notes:

=======================

This is the production release for 8.0.5.

Warnings:

=======================

The Image Cartridge is installed under the database user ORDSYS. This

user is created during installation and is subject to change in future

beta or production releases.

THE FUNCTIONS, PACKAGES AND TYPES SUPPLIED BY THIS PACKAGE AND ITS EXTERNAL

INTERFACE ARE RESERVED BY ORACLE AND ARE SUBJECT TO CHANGE IN FUTURE RELEASES.

THIS PACKAGE MUST NOT BE MODIFIED BY THE CUSTOMER. DOING SO

COULD CAUSE INTERNAL ERRORS AND SECURITY VIOLATIONS IN THE DBMS.

If you created database objects during the installation of the Image

Cartridge, the password for the ORDSYS user may have been written to the log

file. This will happen if you attempt to re-install the image cartridge

database objects more than one time. Please check your installation log files.

=======================

Getting Started

===============

Oracle8 Image Cartridge Production Release 8.0.5

================================================

Provides for the storage, retrieval, and processing of two dimensional,

static bit-mapped images. Images are stored efficiently using popular

compression schemes in industry standard desktop publishing image

interchange formats.

Oracle8 Image Cartridge Documentation

=====================================

Complete online documentation is available on the documentation CD that

shipped with the Oracle8 server.

Installing Oracle8 Image Cartridge

==================================

Prior to installing Oracle8 Image Cartridge, you must first install the

Oracle8 Server. If you installed Oracle8 Image Cartridge during the

same installation as Oracle8 Server, you do not have to perform the

procedures in this section; Oracle8 Image Cartridge was automatically

configured for you.

Oracle8 Image Cartridge is an extension of Oracle8 Enterprise Edition

that provides image storage, retrieval, and format conversion capabilities

through an object data type (ODT).

1 Installation Decisions

2 Pre-Installation Steps

3 Installation Steps

4 Installation Details

1 Installation Decisions

------------------------

During the installation process you you need to create the ORDSYS user.

This user ID is the standard Oracle database account with special

privileges for data cartridges.

Decision: Decide on a password for the ORDSYS user.

The default password for the ORDSYS user during automatic installation is

'ORDSYS'.

2 Pre-Installation Steps

------------------------

Perform the following pre-installation tasks prior to installing

Oracle8 data cartridges. For instructions, please see the Oracle8

Installation and Configuration Guide for your operating system:

2.1 Install the Oracle8 Server, including the PL/SQL option

and the objects option.

2.2 Create the database.

2.3 Start up the database.

3 Installation Steps

--------------------

Perform the following mandatory installation steps. Remember, you

only need to do this if you are manually installing the cartridge.

3.1 Install the non-database components for the Oracle8 Image Cartridge,

using the Oracle Installer.

3.2 Create the ORDSYS account.

Start Server Manager.

-> C:> svrmgr30

Connect to the database with the INTERNAL password:

-> SVRMGR> connect internal

Create the ORDSYS account. Use the password you gave in Section 1.

-> SVRMGR> create user ORDSYS identified by <ORDSYS password>;

3.3 Grant privileges to the ORDSYS account.

Grant the following privileges to the ORDSYS account:

-> SVRMGR> grant connect,resource,create library to ORDSYS;

3.4 Create the image library.

-> SVRMGR> connect ORDSYS/<ORDSYS password>

Create the library:

-> SVRMGR> create or replace library ORDImgLibS as

'<ORACLE_HOME>\bin\ordimg80.dll';

where <ORACLE_HOME> is the ORACLE_HOME directory.

Note: The exact name of this library is operating system dependent.

See the installation and configuration guide for your operating

system for the exact file name.

3.5 Create the Image Cartridge.

-> SVRMGR> connect ORDSYS/<ORDSYS password>

Create the Image Cartridge:

-> SVRMGR> @%ORACLE_HOME%\ord80\img\admin\ordispec.sql

-> SVRMGR> @%ORACLE_HOME%\ord80\img\admin\ordibody.plb

where <ORACLE_HOME> is the ORACLE_HOME directory.

3.6 Grant privileges to others on Oracle8 Image Cartridge.

Start Server Manager.

-> C:> svrmgr30

-> SVRMGR> connect ORDSYS/<ORDSYS password>

Grant privileges to others on Oracle8 Image Cartridge:

-> SVRMGR> grant execute on ORDSYS.ORDImgB to PUBLIC;

-> SVRMGR> grant execute on ORDSYS.ORDImgF to PUBLIC;

Once this has been completed, Oracle8 Image Cartridge is usable.

=======================

Installing the Demo

===================

Once you have installed the image cartridge, you may choose to

install the image cartridge demo. This section contains the steps

required to install the image cartridge demo.

The image demo files are located in <ORACLE_HOME>\ord80\img\demo, where

<ORACLE_HOME> is the ORACLE_HOME directory.

1 Installation Steps

--------------------

1.1 The image cartridge demo uses the SCOTT/TIGER database user. If this

user does not exist, you must create it:

Start Server Manager.

-> C:> svrmgr30

Connect to the database with the INTERNAL password:

-> SVRMGR> connect internal;

Create the SCOTT user.

-> SVRMGR> create user SCOTT identified by tiger;

-> SVRMGR> grant connect,resource to SCOTT;

-> SVRMGR> exit;

1.2 Create the image demo directory:

Start Server Manager.

-> C:> svrmgr30

Connect to the database with the INTERNAL password:

-> SVRMGR> connect internal;

Create the image demo directory:

-> SVRMGR> create or replace directory imgdemodir

as '<ORACLE_HOME>\ord80\img\demo';

where <ORACLE_HOME> is the ORACLE_HOME directory.

1.3 Grant privileges on the directory to PUBLIC:

SVRMGR> grant read on directory imgdemodir to public with grant option;

1.4 Make the imgdemo program.

-> C:\> cd <ORACLE_HOME>\ord80\img\demo

If using Microsoft Visual C++, type:

-> C:\> make

If using Borland C, type:

-> C:\> bmake

This is operating system specific. See the installation and

configuration guide for your operating system for details on how

to make this program on your operating system.

Problems fixed in this release

==============================

o A file handle leak was fixed in copyContent from bfiles.

o A memory leak was fixed

Known Problems in this release

==============================

None.

=======================

END OF README.txt