3 - C H A P T E R -

C H A P T E R 3

Installing the Mobile Edition IDE

This chapter provides step-by-step instructions on how to install your Sun ONE Studio 4, Mobile Edition software from the product CD or from files downloaded electronically from the web. It contains installation instructions for each of the supported platforms. The subdirectories installed with the IDE are described, and uninstallation instructions are also provided.

You can install Sun ONE Studio 4, Mobile Edition as a standalone product or as part of a suite of products. When you install using the CD-ROM, you can select the product configuration during the install process. If you acquire this software as part of an electronic download, the product selection is already set for you when you start the installer.

If you want to use the Palm OS Emulator (included with the J2ME Wireless Toolkit) with the Mobile Edition IDE, you should install the emulator before installing the IDE. See Configuring the Palm OS Emulator for more information.

Supporting Previous Software Releases

This section applies to users of the initial release of the Mobile Edition IDE, as well as developers using the J2ME Wireless Toolkit with a previous version of the Community Edition IDE or Enterprise Edition IDE.

To upgrade your previous version of the IDE to Sun ONE Studio 4 update 1, Mobile Edition, you must do one of the following:

Determine if you want to keep your previous version of the IDE. If you do, identify a different directory in which to install Mobile Edition IDE software.

If you want to use the same installation directory as the previous IDE version, you must first uninstall the previous version of the IDE prior to installing the Mobile Edition IDE.

Determine whether you want to keep your current IDE user settings. If you decide to use your current user settings with the new IDE version, you need to specify the location of your current user directory when prompted during the initial IDE setup. Read Chapter 4 for more information.

Note - Because the Community and Enterprise Edition IDEs include several modules not supported by Mobile Edition IDE, Sun does not recommend using previous settings from the Community and Enterprise Edition IDEs with the Mobile Edition IDE.

Creating a Shared Installation

If you want to share a Sun ONE Studio 4 update 1 installation between multiple users, you must install the IDE into a shared directory.

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

After installation of the IDE in the supported Solaris environment or Linux environment, all user settings are stored in the ffjuser40me directory created under each user's home directory. This occurs for both shared and unshared installations.

Installing the Mobile Edition IDE on the Supported Platforms

These instructions describe the installation process for each of the supported platforms. You can install the Mobile Edition IDE in two ways:

Use the graphical user interface (GUI) installer, described in Installing the Mobile Edition IDE on the Supported Platforms.

Perform a command-line installation if you do not have graphical user interface capabilities or do not choose to use them, see Installing the IDE Using the Command-line Options.

Ensuring Sufficient Free Disk Space

Running the installer requires 50 megabytes of free disk space in the /tmp directory on the computer that contains the product CD-ROM. Ensure that you have this space available before starting the installation process. This requirement applies to all the supported platforms.

Installation on Microsoft Windows Systems

You can install the Mobile Edition IDE on a supported Microsoft Windows system by using the GUI installer on the product CD or downloading an .exe file from the product download web page.

Note - You must have the J2SE, v. 1.3.1 platform or J2SE, v. 1.4.0_02 platform installed on your system before installing the IDE. The recommended option is the J2SE, v. 1.4.0_02 platform with the Mobile Edition IDE. Read for instructions on installing the software.

1. Start the installation.

If you are installing the IDE from a CD, insert the Sun ONE Studio 4 update 1 product CD. The Product Selection pane appears.

If the installer does not start, the auto run feature might be disabled. Follow these steps:

a. Click Start, click Run, and browse to the CD directory.

b. Select startup.exe and click OK.

c. Click Run (or double-click setup.exe).

If you are performing a web installation and have not already done these tasks, you must:

a. Download the ffj_me_win32_en.exe installer file from the Sun ONE Studio 4 update 1 download page available at: http://www.sun.com/software/sundev/jde/buy/index.html

b. Save the file into the s1studiodownload-directory.

c. Double-click the ffj__me_win32_en.exe file in the s1studio-download-directory. The Welcome pane appears.

d. Skip to Step 4.

