Oracle JDeveloper (10.1.3.5.0)

Installation Guide

Studio Version 10.1.3.5.0

June 2009

Before you install JDeveloper, please review the content of this guide.

Table of Content

1.0 JDeveloper System Requirements

This release of JDeveloper is tested and supported on the specific versions Windows, Linux, and Mac OS X, as listed in Section 1.1 below. In addition, it is supported on any operating system that supports Sun Java SE Development Kit (JDK) 5.0 Update 6 or later.

1.1 Recommended CPU, Memory, Display, and Hard Drive Configurations

Windows

 

Resource

Recommended

Operating System

Windows 2000-Service Pack 4
Windows Server 2003 R2
Windows XP-Service Pack 2
Windows Vista

CPU Type and Speed 

Pentium IV 2 GHz or faster

Memory

1 GB RAM

Display 

65536 colors, set to at least 1024 X 768 resolution

Hard Drive Space

Base Installation: 450 MB
Complete Installation: 575 MB

Java SDK

JDK 5.0 Update 6 or later for Windows, available at: http://www.javasoft.com. (Included in the Complete Installation.)

Linux

 

Resource

Recommended

Distribution

Red Hat Enterprise Linux 3.0
Red Hat Enterprise Linux 4.0
Oracle Enterprise Linux 4.0
Oracle Enterprise Linux 5.0

CPU Type and Speed 

Pentium IV 2 GHz or faster

Memory

1 GB RAM

Display 

65536 colors, set to at least 1024 X 768 resolution

Hard Drive Space

Base Installation: 450 MB

Java SDK

JDK 5.0 Update 6 or later for Linux, available at: http://www.javasoft.com.

Note: If you want to use JDeveloper in a multiuser UNIX environment, Oracle recommends a minimum of 1 GB RAM and 2 GB of swap space.

MAC OS X

Resource

Recommended

Operating System

Apple Mac OS X Version 10.4.x

CPU Type and Speed 

Dual 1.25 GHz G4/G5 (1 GHz G4 minimum)

Memory

1.5 GB RAM (1 GB minimum)

Display 

"Thousands" of colors

Hard Drive Space

Base Installation: 450 MB

Java SDK

Sun J2SE 1.5 release 1 available at: http://www.apple.com/support/downloads/java2se50release1.html

1.2 Support for Team Based Development Tools

JDeveloper provides integrated support for Concurrent Version Support (CVS):

  • CVS version 1.11.x
  • CVSNT 2.5.02 & 2.5.03

Download extensions to integrate other source control systems in JDeveloper using the Check for Updates wizard. From the main menu choose Help | Check for Updates to launch the wizard. JDeveloper provides extensions for the following:

  • ClearCase
    • ClearCase 4.x
    • ClearCase 5.x (including ClearCase 2002)
    • ClearCase - 2003.06.x
    • Note: JDeveloper does not support ClearCase UCM
  • Dimension 9.1
  • Perforce 2005.1 and 2005.2
  • Subversion 1.3.1 and 1.3.2
  • Team Foundation Server (VSTS) 2005 Production
Back to TOC

2.0 Installing and Starting JDeveloper on Windows

JDeveloper does not require an installer. To install JDeveloper, you will need an unzip tool. You can download a free, cross-platform unzip tool, Info-Zip, available at: http://www.info-zip.org/.

Alert: Do not install this JDeveloper release into any existing ORACLE_HOME. You will not be able to uninstall it using Oracle Universal Installer.

2.1 Installing the Complete Version

The complete installation ( jdevstudio10135.zip) includes the Windows version of JDK 5.0 Update 6 and the JDeveloper documentation.

To install JDeveloper from jdevstudio10135.zip, unzip jdevstudio10135.zip in the directory you want to install JDeveloper. Ensure that this directory does not contain spaces. For example, do not use C:\Program Files as the installation directory.

Note: The remainder of this document uses <jdev_home> to represent the directory location in which JDeveloper was installed. For example, if JDeveloper was unzipped in c:\jdeveloper, the <jdev_home> directory would be c:\jdeveloper.

2.2 Installing JDeveloper Base

