Oracle8 Enterprise Edition Getting Started
Release 8.0.4 for Windows NT

A55928-01

Library

Product

Contents

Index

Prev Next

8
Post-Installation Configuration Tasks

This chapter describes post-installation configuration tasks for Oracle8 Enterprise Edition.

Specific topics discussed are:

What Must You Configure?

The configuration tasks that you must perform are determined by the products that you install and the network configuration files that you use. Some products such as Oracle Enterprise Manager must always be manually configured, while the configuration requirements for other products such as Oracle8 cartridges are determined by how you install the product and the network configuration files you use. The following table describes the circumstances under which Oracle products are automatically configured or must be manually configured:

Did You...   If Yes...   If No...  

Install cartridges during the same installation as Oracle8 Enterprise Edition release 8.0.4?  

Cartridge configuration was automatically performed for you.  

You must manually perform cartridge configuration.  

Manually copy your Oracle7 TNSNAMES.ORA and LISTENER.ORA files into your Oracle8 network files directory?  

Your TNSNAMES.ORA and LISTENER.ORA network configuration files require several modifications in order for some cartridges to function properly.  

Your network configuration files do not require any modification.

 

Review the table below and the sections/documents referenced to identify the configuration responsibilities for your products.

Product   Is Configuration Automatic?   See the Following for Instructions...  

Net8 network software  

For server configuration files, configuration is usually automatic. For client configuration files, configuration must typically be manually performed (unless you use the Host Adapter).  

"Net8" of this chapter  

Oracle Enterprise Manager  

No.  

"Oracle Enterprise Manager" of this chapter  

Oracle8 Options  

 

 

  • Oracle Parallel Server
 

No.  

Oracle Parallel Server Getting Started for Windows NT  

  • Oracle8 Objects
 

Yes.  

No manual configuration is required  

  • Oracle8 Partitioning
 

Yes  

No manual configuration is required  

PL/SQL External Procedures  

Depends upon network configuration files used.  

"Building External Procedures" of Chapter 15, "Developing Applications"  

Oracle8 Cartridges:  

 

 

  • Oracle8 Spatial
 

Depends upon how product was installed.  

"Oracle8 Spatial Cartridge" of this chapter  

  • Oracle8 ConText (and Workbench)
 

Depends upon how product was installed and whether you are upgrading or migrating from a previous release.  

"Oracle8 ConText Cartridge" of this chapter  

  • Oracle8 Image
 

Depends upon how product was installed and network configuration files used.  

"Oracle8 Image Cartridge" of this chapter  

  • Oracle8 Time Series
 

Depends upon how product was installed and network configuration files used.  

"Oracle8 Time Series Cartridge" of this chapter  

  • Oracle8 Visual Information Retrieval
 

Depends upon how product was installed and network configuration files used.  

"Oracle8 Visual Information Retrieval Cartridge" of this chapter  

Advanced Replication Support  

Depends upon how support was installed.  

"Advanced Replication" of this chapter  

Multi-threaded External Callouts  

No.  

"Step 6: Enabling Multi-threaded Callout Support" of Chapter 15, "Developing Applications"  

Net8

Net8 is the Oracle network software that enables applications running on Windows NT and Windows 95 client workstations to access, modify, share, and store data on Oracle8 databases. An easy-to-use network configuration tool, Oracle Net8 Easy Config, enables you to configure Windows NT and Windows 95 clients to communicate with Oracle8 databases. Use Oracle Net8 Easy Config to create and modify server and client configuration files. See "Oracle Products for Windows NT and Windows 95" in Chapter 2, "Introducing Oracle8 Enterprise Edition" for information on how this product is installed. See also Net8 Getting Started for Windows NT and Windows 95 for instructions on using Oracle Net8 Easy Config.

Oracle Enterprise Manager

Before describing how to configure Oracle Enterprise Manager, the key components are briefly described.

Oracle Enterprise Manager Console

Oracle Enterprise Manager works with Oracle Intelligent Agent (installed in the Oracle8 database to be managed) to perform remote database management from a single console computer. Oracle Enterprise Manager is installed on a console computer, a Windows NT or Windows 95 client.

Oracle Intelligent Agent and Managed Oracle8 Databases

Oracle Intelligent Agent runs on the Oracle8 database to be managed. This Oracle8 database is the one you use for your production work. Oracle Intelligent Agent manages and completes tasks on the Oracle8 database that are requested from the Oracle Enterprise Manager Console computer. Oracle Intelligent Agent:

Oracle8 Repository Database

The Oracle Enterprise Manager Console uses an Oracle8 database as a repository for storing key configuration information. The Oracle8 repository database can be installed on:

The sole responsibility of the repository database is to act as the Oracle Enterprise Manager's storage resource. The Oracle8 repository database is:

Do not create a repository and a production database in the same Oracle8 database. If you do, you will not be able to perform many database administration tasks, such as starting or shutting down the database.

Set up your Oracle Enterprise Manager Console, managed Oracle8 database(s), and Oracle8 repository environment in either of two ways:

Oracle Enterprise Manager setup involves configuring the computers on which your Oracle Enterprise Manager, managed Oracle8 database(s), and Oracle8 repository database are installed. This table describes the tasks that must be performed to configure the two Oracle Enterprise Manager environments illustrated previously and the computers on which to perform these tasks. Each task is then fully described in the sections that follow. Use this table as a reference as you perform your configuration tasks.

Perform This Task...   On Managed Oracle8 databases?   If Console and Repository are on same computer?   If Console and Repository are on separate computers?  

Step 1: Start Oracle Services on Managed Oracle8 Database  

Yes  

No  

No  

Step 2: Create a Repository User Account  

No  

Yes

 

Yes, but only perform this task on the computer on which you create the repository  

Step 3: Create a Windows NT User Account on Managed Oracle8 Database Server  

Yes  

No  

No  

Step 4: Create Network Configuration Files  

No  

No  

Yes  

Step 5: Create the Repository and Discover Services  

No  

Yes  

Yes, but only perform this task on the computer on which you create the repository  

Step 1: Start Oracle Services on Managed Oracle8 Database

Ensure that the Oracle8 database services OracleServiceSID, OracleTNSListener80 (or OracleHOME_NAMETNSListener80 if using an Oracle home directory with a home name), and OracleAgent are started. Oracle Intelligent Agent automatically locates the services on the computer where it resides and passes this information to the Oracle Enterprise Manager Console.

To start Oracle Services:

  1. Go to the Oracle8 database to be managed.

  1. Start the Oracle services listed above in either of two ways:

    • From the MS-DOS command prompt, enter:
      C:\> NET START SERVICE_NAME
      
    • From the Control Panel's Services window, select the service, and click Start.

  2. Continue to "Step 2: Create a Repository User Account".


    Note:

    Oracle Intelligent Agent automatically creates SNMP_RO and SNMP_RW. These are used instead of the SNMP.ORA file of previous releases. If you want to use an SNMP.ORA file that you configured with a previous release instead of SNMP_RO and SNMP_RW, set the following line to TRUE in the SNMP.ORA file.

    nmi.register_with_names=true

    If you set this line to FALSE, Oracle Intelligent Agent uses SNMP_RO and SNMP_RW.

     

Step 2: Create a Repository User Account

You need to have a user account with database administrator (DBA) privileges set up on the Oracle8 repository database. Oracle Enterprise Manager places the repository in the default tablespace of the user account to which you are connected when creating the repository. Because of this, Oracle Corporation recommends that you create a new user account so that the repository can be created in its own tablespace. It is also recommended that you create a new tablespace and the newly-created user be customized to use this tablespace as their default tablespace.

