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

NAME

README.txt - ORACLE8 VISUAL INFORMATION RETRIEVAL (VIR)

CARTRIDGE RELEASE INFORMATION

VERSION=8.0.5.0.0 README FILE

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

Contents

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

Upgrade Notes

Warnings

Problem

Getting Started

Installing the Demo

Problems fixed in this release

Features added in this release

Upgrade Notes:

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

This is the production release for 8.0.5.

Warnings:

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

The VIR 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 VIR

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 VIR cartridge

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

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

Getting Started

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

Oracle8 Visual Information Retrieval Cartridge Production Release 8.0.5

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

Provides for the storage, retrieval, processing, and content-based

searching of two dimensional, static bit-mapped images. Images are stored

efficiently using popular compresion schemes in industry standard desktop

publishing image interchange formats.

For More Information

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

VIR technology licensed from Virage, Inc. For more information about

Virage, see their websight at http://www.virage.com. For more information

about face recognition support from Viisage, see their websight at

http://www.viisage.com.

Oracle8 VIR Cartridge Documentation

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

Complete online documentation is available on the documentation CD that

shipped with the Oracle8 server.

Installing Oracle8 VIR Cartridge

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

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

Oracle8 Server and Oracle8 Image Cartridge. If you installed Oracle8 VIR

Cartridge during the same installation as Oracle8 Server, you do not have

to perform the procedures in this section; Oracle8 VIR Cartridge was

automatically configured for you.

Oracle8 VIR Cartridge is an entention of Oracle8 Enterprise Edition that

provides image storage, retrieval, format conversion, and content based

searching capabilities through an object data type (ODT).

1 Installation Decisions

2 Pre-Installation Steps

3 Installation Steps

1 Installation Decisions

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

During the installation process you are prompted to set the password

for 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 default 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 RDBMS, including the PL/SQL option

and the objects option.

2.2 Install the Oracle Installer

2.3 Create the database.

2.4 Start up the database.

2.5 Install the Image Cartridge, Version 8.0.4.0.0 or later.

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 VIR Cartridge,

using the Oracle Installer.

3.2 Create the VIR library.

-> C:\> svrmgr30

-> SVRMGR> connect ORDSYS/<ORDSYS password>

Create the library:

-> SVRMGR> create or replace library ORDVirLibS as

'<ORACLE_HOME>\bin\ordvir80.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.3 Create the VIR Cartridge.

-> SVRMGR> connect ORDSYS/<ORDSYS password>

Create the VIR Cartridge:

-> SVRMGR> @%ORACLE_HOME%\ord80\vir\admin\ordrspec.sql

-> SVRMGR> @%ORACLE_HOME%\ord80\vir\admin\ordrbody.plb

where <ORACLE_HOME> is the ORACLE_HOME directory.

3.4 Grant privileges to others on the VIR Cartridge.

Connect to the ORDSYS account:

-> C:\> svrmgr30

-> SVRMGR> connect ORDSYS/<ORDSYS password>

Grant privileges to others on the VIR Cartridge:

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

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

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

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

Installing the Demo

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

Once you have install Oracle8 VIR Cartridge, you may choose to install the

Oracle8 VIR cartridge demo. This section contains the steps required to

install the VIR Cartridge demo.

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

<ORACLE_HOME> is the Oracle home directory.

1 Installation Steps

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

1.1 The VIR 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 VIR demo directory.

Start Server Manager.

-> C:\> svrmgr30

Connect to the database with the INTERNAL password:

-> SVRMGR> connect internal;

Create the VIR demo directory:

-> SVRMGR> create or replace directory virdemodir

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

where <ORACLE_HOME> is the Oracle home directory.

1.3 Grant privileges on the directory to PUBLIC;

-> SVRMGR> grant read on directory virdemodir to public with grant option;

-> SVRMGR> exit;

1.4 Make the virdemo program.

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

If using Microsoft Visual C++, type:

-> C:\> make

If using Borland C, type:

-> C:\> bmake

Problems fixed in this release

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

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

o A memory leak was fixed

o Performance has been improved when installed on a server release 8.0.4

or later.

Features added in this release

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

o The "Convert" function was added to the ORDVIR_Pkg package.

The "Convert" function provides support for signature data from

machines with alternate byte orderings. This means that signature

data from an Windows NT database can be imported to a Solaris

database, converted, and then used with out any performance

degredation.

The "Convert" function can also be used to create a signature

Viisage data. Once the Viisage data is converted into a signature

it can be used with the "Score" and "Similar" functions by using

"FACIAL" as a weight in stead of any of the standard weights.

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

END OF README.txt