D Java Access Bridge Installation

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

Contents:

Section D.1, "Introduction"
Section D.2, "Setup for JRE 1.4.2"
Section D.3, "Setup for Oracle Installed Components"

D.1 Introduction

The 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 the Oracle Universal Installer and the Oracle Enterprise Manager Application Server Control.

Your Oracle Application Server 10g (9.0.4) Forms and Reports Services CD-ROMs contain the Java Runtime Environment (JRE) 1.4.1 that is used by the Oracle Universal Installer during installation. The JRE enables use of the Java Access Bridge during installation. To install and configure Java Access Bridge after you install Oracle components, see Section D.3, "Setup for Oracle Installed Components".

D.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 installation media.

DRIVE_LETTER:\install\access_setup.bat

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

D.3 Setup for Oracle Installed Components

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

Section D.3.1, "Installing Java Access Bridge"
Section D.3.2, "Configuring Oracle Components to Use Java Access Bridge"

D.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 Access Bridge. For example:
```
c:\AccessBridge-1.0.4
```

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

ORACLE_BASE\ORACLE_HOME\jre\1.4.2

Table D-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 D-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:
```
c:\AccessBridge-1.0.4\doc
```

D.3.2 Configuring Oracle Components to Use Java Access Bridge

You can configure Oracle components to use the 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.

D.3.2.1 Configuring for Windows NT

To configure Oracle components to use Access Bridge on Windows NT, follow these steps:

Select Start > Settings > Control Panel > System to display the Windows System Control Panel.
Select the Environment tab.
Select a variable in the System Variables list.
In the Variable field, enter ORACLE_OEM_CLASSPATH.
In the Value field, enter the full path to jaccess.jar and access-bridge.jar.

Use a semicolon to separate the two paths. Do not use quotes or space characters. For example, if JRE 1.4.2 is installed in the default location, the setting would be:
```
c:\oracle\product\10.1.0\Db_1\jre\1.4.2\lib\ext\jaccess.jar;c:\oracle\product\10.1.0\Db_ 1\jre\1.4.2\lib\ext\access-bridge.jar
```
Click Set.
Click OK.

D.3.2.2 Configuring for Windows 2000, Windows XP, or Windows Server 2003

To configure Oracle components to use Access Bridge on Windows 2000, Windows XP, or Windows Server 2003, follow these steps:

Select Start > Settings > Control Panel > 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 appears.
In the Variable Name field, enter ORACLE_OEM_CLASSPATH.
In the Variable Value field, enter the full path to jaccess.jar and access-bridge.jar.

Use a semicolon to separate the two paths. Do not use quotes or character spaces. For example, if JRE 1.4.2 is installed in the default location, the setting would be:
```
c:\oracle\product\10.1.0\Db_1\jre\1.4.2\lib\ext\jaccess.jar;c:\oracle\product\10.1.0\Db_1\jre\1.4.2\lib\ext\access-bridge.jar
```
Click OK.