C H A P T E R 3 - Solaris OS and Linux: Installing and Starting the Java Studio Enterprise Software

C H A P T E R 3

Solaris OS and Linux: Installing and Starting the Java Studio Enterprise Software

This chapter describes how to install the Java Studio Enterprise software from physical media (DVD) and from files downloaded from the web in the Solaris OS and Linux environments.

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 in the Solaris OS and Linux environments:

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, see Required Software

The installation directory for the Sun Java System Application Server 8.2 Platform Edition cannot contain spaces or special symbols, such as ! and #, in the path name.

The Java Studio Enterprise installer first extracts the 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 Installation below.

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 terminal window using the following commands:

% cd /location-of-installer

% ./installer -is:log log-file-name

Be sure to replace installer with one of the following:

Solaris OS on SPARC platforms: jstudio_ent81-ml-solaris-sparc.sh

Solaris OS on x86 platforms: jstudio_ent81-ml-solaris-x86.sh

Linux platforms: jstudio_ent81-ml-linux.sh

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 terminal window using the following commands:

% cd /location-of-installer

% ./installer -is:tempdir temporary-directory

Be sure to replace installer with one of the following:

Solaris OS on SPARC platforms: jstudio_ent81-ml-solaris-sparc.sh

Solaris OS on x86 platforms: jstudio_ent81-ml-solaris-x86.sh

Linux platforms: jstudio_ent81-ml-linux.sh

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.

Note - On the Linux platform, you can install the Java Studio Enterprise software without logging in with administrator privileges.

2. To install from media, insert the media in your media drive.

If the installer does not start, open the terminal window and start the installation using the following commands:

% cd /media-drive/volume-label

% ./installer

Be sure to replace installer with the file name of the installer file. The location of the installer file is specified in the README file in the top level of the media.

Note - For Solaris OS, the autorun script is disabled by default. To start the installer, navigate to the product folder on the media and double-click the installer file in the File Browser.

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

a. Download the Java Studio Enterprise installer file (download-installer) into a writable directory.

Caution - Do not usea download directory that contains spaces or other special characters in the path name.

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 directory, 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. From the command prompt, change the file you downloaded to an executable file and start the installer using the following commands:

% chmod +x download-installer

% ./download-installer

Be sure to replace download-installer with the file name of the downloaded 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 must 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, such as ! 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 first. 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 you.

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

Solaris OS platforms: /var/tmp/jstudio_ent81-installation-timestamp.random-number.log

Linux platforms: /tmp/jstudio_ent81-installation-timestamp.random-number.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

Start the IDE by executing a launcher script.

To Start the IDE

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

For example:

% cd java-studio-install-dir/ide/bin

2. Start the IDE using the following command:

% ./jstudio.sh

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