B Installing Java Access Bridge

This appendix describes how to install Java Access Bridge. Java Access Bridge enables use of a screen reader with Oracle components:

Introduction
Setup for JRE 1.4.2
Setup for Oracle Installed Components

Note:

Java Access Bridge and JAWS are not certified on Windows Vista at this time.

B.1 Introduction

Java Access Bridge enables assistive technologies, such as 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 Database Control.

Your Oracle Database, Oracle Database Client, and Oracle Database Companion CD installation media contain the Java Runtime Environment (JRE) 1.4.2, which Oracle Universal Installer uses during installation. The JRE enables use of Java Access Bridge during installation. See "Setup for Oracle Installed Components" for information about installing and configuring Java Access Bridge after you install Oracle components.

B.2 Setup for JRE 1.4.2

To set up Java Access Bridge with JRE 1.4.2, run the following batch file on Oracle Database installation media.

DRIVE_LETTER:\install\access_setup.bat

After the batch file has run, restart your assistive technology program.

B.3 Setup for Oracle Installed Components

This section describes how to install and configure Java Access Bridge for Windows after installing Oracle components. It contains the following topics:

Installing Java Access Bridge
Configuring Oracle Components to Use Java Access Bridge

B.3.1 Installing Java Access Bridge

To install Java Access Bridge, follow these steps:

On the Oracle installation media, go to the AccessBridge directory.
Select the accessbridge-1_0_4.zip file and extract its files to the system where you plan to install Java Access Bridge. For example:
```
c:\AccessBridge-1.0.4
```

Copy the Java Access Bridge files listed in Table B-1 into the JRE 1.4.2 directory used by Oracle components. By default, the JRE installation used by Oracle components is installed in:

ORACLE_BASE\ORACLE_HOME\jre\1.4.2

Table B-1 lists the files you need to copy from the Java Access Bridge location on your hard drive to the JRE directory used by Oracle components:

Table B-1 Copy Files to JRE Directory

Copy	To
`\AccessBridge-1_0_4\installer\installerFiles\jaccess-1_4.jar`	`ORACLE_BASE\ORACLE_HOME\jre\1.4.2\lib\ext`
`\AccessBridge-1_0_4\installer\installerFiles\access-bridge.jar`	`ORACLE_BASE\ORACLE_HOME\jre\1.4.2\lib\ext`
`\AccessBridge-1_0_4\installer\installerFiles\JavaAccessBridge.dll`	`windows_directory\system32`
`\AccessBridge-1_0_4\installer\installerFiles\WindowsAccessBridge.dll`	`windows_directory\system32`
`\AccessBridge-1_0_4\installer\installerFiles\JAWTAccessBridge.dll`	`windows_directory\system32`
`\AccessBridge-1_0_4\installer\installerFiles\accessibility.properties`	`ORACLE_BASE\ORACLE_HOME\jre\1.4.2\lib`

Rename jaccess-1_4.jar (now located in ORACLE_BASE\ORACLE_HOME\jre\1.4.2\lib\ext) to jaccess.jar.
Following a successful installation, you can access Java Access Bridge documentation located at
```
SYSTEM_DRIVE:\AccessBridge-1.0.4\doc
```

B.3.2 Configuring Oracle Components to Use Java Access Bridge

You can configure Oracle components to use Java Access Bridge after you complete the installation. To do so, you need to set the system variable ORACLE_OEM_CLASSPATH to point to the installed Java Access Bridge files.

Follow these steps:

From the Start menu, select Settings, Control Panel, and then System to display the Windows System control panel.
Select the Advanced tab.
Click the Environment Variables button.
Click the New button under the System Variable list. The New System Variable dialog box appears.
In the Variable Name field, enter ORACLE_OEM_CLASSPATH.
In the Variable Value field, enter the full path to the jaccess.jar and access-bridge.jar.

Use a semicolon to separate the two paths. Do not use quotation marks or character spaces. For example, if JRE 1.4.2 is installed in the default location, the setting is:
```
ORACLE_BASE\ORACLE_HOME\jre\1.4.2\lib\ext\jaccess.jar;ORACLE_BASE\ORACLE_HOME\jre\1.4.2\lib\ext\access-bridge.jar
```
Click OK.