To create a repository user account on the Oracle8 repository database:

  1. Go to the computer on which the Oracle8 database that will become your repository is installed.

  1. Start Server Manager:

    C:\> SVRMGR30
    

  2. Connect to the Oracle8 repository database:

    SVRMGR> CONNECT SYSTEM/PASSWORD
    

    where PASSWORD is MANAGER for the SYSTEM user account by default. If you have changed this password, substitute MANAGER with the correct password.

  3. Create a special tablespace for the Oracle Enterprise Manager repository:

    SVRMGR> CREATE TABLESPACE REPOSIT_TABLESPACE DATAFILE                  
    'ORACLE_HOME\DATABASE\DATAFILE' SIZE XM;
    

    where:

    • REPOSIT_TABLESPACE is the tablespace name
    • `ORACLE_HOME\DATABASE\DATAFILE' is the complete path (including drive letter) to the data file (single quotes are required)
    • X is the tablespace size in megabytes (20 MB is a good starting place)

  4. Create a user account and password where the user's default tablespace is the one created in step 4:

    SVRMGR> CREATE USER USERNAME IDENTIFIED BY PASSWORD DEFAULT TABLESPACE 
    REPOSIT_TABLESPACE;
    

  5. Grant the SYSTEM privileges to this user account:

    SVRMGR> GRANT DBA TO USERNAME IDENTIFIED BY PASSWORD;
    

  6. Exit Server Manager:

    SVRMGR> EXIT
    

    Exiting Server Manager closes the database connection.

  7. Follow Steps 3-6 for additional repository user accounts.

  8. Continue to "Step 3: Create a Windows NT User Account on Managed Oracle8 Database Server".

Step 3: Create a Windows NT User Account on Managed Oracle8 Database Server

After a repository user account is created, an NT user account must be created on the managed Oracle8 database server.

To create a user account on the managed Oracle8 database server:

  1. Go to the Oracle8 database to be managed.

  1. Choose Start > Programs > Administrative Tools > User Manager.

    The User Manager window appears:

  2. Choose New User from the User menu.

    The New User dialog box appears:

  3. Enter the appropriate information in the dialog box:

    1. Enter a user name in the Username field.

    2. Enter the same password in both the Password and Confirm Password fields.

      The user name and password that you enter here do not need to match those that you created in "Step 2: Create a Repository User Account".

    3. Make sure the User Must Change Password at Next Logon check box is not checked and Password Never Expires check box is checked.

    4. Make the user a member of the Administrator's group by clicking Groups.

      The Group Memberships dialog box appears:

    5. Select Administrators from the Not member of list box and click <- Add.

      Administrators is added to the Member of list box.

    6. Click OK to close the Group Memberships dialog box and return to the New User dialog box.

  4. Click OK in the New User dialog box to accept the user information.

    The user is added and the User Manager window reappears.

  5. Select the newly-created user and choose User Rights from the Policies menu.

    The User Rights Policy dialog box appears:

  6. Click the Show Advanced User Rights check box and select Log on as a batch job from the Right drop-down list box.

  7. Select Users from the Grant To list box.

    If Users does not exist, create it:

    1. Click Add.

      The Add Users and Groups dialog box appears:

    2. Select the name of the local host computer from the List Names From drop-down list box.

    3. Select Users from the Names list box and click Add.

    4. Click OK.

      Users appears in the Grant To list box.

  8. Click OK in the User Rights Policy dialog box.

    The User Manager window reappears.

  9. Click Exit from the User menu.

  10. Repeat Steps 1-9 for any other repository user accounts you created.

  11. Continue to "Step 4: Create Network Configuration Files"

Step 4: Create Network Configuration Files

If Oracle Enterprise Manager is installed on the same computer as the repository database, you do not need to configure your network. If Oracle Enterprise Manager is installed on a Windows 95 or Windows NT client console separate from the computer on which the repository database is installed, you must configure the client computer so it can connect to the Oracle8 repository database:

To create network configuration files:

  1. Use Oracle Net8 Easy Config to configure your network. See Net8 Getting Started for Windows NT and Windows 95 for instructions on using Oracle Net8 Easy Config.

  1. Continue to "Step 5: Create the Repository and Discover Services"

Step 5: Create the Repository and Discover Services

Before you can use Oracle Enterprise Manager, you need a repository on the console workstation where Oracle Enterprise Manager will run. The repository is a set of base tables in a database that contains status and environment information for your managed databases. A separate repository must be created for each user wanting to use Oracle Enterprise Manager.

The Oracle Enterprise Manager Console workstation must also discover network services, such as databases, listeners, and nodes, to populate the Oracle Enterprise Manager Navigator tree. In addition to discovery, Oracle Enterprise Manager must also be able to manage these services for the Job Scheduling and Event Management systems. This can be achieved with the Discovery Wizard.

When the agent starts up and is explicitly requested by the Oracle Enterprise Manager with the Navigator Discovery feature, the agent passes information from the Oracle Enterprise Manager Console to populate the Navigator tree.

To create a repository:

  1. Go to the computer on which the Oracle8 database that will become your repository is installed.

  1. Choose Start > Programs > Oracle Enterprise Manager > Enterprise Manager.

    The Oracle Enterprise Manager Repository Login Information dialog box appears:

  2. Enter the following information and click OK:

    • Repository user name and password you created earlier in "Step 2: Create a Repository User Account"
    • Net8 service name (or database alias) of the repository database; it is only necessary to enter a service name if you are connecting from a client console to the Oracle8 repository database on a different computer

    The Oracle Repository Manager window appears, prompting you to build the repository:

  3. Click OK.

    The repository is built. A dialog box asking if you want a quick tour of Oracle Enterprise Manger appears.

  4. Click Continue to dismiss this dialog box.

    The Discover New Services Wizard appears:

  5. Follow the wizard instructions to discover services.

    Services are discovered when you see the dialog box below with a status of Discovered:

    If the services are not discovered, click Help for troubleshooting hints. The wizard can be restarted by selecting Service Discovery under Navigator in the main menu.

  6. Click Close.

    The Oracle Enterprise Manager Console appears:

Configuration is complete. Oracle Enterprise Manager is now available for use.

Oracle8 Spatial Cartridge

Oracle8 Spatial Cartridge makes the storage, retrieval, and manipulation of spatial data easier and more intuitive to users. An example of spatial data is a road map. A road map is a 2-dimensional object containing points, lines, and polygons representing cities, roads, and political boundaries such as states. A road map represents geographic information. The locations of cities, roads, and political boundaries are projected onto a 2-dimensional display or piece of paper, preserving the relative positions and relative distances of the objects.

Review the table below to determine your configuration responsibilities:

If You Installed...   Then...  

Oracle8 Spatial Cartridge during the same installation as Oracle8 Enterprise Edition  

No manual configuration is required. All tasks described in "Configuring Oracle8 Spatial Cartridge" were automatically performed.  

Oracle8 Spatial Cartridge during a separate installation from Oracle8 Enterprise Edition  

You must manually configure Oracle8 Spatial Cartridge by either:

 

Configuring Oracle8 Spatial Cartridge

To configure Oracle8 Spatial Cartridge:

  1. Go to the computer on which Oracle8 Spatial Cartridge is installed.

  1. Start Server Manager at the MS-DOS command prompt:

    C:\> SVRMGR30
    

  2. Start the Oracle8 database if it is not currently running. Otherwise, go to step 4.

    1. Connect to the database as INTERNAL:

      SVRMGR> CONNECT INTERNAL/PASSWORD
      
    2. Start the Oracle8 database:

      SVRMGR> STARTUP
      

  3. Connect to the database as the SYSTEM user:

    SVRMGR> CONNECT SYSTEM/PASSWORD
    

    where PASSWORD is MANAGER for the SYSTEM user account by default. If you have changed this password, substitute MANAGER with the correct password.

  4. Create a user called MDSYS with a password of MANAGER:

    SVRMGR> CREATE USER MDSYS IDENTIFIED BY MANAGER;
    

  5. Grant the following privileges to the MDSYS user:

    SVRMGR> GRANT ALL PRIVILEGES TO MDSYS IDENTIFIED BY MANAGER WITH ADMIN 
    OPTION;
    SVRMGR> ALTER USER MDSYS QUOTA UNLIMITED ON SYSTEM;
    

  6. Exit Server Manager:

    SVRMGR> EXIT
    

  7. Start SQL*Plus from the MS-DOS command prompt:

    C:\> PLUS80W
    

  8. Connect to the database as MDSYS/MANAGER:

    The Host String field can be left blank as this is a local database connection. This field is for specifying a service name when connecting to a remote database.


    Note:

    You must use SQL*Plus to run CATMD.SQL. Server Manager cannot run CATMD.SQL.

     

  9. Run the CATMD.SQL script:

    SQL> @%ORACLE_HOME%\MD80\ADMIN\CATMD.SQL
    

    This script creates the following:

    • MD3 data dictionary tables
    • MD3 data dictionary user views
    • MDSQL packages for MD operations
    • MDWEX packages for extracting data
    • MDGTRIG package for generating triggers

For information on using Oracle8 Spatial Cartridge, See the Oracle8 Spatial Cartridge User's Guide and Reference.


Note:

In order to develop applications that work with Oracle8 Spatial Cartridge, you must link with SDO80.LIB, which is located in the ORACLE_HOME\MD80 directory.

 

Oracle8 ConText Cartridge

Oracle8 ConText Cartridge provides search, retrieval, and viewing capabilities for text stored in an Oracle8 database. Oracle8 ConText Cartridge manages textual data in concert with traditional data types in an Oracle8 database. When text is inserted, updated, or deleted, Oracle8 ConText Cartridge automatically manages the change. Oracle8 ConText Cartridge enables text queries to be performed through SQL and PL/SQL from most Oracle interfaces, using tools such as SQL*Plus, Oracle Forms, and Pro*C.

Review the table below to determine your configuration responsibilities. All instructions assume that you have already installed Oracle8 ConText Cartridge release 2.3.6 from the Oracle8 Enterprise Edition for Windows NT CD-ROM:

If...   Then...  

You migrated from Oracle7 Server release 7.3.x to Oracle8 Enterprise Edition release 8.0.4 and now want to migrate ConText to Oracle8 ConText Cartridge release 2.3.6  

Follow the instructions in:

 

You upgraded from Oracle8 Enterprise Edition release 8.0.3 to Oracle8 Enterprise Edition release 8.0.4 by installing release 8.0.4 into the same Oracle home directory as your previous installation using Oracle Installer  

Follow the instructions in:

 

You installed Oracle8 ConText Cartridge release 2.3.6 for the first time, and you do not have a previous release of ConText installed (fresh installation)  

Follow the instructions in:

 

Upgrading Oracle8 ConText Cartridge

This section describes how to upgrade from previous releases of Oracle ConText Option to Oracle8 ConText Cartridge release 2.3.6. The following table lists the release numbers of Oracle ConText with the corresponding Oracle Server releases:

Oracle ConText Release   Oracle Server Release  

Oracle ConText Option release 1.1.2  

Oracle7 Server release 7.3.2  

Oracle ConText Option release 2.0.4  

Oracle7 Server release 7.3.3  

Oracle ConText Option release 2.3.4  

Oracle7 Server release 7.3.4  

Oracle8 ConText Cartridge release 2.0.6  

Oracle8 Enterprise Edition release 8.0.3  

Oracle8 ConText Cartridge release 2.3.6  

Oracle8 Enterprise Edition release 8.0.4  

You cannot migrate directly from release 1.1.2 to release 2.3.6. You need to first migrate to release 2.0.4, and then upgrade to release 2.3.6. You do not need to install Oracle ConText Option release 2.0.4 from your previous CD-ROM. Follow the instructions below appropriate to your situation:

Migrate from Oracle ConText release 1.1.2 to release 2.0.4

To migrate from release 1.1.2 to release 2.0.4:

  1. Migrate the Oracle database from release 7.3.x to release 8.0.4, if you have not already done so.

  1. Start the ConText database you want to migrate by entering at the MS-DOS command prompt:

    C:\> SVRMGR30
    SVRMGR> CONNECT SYS/PASSWORD
    SVRMGR> STARTUP [PFILE=PATH\FILENAME]
    

    where PFILE is the option to specify the full path and file name of an initialization parameter file (INITSID.ORA) that exists in a location other than that for the default INITSID.ORA file.

  2. Exit Server Manager:

    SVRMGR> EXIT
    

  3. Start SQL*Plus in one of two ways from the directory ORACLE_HOME\ CTX80\ADMIN:

    Start SQL*Plus...   By Doing This...  

    From the MS-DOS command line  

    Enter:

    C:\>PLUS80
    
     

    From the Taskbar  

    Choose Start > Programs > Oracle for Windows NT - [HOME_NAME] > SQL*Plus 8.0  

  4. Connect as SYS:

    SQL> CONNECT SYS/PASSWORD;
    

  5. Run the SYS20000.SQL script:

    SQL> @SYS20000.SQL;
    

  6. Exit SQL*Plus:

    SQL> EXIT
    

  7. Start SQL*Plus again from the directory ORACLE_HOME\CTX80\ADMIN, and log in to the database as user CTXSYS.

  8. Run the UPG20000.SQL script:

    SQL> @UPG20000.SQL;
    

  9. Exit SQL*Plus:

    SQL> EXIT
    

  10. Import the linguistics data in to the ConText data dictionary from the file CTXSET.DMP:

    C:\ORACLE_HOME\CTX80\ADMIN>IMP80 CTXSYS/PASSWORD \FILE=CTXSET.DMP FULL=Y 
    IGNORE=Y
    

  11. Upgrade from Oracle ConText release 2.0.4 to release 2.3.6.

Upgrade from Oracle ConText release 2.0.4 to release 2.3.6

To upgrade from release 2.0.4 to release 2.3.6:

  1. Upgrade the Oracle7 database release 7.3.3 to release 8.0.4, if you have not already done so.

  1. Start the ConText database you want to upgrade by entering at the MS-DOS command prompt:

    C:\> SVRMGR30
    SVRMGR> CONNECT SYS/PASSWORD
    SVRMGR> STARTUP [PFILE=PATH\FILENAME]
    

    where PFILE is the option to specify the full path and file name of an initialization parameter file (INITSID.ORA) that exists in a location other than that for the default INITSID.ORA file.

  2. Exit Server Manager:

    SVRMGR> EXIT

  3. Start SQL*Plus in one of two ways from the directory ORACLE_HOME\ CTX80\ADMIN:

    Start SQL*Plus...   By Doing This...  

    From the MS-DOS command line  

    Enter:

    C:\> PLUS80
    
     

    From the Taskbar  

    Choose Start > Programs > Oracle for Windows NT - [HOME_NAME] > SQL*Plus 8.0  

  4. Log in to the database as CTXSYS:

    SQL> CONNECT CTXSYS/PASSWORD;
    

  5. Run the script UPG23600.SQL:

    SQL> @UPG23600.SQL;
    

  6. Exit SQL*Plus:

    SQL> EXIT
    

  7. Start at least one ConText server process from the directory ORACLE_HOME\BIN:

    C:\ORACLE_HOME\BIN> CTXSRV80 -user CTXSYS/PASSWORD -personality DQM
    

  8. Run the PL/SQL function CTX_DDL.UPGRADE_INDEX for each existing Oracle ConText index that must be upgraded for use with release 2.3.6. The owner of the index should perform this task, but it can also be performed by CTXSYS. The following syntax assumes the user CTXSYS is performing the task:

    C:\ORACLE_HOME\CTX80\ADMIN> PLUS80
    SQL> CONNECT CTXSYS/PASSWORD
    SQL> EXEC CTX_DDL.UPGRADE_INDEX(`DOC_POL1');
    

    where DOC_POL1 is the name of the index to be upgraded.

  9. Go to "Load Lexical Data".