For quicker download times, you can download the base installation ( jdevstudiobase10135.zip). The base installation, by default, includes the JDeveloper documentation, but requires that you already have JDK 5.0 Update 6 on your machine because the SDK is not included.

Note: JDeveloper provides OJVM, and OJVM can be installed for use with JDeveloper, but this configuration is only supported for JDeveloper projects, not the JDeveloper IDE.

To install JDeveloper from jdevstudiobase10135.zip:

  1. If you don't have JDK 5.0 Update 6 installed, you can obtain it from: http://www.javasoft.com.
  2. Unzip jdevstudiobase10135.zip to the target directory.
  3. Set the variable SetJavaHome in the file <jdev_home>\jdev\bin\jdev.conf to the location of your SDK installation. Use an editor that recognizes UNIX end-of-line characters, such as WordPad. When you save the file, WordPad will warn you that it is about to save the file in text-only format. You can ignore this warning.

    For example, in a Windows environment, if the location of your JDK 5.0 Update 6 is in a directory called jdk1.5.0_06 on your D: drive, your entry in jdev.conf would look like:

    SetJavaHome d:\jdk1.5.0_06
  1. In order to use the Profilers and CodeCoach, you will need to install OJVM, the specialized Oracle Java Virtual Machine for JDeveloper. The OJVM will also make the JDeveloper debugger run more quickly. See Installing OJVM in the next section.

    Note: JDeveloper provides OJVM, and OJVM can be installed for use with JDeveloper, but this configuration is only supported for JDeveloper projects, not the JDeveloper IDE.

2.2.1 Installing OJVM

To use CodeCoach and the Profilers with a base installation you need to install OJVM, the specialized Oracle Java Virtual Machine for JDeveloper. OJVM will also increase the speed of the JDeveloper debugger, and provide automatic deadlock detection and memory debugging features. If you performed the complete installation using jdevstudio10135.zip, OJVM was installed automatically.

If you perform the base installation using jdevstudiobase10135.zip, you are prompted to install OJVM into your SDK. JDeveloper copies OJVM files into the specified SDK and updates the configuration of that SDK. The files are copied into a separate OJVM directory and will not overwrite any of the existing files in the SDK. You can install or update OJVM later if you decline the installation at startup.

To install or update OJVM with a base installation:

  1. From the main menu select Tools | Manage Libraries.
  2. Click the J2SE Definitions tab.
  3. In the Definitions list select the SDK into which OJVM is to be installed.
  4. In the right pane, OJVM Successfully Installed/Updated indicates whether or not OJVM is currently installed or updated with the most recent version. If it is not, the Install or Update button is active. Click to install or update OJVM.

2.3 Starting JDeveloper on Windows

To start JDeveloper on Windows, run any of the following files:

  • <jdev_home>\jdev\bin\jdevw.exe
  • <jdev_home>\jdev\bin\jdev.exe (to display a console window for internal diagnostic information)
  • <jdev_home>\jdeveloper.exe
Back to TOC

3.0 Installing and Starting JDeveloper on Linux and UNIX Platforms

This section provides additional instructions specific to installing JDeveloper on Linux and UNIX systems.

JDeveloper does not require an installer. To install JDeveloper, you will need an unzip tool. You can download a free, cross-platform unzip tool, Info-Zip, available at: http://www.info-zip.org/.

To install JDeveloper on Linux and UNIX platforms, unzip jdevstudiobase10135.zip in the directory you want to install JDeveloper. Ensure that this directory does not contain spaces. For example, do not use /home/jdoe/my apps as the installation directory.

Alert: Do not install this JDeveloper release into any existing ORACLE_HOME. You will not be able to uninstall it using Oracle Universal Installer.

3.1 Configuring Java SDK in JDeveloper

The base installation ( jdevstudiobase10135.zip) does not contain the Java J2SE SDK for running JDeveloper and creating projects. If you install JDeveloper on Linux or UNIX, perform the following steps to configure JDeveloper to use the appropriate SDK.

  1. If you don't have JDK 5.0 Update 6 installed, install it. You can get a copy for many operating systems from http://www.javasoft.com, or check with your OS vendor where to obtain a copy.
  2. Set the variable SetJavaHome in the file <jdev_home>/jdev/bin/jdev.conf to the location of your Java installation.

    For example, in a UNIX environment, if the location of your JDK is in a directory called /usr/local/java, your entry in jdev.conf would look like:

    SetJavaHome /usr/local/java

