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 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, you:

a. Double-click the Sun ONE Studio 4 EE icon created on your desktop or click the Start menu.

b. Choose Programs right arrow Sun Microsystems Sun ONE Studio 4 EE Sun ONE Studio.

Alternatively, from a command prompt window, type:

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

C:\s1studio-install-directory\bin>runidew.exe

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

For the supported Solaris or Linux environments, type:

$ cd s1studio-install-directory/bin

$ runide.sh

Skip toStep 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 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 or set to the same user directory you specified in a previous installation of this version of the IDE if you did not remove the previous UserDir value in the registry.

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

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

(Solaris only) If you click Next and you have installed the Solaris Developer Modules, the Text Editor Preference pane appears. Continue with Step 7.

If you click Next, the Module Installation pane appears. Continue with Step 8.

7. (Solaris only) In the Text Editor Preference pane, select the text editor you want to use with the IDE. Click Next to continue with the setup, or Finish to continue with the IDE startup.

The installation of the Solaris Developer Modules includes the XEmacs and VIM text editors. You can select from the IDE's built-in editor, XEmacs, or VIM as the default text editor to use with the IDE. If you decide to modify the default text editor at a later time, choose Tools right arrow Setup Wizard from the main window of the IDE.

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

If you click Next, the Module Installation pane appears.

8. In the Module Installation pane, specify which 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.

9. 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 11.

If you click Next, the Update Center pane appears.

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

11. 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 in 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.

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

13. Continue to Chapter 5 for instructions on validating your installation 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. In this document, these flags are referred to by the variable [s1studio-ide-options] when used on the command line.

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

C:\>runidew.exe -help

In a Linux or Solaris environment, for example, you might type:

# runide.sh -help

Alternatively, you can put the options in the s1studio-install-directory/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 Window systems, by default, the IDE checks the registry and selects the latest SDK available.
`-hotspot or -server or -client or -classic or -native or -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-directory instead of from your s1studio-user-directory directory. Runs the Sun ONE Studio 4 IDE in single-user mode. The default mode is multiuser.
-fortecc fcc-path	(Solaris only) Specifies the path to the Forte Compiler Collection to use for this session of the IDE. Overrides any default settings created in the IDE or user directory.
`-userdir` s1studio-user-directory	Explicitly specifies the s1studio-user-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-directory 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`/ffjuser40ee`.
`-J`jvm-flags	Passes specified flags directly to the JVM.
`-J-Xverify:none`	Tells the JVM not to verify the correctness of the bytecode 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.