Upgrade from release 2.0.6 to release 2.3.6

To upgrade from release 2.0.6 to release 2.3.6:

  1. Upgrade the Oracle8 database release 8.0.3 to release 8.0.4, if you have not already done so.

  1. Start the ConText database you want to upgrade by entering the following:

    C:\> SVRMGR30
    SVRMGR> CONNECT SYS/PASSWORD
    SVRMGR> STARTUP [PFILE=PATH\FILENAME]
    

    where PFILE is the option to specify the full path and file name of an initialization parameter file (INITSID.ORA) that exists in a location other than that of the default INITSID.ORA file.

  2. Exit Server Manager:

    SVRMGR> EXIT

  3. Start SQL*Plus in one of two ways from the directory ORACLE_HOME\CTX80 \ADMIN:

    Start SQL*Plus...   By Doing This...  

    From the MS-DOS command line  

    Enter:

    C:\> PLUS80
    
     

    From the Taskbar  

    Choose Start > Programs > Oracle for Windows NT - [HOME_NAME] > SQL*Plus 8.0  

  4. Log in to the database as CTXSYS:

    SQL> CONNECT CTXSYS/PASSWORD;
    

  5. Run the script UPG23600.SQL:

    SQL> @UPG23600.SQL;
    

  6. Exit SQL*Plus:

    SQL> EXIT
    

  7. Start at least one ConText server process from the directory ORACLE_HOME\BIN:

    C:\ORACLE_HOME\BIN> CTXSRV80 -user CTXSYS/PASSWORD -personality DQM
    

  8. Run the PL/SQL function CTX_DDL.UPGRADE_INDEX for each existing Oracle ConText index that must be upgraded for use with release 2.3.6. The owner of the index should perform this task, but it can also be performed by CTXSYS. The following syntax assumes the user CTXSYS is performing the task:

    C:\ORACLE_HOME\CTX80\ADMIN> PLUS80
    SQL> CONNECT CTXSYS/PASSWORD
    SQL> EXEC CTX_DDL.UPGRADE_INDEX(`DOC_POL1');
    

    where DOC_POL1 is the name of the index to be upgraded.

  9. Go to "Load Lexical Data".

Upgrade from release 2.3.4 to release 2.3.6

To upgrade from release 2.3.4 to release 2.3.6, you do not need to perform any upgrading tasks except loading lexical data. Go to "Load Lexical Data".

Load Lexical Data

The CTXSRXversion executable, the ConText server without linguistics, has been obsoleted for release 2.3.6 of Oracle8 ConText Cartridge. All lexical information is now stored in the database. Therefore, if you have upgraded from a previous release of ConText, you need to load lexical data into the database.

To load lexical data into the database:

  1. Ensure that:

    • Oracle database has been upgraded to release 8.0.4
    • ConText database has been upgraded to release 2.3.6

  1. Ensure the CTXSYS tablespace has at least 30 to 40 MB available. If it does not, then extend the tablespace for CTXSYS in one of two ways:

    To Enlarge CTXSYS Tablespace by...   Do This...  

    Adding a datafile to the tablespace  

    1. Log in to the database using Server Manager as SYS, and start the database:

      C:\ORACLE_HOME\BIN> SVRMGR30

      SVRMGR> CONNECT SYS/PASSWORD;

      SVRMGR> STARTUP [PFILE=PATH/FILENAME];

    2. Enter the following command:

      SVRMGR> ALTER DATABASE DATAFILE `DATAFILE' RESIZE SIZE M;

      where:

      DATAFILE is the name of the data file in the ConText tablespace
      SIZE is the current size of the datafile in MB + 30 MB

    3. Exit Server Manager:

      SVRMGR> EXIT

     

    Resizing the existing datafile in the tablespace  

    1. Log in to the database using Server Manager as SYS, and start the database:

      C:\ORACLE_HOME\BIN> SVRMGR30

      SVRMGR> CONNECT SYS/PASSWORD;

      SVRMGR> STARTUP [PFILE=PATH/FILENAME];

    2. Enter the following command:

      SVRMGR> ALTER TABLESPACE TABLESPACE ADD DATAFILE `DATAFILE' SIZE 30 M;

      where:

      TABLESPACE is the ConText object tablespace name
      DATAFILE is the new data file in the ConText tablespace

    3. Exit Server Manager:

      SVRMGR> EXIT

     

  2. Create a temporary rollback segment with at least 30 MB available.

    In this example, a rollback segment named ROLLBK_TEMP is created in a tablespace named DRSYS:

    C:\ORACLE_HOME\BIN> SVRMGR30
    SVRMGR> CONNECT SYSTEM/PASSWORD
    SVRMGR> CREATE ROLLBACK SEGMENT ROLLBK_TEMP TABLESPACE DRSYS STORAGE 
    (INITIAL 5M NEXT 5M OPTIMAL 10M MINEXTENTS 2 MAXEXTENTS UNLIMITED);
    

  3. Bring the new temporary rollback segment online, and bring all existing rollback segments except SYSTEM offline:

    SVRMGR> ALTER ROLLBACK SEGMENT ROLLBK_TEMP ONLINE;
    SVRMGR> ALTER ROLLBACK SEGMENT ROLLBACK OFFLINE;
    

    where ROLLBACK is the name of the rollback segment currently online.

  4. Import the lexical data into the ConText data dictionary from the file CTXLEX.DMP located in the directory ORACLE_HOME\CTX80\ADMIN:

    C:\ORACLE_HOME\CTX80\ADMIN> IMP80 CTXSYS/PASSWORD FILE=CTXLEX.DMP FULL=Y 
    IGNORE=Y COMMIT=Y
    

  5. Bring the new temporary rollback segment offline, and bring all existing rollback segments online:

    SVRMGR> ALTER ROLLBACK SEGMENT ROLLBACK ONLINE;
    SVRMGR> ALTER ROLLBACK SEGMENT ROLLBK_TEMP OFFLINE;
    

    where ROLLBACK is the name of the rollback segment currently online.

  6. Drop the temporary rollback segment named ROLLBK_TEMP in the example:

    SVRMGR> DROP ROLLBACK SEGMENT ROLLBK_TEMP;
    

  7. See "Configuring Oracle8 ConText Cartridge"

Configuring Oracle8 ConText Cartridge

The way you configure Oracle8 ConText Cartridge depends on how it was installed:

If you installed Oracle8 ConText Cartridge this way...   Then see this section...  

Installed Oracle8 ConText Cartridge for the first time (and you do not have a previous release of ConText installed) or upgraded from release 2.0.6 to release 2.3.6  

"Configuring After a Fresh Installation"  

Upgraded or migrated to Oracle8 ConText Cartridge release 2.3.6 from a previous release  

"Configuring After Upgrading or Migrating"  

Configuring After a Fresh Installation

If you installed Oracle8 ConText Cartridge when you installed Oracle8 Enterprise Edition, then you can use Oracle Database Assistant to perform configuration tasks after installation.

  1. Ensure that your ConText service is started.

    To verify that the service is started:

    1. From the Taskbar, choose Start > Settings > Control Panel.

    2. Double-click Services.

    3. Verify that OracleConTextService80 (or OracleHOME_NAMEConTextService80, if using an Oracle home directory with a home name) is started.

      If the service is not started, then select the service name, and click Start.

    4. Close the Services control panel.

  1. Choose Start > Programs > Oracle for Windows NT - [HOME_NAME] > Oracle Database Assistant.

  2. Select Modify a Database, and click Next.

  3. Select the instance you want to modify by choosing the appropriate service name from the list, and click Next.

  4. Select Configure Oracle Cartridges, and click Next.

  5. Select ConText Cartridge, and then click Finish.

    You can also select Enable Demo at this time if you want to use the ConText demos. A message appears showing the progress of the configuration. The configuration can take up to or more than 30 minutes, depending upon your specific environment.

    A message appears informing you that configuration was successful.

  6. Click OK to dismiss the message.

    Oracle Database Assistant closes, and your database is now ConText enabled.

Configuring After Upgrading or Migrating

If you upgraded or migrated from a previous release of ConText to release 2.3.6, then configure ConText using the instructions below.

To configure Oracle8 ConText Cartridge:

  1. Start Server Manager at the MS-DOS command prompt on the computer where Oracle8 ConText Cartridge is installed:

    C:\> SVRMGR30
    

  1. Start the Oracle8 database if it is not currently running. If the database is running, go to step 3.

    1. Connect to the database as SYS:

      SVRMGR> CONNECT SYS/PASSWORD;
      
    2. Start the Oracle8 database:

      SVRMGR> STARTUP [PFILE=PATH/FILENAME]
      

      where PFILE is the option to specify the full path and file name of an initialization parameter file (INITSID.ORA) that exists in a location other than that of the default INITSID.ORA file.

  2. Create Oracle8 ConText Cartridge dictionary and packages in either of two ways:

    Create Dictionary and Packages in...   By Doing This...  

    an existing tablespace  

    1. Expand an existing tablespace by at least 5 MB:

      SVRMGR> ALTER TABLESPACE EXISTING_TABLESPACE ADD DATAFILE `ORACLE_HOME\DATABASE\SYS2ORCL.ORA' SIZE 30 M;

      where:

    • EXISTING_TABLESPACE is an existing tablespace name
    • `ORACLE_HOME\DATABASE\SYS2ORCL.ORA' is the complete path (including drive letter) to the new data file (single quotes are required)
    • Exit Server Manager:

      SVRMGR> EXIT

    Note: At least 30 MB of database space is needed for this object.  

    a separate tablespace (preferred method)  

    1. Create a tablespace called DRSYS with a size of at least 5 MB.

      SVRMGR> CREATE TABLESPACE DRSYS DATAFILE 'ORACLE_HOME\DATABASE\DR1ORCL.ORA' SIZE 30 M;

    2. Exit Server Manager:

      SVRMGR> EXIT

    Note: At least 30 MB of database space is needed for this object.  

Additional Information:

See:

 

Configuring Oracle8 ConText Cartridge Demos

This section provides instructions for performing the initial setup required to use the samples. The samples are located in the directory ORACLE_HOME \CTX80\DEMO\.

The samples provided with Oracle8 ConText Cartridge are:

Demonstration   Description  

CTXPLUS  

SQL*Plus text query scripts  

CTXLING  

SQL*Plus linguistic extraction sample  

To set up the CTXPLUS and CTXLING demos:

  1. Ensure that your ConText service is started.

    To verify that the service is started:

    1. From the Taskbar, choose Start > Settings > Control Panel.

    2. Double-click Services.

    3. Look to see that OracleConTextService80 (or OracleHOME_NAMEConTextService80) is started.

      If the service is not started, then select the service name, and click Start.

    4. Close the Services control panel.

  1. Start the ConText server:

    C:\ORACLE_HOME\BIN> CTXSRV80 -PERSONALITY DQL
    

  2. Enter the CTXSYS user name and password:

    Enter user: CTXSYS/PASSWORD
    

    The ConText server is initialized, and the ConText session is opened. The prompt returns after the ConText server is started.

  3. Start Oracle Database Assistant:
  4. Choose Start > Programs > Oracle for Windows NT - [HOME_NAME] > Oracle Database Assistant.

  5. Click Modify a Database, and click Next.

  6. Select the instance you want to modify by choosing the appropriate service name from the list, and click Next.

  7. Select Configure Oracle Cartridge, and click Next.

  8. Select Enable Demo, and click Finish.

Oracle8 ConText Cartridge Workbench

Oracle8 ConText Cartridge Workbench consists of administrative tools and application development tools. Specific topics discussed in this section are:

Upgrading Oracle8 ConText Cartridge Workbench

To upgrade from previous releases of Workbench, install the current release of Oracle8 ConText Cartridge Workbench in the same Oracle home directory as the previous release using Oracle Installer. Oracle Installer automatically upgrades all Workbench files to the current release.

Configuring Oracle8 ConText Cartridge Viewer Cartridge

To configure Oracle8 ConText Cartridge Workbench:

  1. Choose Start > Programs > Oracle for Windows NT (or Windows 95) - [HOME_NAME] > Viewer Cartridge Setup.

    Oracle Installer starts, and the Oracle8 ConText Cartridge Viewer Cartridge Setup dialog box appears:

  1. Enter the appropriate information in each of the fields, and click OK:

    Field1   Description  

    Machine name  

    Enter the machine name of the WebServer or Web Application Server.  

    Admin listener port  

    Enter the admin listener port of the WebServer or Web Application Server.  

    Admin listener user and password  

    Enter the admin listener user and password.  

    Listener name  

    Enter an existing listener name.  

    User/Password  

    Enter the CTXSYS user and password. The default password is CTXSYS.  

    Connection alias  

    Enter the database alias for the WebServer or Web Application Server to the Oracle8 database.

    Note: The alias that you enter here is not the alias that connects the client to the Oracle database.  

    1 Ask your web server administrator for assistance with these values.

    If your web server is on the same computer as the Viewer Cartridge, then go to Step 5. Otherwise, the Remote Web Application Server dialog box appears.

  2. Select the platform of the web server, and select how you want to copy configuration files to the web server computer (in one of two ways):

    • automatically

      You can only select Automatically if the web server and Configuration Manager are installed on the same computer.

    • manually

  3. Enter the database alias of the client computer to the Oracle8 database. Also, note the directory information so that you can copy the files after the configuration process. Click OK.

    Oracle Installer begins installing Viewer Cartridge files. This process may take several minutes.

    After installation is complete, an information message appears with important post-installation instructions.

  4. Copy the files and directories specified in Step 3.

  5. Shut down and restart all web server listeners and services.

  6. Double-click the new Viewer Cartridge icon that appears in the Oracle for Windows NT (or Windows 95) program group to start the Viewer Cartridge.

Configuring Oracle8 ConText Cartridge Configuration Manager

To configure Oracle8 ConText Cartridge Configuration Manager:

  1. Choose Start > Programs > Oracle for Windows NT (or Windows 95) - [HOME_NAME] > Configuration Manager Setup.

    Oracle Installer starts, and the Oracle8 ConText Cartridge Configuration Manager Setup dialog box appears:

  1. Enter the appropriate information in each of the fields, and click OK:

    Field1   Description  

    Machine name  

    Enter the machine name of the WebServer or Web Application Server.  

    Admin listener port  

    Enter the admin listener port of the WebServer or Web Application Server.  

    Admin listener user and password  

    Enter the admin listener user and password.  

    Listener name and port  

    Enter an existing listener name and port number.  

    User/Password  

    Enter the CTXSYS user and password. The default password is CTXSYS.  

    Connection alias  

    Enter the database alias for the WebServer or Web Application Server to the Oracle8 database. The alias that you enter here is not the alias that connects the client to the Oracle database.  

    1 Ask your web server administrator for assistance with these values.

    If your web server is on the same computer as the Configuration Manager, then go to Step 5. Otherwise, the Remote Web Application Server dialog box appears:

  2. Select the platform of the web server, and select how you want to copy configuration files to the web server computer (in one of two ways):

    • Automatically

      You can only select Automatically if the web server and Configuration Manager are installed on the same computer.

    • Manually

      Enter the database alias of the client computer to the Oracle8 database. Also, note the directory information so that you can copy the files after the configuration process.

  3. Click OK.

    Oracle Installer begins installing Configuration Manager files. This process may take several minutes.

    After installation is complete, an information message appears with important post-installation instructions.

  4. Copy the files and directories specified in Step 3.

  5. Shut down and restart all web server listeners and services.

  6. Double-click the new icon Configuration Manager that appears in the Oracle for Windows NT (or Windows 95) program group to start the Configuration Manager.

Configuring Oracle8 ConText Cartridge Workbench Demo

This section provides instructions for performing the initial set up required to use the Oracle8 ConText Cartridge Workbench sample, CTXFORM.

To set up the CTXFORM demo:

  1. Determine the user you will use to log in to the database in order to use the demo. You can use the supplied user CTXDEMO, or create an Oracle user for the demos.

    The CTXDEMO user is provided with the Oracle8 ConText Cartridge. The CTXDEMO user has all of the required privileges to set up and use the demos. The initial password is CTXDEMO.

    If you want to create a user, note that in addition to the standard privileges required for an Oracle user, the demo user must have CREATE privileges for the tables and views used in the demos. Also, the demo user must be assigned the CTXAPP role.

    To create a demo user:

    1. Start SQL*Plus:

      Start SQL*Plus...   By Doing This...  

      From the MS-DOS command line  

      Enter:

      C:\> PLUS80
      
       

      From the Taskbar  

      Choose Start > Programs > Oracle for Windows NT - [HOME_NAME] > SQL*Plus 8.0  

    2. Log in to SQL*Plus as CTXSYS:

      SQL> CONNECT CTXSYS/PASSWORD
      
    3. Enter the following commands:

      SQL> GRANT CONNECT, RESOURCE TO MYDEMO IDENTIFIED BY MYDEMO;
      SQL> GRANT CTXAPP TO MYDEMO;
      

      where MYDEMO is the newly created user.

  1. Go to the ORACLE_HOME\CTX80\DEMO\INSTALL directory.

  2. Run the IMP80 utility from the MS-DOS command prompt with parameter TABLES=ARTICLES to import the DEMO.DMP file into the schema of the demonstration user:

    ORACLE_HOME\CTX80\DEMO\INSTALL> IMP80 CTXSYS/PASSWORD FILE=DEMO.DMP 
    IGNORE=Y TABLES=ARTICLES
    

    Importing the DEMO.DMP file:

    • creates an ARTICLES table for the demonstration user
    • populates ARTICLES.TEXT with the text of the articles used in the demos

    The DEMO.DMP file was originally exported for CTXDEMO. If you specified a user name other than CTXDEMO for your demonstration user, you must include the following parameters when running the Oracle Import utility:

    • FROMUSER=CTXDEMO
    • TOUSER=USER_NAME

    For example:

    IMP80 SYSTEM/PASSWORD FILE=DEMO.DMP FROMUSER=CTXDEMO TOUSER=MYDEMO 
    TABLES=ARTICLES
    

    In the example above, a user named SYSTEM imports the ARTICLES table from the DEMO.DMP file created by CTXDEMO into the schema for a user named MYDEMO.

  3. Start a ConText Server with the DDL (D) personality:

    C:\ORACLE_HOME\CTX80\DEMO\INSTALL> CTXSRV80 -USER CTXSYS/CTXSYS -
    PERSONALITY DDL
    

  4. Log on to SQL*Plus as the demonstration user, and run the DEMOINST.SQL script:

    SQL> @DEMOINST.SQL
    

    This script serves as an example of the tasks that you must perform to set up your tables for processing text queries using Oracle8 ConText Cartridge.

    The script creates the policies, preferences, views, and results tables used by the demos and creates a text index for the ARTICLES table.

Oracle8 Image Cartridge

Oracle8 Image Cartridge provides image storage, retrieval, and format conversion capabilities through an object data type (ODT). Oracle8 Image Cartridge supports image storage using Binary Large Objects (BLOBS) and references to image data residing in external files (BFILEs).

Review the table below to determine your configuration responsibilities:

If You...   Then...  

Installed Oracle8 Image Cartridge during the same installation as Oracle8 Enterprise Edition  

No manual configuration is required. All tasks described in "Configuring Oracle8 Image Cartridge" were automatically performed.  

Installed Oracle8 Image Cartridge during a separate installation from Oracle8 Enterprise Edition  

You must manually configure Oracle8 Image Cartridge by either:

 

Want to use the demos  

You must manually configure Oracle8 Image Cartridge Demos by either:

 

Manually copied your Oracle7 LISTENER.ORA and TNSNAMES.ORA files into your Oracle8 network directory  

You must modify the TNSNAMES.ORA and LISTENER.ORA network configuration files on your server to enable external procedure calls to work and Oracle8 Image Cartridge to function properly. Follow the tasks in "Configuring External Procedure Calls" in Chapter 8 of Net8 Getting Started for Windows NT and Windows 95.  

Want to use Oracle8 Visual Information Retrieval Cartridge with Oracle8 Image Cartridge  

Install Oracle8 Image Cartridge first. If you selected both cartridges for installation in the Select Cartridges and Options dialog box, Oracle8 Image Cartridge was installed first.  

Want to build the Oracle8 Image Cartridge sample application  

Install a C compiler.  

Did not install Oracle8 Objects Option  

Install Oracle8 Objects Option, which is required for Oracle8 Image Cartridge to function properly.  

Want multi-threaded external callout functionality  

Perform the tasks in "Step 6: Enabling Multi-threaded Callout Support" in Chapter 15, "Developing Applications".  

Configuring Oracle8 Image Cartridge

To configure Oracle8 Image Cartridge:

  1. Start Server Manager:

    C:\> SVRMGR30
    

  1. Connect to the database with the INTERNAL account:

    SVRMGR> CONNECT INTERNAL/PASSWORD
    

  2. Start the database:

    SVRMGR> STARTUP
    

  3. Run the following script:

    SVRMGR> @%ORACLE_HOME%\ORD80\IMG\ADMIN\ORDIINST.SQL
    

  4. Enter the password for INTERNAL when prompted by the ORDIINST.SQL script:

    Password: PASSWORD
    

  5. Change the password for ORDSYS (if necessary):

    1. Connect to the database with the INTERNAL account:

      SVRMGR> CONNECT INTERNAL/PASSWORD
      
    2. Enter the following command:

      SVRMGR> ALTER USER ORDSYS IDENTIFIED BY NEW_PASSWORD;
      

  6. Exit Server Manager:

    SVRMGR> EXIT
    

Configuring Oracle8 Image Cartridge Demos

Oracle8 Image Cartridge Demos provide a sample demonstration showing how an image is extracted from an Oracle8 database.

To configure Oracle8 Image Cartridge Demos:

  1. Start Server Manager:

    C:\> SVRMGR30
    

  1. Connect to the database with the INTERNAL account:

    SVRMGR> CONNECT INTERNAL/PASSWORD
    

  2. Run the following script:

    SVRMGR> @%ORACLE_HOME%\ORD80\IMG\ADMIN\IMGDEMO.SQL
    

  3. Enter the password for INTERNAL when prompted by the IMGDEMO.SQL script:

    Password: PASSWORD
    

  4. Exit Server Manager:

    SVRMGR> EXIT 
    

  5. Go to the following directory:

    C:> CD ORACLE_HOME\ORD80\IMG\DEMO 
    

  6. Make the Oracle8 Image Cartridge Demo program:

    If Using a...   Then Enter...  

    Microsoft C compiler  

    MAKE  

    Borland C compiler  

    BMAKE  

Oracle8 Time Series Cartridge

Oracle8 Time Series Cartridge stores and retrieves timestamped data through object data types (ODTs). Oracle8 Time Series Cartridge is a building block for applications, rather than being an end-user application. For example, applications can use this cartridge to process historical data derived from financial market transactions, such as trades of stocks, bonds, and mutual fund shares. From this you can find the opening, closing, low, and high prices for a stock on a specific date; calculate monthly volumes for a stock for a specific year; and derive the 30-day moving average for a stock over a year.

Review the table below to determine your configuration responsibilities:

If You...   Then...  

Installed Oracle8 Time Series Cartridge during the same installation as Oracle8 Enterprise Edition  

No manual configuration is required. All tasks described in "Configuring Oracle8 Time Series Cartridge" were automatically performed.  

Installed Oracle8 Time Series Cartridge during a separate installation from Oracle8 Enterprise Edition  

You must manually configure Oracle8 Image Cartridge by either:

 

Want to use the demos  

Perform the tasks in "Configuring Oracle8 Time Series Cartridge Demos".  

Manually copied your Oracle7 LISTENER.ORA and TNSNAMES.ORA files into your Oracle8 network directory  

You must modify the TNSNAMES.ORA and LISTENER.ORA network configuration files on your server to enable external procedure calls to work and Oracle8 Time Series Cartridge to function properly. Follow the tasks in "Configuring External Procedure Calls" in Chapter 8 of Net8 Getting Started for Windows NT and Windows 95.  

Did not install Oracle8 Objects Option  

Install Oracle8 Objects Option, which is required for Oracle8 Time Series Cartridge to function properly.  

Want multi-threaded external callout functionality  

Perform the tasks in "Step 6: Enabling Multi-threaded Callout Support" in Chapter 15, "Developing Applications".  

Configuring Oracle8 Time Series Cartridge


Note:

Oracle8 Time Series Cartridge uses the same user name as Oracle8 Image Cartridge and Oracle8 Visual Information Retrieval Cartridge (ORDSYS). If you automatically or manually configured either of these cartridges first, then the error ORA-01920 can appear on-screen when running the script below. This error message can be ignored.

 

To configure Oracle8 Time Series Cartridge:

  1. Start Server Manager:

    C:\> SVRMGR30
    

  1. Connect to the database with the INTERNAL account:

    SVRMGR> CONNECT INTERNAL/PASSWORD
    

  2. Create the user ORDSYS (if it does not currently exist):

    SVRMGR> CREATE USER ORDSYS IDENTIFIED BY ORDSYS;
    

  3. Grant the following privileges to ORDSYS:

    SVRMGR> GRANT CONNECT,RESOURCE,CREATE LIBRARY TO ORDSYS;
    SVRMGR> GRANT GRANT ANY PRIVILEGE TO ORDSYS;
    

  4. Connect as ORDSYS:

    SVRMGR> CONNECT ORDSYS/PASSWORD
    

  5. Run the following script:

    SVRMGR> @%ORACLE_HOME%\ORD80\TS\ADMIN\ORDTINST.SQL
    

    This script:

    • defines calendar and time series types
    • defines utility, calendar, and time series functions
    • grants EXECUTE privileges to PUBLIC for all public types and packages

  6. Change the password for ORDSYS (if necessary):

    1. Connect to the database with the INTERNAL account:

      SVRMGR> CONNECT INTERNAL/PASSWORD
      
    2. Enter the following command:

      SVRMGR> ALTER USER ORDSYS IDENTIFIED BY NEW_PASSWORD;
      

  7. Exit Server Manager:

    SVRMGR> EXIT
    

Configuring Oracle8 Time Series Cartridge Demos

Five Oracle8 Time Series Cartridge Demos are provided:

Demo   This Demo...  

Usage  

Creates a sample database for use with Oracle8 Time Series Cartridge and demonstrates several basic queries. This demo is used as the basis for all five demos.  

Extend  

Includes sample PL/SQL code to extend the functionality of Oracle8 Time Series Cartridge with new functions. The Oracle8 Objects Option is required to extend the Oracle8 Time Series Cartridge.  

OCI  

Provides C examples of client side time series access.  

Pro*C  

Provides examples of several approaches to client side time series access. Users must have Pro*C to build this demo.  

Developers  

Includes a Developer 2000 Form that incorporates a Developer 2000 Graphic, both of which access data using the Oracle8 Time Series Cartridge. This demo requires Developer 2000 Release 2.0 or higher.  

To configure Oracle8 Time Series Cartridge Demos:

  1. Go to the ORACLE_HOME\ORD80\TS\DEMO directory.

  1. Read the README file in this directory for an overview of the five Oracle8 Time Series Cartridge Demos.

  2. Go to the appropriate subdirectory of ORACLE_HOME\ORD80\TS\DEMO for instructions on configuring the demo that you want to use (for example, directory PROC for Pro*C).

  3. Follow the README file instructions in the subdirectory to configure the demo.


    Note:

    Each of the five subdirectories contains a README that provides configuration instructions.

     

Oracle8 Visual Information Retrieval Cartridge

Oracle Visual Information Retrieval Cartridge stores, retrieves, and manipulates image data managed by an Oracle8 database. This cartridge supports image storage using BLOBS and references to image data residing in external files (BFILEs). This cartridge is a building block for various imaging applications, rather than being an end-user application. Some example applications for this cartridge are digital art galleries and museums, real estate marketing, document imaging, and stock photo collections (such as for fashion designers and architects).

Review the table below to determine your configuration responsibilities:


Note:

When you select Oracle8 Visual Information Retrieval Cartridge for installation, Oracle8 Image Cartridge is installed automatically. To function properly, Oracle8 Visual Information Retrieval Cartridge requires Oracle8 Image Cartridge.

 

If You...   Then...  

Installed Oracle8 Visual Information Retrieval Cartridge during the same installation as Oracle8 Enterprise Edition  

No manual configuration is required. All tasks described in "Configuring Oracle8 Visual Information Retrieval Cartridge" were automatically performed.  

Installed Oracle8 Visual Information Retrieval Cartridge during a separate installation from Oracle8 Enterprise Edition  

You must manually configure Oracle8 Visual Information Retrieval by either:

 

Want to use the demos  

Perform the tasks in "Configuring Oracle8 Visual Information Retrieval Cartridge Demos".  

Want to build an Oracle8 Visual Information Retrieval Cartridge sample application.  

Install a C compiler.  

Manually copied your Oracle7 LISTENER.ORA and TNSNAMES.ORA files into your Oracle8 network directory  

You must modify the TNSNAMES.ORA and LISTENER.ORA network configuration files on your server to enable external procedure calls to work and Oracle8 Visual Information Retrieval Cartridge to function properly. Follow the tasks in "Configuring External Procedure Calls" in Chapter 8 of Net8 Getting Started for Windows NT and Windows 95.  

Did not install Oracle8 Objects Option  

Install Oracle8 Objects Option, which is required for Oracle8 Visual Information Retrieval Cartridge to function properly.  

Want multi-threaded external callout functionality  

Perform the tasks in "Step 6: Enabling Multi-threaded Callout Support" in Chapter 15, "Developing Applications".  

Configuring Oracle8 Visual Information Retrieval Cartridge


Note:

Oracle8 Visual Information Retrieval Cartridge uses the same user name as Oracle8 Image Cartridge and Oracle8 Time Series Cartridge (ORDSYS). If you automatically or manually configured either of these cartridges first, then the error ORA-01920 can appear on-screen when running the script below. This error message can be ignored.

 

To configure Oracle8 Visual Information Retrieval Cartridge:

  1. Ensure that Oracle8 Image Cartridge is already configured. If not, see "Oracle8 Image Cartridge" for instructions.

  1. Start Server Manager:

    C:\> SVRMGR30
    

  2. Connect to the database with the INTERNAL account:

    SVRMGR> CONNECT INTERNAL/PASSWORD
    

  3. Run the following script:

    SVRMGR> @%ORACLE_HOME%\ORD80\VIR\ADMIN\ORDRINST.SQL
    

  4. Enter the password for INTERNAL when prompted by the ORDRINST.SQL script:

    Password: PASSWORD
    

  5. Change the password for ORDSYS (if necessary):

    1. Connect to the database with the INTERNAL account:

      SVRMGR> CONNECT INTERNAL/PASSWORD
      
    2. Enter the following command:

      SVRMGR> ALTER USER ORDSYS IDENTIFIED BY NEW_PASSWORD;
      

  6. Exit Server Manager:

    SVRMGR> EXIT
    

Configuring Oracle8 Visual Information Retrieval Cartridge Demos

Oracle8 Visual Information Retrieval Demos provide a sample demonstration showing how an image is extracted from an Oracle8 database.

To configure Oracle8 Visual Information Retrieval Cartridge Demos:

  1. Start Server Manager:

    C:\> SVRMGR30
    

  1. Connect to the database with the INTERNAL account:

    SVRMGR> CONNECT INTERNAL/PASSWORD
    

  2. Run the following script:

    SVRMGR> @%ORACLE_HOME%\ORD80\VIR\ADMIN\VIRDEMO.SQL
    

  3. Enter the password for INTERNAL when prompted by the VIRDEMO.SQL script:

    Password: PASSWORD
    

  4. Exit Server Manager:

    SVRMGR> EXIT 
    

  5. Go to the following directory:

    CD ORACLE_HOME\ORD80\VIR\DEMO 
    

  6. Make the Oracle8 Visual Information Retrieval Demos program:

    If Using a...   Then Enter...  

    Microsoft C compiler  

    MAKE  

    Borland C compiler  

    BMAKE  

Advanced Replication

Review the table below to determine your configuration responsibilities:

If You...   Then...  

Selected:

  • Typical Configuration when prompted for a database type during Oracle8 Enterprise Edition installation.
  • Oracle8 Enterprise Edition during Custom installation in the Software Asset Manager window.
  • Advanced Replication while creating a customized Oracle8 Enterprise Edition with Oracle Database Assistant
 

All configuration tasks described in "Configuring Advanced Replication Support" were automatically performed. No manual configuration is required.  

Decided to add replication support to a previously installed Oracle8 Enterprise Edition  

You must manually configure Advanced Replication support by following the procedures in "Configuring Advanced Replication Support".  

Configuring Advanced Replication Support

Follow the procedures described below:

See Oracle8 Enterprise Edition Installation for Windows NT for Advanced Replication installation requirements.

Additional Information:

There are many configuration and usage possibilities with Advanced Replication. For more information about advanced replication and for definitions of master sites and snapshot sites, see:

 

Step 1: Checking Tablespace Requirements

The following are recommended tablespace requirements for Advanced Replication:

Tablespace   Requirement  

SYSTEM  

At least 20 MB of free space is required for replication packages. Replication triggers and procedures are stored here.  

ROLLBACK SEGMENTS  

  • Rollback Initial Extent = 50 KB
  • Rollback Next Extent = 50 KB
 

ROLLBACK  

At least 5 MB of free space.  

TEMPORARY  

At least 10 MB of free space.  

USER  

No specific requirement.  

Step 2: Checking Initialization Parameters

Certain initialization parameter values must be set or added to the INITSID.ORA file (recommended values are included) if you use Advanced Replication.

Master Site

Add these initialization parameters to the master site:

Parameter Name   Recommended Value  

SHARED_POOL_SIZE  

At least 10 MB  

DISTRIBUTED_LOCK_TIMEOUT  

300 seconds  

DISTRIBUTED_TRANSACTIONS  

5  

GLOBAL_NAMES  

TRUE  

OPEN_LINKS  

4  

PROCESSES  

Add 9 to current value  

JOB_QUEUE_PROCESSES  

2 (depends on number of n-way sites)  

JOB_QUEUE_INTERVAL  

10 seconds  

JOB_QUEUE_KEEP_CONNECTIONS  

FALSE  

Snapshot Sites

Add these initialization parameters for snapshot sites:

Parameter Name   Recommended Value  

JOB_QUEUE_PROCESSES  

2  

JOB_QUEUE_INTERVAL  

60 seconds  

SNAPSHOT_REFRESH_KEEP_CONNECTIONS  

FALSE  

Step 3: Performing Configuration Tasks

After setting up the INITSID.ORA file with the initialization parameters for Advanced Replication, perform the following steps:

To configure Advanced Replication:

  1. Start Server Manager:

    C:\> SVRMGR30
    

  1. Connect to the database with the INTERNAL account:

    SVRMGR> CONNECT INTERNAL/PASSWORD
    

  2. Start the database if it is not currently running:

    SVRMGR> STARTUP
    

  3. Run the script CATREP8M.SQL once the database has started.

    The script is found in the ORACLE_HOME\RDBMS80\ADMIN directory. It takes approximately one hour to run. Spool output to a log file first before running CATREP.SQL.

    1. Enter the following command:

      SVRMGR> SPOOL OUTPUT.LOG
      

      This creates a file called OUTPUT.LOG to which to output all on-screen activity while the SPOOL session is open.

    2. Run CATREP8M.SQL:

      SVRMGR> @%RDBMS80%\ADMIN\CATREP8M.SQL
      
    3. Close the SPOOL file by entering OFF when the script completes running:

      SVRMGR> SPOOL OFF
      

      OUTPUT.LOG is saved to your current directory.

  4. Confirm that CATREP.SQL ran correctly by running a query on ALL_OBJECTS where STATUS = 'INVALID':

    SVRMGR> SELECT * FROM ALL_OBJECTS WHERE STATUS = 'INVALID';
    

    If all package bodies compiled successfully, the following message displays:

    0 rows selected.
    

    If you find that any of the package bodies compiled incorrectly, recompile them manually. The syntax for running them manually is:

    SVRMGR> ALTER PACKAGE PACKAGE NAME COMPILE BODY;
    

    If CATREP.SQL ran successfully, a number of replication tables are created in the SYSTEM subdirectory. The database is now set up for Advanced Replication support.

  5. Exit Server Manager:

    SVRMGR> EXIT
    

  6. See Oracle8 Replication for details on setting up:

    • master definition site
    • master sites
    • updatable snapshot sites
    • conflict resolution


      Note: Execute the following statement on the master site when setting up updatable snapshot sites:

      SVRMGR> GRANT EXECUTE ON DBMSOBJGWRAPPER TO PUBLIC;  


Step 4: Monitoring Data Dictionary Tables

The practical limit to the number of master sites an environment can have is 36. The processes SNP0 to SNP9 (total of 10) and SNPA to SNPZ (total of 26) each handle one destination master at a time.

If you use Advanced Replication and intend to set up a large number of replicated objects, monitor the following data dictionary tables with the SQL SELECT command:

SOURCE$  

I_ARGUMENT1  

IDL_UB1$  

IDL_SB4$  

IDL_UB2$  

IDL_CHAR$  

I_SOURCE1I$  

TRIGGER$  

ARGUMENT$  

 

If necessary, increase the storage parameters to accommodate the storage requirements of large numbers of replicated objects.

Step 5: Upgrading Advanced Replication

If you are upgrading from a previous version of the Oracle8 database and want to use Advanced Replication, you must first complete the upgrade (see Chapter 7, "Migrating and Upgrading" in this guide). After upgrading, Advanced Replication is automatically installed with the Oracle8 database during Release 8.0 installation (see Oracle8 Enterprise Edition Installation for Windows NT).

Advanced Replication is an advanced feature. Please consult your Oracle8 Replication documentation for concepts and details before proceeding. For additional information, contact Oracle Education.




Prev

Next
Oracle
Copyright © 1997 Oracle Corporation.

All Rights Reserved.

Library

Product

Contents

Index