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 (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 installation on the Microsoft Windows platform:

JDK 5.0 Update 1 or higher must be installed on your system. If you do not have JDK 5.0 Update 1 or higher, you cannot proceed with the installation.

For more information about the JDK version, see Required Software.

Disable any firewall applications before you start the installation.

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

The Java Studio Enterprise installer first extracts the required files to the default temporary space directory defined by the TEMP environment variable. If the amount of disk space in the temp directory is less than required, the installation might fail or proceed incorrectly.

If you encounter this problem, you can increase the space allocated for the TEMP environment variable or specify a different temporary directory that has sufficient space. Another option is to create an installation log file where the installer will record error messages.

For instructions, see Generating an Installation Log File and Specifying a Temporary Directory for the Installationbelow.

Generating an Installation Log File

If you want to create a log file with information about the installation, you must start the installation process from the command prompt window using the following commands:

C:\>cd location-of-installer

C:\location-of-installer>jstudio_ent81-ml-windows.exe -is:log log-file-name

Specifying a Temporary Directory for the Installation

If you want to specify a different temporary directory for the installer to use, you must start the installer from the command prompt window using the following commands:

C:\>cd location-of-installer

C:\location-of-installer>jstudio_ent81-ml-windows.exe -is:tempdir temporary-directory

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

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 media in your media drive.

If the installer does not start, navigate to the location specified in the README file in the top level of the media and double-click the installer file.

3. To install from a download file, do the following:

a. Download the Java Studio Enterprise 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.

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

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

5. Respond to the license agreement and click Next.

6. At the installation type page, do one of the following:

If you want to install the bundled Application Server, use the following table to determine your selection and next steps.

To install ...	Do this ...
All components	Select the Typical radio button and click Next. At the installation directory page, follow the instructions in To Continue an Installation With the Bundled Application Server.
The IDE and the bundled Application Server (you do not want to install the Collaboration Runtime)	Select the Custom radio button and click Next. At the component selection page, clear the Collaboration Runtime checkbox. Click Next. At the installation directory page, follow the instructions in To Continue an Installation With the Bundled Application Server.

If you have an installation of Sun Java^TM System Application Server 8.2 Platform Edition that you want to use with this installation of Java Studio Enterprise, use the following table to determine your selection and next steps.

To install ...	Do this ...
The IDE and Collaboration Runtime	Select the Custom radio button and click Next. At the component selection page, clear the Sun Java System Application Server 8.2 PE checkbox. Click Next. At the installation directory page, follow the instructions in To Continue an Installation With a Preinstalled Application Server.
The IDE	Select the Custom radio button and click Next. At the component selection page, clear the Sun Java System Application Server 8.2 PE and the Collaboration Runtime checkboxes. Click Next. At the installation directory page, follow the instructions in To Continue an Installation With a Preinstalled Application Server.

To Continue an Installation With the Bundled Application Server

1. At the installation directory page of the installation wizard, accept the default installation directories for the IDE and the Application Server or specify different directories and click Next.

Note - The installation directories you specify must be empty. If the directory you specify does not exist, it will be created during the installation. You should have write permissions for the selected directories.
The installation directory for the Sun Java System Application Server 8.2 Platform Edition cannot contain spaces or special symbols, for example ! and #, in the path name.

2. If the installer fails to automatically detect a compatible JDK, specify the JDK to be used with this installation of Java Studio Enterprise and click Next.

Note - If you do not have JDK 5.0 Update 1 or higher, cancel the current installation and install the required JDK version. See Required Software.

3. Define the admin username and password for the Application Server installation or accept the defaults and click Next.

The admin username must be an alphanumeric string and the password should be at least eight characters long. The default username is admin and password is adminadmin.

4. (Optional) Verify the default port values for the Application Server and change them if necessary. Then click Next.

This page appears only if you have selected the Custom installation type (for example, you are installing the IDE and bundled Application Server, without the Collaboration Runtime).

For Typical installation, the installer automatically validates default Application Server ports, requiring no interaction from your side.

5. Follow the instructions in To Complete the Installation to finish the installation.

To Continue an Installation With a Preinstalled Application Server

1. At the installation directory page of the installation wizard, accept the default IDE installation directory or specify a different directory and click Next.

2. Specify the JDK to be used with this installation of Java Studio Enterprise from the list of compatible JDK installations and click Next.

Note - If you do not have JDK 5.0 Update 1 or higher, cancel the current installation and install the required JDK version first. See Required Software.

3. Select the preinstalled Application Server from the list of compatible installations or click Browse to specify its location and click Next.

If you proceed with the installation without selecting a preinstalled Application Server, the Java Studio Enterprise IDE will not be configured to use this Application Server installation. You need to manually configure the IDE for the preinstalled Application Server.

4. (Optional) At the Collaboration Runtime settings page, specify the port values, service name, and instance name for the Collaboration Runtime, or accept the default values.

This page appears only if you have selected to install the Collaboration Runtime.

5. Click Next.

6. Follow the instructions in To Complete the Installation to finish the installation.

To Complete the Installation

1. Verify that the current settings are correct and you have enough space on your system.

2. Click Install to begin the installation.

3. To start the IDE after the installation is complete, leave the Launch Java Studio Enterprise IDE checkbox selected.

4. Click Finish.

The installation program creates a log with information about the installation. By default, this log file resides in the following directory: %SystemDrive%\Documents and Settings\user-ID\Local Settings\Temp\jstudio_ent81-installation-timestamp.random-number.log

For example: C:\Documents and Settings\myUserName\Local Settings\Temp\jstudio_ent81-installation-20060227130933.12558.log

If you followed the instructions in Generating an Installation Log File, the log file also resides in the location you specified before the installation.

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

Note - If you installed Sun Java trademark System Application Server 8.2 Platform Edition or Collaboration Runtime, you can find configuration information, such as server port numbers, 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.1 icon located on your desktop.

Choose Start right arrow Programs Sun Microsystems Java Studio Enterprise 8.1 Java Studio Enterprise IDE Start IDE.

To Start the IDE at the Command Prompt

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 jstudiow.exe command.

To start the IDE and display messages in the command prompt window, use the jstudio.exe command.

You can specify command options for the executable at the command prompt or in the java-studio-install-dir\ide\etc\jstudio.conf file. See Using Startup Command-Line Options.