A
Java Access Bridge Installation

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

• Setting-Up the Java Access Bridge

• Setup for JRE 1.3.1

• Setup for Oracle Installed Components

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 the Java Runtime Environment (JRE) 1.3.1 that is used by the Oracle Universal Installer during installation. The JRE enables use of the Java Access Bridge during installation.

A.2 Setup for JRE 1.3.1

To setup the access bridge with JRE 1.3.1, and enable assistive technologies to read the windows that appear during Oracle9iAS installation, run the batch file on the first Oracle9iAS CD-ROM. The batch file is located at:

disk:\install\win32\access_setup.bat

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

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

A.3.1 Installing the Java Access Bridge

1. Download the Java Access Bridge accessbridge-1_0_2.zip file from http://java.sun.com/products/accessbridge to a location on your hard drive. The accessbridge-1_0_2.zip file is also available from the first Oracle9iAS component CD-ROM.

2. Extract the files onto your computer hard drive. For example:

   c:\accessbridge
   
   

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

   The Java Access Bridge must be installed into the subdirectory of JRE 1.3.1 used by Oracle components. By default, the JRE, used by Oracle components is installed in:

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

   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_2\installer\installerFiles\ jaccess-1_1.jar	\lib\jaccess.jar (rename jaccess-1_1.jar to jaccess.jar)
   \AccessBridge-1_0_2\access-bridge.jar	\lib\
   \AccessBridge-1_0_2\JavaAccessBridge.dll	\bin\
   \AccessBridge-1_0_2\WindowsAccessBridge.dll	\bin\

4. In the destination folder, rename jaccess-1_1.jar to jaccess.jar.

5. Use a text editor to modify \lib\awt.properties file that is located in the subdirectory of the JRE used by Oracle components.

6. 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
   
   

   Ensure that space characters are not appended to the end of the lines. The two lines can be added anywhere in the awt.properties file.

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

   \AccessBridge-1_0\doc
   

A.3.2 Configuring Oracle Components to use the Access Bridge on Windows NT

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

1. Select Start > Settings > Control Panel > System to display the Windows System Control Panel.

2. Select the Environment tab.

3. Select a variable in the System Variables list.

4. In the Variable field, enter ORACLE_OEM_CLASSPATH.

5. In the Value field, enter the full path of jaccess.jar and access-bridge.jar. For example, if JRE 1.3.1 is installed in the default location, then the paths are:

   c:\Program Files\Oracle\jre\1.3.1\lib\jaccess.jar
   c:\Program Files\Oracle\jre\1.3.1\lib\access-bridge.jar
   
   

6. Select Set.

7. Select OK.

A.3.3 Configuring Oracle Components to use the Access Bridge on Windows 2000

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

1. Select Start > Settings > Control Panel > System to display the Windows System Control Panel.

2. Select the Advanced tab.

3. Click the Environment Variables button.

4. Click the New button under the System Variable list. The New System Variable dialog appears.

5. In the Variable Name field, enter ORACLE_OEM_CLASSPATH.

6. In the Variable Value field, enter the full path of jaccess.jar and access-bridge.jar. For example, if JRE 1.3.1 is installed in the default location, then the paths are:

   c:\Program Files\Oracle\jre\1.3.1\lib\jaccess.jar
   c:\Program Files\Oracle\jre\1.3.1\lib\access-bridge.jar
   
   

7. Select OK.