3.2 Modifying Permissions on Linux and UNIX Platforms

All JDeveloper files must have read permissions which can be set by issuing:

chmod -R g+r <jdev_home>

Users (or groups) must have write permissions for the following files (required for deployment):

Note: < jdev_home>/j2ee/home/application-deployments is not available until you run java -jar oc4j.jar -install

  • < jdev_home>/j2ee/home/application-deployments
  • < jdev_home>/j2ee/home/applications
  • < jdev_home>/j2ee/home/config

3.3 Cursor Problems

On UNIX or Linux platforms, the Java cursors may display large and opaque, creating difficulties when used for drag and drop operations. To address this problem JDeveloper provides a set of cursors to replace the default set. You must have write access to the Java SDK in order to replace the cursors.

To replace the cursors:

  1. Make a back-up copy of the default cursors located in the SDK directory at:

    <jdk_install>/jre/lib/images/cursors

  2. Extract the replacement cursors from the tar file at:

    <jdev_home>/jdev/bin/clear_cursors.tar

3.4 Starting JDeveloper on Linux and UNIX Systems

To start JDeveloper on Linux and UNIX, run the file <jdev_home>/jdev/bin/jdev .

Back to TOC

4.0 Installing and Starting JDeveloper on Mac OS X Platforms

JDeveloper is provided as a self-contained application bundle. An installer is not required.

You must update your Mac OS X SDK to Java Sun version 1.5 release 1 or later for use with JDeveloper. Use Mac OS X Software Update or download from http://www.apple.com/support/downloads/java2se50release1.html .

To install JDeveloper from jdevstudio10135.dmg:

  1. Mount the JDeveloper 10.1.3.5.0 Disk Image by double-clicking the .dmg file.
  2. Drag the JDeveloper application to a location on your hard drive; for example, Applications.
  3. Start JDeveloper by double-clicking the JDeveloper application.
  4. If starting JDeveloper for the first time answer:
    • Yes to create a JDeveloper user home.
    • No to migrate from a previous version.

    Note that by default JDeveloper files are stored under /Users/ <username>/jdevhome .

Back to TOC

5.0 Migrating User Settings from Previous Releases

User settings such as system settings, libraries, connections, and projects from the production release of JDeveloper 9.0.4.3 can be migrated to this release of JDeveloper. Oracle does not support direct migration from any release prior to JDeveloper 9.0.4.3. If you are running a newly installed version of JDeveloper for the first time you will be prompted with a Migrate User Settings dialog. You can use this dialog to migrate your user settings by selecting Yes. If you select No, any settings that you set on the first and subsequent runs will be overwritten if you later run JDeveloper with the -migrate flag. For information about migration issues, see the "Migrating to JDeveloper 10g" topics in the online documentation, which you can access by choosing Help | Table of Contents | Getting Started with JDeveloper from the JDeveloper main menu.

To migrate user settings from previous installations of JDeveloper:

  1. Start JDeveloper at a command line or shell prompt with the -migrate flag:

    jdev -migrate

  2. When the Migrate User Settings dialog appears, select a version of JDeveloper to migrate. If the Version dropdown list is empty, click Browse.
  3. Browse for the location of the system directory of the source installation of JDeveloper, for example:
    <previous_jdev_home>/jdev/system9.0.4.3.1354 where <previous_jdev_home> is the root directory and 9.0.4.3.1354 represents the previous build version of the installation of JDeveloper you are migrating from. For UNIX users, any previous releases that are discovered will already be included in the dropdown list of the dialog.
  4. Select the settings and customizations you want to migrate. Oracle recommends that you select all available options.
  5. Click OK. Your user settings are migrated to your latest version of JDeveloper.

Back to TOC

6.0 Enabling JDeveloper Extensions

Before you can use an extension in JDeveloper, you first need to download the extension from OTN. An example of available JDeveloper Extensions is JUnit.

