4 - C H A P T E R -

C H A P T E R 4

Using Your Newly Installed Sun ONE Studio 4 IDE

After you have successfully installed the Sun ONE Studio 4 IDE, use the information in this chapter to start, set up, and register your IDE. Details about the available command-line switch options are also included.

Setting Up Your Sun ONE Studio 4 IDE

When you first start up the Sun ONE Studio 4 IDE, you are prompted to:

Specify the user directory to use with the IDE

Indicate whether you would like automatic update checking

Use the following steps to guide you through setup of your initial IDE environment:

1. Start the Sun ONE Studio 4 IDE.

For a Microsoft Windows system, double-click the Sun ONE Studio 4 CE icon created on your desktop, or click the Start menu and choose Programs Sun Microsystems Sun ONE Studio 4 CE Sun ONE Studio. Alternatively, from a command prompt window, type:

C:\>cd s1studio-install-dir\bin

C:\s1studioinstall-dir\bin>runidew.exe

If this is the first time you are installing this version of Sun ONE Studio 4 IDE on a Microsoft Windows system, you are prompted for the user directory.

For the Solaris or Linux environments, type:

$ cd s1studio-install-dir/bin

$ runide.sh

Skip to Step 3.

2. (Microsoft Windows only) Type the name of the directory where you want the IDE to store your settings and project information, and click OK.

Ensure that the directory you create is in a place that is always accessible to your system. If you have different versions of the IDE, use a different user directory for each IDE version. This directory should be different from the directory where the IDE is installed.

The recommended name for the user directory in a Microsoft Windows system is drive:fully-qualified-path\ffjuser40ce. This name is entered as the UserDir value of the Software\Sun Microsystems, Inc.\Forte for Java key in the HKEY_CURRENT_USER registry. This value is not deleted when the IDE is uninstalled. The name will be reused by future installations of the IDE if the UserDir value is not explicitly deleted from the Microsoft Windows Registry. Refer to the troubleshooting information in TABLE 7-3, if you want to use a different location for your user directory.

The Settings Import wizard appears.

3. In the Settings Import wizard, specify whether you want to import your settings from a previous version of the IDE.

If you do not want to import your previous user settings, select No, and click Finish to exit the wizard.

On a Microsoft Windows system, the user directory is created in the previous step. If you did not remove the previous UserDir value in the registry, the user directory is set to the same user directory you specified in a previous installation of this version of the IDE.

For supported Solaris or Linux environments, the default user directory is created and named $HOME/ffjuser40ce.

If you want to import your previous user settings, select Yes, and click Next.

You are prompted for the location of the user directory for the previously installed IDE.

a. Specify the path or click Browse to locate the directory. Click Next.

The IDE imports the settings.

b. Click Finish to exit the wizard.

The IDE continues with the startup and the Setup wizard appears.

4. If you are behind a firewall, specify the proxy server information.

5. Select the window mode, and click Next to continue with the setup.

6. Click Finish to continue with IDE startup, or click Next for additional setup options.

If you click Finish, the IDE continues with the startup and several windows appear. The registration wizard appears. Continue with Step 10.

If you click Next, the Module Installation pane appears.

7. In the Module Installation pane, specify the module you want to enable or disable.

By default, all the modules installed with the IDE are enabled. Disable a module by doing the following:

a. Click the Enabled property value for the module.

b. Click a second time, and select False to disable the module.

8. Click Next to continue with the setup, or click Finish to continue with the IDE startup.

If you click Finish, the IDE continues with the startup and several windows appear. The registration wizard appears. Continue with Step 10.

If you click Next, the Update Center pane appears.

9. From the Update Center pane, specify how often you want the IDE to automatically check the Update Center. Select the Sun ONE Studio Update Center as the center from which you want to obtain the updates for modules of your choice.

Click Finish to continue with the IDE startup. Several windows appear and the registration wizard appears.

10. From the registration wizard, select your preferred method of registration.

Select "Register using the web" to register your Sun ONE Studio 4 software using the web, or to edit your existing registration information if you have changed Sun ONE Studio 4 editions.

The registration page appears on your web browser. You can register the product, create a new Sun ONE Studio 4 Developer Resources account, or update your account.

Registering your Sun ONE Studio 4 software through the web enables you to:

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

Subscribe to the Early Access Program (http://forte.sun.com/eap) and receive new, nonpublic builds of the IDE, as well as preview releases of Sun ONE Studio 4 modules, patches, and bug fixes

Receive product announcements, if desired

Use the same user name and password to access the Update Center, the Early Access Program, and the Sun Download Center (from which you might have downloaded the Sun ONE Studio 4 IDE)

If you are already registered with Sun ONE Studio Developer Resources, Sun Download Center, or mysun.sun.com, you can use the same user name and password, but you are prompted for additional information.

Note - To maintain your Sun ONE Studio Developer Resources account using the web, choose Help right arrow Registration Wizard from the main window of the IDE. Or, go to http://forte.sun.com/services/registration/accountmaintenance.html.

This method of registration registers only your Sun ONE Studio 4 IDE.

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

11. From the Automatic Update Check dialog box, specify whether you want to check for new IDE updates.

If you reply Yes, the Update Center wizard appears. Follow the wizard's instructions to complete the setup for automatic update checking.

If you reply No, you can start the Update Center wizard at a later time by choosing Tools Update Center from the main window of the IDE.

Using the Startup Command-Line Options

The IDE startup scripts for all supported platforms can be run with additional options. These command-line options are specified with flags.

On a supported Windows system, for example, you might type:

C:\>runidew.exe -help

In Linux or Solaris environments, for example, you might type:

# runide.sh -help

Alternatively, you can put the options in the s1studio-install-dir/bin/ide.cfg file. The IDE reads this file before parsing any command-line options. You can break options into multiple lines in ide.cfg.

TABLE 4-1 lists the startup command-line options for all supported platforms.


Switch Options	Description
`-h -help`	Prints usage.
`-jdkhome` jdk-home-dir	Selects an SDK other than the default SDK. On Microsoft Windows systems, by default, the IDE checks the registry and selects the latest SDK available.
`-hotspot -server -client -classic -native -green`	Explicitly 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.
`-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.
`-ui` UI-class-name	Selects a given class as the IDE's look and feel.
`-fontsize` size	Sets the font size, expressed in points, in the IDE's user interface.
`-single`	Starts the IDE from s1studio-install-dir instead of from your s1studio-user-dir directory. Runs the Sun ONE Studio 4 in single-user mode. The default mode is multiuser.
`-userdir` s1studio-user-dir	Explicitly specifies the s1studio-user-dir directory (the location where your user settings are stored). If this option is not used on a Microsoft Windows system, the user is prompted at the initial startup of the IDE for the s1studio-user-dir directory to use. On Microsoft Windows systems, this value is stored in the registry for later use. If this option is not used in Solaris or Linux operating environments, the location is user-home-dir`/ffjuser40ce`.
`-J`jvm-flags	Passes specified flags directly to the JVM.
`-J-Xverify:none`	Tells the JVM not to verify the correctness of the byte code for faster startup. Bytecode verification is a slow process. Whenever a class is loaded, the JVM scans all bytecode and detects an invalid byte sequence even if a method is never called. Also, the JVM loads certain classes referred to in method signatures and in the method body, even though they are not called during startup. However, setting this flag removes some of the protection that the Java language gives you. (Refer to the JVM documentation for more information.)
`-J-Xms24m`	Sets up the initial heap size of the JVM to 24 MB. This switch prevents the JVM from extending the heap size during startup, which enables faster startup time for the IDE.

In the Solaris and Linux environments, users can modify startup scripts to suit their needs.