A Java Access Bridge Installation

This appendix describes the procedures required for installation of Java Access Bridge.

This appendix contains these topics:

Setting Up Java Access Bridge
Setup for JRE 1.3.1
Setup for JRE 1.1.8

A.1 Setup for JRE 1.3.1

To set up Java Access Bridge with JRE 1.3.1, run the batch file on the first Oracle Collaboration Suite CD-ROM. The batch file is located at:

first_install_CD-ROM\install\win32\access_setup.bat

A.2 Setup for JRE 1.1.8

The following sections describe how to use Java Access Bridge with JRE 1.1.8:

Setup for Oracle Universal Installer
Setup for Oracle Installed Components

A.2.1 Setup for Oracle Universal Installer

Install and configure Java Access Bridge before installing Oracle components to enable assistive technologies to read Oracle Universal Installer screens.

To install Java Access Bridge:

Exit any assistive technology software that is running before you begin Java Access Bridge installation.
Insert the first Oracle Collaboration Suite component CD-ROM.
Copy \AccessBridge\accessbridge1_0_2.zip to a location on your hard drive.
Extract the files onto your computer hard drive. For example:
```
c:\
```
Add access-bridge.jar and jaccess-1_1.jar information to the CLASSPATH user environment variable.
1. Open the Windows System Control Panel. For Windows NT or Windows 2000, choose Start > Settings > Control Panel > System.
  - On Windows NT, click the Environment tab.
  - On Windows 2000, click the Advance tab. Then, click Environment Variables.
2. Add the following to the CLASSPATH user environment variable:
```
c:\AccessBridge-1_0_2fcs\installer\installerFiles\access-bridge.jar
c:\AccessBridge-1_0_2fcs\installer\installerFiles\jaccess-1_1.jar
```
  where c:\AccessBridge-1_0_2fcs is the full path to the Java Access Bridge location on your computer hard drive.
Copy JavaAccessBridge.dll and WindowsAccessBridge.dll from:
```
c:\AccessBridge-1_0_2fcs\installer\installerFiles\
```
to
```
%SystemRoot%\system32\
```
Following successful installation, Java Access Bridge documentation is located at:
```
\AccessBridge-1_0_2fcs\doc
```

A.2.2 Setup for Oracle Installed Components

Install and configure Java Access Bridge for Windows after installing Oracle components to enable assistive technologies to read Oracle component screens.

To install Java Access Bridge:

Insert the first Oracle Collaboration Suite component CD-ROM.
Copy \AccessBridge\accessbridge1_0_2.zip to a location on your hard drive.
Extract the files onto your computer hard drive. For example:
```
c:\
```
Install Java Access Bridge into the subdirectory of JRE 1.1.8 used by Oracle components. By default, the JRE 1.1.8 used by Oracle is installed in:
```
SYSTEM_DRIVE:\Program Files\Oracle\jre\1.1.8
```

Table A-1 lists the files to copy from the Java Access Bridge location on your computer hard drive to the appropriate subdirectory of the JRE used by Oracle components.

Table A-1 Copy Files To Subdirectory

Copy...	To...
\AccessBridge-1_0_2fcs\installer\installerFiles\ jaccess-1_1.jar	\lib\
\AccessBridge-1_0_2fcs\access-bridge.jar	\lib\
\AccessBridge-1_0_2fcs\JavaAccessBridge.dll	\bin\
\AccessBridge-1_0_2fcs\WindowsAccessBridge.dll	\bin\

Rename jaccess-1_1.jar to jaccess.jar in the destination folder.
Use a text editor to open the \lib\awt.properties file located in the subdirectory of JRE 1.1.8 used by Oracle components.

Add the following lines to the awt.properties file:

AWT.EventQueueClass=com.cun.java.accessibility.util.EventQueueMonitor
AWT.assistive_technologies=com.sun.java.accessibility.AccessBridge

Following successful installation, Java Access Bridge documentation is located at:

\AccessBridge-1_0_2fcs\doc

To configure Oracle components to use Java Access Bridge:

Set the system environment variable ORACLE_OEM_CLASSPATH to point to the installed Java Access Bridge files.

Open System Properties. For Windows NT or Windows 2000, choose Start > Settings > Control Panel > System.

On Windows NT:
1. Click the Environment tab.
2. Select a variable in the System Variables list.
3. Enter ORACLE_OEM_CLASSPATH in the Variable field.
4. Enter the full path of jaccess.jar and access-bridge.jar in the Value field. For example, if JRE 1.1.8 is installed in the default location, then the paths are:
```
SYSTEM_DRIVE:\Program Files\Oracle\jre\1.1.8\lib\jaccess.jar;
SYSTEM_DRIVE:\Program Files\Oralce\jre\1.1.8\lib\access-bridge.jar
```
5. Click Set.
6. Click OK.
On Windows 2000:
1. Click the Advanced tab.
2. Click Environment Variables.
  
  The Environment Variables dialog appears.
3. Click the New button under the System Variable list.
  
  The New System Variable dialog appears.
4. Enter the ORACLE_OEM_CLASSPATH in the Variable Name field.
5. Enter the full path of jaccess.jar and access-bridge.jar in the Variable Value field. For example, if JRE 1.1.8 is installed in the default location, then the paths are:
```
SYSTEM_DRIVE:\Program Files\Oracle\jre\1.1.8\lib\jaccess.jar;
SYSTEM_DRIVE:\Program Files\Oralce\jre\1.1.8\lib\access-bridge.jar
```
6. Click OK until you exit System Properties.

A.3 Setting Up Java Access Bridge

This section contains setup information for enabling Oracle components to use a screen reader.

Java Access Bridge enables assistive technologies, such as the JAWS screen reader, to read Java applications running on the Windows platform. Assistive technologies can read Java-based interfaces, such as Oracle Universal Installer and Oracle Enterprise Manager.

Your Oracle Collaboration Suite installation CD-ROMs contain two different versions of Java Runtime Environment (JRE) that are used by Oracle Universal Installer during installation. The CD-ROMs contain JRE 1.3.1 and JRE 1.1.8. The JREs enable use of Java Access Bridge during installation.

Complete the following procedures to install and configure Java Access Bridge for each of the JREs.

Note:

Java Access Bridge is available on the first CD-ROM of the following installation CDs:

Oracle9iAS Infrastructure
Oracle Collaboration Suite information storage
Oracle Collaboration Suite