To automatically download and install a JDeveloper extension:

  • From the JDeveloper main menu, select Help | Check for Updates.
    This menu option lists extensions that you don't have, lists newer versions of ones you have, and downloads them after you select them. After you restart JDeveloper, you will be able to use the extension.

To manually download a JDeveloper Extension:

  1. Go to http://www.oracle.com/technology/products/jdev/htdocs/partners/addins/exchange/index.html.
  2. Select a JDeveloper Extension.
  3. Follow the instructions to download the zip file.

To manually install a JDeveloper extension:

  1. Verify if there are additional installation instructions in the extension archive.
  2. From the JDeveloper main menu, select Help | Check for Updates.
  3. On Step 1 of the wizard, select Install from a Local File and navigate to the ZIP file.
  4. Finish the wizard and restart JDeveloper. After you restart JDeveloper, you will be able to use the extension.

For additional information, see the "Extending JDeveloper" topics in the online documentation, which you can access by choosing Help | Table of Contents from the JDeveloper main menu.

Back to TOC

7.0 Setting the User Home Directory

This section provides instructions on how to define a user home environment variable and set its value for each user in order for JDeveloper to identify user home directories correctly.

The user home directory contains the user's preferences for JDeveloper (in the system subdirectory). It is also the default location for new projects (in the mywork subdirectory) as well as other configuration files that are specific to a given user.

To define the name of the user home environment variable:

  1. Open the file <jdev_home>\jdev\bin\jdev.conf in a text editor. Use an editor that recognizes UNIX end-of-line characters, such as WordPad.
  2. Find the entry:

    SetUserHomeVariable JDEV_USER_DIR


    This is the default variable that JDeveloper will look for at startup. As the terminal server administrator, you may change the name of this variable to follow your system's naming conventions.
  3. Save the file. If you are using WordPad, it will warn you that it is about to save the file in text-only format. You can ignore this warning.

7.1 Setting the Home Environment Variable on Windows

To set the home environment variable on Windows systems:

Note: Each user of JDeveloper on a multiuser system must follow these procedures.

  1. From the Windows Start menu, choose Control Panel | System.
  2. Select the Advanced tab, then click Environment Variables.
  3. In the User Variables section, click New.
  4. Add JDEV_USER_DIR, or the name you chose for the SetUserHomeVariable, as a user variable.
  5. Set the value of this variable to your home directory (e.g., N:\users\jdoe), and click OK.
  6. To check your variable setting, open a command shell and enter:

    set

    You should see output similar to the following:

    JDEV_USER_DIR=N:\users\jdoe

  7. Launch JDeveloper.
  8. Choose Help | About to verify that the value of ide.user.dir is set to your user home directory.

By default, the user home directory on Windows is <jdev_home>\jdev .

7.2 Setting the Home Environment Variable on Linux and UNIX

Follow the steps below to set the environment variable on Linux and UNIX systems. The examples and syntax provided refer to the C Shell.

  1. In your startup configuration file (for example, .cshrc), set the environment variable to your preferred directory:

    setenv JDEV_USER_DIR $HOME/mydocs/jdevfiles

  2. Source the file to make your changes take effect:

    source .cshrc

  3. Display the environment variable to confirm the change:

    echo $JDEV_USER_DIR

    You should see output similar to the following:

    /home/jdoe/mydocs/jdevfiles

  4. Launch JDeveloper.
  5. Choose Help | About to confirm that the value of ide.user.dir is set to your user home directory.

By default, the user home directory on Linux and UNIX is $HOME/jdevhome.

7.3 Setting the Home Environment Variable on Mac OS X

Follow the steps below to set the environment variable on Mac OS X systems. The examples and syntax provided refer to the BASH shell.

  1. In your startup configuration file (for example, .bashrc), set the environment variable to your preferred directory:

    JDEV_USER_DIR=$HOME/mydocs/jdevfiles

  2. Export the new value of the environment variable:

    export JDEV_USER_DIR

  3. Source the file to make your changes take effect:

    . .profile

  4. Display the environment variable to confirm the change:

    echo $JDEV_USER_DIR

    You should see output similar to the following:

    /Users/jdoe/mydocs/jdevfiles

  5. Launch JDeveloper.
  6. Choose Help | About to confirm that the value of ide.user.dir is set to your user home directory.

