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.
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
CPU Type and Speed
Pentium IV 2 GHz or faster
Memory
Studio Edition: 2 GB RAM
Display
65536 colors, set to at least 1024 X 768 resolution
Note: If you want to use JDeveloper in a multiuser UNIX environment, Oracle recommends a minimum of 2 GB RAM and 4 GB of swap space per concurrent user.
Note: This document uses jdev<edition>1111.zip or jdev<edition>base1111.zip to represent the JDeveloper installation zip file. For example, if you are installing the Studio edition, jdev<edition>1111.zip and jdev<edition>base1111.zip would refer to jdevstudio1111.zip and jdevstudiobase1111.zip, respectively.
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.
Alert: Ensure that you install JDeveloper into a directory that 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.1 Installing the Complete Version
The complete installation (jdev<edition>1111.zip) includes the Windows version of JDK 5.0 and the JDeveloper documentation.
To install the complete version, unzip jdev<edition>1111.zip in the directory you want to install JDeveloper.
2.2 Installing JDeveloper Base
For quicker download times, you can download the base installation (jdev<edition>base1111.zip). The base installation requires that you already have JDK 5.0 on your machine because the JDK is not included.
To install JDeveloper from jdev<edition>base1111.zip:
Unzip jdev<edition>base1111.zip to the target directory.
Specify the location of your JDK installation in the dialog that appears when you start JDeveloper for the first time. You will need to enter the path to java.exe.
2.3 Starting JDeveloper on Windows
To start JDeveloper on Windows, run any of the following files:
<jdev_home>\jdeveloper.exe
<jdev_home>\jdev\bin\jdevw.exe
<jdev_home>\jdev\bin\jdev.exe (to display a console window for internal diagnostic information)
2.4 Specifying the JDK location on Windows Systems
Specify the location of your JDK installation in the dialog that appears when you start JDeveloper for the first time. You will need to enter the path to java.exe.
To change a JDK location that you have previously specified, set the variable SetJavaHome in the file <jdev_home>\jdev\bin\jdev.conf to the location of your JDK 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 is in a directory called jdk1.5.0_14 on your D: drive, your entry in jdev.conf would look like:
SetJavaHome d:\jdk1.5.0_14
2.5 User Directories on Windows
The new default directory structure for user-specific content in JDeveloper for Windows is provided below:
The default location for the system subdirectory is now %APPDATA%\JDeveloper\systemXX.XX.XX.XX, where:
%APPDATA% is the Windows Application Data directory for the user (usually C:\Documents and Settings\<user>\Application Data)
XX.XX.XX.XX is a unique number of the product build, for example, system11.1.1.0.22.47.89
The default location for user-generated content (previously stored in <jdev_home>\jdev\mywork) is now C:\JDeveloper\mywork.
For more information on user directories and how to set the value for the home environment variable, see Setting the User Home Directory.
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 jdev<edition>base1111.zip in the directory you want to install JDeveloper.
Alert: Do not install this JDeveloper release into any existing ORACLE_HOME. You will not be able to uninstall it using Oracle Universal Installer.
Alert: Ensure that you install JDeveloper into a directory that does not contain spaces.. For example, do not use /home/jdoe/my apps as the installation directory.
3.1 Configuring the JDK in JDeveloper
The base installation (jdev<edition>base1111.zip) does not contain the JDK 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 JDK.
When you start JDeveloper for the first time, the jdev script prompts you to provide the location of your JDK installation if it cannot locate it. You will need to enter the path to java.exe.
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-deploymentsis 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 JDK in order to replace the cursors.
To replace the cursors:
Make a back-up copy of the default cursors located in the JDK directory at:
<jdk_install>/jre/lib/images/cursors
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.
3.5 Specifying the JDK location on Linux and UNIX Systems
When you start JDeveloper for the first time, the jdev script prompts you to provide the location of your JDK installation if it cannot locate it. You will need to enter the path to java.exe.
To change a JDK location that you have previously specified, 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
4.0 Installing and Starting JDeveloper on Mac OS X Platforms
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 this version of JDeveloper on Mac OS X platforms, unzip jdev<edition>base1111.zip in the directory you want to install JDeveloper.
Alert: Do not install this JDeveloper release into any existing ORACLE_HOME. You will not be able to uninstall it using Oracle Universal Installer.
Alert: Ensure that you install JDeveloper into a directory that does not contain spaces. For example, do not use /home/jdoe/my apps as the installation directory.
4.1 Configuring the JDK in JDeveloper
The base installation (jdev<edition>base1111.zip) does not contain the JDK for running JDeveloper and creating projects. If you install JDeveloper on Mac OS X, perform the following steps to configure JDeveloper to use the appropriate JDK.
Set the variable SetJavaHome in the file <jdev_home>/jdev/bin/jdev.conf to the location of your Java installation. For example, 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
4.2 Modifying Permissions on Mac OS X 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-deploymentsis not available until you run java -jar oc4j.jar -install
Migration to this JDeveloper 11g Technology Preview 4 release from a previous release, and from this release to the final production release of JDeveloper 11.1.1.0.0 is not supported.
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.
Verify if there are additional installation instructions in the extension archive.
From the JDeveloper main menu, select Help | Check for Updates.
On Step 1 of the wizard, select Install from a Local File and navigate to the ZIP file.
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.
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 C:\JDeveloper\mywork\ directory) as well as other configuration files that are specific to a given user.
To define the name of the user home environment variable:
Open the file <jdev_home>\jdev\bin\jdev.boot in a text editor. Use an editor that recognizes UNIX end-of-line characters, such as WordPad.
Find the entry:
ide.user.dir.var = JDEV_USER_HOME, JDEV_USER_DIR
This is the default variable that JDeveloper will look for at startup. You can define or add any environment variable that JDeveloper should use. As the terminal server administrator, you may change the name of this variable to follow your system's naming conventions.
Note: You can explicitly set the home environment variable by adding the following line in the jdev.boot file: ide.user.dir = <Path to preferred user directory>
The output should look something like this: ide.user.dir = D:/users/jdoe
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.
The user home directory can also specified from the command line using this command:
jdev.exe -J-Dide.user.dir=<Path>
Example: jdev.exe -J-Dide.user.dir=D:/users/joe
7.1 Setting the Home Environment Variable on Windows
Alert: Do not set the home environment variable to a directory that contains spaces. For example, do not specify C:\My Projects as the home directory.
To set the home environment variable on Windows systems:
Note: Each user of JDeveloper on a multiuser system must follow these procedures.
From the Windows Start menu, choose Control Panel | System.
Select the Advanced tab, then click Environment Variables.
In the User Variables section, click New.
Add JDEV_USER_DIR, or the name you chose for ide.user.dir.var, as a user variable.
Set the value of this variable to your home directory (e.g., N:\users\jdoe), and click OK.
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
Launch JDeveloper.
Choose Help | About to verify that the value of ide.user.dir is set to your user home directory.
For information on the new default directory structure for Windows in this release of JDeveloper, see User Directories on Windows.
7.2 Setting the Home Environment Variable on Linux and UNIX
Alert: Do not set the home environment variable to a directory that contains spaces. For example, do not specify /home/jdoe/my projects as the home directory.
Follow the steps below to set the environment variable on Linux and UNIX systems. The examples and syntax provided refer to the C Shell.
In your startup configuration file (for example, .cshrc), set the environment variable to your preferred directory:
setenv JDEV_USER_DIR $HOME/mydocs/jdevfiles
Source the file to make your changes take effect:
source .cshrc
Display the environment variable to confirm the change:
echo $JDEV_USER_DIR
You should see output similar to the following:
/home/jdoe/mydocs/jdevfiles
Launch JDeveloper.
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
Alert: Do not set the home environment variable to a directory that contains spaces. For example, do not specify /home/jdoe/my projects as the home directory.
Follow the steps below to set the environment variable on Mac OS X systems. The examples and syntax provided refer to the BASH shell.
In your startup configuration file (for example, .bashrc), set the environment variable to your preferred directory:
JDEV_USER_DIR=$HOME/mydocs/jdevfiles
Export the new value of the environment variable:
export JDEV_USER_DIR
Source the file to make your changes take effect:
. .profile
Display the environment variable to confirm the change:
echo $JDEV_USER_DIR
You should see output similar to the following:
/Users/jdoe/mydocs/jdevfiles
Launch JDeveloper.
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.
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:
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 may want to 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 %APPDATA%\.jdeveloper directory for each user for storing system settings, and C:\JDeveloper\mywork as the default user source directory for all 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:
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.
Log on to your terminal server.
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.
JDeveloper will ask if you would like your user home directory to be created. Select Yes.
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, each user must modify the default project to apply this setting. To specify this value in the default project settings:
Select Tools | Default Project Properties.
In the Default Project Properties dialog, click Run/Debug/Profile, and then click Edit.
Click the Launch Settings node.
On the Launch Settings page, enter -Xheapbase100000000 in the Java Options field.
JDeveloper is pre-packaged with Oracle Containers for J2EE (OC4J), which you can use for testing your Java EE applications. In this technical preview release, the pre-packaged OC4J can be used in one of 4 modes, depending on your requirement.
For an explanation of the different modes, please refer to the Release Notes. For additional information on using OC4J with JDeveloper, please refer to the Help topic "Connecting and Deploying to OC4J Application Servers" in the online documentation.
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.
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 2.0.1
JAWS 7.0+
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 7.00.135U, please refer to the additional configuration information provided below the procedure.
Install the screen reader, if it is not already installed.
Refer to the documentation for your screen reader for more information about installation.
Install JDeveloper.
Refer to the Installation Guide for more information about installing JDeveloper.
Download Java Access Bridge for Windows version 2.0.1. The file you will download is accessbridge-2_0_1.zip. It is available from: http://java.sun.com/products/accessbridge.
Refer to the Java Access Bridge documentation available from this web site for more information about installation and the Java Access Bridge.
After downloading the file, extract (unzip) the contents to a folder, for example, accessbridge_home.
Install Java Access Bridge by running Install.exe from the <accessbridge_home>\installer folder.
The installer first checks the JDK version for compatibility, then the Available Java virtual machines dialog displays.
Click Search disks. Then select to search only the drive that contains the JDeveloper build and the JDK 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 JDK 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.
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.
Click OK when you see the Installation Completed message.
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:
Note that the system directory is required in the PATH system variable.
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_4.jar
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:
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 7.0 and Access Bridge with JDeveloper
The following combinations of Access Bridge file versions are necessary to achieve optimal functionality with JAWS 7.0. Also required in the system32 directory is a copy of the latest version of the Access Bridge jar file.
Access Bridge v. 2.0.1 Configuration for JDeveloper
Place the following files in the JDeveloper directory [\jdk\jre\lib\ext]:
access-bridge.jar jaccess-1_4.jar
Place the following file in the JDeveloper directory [\jdk\jre\lib]:
accessibility.properties
Place the following files in the Windows system32 directory [\winnt\system32]:
To uninstall JDeveloper, remove the entire JDeveloper installation directory. No other action is necessary.
Note: In a default installation, removing the installation directory does not remove the user-specific content (applications and projects, source code, user settings, etc.). To locate and remove these, please refer to Setting the User Home Directory.