Note - If you encounter errors at any point during the Mobile Edition IDE installation, refer to Chapter 6 for troubleshooting hints.

2. From the Product Selection pane, select Sun ONE Studio 4 update 1, Mobile Edition.

A brief description of this edition of the IDE appears under the list of products.

3. Click Install.

Note - During the installation process, the Installation wizard displays a blue Sun ONE Studio pane with text that states "Launching and Running Installer." Other installation panes appear in the foreground. Do not close either pane. If you bring the larger blue pane to the foreground, it might hide the secondary installation pane. Keep both panes visible, with the larger blue pane behind the smaller pane.

4. When the InstallShield wizard's welcome screen appears, click Next to continue.

The license agreement pane appears.

5. Read the license agreement carefully. To proceed, accept the terms of the license agreement, and click Next to continue.

You must agree to the license to continue with the installation.

The installer attempts to locate a compatible Java 2 SDK v. 1.3.1 or v. 1.4.0_02 on your system.

6. Set the location of compatible Java 2 SDK software, and click Next.

Sun ONE Studio 4 update 1 requires local or network access to either v. 1.3.1 or v. 1.4.0_02 of the Java 2 SDK software. Specify which installed Java 2 SDK software to use.

7. Accept the default installation folder, or click Browse to install the IDE in a different directory. Click Next to continue.

8. Click Next to confirm the components you want to install.

The following components are required for installation:

Core Platform and Modules

J2ME Wireless Toolkit, version 1.0.4

9. Determine whether you want to associate .java and .nbm files with the IDE. Click Next to continue.

If you decide to associate these file types, the Mobile Edition IDE launches when you open these files.

10. Confirm your installation choice in the installation summary pane, and click Next.

The Installation Wizard installs the Mobile Edition IDE components you selected.

11. Review the Release Notes file for important information regarding the release. You can access the Release Notes from either one of these locations:

The product CD's image\Documentation\relnoteme41.html file

http://forte.sun.com/ffj/documentation/index.html

12. Continue to Chapter 4 for information on setting up the Mobile Edition IDE.

Installation in the Linux Environment

You can install the IDE in a supported Linux environment from the Sun ONE Studio 4 update 1 product CD or by electronically downloading a .bin file from the product download web page.

Note - You must have the J2SE, v. 1.3.1 platform or J2SE, v. 1.4.0_02 platform installed on your system before installing the Mobile Edition IDE. The recommended option is the J2SE, v. 1.4.0_02 platform with the Mobile Edition IDE. Read for instructions on installing the software.

1. Start the installation.

If you are installing the software from the Sun ONE Studio 4 update 1 product CD, insert the CD.

a. Answer yes if you are prompted about whether you want to use Autorun to install the CD. The Product Selection pane appears.

b. Continue with Step 2.

If you are performing a web installation and have not already done these tasks, you must:

a. Download the ffj_me_linux_en.bin installer file from http://www.sun.com/software/sundev/jde/buy/index.html

b. Save the file into the s1studio-download-directory.

c. Set the DISPLAY environment variable to display to your local system.

If you are installing to your local system, set the DISPLAY environment variable to :0.0. If you are using a superuser (root) account or are doing a remote installation, set your superuser session's DISPLAY environment variable to display to your local system.

For example, to set the variable from a root account running C-shell, type the following in your superuser session command prompt:

# setenv DISPLAY your-local-system:0.0

d. Set the execute permission on the ffj_me_linux_en.bin file, and execute the file by typing the following:

$ cd s1studio-download-directory

$ chmod a+x ffj_me_linux_en.bin

$ ffj_me_linux_en.bin

Note - If you encounter errors at any point during the Mobile Edition IDE installation, refer to Chapter 6 for troubleshooting hints.

e. Skip to Step 4.

2. When the Product Selection Wizard appears, select Sun ONE Studio 4 update 1, Community Edition.

A description of this edition of the IDE appears under the list of products.

3. Click Install.