By default, the user home directory on Mac OS X is $HOME/jdevhome.

Back to TOC

8.0 Using JDeveloper in a Multiuser Environment

If you are using JDeveloper on Linux or UNIX, you will have to set permissions on directories and files. See Modifying Permissions on Linux and UNIX Platforms for more information.

You can install JDeveloper in Microsoft Terminal Server, Citrix MetaFrame and MetaFrame XP (for Windows), and MetaFrame 1.1 for UNIX environments. These environments allow many clients to access one installation of JDeveloper. In all cases, users can save their projects locally.

When installing and configuring JDeveloper for a multiuser environment, you'll need to account for resource planning, such as number of users and power of the server to deliver optimal performance for JDeveloper and your users.

8.1 Installing JDeveloper on a Citrix MetaFrame Server or a Microsoft Terminal Server

You need to have administrative privileges to install JDeveloper.

To Install JDeveloper on a Citrix MetaFrame or Microsoft Terminal Server:

  1. Install JDeveloper as described in Installing and Starting JDeveloper on Windows.
  2. Define the user home directory environment variable (see below).

8.2 Configuring User Home Directories in a Multiuser Environment

Before you run JDeveloper in a terminal server environment, you must define the user home environment variable and set its value for each user in order for JDeveloper to identify user home directories correctly. If the variable is not defined and set, JDeveloper uses the <jdev_home>/jdev as the home directory for all users. Using this directory may cause unstable behavior in JDeveloper with multiple users. See Setting the User Home Directory for instructions specific to configuring user home directory environment variables.

8.3 Configuring Terminal Server Clients for Running JDeveloper

These topics assume that you have already installed a Citrix MetaFrame or Microsoft Terminal Server client locally and that JDeveloper has been installed and configured by the system administrator.

To configure a terminal server client for running JDeveloper:
  1. Verify that the color resolution of the terminal server client has been set to a minimum of 256 colors. This minimum resolution is required by Java JDK 5.0 Update 6.
  2. Log on to your terminal server.
  3. Verify that the user home environment variable has been defined: Ask your system administrator for the naming convention that is used on your system. The default variable is JDEV_USER_DIR.
  4. Set the user home environment variable: from the Windows Start menu, choose Control Panel | System.
    1. Select the Advanced tab, then click Environment Variables.
    2. In the User Variables section, click New.
    3. Add the variable to User Variables and click OK.
      For example, you can define JDEV_USER_DIR as the variable containing the path to the user's home directory.
    4. To check the correct variable settings, open a command shell and enter:

      set

      You should see output similar to the following:

      JDEV_USER_DIR=n:\users\jdoe

  5. Launch JDeveloper.
  6. JDeveloper will ask if you would like your user home directory to be created. Select Yes.
  7. Choose Help | About to verify that the value of ide.user.dir is set to your user home directory.

If you run JDeveloper in a multiuser environment and you see the error

The system DLL ole32.dll was relocated in memory. The application will not run properly. The relocation occurred because the DLL Dynamically Allocated Memory occupied an address range reserved for Windows NT system DLL's. The vendor supplying the DLL should be contacted for a new DLL.

you'll need to update the <jdev_home>\jdev\bin\jdev.conf file by uncommenting the line:

AddVMOption -Xheapbase100000000

Use an editor that recognizes UNIX end-of-line characters, such as WordPad. You may have to change the number upward or downward if you still get the error when starting JDeveloper. When you save the file, WordPad will warn you that it is about to save the file in text-only format. You can ignore this warning.

In addition, you will need to set the same option with the same value in Project | D efault Project Settings | Runner | Java options.

To make this setting available to all users, the administrator should perform this change, exit JDeveloper and then copy the file:

<userhome>\system\DefaultWorkspace\Project1.jpr.

<jdev_home>\jdev\multi\system\DefaultWorkspace\Project1.jpr .
Back to TOC

9.0 Using OC4J with JDeveloper

