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

C H A P T E R 3

Solaris OS: 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 in the Solaris OS environment.

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 environment:

Download directories and installation directories cannot contain spaces or other special characters in the path name.

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.

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 a 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 based systems: jstudio_ent8-solaris-sparc.bin

Solaris OS on x86 based systems: jstudio_ent8-solaris-x86.bin

Specifying a Temporary Directory for the Installation

By default, the installation uses a directory inside your user home directory to store initial installation files. In some cases, this can increase the time needed for the installation. To avoid this scenario, you can specify a different 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 a 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 based systems: jstudio_ent8-solaris-sparc.bin

Solaris OS on x86 based systems: jstudio_ent8-solaris-x86.bin

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. Ensure that the volume manager process is running and insert the Java Studio Enterprise media in your CD/DVD drive.

2. In the File Browser that appears, double-click the installer.sh file.

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

% cd /media-drive/volume-label

% ./installer.sh

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 directory.

Caution - Do not use a 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.

2. From a 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 binary that you downloaded.

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.

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

You 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 runide.sh command:

% ./runide.sh

You can specify runide.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.