A
Java Access Bridge Installation

This appendix describes the procedures required for installation of a Java Access Bridges. The topics include:

A.1 Setting-Up the 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 Oracle9i Application Server (Oracle9iAS) installation CD-ROMs contain two different versions of the Java Runtime Environment (JRE) that is used by the Oracle Universal Installer during installation. The CD-ROMs contain JRE 1.31 and JRE 1.1.8. The JREs enable use of the Java Access Bridge during installation.

Complete the following procedures to install and configure the access bridge for each of the JREs.

This section contains the following topics:

A.2 Setup for JRE 1.3.1

To setup the access bridge with JRE 1.3.1, run the batch file on the first Oracle9iAS CD-ROM. The batch file is located at:

<Disk1>\install\win32\access_setup.bat

A.3 Setup for JRE 1.1.8

This section features the following topics regarding use of the access bridge with JRE 1.1.8:

A.3.1 Setup for Oracle Universal Installer

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

Before you begin Java Access Bridge installation exit any assistive technology software that is running.

To install the Java Access Bridge:

From the first Oracle9iAS component CD-ROM, copy \AccessBridge\accessbridge1_0.zip to a location on your hard drive.
Extract the files onto your computer hard drive. For example:
```
c:\accessbridge
```
Add access-bridge.jar and jaccess-1_1.jar to the CLASSPATH user environment variable.

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

On Windows NT, choose the Environment tab.

On Windows 2000, choose the Advance tab. Then, click the Environment Variables button.
Add the following to the CLASSPATH user environment variable:
```
c:\AccessBridge-1_0\installer\installerFiles\access-bridge.jar
c:\AccessBridge\installer\installerFiles\jaccess-1_1.jar
```
where c:\AccessBridge-1_0 is the full path of the Access Bridge location on your computer hard drive.
Copy JavaAccessBridge.dll and WindowsAccessBridge.dll from:
```
c:\AccessBridge-1_0\installer\installerFiles\
```
to
```
operating system\system32\.
```
Following successful installation, Java Access Bridge documentation is located at:
```
\AccessBridge-1_0\doc
```

A.3.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 windows.

To install the Java Access Bridge:

From the first Oracle9iAS component CD-ROM, copy \AccessBridge\accessbridge1_0.zip to a location on your hard drive.
Extract the files onto your computer hard drive. For example:
```
c:\accessbridge
```

Install the Java Access Bridge into the right subdirectory used by Oracle components.

Java Access Bridge must be installed into the subdirectory of Java Runtime Environment (JRE) 1.1.8 used by Oracle components. By default, the JRE 1.1.8 used by Oracle is installed in:

c:\Program Files\Oracle\jre\1.1.8.

The following Table A-1 list 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\installer\installerFiles\ jaccess-1_1.jar`	`\lib\jaccess.jar` (rename `jaccess-1_1.jar` to `jaccess.jar`)
`\AccessBridge-1_0\access-bridge.jar`	`\lib\`
`\AccessBridge-1_0\JavaAccessBridge.dll`	`\bin\`
`\AccessBridge-1_0\WindowsAccessBridge.dll`	`\bin\`

In the destination folder, rename jaccess-1_1.jar to jaccess.jar.
Use a text editor to modify \lib\awt.properties file that is located in the subdirectory of JRE 1.1.8 used by Oracle components.

Add the following lines to 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\doc

To Configure Oracle Components to use the Java Access Bridge:

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

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

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

A Java Access Bridge Installation