Included with JDeveloper is a fully functioning version of Oracle Application Server 10g Release 3 (10.1.3.5) Containers for J2EE (OC4J). The embedded server resides in the following location in the JDeveloper installation:

<JDEV_USER_DIR>/system/oracle.j2ee.10.1.3.xx.xx/embedded-oc4j

If you are using JDeveloper to test your J2EE applications before deploying to a target application server, you will not have to make any modifications to your configuration.

If you performed the base installation of JDeveloper and wish to deploy your application to OC4J in standalone mode, JDeveloper includes a copy of OC4J in <jdev_home>/j2ee/home/config . To run OC4J in standalone mode you must set the JAVA_HOME variable to point to the full SDK. You must also modify jdev.conf to point to this SDK home. See Installing JDeveloper Base for more information.

If you deploy your applications to standalone OC4J, make sure that you use the remote admin.jar file that was shipped with the remote OC4J. If you are using an admin.jar that doesn't match the version of OC4J to which you are deploying, deployment may fail. You can configure deployment to use the correct admin.jar for the OC4J standalone instance when you set up your connection using the JDeveloper Application Server Connection Wizard. To identify the standalone OC4J version that you are using, enter java -jar oc4j.jar -version from your OC4J installation directory.

You can start and stop the OC4J server in standalone mode using the provided start_oc4j.bat and stop_oc4j.bat files and shell scripts located in <jdev_home>\jdev\bin\. The start_oc4j batch file can be run either from Windows Explorer or the command line since no arguments are required; however the stop_oc4j batch file requires <admin> and <admin-password> on the command line. You can also run the following commands from the <jdev_home>\j2ee\home\ directory:

To start the OC4J server for use in standalone mode:

  1. Execute the following command:

    java -jar oc4j.jar

  2. Enter and confirm the administrator password.

To stop OC4J:

  • Execute the following command:

    java -jar $j2ee_home/admin.jar ormi://localhost/ <admin> <admin-password> -shutdown

Note: The server must be running when you deploy projects to it.

 

9.1 OC4J Memory Requirements

By default, OC4J preloads a large number of classes to improve performance. Because of this, you may get a java.lang.OutOfMemoryError when you attempt to deploy to OC4J or run an application after deploying.

If you get a java.lang.OutOfMemoryError, you have two options:

  • If your machine lacks sufficient free memory to run OC4J with a larger maximum heap size, shut down the Java process that runs OC4J and restart it with the -Doracle.j2ee.dont.use.memory.archive=true flag to turn off class preloading, for example:

    Java -Doracle.j2ee.dont.use.memory.archive=true -jar oc4j.jar

  • If your machine has at least 512 MB of free memory, OC4J will run more quickly if you leave preloading enabled, but startup time will increase considerably. Shut down the Java process that runs OC4J, and restart it with a larger maximum heap size using the -mx flag, for example:

    Java -mx512M -jar oc4j.jar

For more information on fine tuning your OC4J server instance, see the OC4J documentation.

Back to TOC

10.0 Application Servers Supported by JDeveloper

A matrix associating JDeveloper versions with the application servers they support for deployment is available on Oracle Technology Network (OTN) at: http://www.oracle.com/technology/products/jdev/collateral/papers/10g/as_supportmatrix.html.

For additional information, see the "Deploying Applications " topics in the online documentation, which you can access by choosing Help | Table of Contents from the JDeveloper main menu.

Back to TOC

11.0 Database Certification for JDeveloper

A matrix that associates Oracle and non-Oracle databases with the JDeveloper features they are certified against is available on Oracle Technology Network (OTN) at: http://www.oracle.com/technology/products/jdev/collateral/papers/10131/cert/database.html

Back to TOC

12.0 Web Browsers Supported by JDeveloper

JDeveloper supports the following web browsers:

  • IE 5.5
  • IE 6.0
  • IE 7.0
  • IE 8.0
  • Netscape 7.2
  • Mozilla 1.7
  • Firefox 1.0.4
  • Firefox 1.5
  • Firefox 2.x
  • Firefox 3.x
  • Safari 2.x (Mac-Specific)

Back to TOC