Note - During the installation process, the installation wizard displays a blue Sun ONE Studio pane with text that states "Launching and Running Installer." Other installation panes appear in the foreground. Do not close either pane. If you bring the larger blue pane to the foreground, it might hide the secondary installation pane. Keep both panes visible, with the larger blue pane behind the smaller pane.

4. When Install Shield Wizard welcome screen appears, click Next to continue.

The license agreement pane appears.

5. Read the license agreement carefully. To proceed, accept the terms of the license agreement, and click Next.

You must agree to the license to continue with the installation.

The Installer attempts to locate a compatible Java 2 SDK v. 1.3.1 or v. 1.4.0_02 on your system.

6. Set the location of compatible Java 2 SDK software and click Next.

The Mobile Edition IDE requires local or network access to either v. 1.3.1 software or v. 1.4.0 of the Java 2 SDK software. Specify which installed software to use.

7. Accept the default installation folder, or click Browse to install the IDE in a different directory. Click Next to continue.

Note - The installation directory name cannot contain any spaces and it must be an empty or new directory.

8. Click Next to confirm the features listed in the Select Features dialog box.

The following features are required for installation:

Core Platform and Modules

J2ME Wireless Toolkit, version 1.0.4

9. Confirm your installation choices in the installation summary dialog box and click Next.

The installation wizard installs the Sun ONE Studio 4 update 1 components you selected.

10. Review the installation summary pane that displays the directory location of the IDE, the features you have selected, and the total size of the installation. Click Next.

11. When the installation is complete, click Finish to exit the installation wizard.

12. Review the release notes file for important information regarding the release. You can access the Release Notes from rom either one of these locations:

The product CD's image\Documentation\relnoteme41.html file

http://forte.sun.com/ffj/documentation/index.html

13. Continue to Chapter 4 for information on setting up the Mobile Edition IDE.

Installation in the Solaris Operating Environments

You can install the IDE in a supported Solaris operating environment by using the the product CD or by downloading a .bin file from the product web page.

1. Start the installation.

If you are installing software from the Sun ONE Studio 4 update 1 product CD, insert the CD. (If you are running the Solaris 7 operating environment and you insert the product CD, a message appears stating that the product is not supported on Solaris 7 operating environment.)

a. If you are prompted to use Auto run, answer yes. The Product Selection pane appears.

b. Continue with Step 2.

If you are performing a web installation:

a. Download the ffj_me_solsparc_en.bin installer file from http://www.sun.com/software/sundev/jde/buy/index.html.

b. Save the file into the s1studio-download-directory.

c. Set the DISPLAY environment variable to display to your local system.

For example, to set the variable from a root account running a C shell, type the following in your superuser session command prompt:

# setenv DISPLAY your-local-system:0.0

d. Set the execute permission on the ffj_me_solsparc_en.bin file and execute the file by double-clicking it or by typing the following:

$ cd s1studio-download-directory

$ chmod a+x ffj_me_solsparc_en.bin

$ ffj_me_solsparc_en.bin

Note - If you encounter errors at any point during the Mobile Edition IDE installation, refer to Chapter 6 for troubleshooting hints.

e. Become a superuser (root) by typing the following in a terminal window:

$ su

Password: root-password

f. Skip to Step 4.

2. From the Product Selection pane, select Sun ONE Studio 4 update 1, Community Edition.

A description of this edition of the IDE appears under the list of products.

3. Click Install.

4. When the InstallShield Wizard's welcome screen appears, click Next to continue.

The license agreement pane appears.

5. Read the license agreement carefully. To proceed, accept the terms of the license agreement, and click Next to continue.

You must agree to the license to continue with the installation.

The Installer attempts to locate a compatible Java 2 SDK v. 1.3.1 or v. 1.4.0_02 on your system.

6. Set the location of compatible Java 2 SDK software, and click Next.

Sun ONE Studio 4 update 1 requires local or network access to either v. 1.3.1 or v. 1.4.0_02 of the Java 2 SDK software. Specify which installed Java 2 SDK software to use by doing one of the following:

