Before You Begin

This document provides installation instructions for the Fortetrademark for Javatrademark 4, Mobile Edition integrated development environment (IDE). Topics covered include:

This document instructs you to enter several commands at the command line. Command lines vary slightly from one platform to another. For example, a Microsoft Windows command might look like this:

c:\>cd MyWorkDir\MyPackage

To translate for UNIX® or Linux environments, simply change the prompt and use forward slashes:

% cd MyWorkDir/MyPackage


Before You Read This Book

Before you continue with the rest of this guide, you should be familiar with the process of installing and uninstalling software products on the platforms you choose to use with this release of the Forte for Java 4 product. You need familiarity with some system administrative commands, such as:

  • patchadd, pkgadd, patchrm, and pkgrm utilities in the Solaristrademark operating environment
  • Add/Remove Program utility on the Microsoft Windows systems
  • rpm command in the Red Hat Linux environment

If you are unfamiliar with or unsure about the system administrative commands for your environment or system, contact your system administrator for assistance with the instructions contained in this guide.



Note - Sun is not responsible for the availability of third-party web sites mentioned in this document and does not endorse and is not responsible or liable for any content, advertising, products, or other materials on or available from such sites or resources. Sun will not be responsible or liable for any damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services available on or through any such sites or resources.




How This Book Is Organized

Chapter 1 gives an overview of the general installation process and information on system requirements for Forte for Java 4, Mobile Edition.

Chapter 2 provides instructions on installing the J2SE, v. 1.4.0 platform on your system.

Chapter 3 describes the steps to install the Mobile Edition IDE on the supported platforms. The subdirectories installed with the IDE are described and uninstallation instructions are also provided.

Chapter 4 gives instructions on how to start and set up the newly installed Mobile Edition IDE. The command-line options are provided and information about product registration is also included.

Chapter 5 describes steps to update the IDE modules using the Forte for Java Update Center. Information about other documentation resources are also included in this chapter.

Chapter 6 provides you with some troubleshooting hints to assist you with problems you might encounter during the installation and setup process.

Appendix A lists the patches for the Solaris 8 operating environment that are included with the Solaris patch installer for the Solaris operating environment (SPARCtrademark platform).


Typographic Conventions

Typeface

Meaning

Examples

AaBbCc123

The names of commands, files, and directories; on-screen computer output

Edit your.login file.

Use ls -a to list all files.

% You have mail.

AaBbCc123

What you type, when contrasted with on-screen computer output

% su

Password:

AaBbCc123

Book titles, new words or terms, words to be emphasized

Read Chapter 6 in the User's Guide.

These are called class options.

You must be superuser to do this.

AaBbCc123

Command-line variable; replace with a real name or value

To delete a file, type rm filename.



Related Documentation

Forte for Java 4 documentation includes books delivered in Acrobat Reader (PDF) format, online help, readme files of example applications, and Javadoctrademark documentation.

Documentation Available Online

The documents in this section are available from the Forte for Java Developer Resources (or Suntrademark ONE Studio Developer Resources) portal and the docs.sun.comSM web site.

The documentation link of the Forte for Java Developer Resources portal is at http://forte.sun.com/ffj/documentation/, or can be accessed by selecting Documentation in the Help menu of the IDE. The docs.sun.com web site is at http://docs.sun.com.

  • Release notes (HTML format)
Available for each Forte for Java 4 edition. Describe last-minute release changes and technical notes.
  • Forte for Java 4, Mobile Edition Getting Started Guide (PDF format) -
    part no. 816-4338-10.
Describes how to install the Forte for Java 4 product on each supported platform and includes other pertinent information, such as system requirements, upgrade instructions, command-line switches, installed subdirectories, Javadoc setup, and information on how to use the Update Center.
  • Forte for Java 4, Mobile Edition Tutorial - part no. 816-5081-10
Provides step-by-step instructions for building a simple MIDP/CLDC application using Forte for Java 4, Mobile Edition tools.
You can also find the completed tutorial applications at http://forte.sun.com/ffj/documentation/
tutorialsandexamples.html

The docs.sun.com web site (http://docs.sun.com) enables you to read, print, and buy Sun Microsystems manuals through the Internet. If you cannot find a manual, see the documentation index installed with the product on your local system or network.

Online Help

Online help is available inside the Forte for Java 4 development environment. You can access help by pressing the help key (Help in a Solaris environment, F1 on Microsoft Windows and Linux), or by choosing Help right arrow Contents. Either action displays a list of help topics and a search facility.

Examples

You can download several examples that illustrate a particular Forte for Java 4 feature, as well as completed tutorial applications from the Developer Resources portal, at

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

Javadoc Documentation

Javadoc documentation is available within the IDE for many Forte for Java 4 modules. Refer to the release notes for instructions on installing this documentation. When you start the IDE, you can access this Javadoc documentation within the Javadoc pane of the Explorer.


Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. Email your comments to Sun at this address:

docfeedback@sun.com

Please include the part number (816-4338-10) of your document in the subject line of your email.