13.0 Finding JDeveloper Accessibility Information

For the latest configuration information or for information on addressing accessibility and assistive technology issues, see the Oracle Accessibility FAQ at http://www.oracle.com/accessibility/faq.html. Also, see the help topics available by selecting the JDeveloper Accessibility Information node under Getting Started with Oracle JDeveloper in the online help table of contents.

Back to TOC

14.0 Using a Screen Reader and Java Access Bridge with JDeveloper

To make the best use of our accessibility features, Oracle Corporation recommends the following minimum technology stack:

  • Windows NT 4.0 (with Service Pack 6), Windows 2000, or Windows XP
  • Java Sun J2SE 1.5.0_05
  • Sun Java Access Bridge 1.2 or higher
  • JAWS 3.70.87 or 5.0.0.844+
  • Microsoft Internet Explorer 5.5 or higher

Please refer to the following information to set up a screen reader and Java Access Bridge. If you are using JAWS 3.70.87, please refer to the additional configuration information provided below the procedure.

  1. Install the screen reader, if it is not already installed.

    Refer to the documentation for your screen reader for more information about installation.

  2. Install JDeveloper.

    Refer to the Installation Guide for more information about installing JDeveloper.

  3. Download Java Access Bridge for Windows version 1.2. The file you will download is accessbridge-1_2.zip. It is available from:
    www.oracle.com/technetwork/java/javase/tech/index-jsp-136191.html.

    Refer to the Java Access Bridge documentation available from this web site for more information about installation and the Java Access Bridge.

  4. After downloading the file, extract (unzip) the contents to a folder, for example, accessbridge_home.
  5. Install Java Access Bridge by running Install.exe from the <accessbridge_home>\installer folder.

    The installer first checks the SDK version for compatibility, then the Available Java virtual machines dialog displays.

  6. Click Search disks. Then select to search only the drive that contains the JDeveloper build and the SDK version in the program files directory (if it exists).

    The search process can take a long time on a large disk with many instances of SDK or JDeveloper, or when searching multiple disks. However, unless you complete an exhaustive search of your disk, Access Bridge will not be optimally configured, and will not be correctly installed to all of the Java VMs on your system. After selecting the disk to search, click Search.

  7. Confirm that you want to install the Java Access Bridge into each of the Java virtual machines displayed in the dialog, by clicking Install in All.
  8. Click OK when you see the Installation Completed message.
  9. Confirm that the following files have been installed in the Winnt\System32 directory (or the equivalent Windows 2000 or XP directory), or copy them from <accessbridge_home>\installer\installerFiles as they must be in the system path in order to work with JDeveloper:

    JavaAccessBridge.dll
    JAWTAccessBridge.dll
    WindowsAccessBridge.dll

    Note that the system directory is required in the PATH system variable.

  10. Confirm that the following files have been installed in the <jdev_home>\jdk\jre\lib\ext directory, or copy them from <accessbridge_home>\installer\installerFiles:

    access-bridge.jar
    jaccess-1_3.jar
    jaccess-1_4.jar
    JavaAccessBridge.dll
    JAWTAccessBridge.dll
    WindowsAccessBridge.dll

  11. Confirm that the file accessibility.properties has been installed in the <jdev_home>\jdk\jre\lib directory, or copy it from <accessbridge_home>\installer\installerFiles. Confirm that the file accessibility.properties includes the following three lines:

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

  12. Only if you are using JAWS version 3.7, do the following: modify the file jdev.conf located in the folder <jdev_home>\jdev\bin to uncomment the AddVMOption line as shown below:

    #
    # Prepend patches to the bootclasspath. Currently, rtpatch.jar contains a
    # patch that fixes the javax.swing.JTree accessibility problems.
    # Uncomment the line below if you need to run JDeveloper under JAWS.
    #
    AddVMOption -Xbootclasspath/p:../../jdk/jre/lib/patches/rtpatch.jar

  13. Start your screen reader.
  14. Start JDeveloper by running the file jdev.exe located in the folder <jdev_home>\jdev\bin.