7. Accept the default installation folder, or click Browse to install the IDE in a different directory. Click Next to continue.

Note - The installation directory name cannot contain any spaces, and it must be an empty or new directory.

8. Click Next to confirm the list of components to be installed.

The following features are required for installation:

Core Platform and Modules

J2ME Wireless Toolkit, version 1.0.4

9. Confirm your installation choice in the installation summary pane, and click Next.

The Installation Wizard installs the Sun ONE Studio 4 update 1 components you selected.

10. Review the installation summary pane that displays the directory location of the IDE, the features you have selected, and the total size of the installation. Click Next.

11. When the installation is complete, click Finish to exit the installation wizard.

12. Review the release notes file for important information regarding the release. You can access the release notes from either of these locations:

The product CD's image\Documentation\relnoteme41.html file

http://forte.sun.com/ffj/documentation/index.html

13. Continue to Chapter 4 for information on setting up the IDE.

Installing the IDE Using the Command-line Options

If you prefer to install the Mobile Edition IDE using the command line, follow these steps. You need to create a file called installer.sp and add to the file the installation command-line options you want to use to install the IDE.

1. If you have not already done so, download the installer file for your supported platform from http://www.sun.com/software/sundev/jde/buy/index.html or locate the file on the Sun ONE Studio 4 update 1 product CD. Save the installer file into the s1studio-download-directory.

Download the installer file specific to your platform:

On a Microsoft Windows systems, download the ffj_me_win32_en.exe file.

In a Solaris environment, download the ffj_me_solsparc_en.bin file.

In a Linux environment, download the ffj_me_linux_en.bin file.

2. Create an installer.sp file in the s1studio-download-directory.

The IDE installer reads the command-line options you include in the installer.sp file.

On a Microsoft Windows system, create a file called ffj_me_win32_en.sp and place the file in the s1studio-download-directory. In the Solaris and Linux environments, name the file ffj_me_solsparc_en.sp and ffj_me_linux_en.sp, respectively, and place it in the s1studio-download-directory.

If you chose to type the installation options directly on the command line, you do not need the installer.sp file.

3. Determine the command-line options and corresponding values you want to use, and include them in the installer.sp file.

TABLE 3-1 lists the different command-line options and their default values, if any.You can use either the long or short name for each option.


Installation Options	Description
`fortehome=`s1studio-install-dir `fh=`ffj-install-dir	Specifies the directory into which you want the IDE installed. This is a mandatory command-line parameter for the `-silent` mode.
`jdkhome=`jdkhome-dir `jh=`jdkhome-dir	Sets the location of the valid Java 2 SDK version to use with the IDE. The installer will configure the IDE to use this Java 2 SDK software. This is a mandatory command-line parameter for the `-silent` mode.
-silent	Specify this option on the command line and not in the installer.`sp` file. If not specified, the Installshield wizard will appear. If specified, any error messages will be displayed on the command window from which the installer was invoked.

4. If you chose to use the installer.sp file, add the command-line options in that file.

For example, on a Microsoft Windows system, the ffj_me_win32_en.sp might have the following contents:

fh=C:\ffj

jh=C:\j2sdk1.4.0_02

On a Solaris environment, the ffj_me_solsparc_en.sp might have the following contents:

fh=/yourserver/ffj

jh=/usr/j2se

5. Execute the installer from the command line.

For example, on a Microsoft Windows system, type the following in a command prompt window:

C:\>cd s1studio-download-directory

C:\>s1studio-download-directory> ffj_me_win32_en.exe -silent

For example, in a Solaris environment, type the following in a terminal window:

$ cd s1studio-download-directory

$ ffj_me_solsparc_en.bin -silent

The installer displays the following on the command prompt or terminal window:

InstallShield Wizard

Initializing InstallShield Wizard...

Searching for Java(tm) Virtual Machine...

.........

Running InstallShield Wizard...

If there are any errors encountered, messages are displayed on the command prompt window.

