C H A P T E R 2 - Microsoft Windows: Installing and Starting the Java Studio Enterprise Software

C H A P T E R 2

Microsoft Windows: Installing and Starting the Java Studio Enterprise Software

This chapter describes how to install the Java Studio Enterprise software from physical media (CD-ROM or DVD) and from files downloaded from the web on the Microsoft Windows platform.

This chapter covers the following topics:

Before You Start

Installing the Java Studio Enterprise Software

Starting the IDE

Note - If you want to install the Java Studio Enterprise software on multiple hosts that require similar installation configurations, you can use silent installation. See Installing the Java Studio Enterprise Software Using Silent Mode for details about preparing and executing a silent installation.

Before You Start

The following restrictions apply to the installation on the Microsoft Windows platform:

Do not exceed 35 characters for the java-studio-install-dir root directory name. Some of the component products installed with the Java Studio Enterprise software have limitations on the length of the path name to their executable files.

Disable any firewall applications before you start the installation.

Enabled firewall applications can prevent some components from being configured correctly during the installation process.

By default, the Collaboration Runtime is configured to use port 5222 if it is available. If you have Java Studio Enterprise 7 Collaboration Runtime installed and you want to use both installations at the same time, make sure you start the Java Studio Enterprise 7 Collaboration Runtime before you start the IDE installation. Starting the Java Studio Enterprise 7 Collaboration Runtime ensures that the installer detects that port 5222 is already in use. In this case, another available port is used for the Collaboration Runtime.

Installing the Java Studio Enterprise Software

You can install the Java Studio Enterprise software from media or from a download file.

To Start the Installation From Media

1. Log in to your system with administrator privileges and disable any firewall applications.

Enabled firewall applications can prevent some components from being configured correctly during the installation process.

2. To install from media, insert the Java Studio Enterprise media in your CD/DVD drive.

If the installer does not start, navigate to the product folder on the media and double-click the media-drive\jstudio_ent8-win.exe file.

3. Follow the instructions in To Continue the Installation to continue the installation.

To Start the Installation From a Download File

1. Download the Java Studio Enterprise IDE installer file (download-installer) into a writable folder.

Use Sun trademark Download Manager software (http://www.sun.com/download/sdm/) to ensure a successful download.

Note - After you complete the download, verify the downloaded file. In the download folder, check that the file that you have downloaded has the same number of bytes that is shown on the download page. If the file size does not match, the file might have been corrupted during download. In that case, try downloading again.

2. In the download folder, double-click the download-installer file.

3. Follow the instructions in To Continue the Installation to continue the installation.

To Continue the Installation

1. At the Welcome page of the installation wizard, click Next.

2. Respond to the license agreement and click Next.

3. At the Select Features page, use the following table to determine how to select features to install.

If ...	Then do this ...
You have an installation of Sun Java System Application Server 8.1 Platform Edition, Update Release 2, and you want to use that installation with this installation of Java Studio Enterprise	Clear the Sun Java(tm) System Application Server 8.1 PE UR2 checkbox. Click Next. In the Application Server Selection page, provide the necessary information about the installed application server and click Next.
You do not want to install the Collaboration Runtime	Clear the Collaboration Runtime checkbox. Click Next.
You want to install all features	Click Next.

4. At the Java Development Kit (JDK) Selection page, use the radio buttons to define which JDK will be used with this installation of Java Studio Enterprise and click Next.

See http://java.sun.com/j2se/ for additional information about available versions.

Note - If you do not have an installation of a JDK version 1.5.0_01 or higher, you must install the included JDK.

If you have an installation of a JDK version 1.5.0_01 or higher and you want to use that version with this installation of Java Studio Enterprise, you can use the available options in the Java Development Kit (JDK) Selection page to select the installed JDK.
Use the Select other JDK (At least version 1.5.0_01) option to navigate to and select a JDK installation that the installation wizard did not detect.

5. At the Start Copying Files page, verify the current settings and click Next to begin the installation.

When the installation is done, the Complete page opens.

6. To start the IDE after you complete the installation wizard, select the Start Sun Java(TM) Studio Enterprise 8 checkbox.

7. Click Finish.

The installation program creates a log with information about the installation. This log file (sjse8_InstallLog_date_time.txt) resides in the following location:

%SystemDrive%:\Documents and Settings\user-ID\Local Settings\Temp

8. If you disabled any firewall applications, enable those firewall applications.

Note - If you installed Sun Java trademark System Application Server 8.1 Platform Edition or Collaboration Runtime, you can find configuration information, such as server port numbers and passwords, in the following file:
java-studio-install-dir/configuration_data.txt

Starting the IDE

If you did not start the IDE from the last page of the installation wizard, you can use one of the methods described in this section to start the IDE.

To Start the IDE

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

Choose Start right arrow Programs Sun Microsystems Java Studio Enterprise 8 Start Java Studio Enterprise.

To Start the IDE at the Command Line

1. Change to the folder that contains the IDE executable.

For example:

> cd java-studio-install-dir\ide\bin

2. To start the IDE with the default launcher used by the desktop icon, use the runidew.exe command.

To start the IDE and display messages in a Windows Console, use the runide.exe command.

You can specify runide.exe command options on the command line or in the java-studio-install-dir\ide\etc\jstudio.conf file. See Using Startup Command-Line Options.