The steps above assume you are running Windows and using a Windows-based screen reader. A console window that contains error information (if any) will open first and then the main JDeveloper window will appear, once JDeveloper has started. Any messages that appear will not affect the functionality of JDeveloper.

14.1 Configuring JAWS 3.70 and Access Bridge with JDeveloper

The following combinations of Access Bridge file versions are necessary to achieve optimal functionality with JAWS 3.70 since this version of the screen reader uses older Java technology than is used in JDeveloper 10.1.3.5.0. There are two stacks of software technology listed below for those who want to use either version 1.0.3 or 1.0.4 of the Access Bridge. Also required in the system32 directory is a copy of the latest version of the Access Bridge jar file.

Access Bridge v. 1.0.3 Configuration for JDeveloper 10.1.3.5.0

Place the following files in the JDeveloper directory [ \jdk\jre\lib\ext]:

access-bridge.jar

size: 27295

version: access-bridge-1.0.4

JAWTAccessBridge.dll

size: 28672

version: AccessBridge-1.0.3

jaccess-1_3.jar

size: 43584

version: AccessBridge-1.0.3

jaccess-1_4.jar

size: 46597

version: AccessBridge-1.0.3

JavaAccessBridge.dll

size: 139264

version: AccessBridge-1.0.3

WindowsAccessBridge.dll

size: 77824

version: AccessBridge-1.0.3

Place the following file in the JDeveloper directory [ \jdk\jre\lib]:

accessibility.properties

size: 353

version: AccessBridge-1.0.3

Place the following files in the Windows system32 directory [\winnt\system32]:

JavaAccessBridge.dll

size: 155648

version: AccessBridge_1_1_GA

WindowsAccessBridge.dll

size: 77824

version: AccessBridge-1.0.3

JAWTAccessBridge.dll

size: 28672

version: AccessBridge-1.0.3

Access Bridge v. 1.0.4 Configuration for JDeveloper 10.1.3.5.0

Place the following files in the JDeveloper directory [ \jdk\jre\lib\ext]:

access-bridge.jar

size: 27295

version: access-bridge-1.0.4

JAWTAccessBridge.dll

size: 32768

version: AccessBridge-1.0.4

jaccess-1_4.jar

size: 46573

version: AccessBridge-1.0.4

JavaAccessBridge.dll

size: 139264

version: AccessBridge-1.0.4

WindowsAccessBridge.dll

size: 77824

version: AccessBridge-1.0.4

Place the following file in the JDeveloper directory [ \jdk\jre\lib]:

accessibility.properties

size: 153

version: AccessBridge-1.0.4

Place the following files in the Windows system32 directory [ \winnt\system32]:

JavaAccessBridge.dll

size: 155648

version: AccessBridge_1_1_GA

WindowsAccessBridge.dll

size: 77824

version: AccessBridge-1.0.3

JAWTAccessBridge.dll

size: 28672

version: AccessBridge-1.0.3


Back to TOC

15.0 Uninstalling JDeveloper

Before you uninstall JDeveloper, you may want to backup your projects and files. By default, these files are in <jdev_home>\jdev\mywork .

To uninstall JDeveloper, remove the entire JDeveloper installation directory. No other actions are necessary.

Back to TOC

16.0 Oracle on the Web

Oracle provides a number of resources on the Web. These are some sites you may find helpful:

 

Description  URL 

JDeveloper Home Page  

http://www.oracle.com/technology/products/jdev/ 

JDeveloper Discussion Forum

http://www.oracle.com/technology/discussionforums/jdev.html 

Corporate Site 

http://www.oracle.com/  

Oracle Developer Suite-JDeveloper

http://www.oracle.com/tools/index.html

Oracle Technology Network 

http://www.oracle.com/technology/

Worldwide Customer Support 

http://www.oracle.com/support/ 

Oracle Accessibility Site

http://www.oracle.com/accessibility/

Back to TOC

Oracle Corporation
World Headquarters
500 Oracle Parkway
Redwood Shores, CA 94065, USA
http://www.oracle.com

Worldwide Inquiries:
1-800-ORACLE1
Fax 650.506.7200

Copyright © 2009, Oracle. All Rights Reserved.

 

false ,,,,,,,,,,,,,,,