Note - If you encounter errors at any point during the Mobile Edition IDE installation, refer to Chapter 6 for troubleshooting hints.

6. Continue to Chapter 4 for information on setting up the Mobile Edition IDE.

Finding Installation Subdirectories

After you have installed the Mobile Edition IDE, the subdirectories listed in TABLE 3-2 can be found under ffj-install-dir, your Sun ONE Studio 4 update 1 installation directory.


Subdirectory Name	Description
`/_uninst`	Contains the files used to uninstall the IDE.
`/bin`	Includes the Mobile Edition IDE startup scripts (as well as the `ide.cfg` file in Microsoft Windows installations).
`/docs`	Contains miscellaneous documentation.
`/emulator`	Contains the J2ME Wireless Toolkit emulator.
`/lib`	Contains the JAR files that make up the IDE's core implementation and the open APIs.
`/modules`	Stores Sun ONE Studio modules as JAR files.
`/sources`	Contains sources for libraries that might be redistributed with user applications.
`/system`	Includes files and directories used by the IDE for special purposes. Go to your individual s1studio-user-dir`/system` directory to get the `ide.log`, which provides information useful when requesting technical support, and to view `project.basic` and `project.last` files, which contain information on Sun ONE Studio projects. In a Microsoft Windows system, this s1studio-user-dir`/system` directory contains the project-specific files under `project.basic_hidden` and `project.last` files.
`update_tracking.xml`	Contains information used by the AutoUpdate Center.

Configuring the Palm OS Emulator

If you want to run the Palm OS Emulator that is included with the J2ME Wireless Toolkit, you should install the emulator before installing the Mobile Edition IDE. You can download the emulator from http://www.palmos.com/dev/tech/tools/emulator/.

You must first configure the emulator as follows:

1. Redirect NetLib calls to the host's TCP/IP.

For certain functions like debugging and Internet connectivity to work, you must set NetLib API calls to be redirected from the Palm OS Emulator to use your computer's TCP/IP.

a. Run the Palm OS Emulator and right-click the emulator.

A menu appears.

b. Select Settings right arrow Properties...

The Properties dialog appears.

c. Check the Redirect NetLib calls to host TCP/IP box, and click OK.

The Properties dialog disappears.

d. Right-click the emulator and select Save.

Your changes are saved.

2. Disable debugging.

The Palm OS Emulator allows various items to be debugged while the application executes. However, for the Palm OS Emulator to work with the Mobile Edition IDE, debugging must be disabled altogether.

a. Run the Palm OS Emulator, and right-click the emulator.

A menu appears.

b. Select Settings right arrow Debugging...

The Debug Options dialog appears.

c. Uncheck all the boxes and click OK.

The Debug Options dialog disappears.

d. Right-click the emulator and select Save.

Your changes are saved.

3. Set the Palm OS Emulator location in the Mobile Edition IDE.

The first time you run an application using the Palm OS Emulator through the Mobile Edition IDE, a dialog appears, asking you for the Palm OS Emulator location. After you set the location, the dialog will not appear again when you run MIDP applications using the emulator.

Uninstalling the Mobile Edition IDE

An uninstaller wizard is available to assist you in the uninstallation of the Mobile Edition IDE. Follow these steps to uninstall your copy of the Sun ONE Studio 4 update 1 IDE:

1. Start the uninstaller from the s1studio-install-dir/_uninst directory.

In a supported Solaris operating environment or Linux environment, ensure that your DISPLAY environment variable is defined correctly, and then type:

$ java -jar uninstall.jar

On a Microsoft Windows system, execute the uninstaller.exe file located in the s1studio-install-dir/_uninst directory or use the Add/Remove Program utility in the Control Panel.

The uninstaller's Welcome screen appears.

2. Click Next from the Welcome screen.

A list of Sun ONE Studio 4 update 1 components is displayed.

3. Select the components you want to uninstall and click Next.

4. Click Next to confirm the components to be uninstalled.

The uninstaller wizard proceeds with the uninstallation of the IDE.

5. Click Finish to close the uninstaller wizard.