C H A P T E R 8 - Setting Up the Java Studio Enterprise IDE

C H A P T E R 8

Setting Up the Java Studio Enterprise IDE

After you have installed the IDE, use the information in this chapter to start, set up, and register your software.

This chapter covers the following topics:

Starting the IDE

Setting Up the IDE

Using the Startup Options

Java Studio Enterprise IDE User Directory

Starting the IDE

When you first start the IDE, you are prompted to do the following tasks:

Import your customized settings from previous versions

Indicate whether you would like automatic update checking

To Start the IDE (Microsoft Windows Systems)

Use one of these methods:

Double-click the Java Studio Enterprise icon located on your desktop.

Choose Start Programs Sun Microsystems Java Studio Enterprise 2004Q1 Start Java Studio Enterprise.

Start the IDE at the command line by following these steps:

1. In the Command Prompt window, change to the installation directory containing the IDE executable. For example

C:\> cd java-studio-install-dir\Ent6_04Q1\bin

2. Start the IDE using one of the following commands:

Use runidew.exe to start the IDE with the default launcher used by the desktop icon.

C:\> runidew.exe

To start the IDE and display messages in the Windows Console, type:

C:\> runide.exe

The runide.exe command options can be specified on the command line or in the java-studio-install-dir\Ent6_04Q1\bin\ide.cfg file. See Using the Startup Options.

To Start the IDE (Solaris Systems)

1. Change to the installation directory containing the IDE executable. For example:

% cd java-studio-install-dir/Ent6_04Q1/bin

2. Start the IDE.

% ./runide.sh

The runide.sh command options can be specified on the command line or in the java-studio-install-dir/Ent6_04Q1/bin/ide.cfg file. See Using the Startup Options.

Setting Up the IDE

The IDE has the following wizards that enable you to control aspects of the IDE environment:

Settings Import Wizard

Setup Wizard

Registration Wizard

Settings Import Wizard

The Settings Import wizard appears the first time that you start the IDE. The wizard enables you to import settings from prior versions of the IDE for use with Java Studio Enterprise. If you do not need to import settings, then select No, and click Start IDE.

Setup Wizard

You can access the Setup wizard by choosing Tools right arrow Setup Wizard from the main IDE window.

In the Setup wizard you can do the following:

Set the IDE display window mode (MDI or SDI)

Specify the web browser to use for internal and external web pages

Set the web proxy settings to use if you are behind a firewall

Use the Module Installation page to enable or disable IDE modules

Use the Update Center page to control the following:

Automatic update checking

Frequency of automatic updates

Update Center URL to check

Registration Wizard

The Registration wizard appears the first time that you start the IDE. This wizard enables you to register with the Sun Developer Resources web site.

Registering your software through the web enables you to do the following:

Use the Update Center to download and install new modules and updates specific to your environment

Receive product announcements, if desired

If you decide to register with Sun Developer Resources at a later time, choose Help right arrow Registration Wizard from the main window of the IDE.

To Enable or Disable IDE Modules

1. Choose Tools > Setup Wizard from the main menu.

2. Click Next until the Module Installation page is displayed.

3. Expand the module category node for a list of modules.

Click on the module icon to see a short description of the module function.

4. Disable or enable a module by toggling the Enabled property value to true or false.

By default, all the modules installed with the IDE are enabled except the WebLogic Server Deployment Module (the WebLogic plug-in). For information on enabling this module, see Chapter 13.

Using the Startup Options

The runide startup scripts can be run with additional command-line options.

You can use the options in the following ways:

Type the options on the command line

Put the options in the java-studio-install-dir/Ent6_04Q1/bin/ide.cfg file

The IDE reads the ide.cfg file before parsing any command-line options. You can type options on multiple lines in the ide.cfg file.

TABLE 8-1 lists the runide command-line options.


Option	Description
`-h -help`	Prints a description of the available options and their usage.
`-jdkhome` jdk-home-dir	Specifies the location of a J2SE platform other than the default that was specified during installation.
`-cp:p` additional-classpath	Prepends the specified class path onto the IDE's class path.
`-cp:a` additional-classpath	Appends the specified class path to the IDE's class path.
`-userdir` IDE-user-dir	Specifies the IDE-user-dir (the location where your user settings are stored). If this option is not specified, the default location is used. See Java Studio Enterprise IDE User Directory.
`-J` jvm-flags	Passes specified flags directly to the Java Virtual Machine (JVM⁾software.
`-Xverify:none`	`-J` `-Xverify:none` tells the JVM software not to verify the correctness of the bytecode, thereby providing for faster startup time. Setting this flag removes some of protection that the Java language gives you. Refer to the JVM software documentation for more information.
`-Xms24m`	`-J` `-Xms24m` sets the initial heap size of the JVM software to 24 MB. This flag prevents the JVM software from extending the heap size during startup, thereby providing a faster startup time.
-`Xmx96m`	maximum Java heap size
`-Xss1024k`	Thread stack size
(Microsoft Windows only) `hotspot` or -`classic`	Specifies the Java virtual machine (JVM) variant to be used. The terms "Java virtual machine" and "JVM" mean a virtual machine for the Java platform.
`"-ui"` UI_class_name	Sets the specified UI class as the IDE's look and feel.
`"-fontsize"` size	Sets the font size, expressed in points, in the IDE's user interface. The default value is 11.

Java Studio Enterprise IDE User Directory

The IDE stores user-specific data in the user directory. Examples of this information are IDE settings and options and other necessary runtime data for personal development servers, such as the PointBase Server, UDDI Registry Server and Tomcat. The user directory also contains the ide.log file, which provides useful information when requesting technical support.

The default location for this directory on a Microsoft Windows system %SystemDrive%:\Documents and Settings\user-id\jstudio_6ee_user.

On a Solaris system, the default location is $HOME/jstudio_6ee_user.

The minimum space requirement for this directory for initial installation is 5.5 MB. Actual runtime space usage varies depending on your component use within the IDE.

The first time that you start the IDE, you can specify an alternate location for the user directory by starting the IDE from the command line and using the command line -userdir option. See TABLE 8-1 for additional command-line options.

Troubleshooting During Setup of the IDE

This section describes problems you might receive during startup and configuration of the newly installed IDE.

1. You experience performance problems running the IDE.

Reason. You may not have sufficient virtual memory or swap space.

Solution. Increase your virtual memory or swap space to 1.5 to 2 times the amount of your machines's installed RAM.

2. Trying to access links from the IDE Welcome page, you see an exception such as:.

Could not access the URL through the external browser. Check the browser configuration...

Reason. Your external web browser may not be set correctly.

Solution. Follow these steps to set your external browser.

a. Choose Options from the Tools menu.

b. In the Options window, expand the IDE Configuration node.

c. Expand the Server and External Tool Settings node.

d. Expand the Web Browsers node.

e. Select the external browser type and modify the Browser Executable property and the DDE Server property to the proper value for your external browser.

If this does not fix the problem, then follow these steps:

(Windows)

a. Select the Java Studio Enterprise icon on the desktop and right-click.

b. Select properties.

c. Edit the Target field as follows:

C:\ java-studio-install-dir\bin\runidew.exe -userdir pathname-to-user-directory

(Solaris)

Start the IDE from the command line using the startup option -userdir. See also Java Studio Enterprise IDE User Directory.

3. When you select one of the IDE Start Menu items that take you to a web page, you see the following error message:

Error: Cannot find the file C:\Sun\jstudio\AppServer7\docs\about.html. Make sure the path and filename are correct and that all required libraries are available.

Reason. This error is a Microsoft Windows error that occurs when using a Netscape browser. If you have Netscape set as the program to open HTML pages, but you don't set Netscape as your default browser, you may see this error.

Solution. Click OK to dismiss the error. Set Netscape as your default browser, or set Internet Explorer as the program to open HTML pages.

4. A subsequent error message appears after dismissing the one described above.

Error: Unable to run this command.

Click OK to dismiss this error. Set Netscape as your default browser.