C H A P T E R  4

Installing the IDE
(Solaris OS)

This chapter describes how to install your Sun ONE Studio 5 IDE from the product CD or from files downloaded from the web in supported Solaris operating systems. It also describes applying the necessary Solaris 8 OS patches using the solaris_patch_installer script.

The IDE installer installs Suntrademark ONE Application Server 7, Standard Edition as the default application server. The application server installation includes the PointBase Server 4.2 Restricted Edition as part of its standard installation. If you already have the Sun ONE Application Server 7 installed on your system, a second is not automatically installed.

You can install the IDE in two ways:

Before installing the IDE, you need to install the necessary Solaris 8 OS patches.


Applying the Solaris 8 OS Patches

Run the solaris_patch_installer script to ensure that all the Solaris patches required by the IDE are installed on your system. The patch installer includes the Solaris patch packages you need for your Solaris 8 OS.

The solaris_patch_installer script is provided on the Sun ONE Studio 5 companion CD and is also available from the Sun ONE Studio 5 product download page. See To Install Patches for the Solaris 8 OS for instructions on how to use the solaris_patch_installer script.

If you do not have the required Solaris patches when you start the IDE installer, a message displays the Solaris patches that you need. Installing these patches individually is not recommended. Use the provided solaris_patch_installer script. If you are unsure about installing Solaris patches in your Solaris environment, contact your system administrator. You need to have superuser privileges to install patches for the Solaris OS.



Note - Some Solaris patches require that you reboot your system after installation has completed. The installer prompts you to reboot, if necessary.




procedure icon  To Install Patches for the Solaris 8 OS

1. If you have not already done so, download the solaris_patch_installer.tar.gz file into the solaris-patches-directory from the Sun ONE Studio download web site at http://www.sun.com/software/sundev/jde/buy/index.html or from the Sun ONE Studio 5 companion CD.



Note - Ensure that the solaris-patches-directory on your system has enough available space to uncompress and extract the contents of the downloaded file. You need at least 160 MB of free disk space.



2. From the solaris-patches-directory, uncompress and extract the contents of the downloaded file.

% cd solaris-patches-directory
% /usr/bin/gzcat solaris_patch_installer.tar.gz | tar xvf - 

The solaris_patch_installer file and the patches directory are extracted into the solaris-patches-directory.

3. (Optional) To recover disk space, remove the downloaded file.

% rm -rf solaris_patch_installer.tar.gz

4. Become a superuser (root).

% su root

Enter your superuser password when prompted.

5. Change to the solaris-patches-directory and run the solaris_patch_installer script.

# cd solaris-patches-directory
# ./solaris_patch_installer

The solaris_patch_installer installs the necessary patches.

You see output similar to the following:

# ./solaris_patch_installer
Solaris Patch Installer for J2SE, v.1.4.1
Installing 110380-04...already applied
 
Installing 110934-10...successfully installed
 
Installing 112396-02...successfully installed
 
Installing 108987-13...attempting to patch a package that is not installed
 
Installing 111310-01...already applied

This is a sample listing of normal messages and indicate the patch installer script is running correctly.

6. If prompted, reboot your system.

# Certain patches installed on your system require that you reboot your machine.
Do you want to REBOOT your machine now? (y/n)
# y

7. If you are not prompted to reboot, exit from superuser privileges.

8. (Optional) Remove the solaris-patches-directory to recover disk space.

% rm -rf solaris-patches-directory

For a complete list of the Solaris patches included with the solaris_patch_installer script, see Appendix A.

The solaris_patch_installer installs all the necessary patches for the J2SE platform and those needed for the Sun ONE Studio IDE and its components. Be sure you have run the patch installer script before trying to install the J2SE platform.


Using the GUI Installer

You can install the Sun ONE Studio IDE by using the product CD or by downloading the s1s5se-sol-sparc-en.bin installer launcher from http://www.sun.com/software/sundev/jde/buy/index.html.



Note - If you encounter errors at any point during the installation, refer to Chapter 12 for troubleshooting tips.




procedure icon  To Install the IDE

1. Verify that you have at least the J2SE, version 1.4.1_02 platform installed on your system before installing Sun ONE Studio 5 software.

See Verifying Your J2SE Platform.

2. Start the installation.

  • To start the install from web download, follow these steps:

a. Download the s1s5se-sol-sparc-en.bin installer file from http://www.sun.com/software/sundev/jde/buy/index.html and save into the s1studio-download-directory.

b. Set the execute permission on the s1s5se-sol-sparc-en.bin file.

% chmod a+x /s1studio-download-dir/s1s5se-sol-sparc-en.bin

c. Set the DISPLAY environment variable to display to your local system.

% setenv DISPLAY your-local-machine:0.0

d. Enable access to the X server.

% xhost + your-local-machine

e. Become a superuser (root).

%su root

Enter your superuser password when prompted.

f. Start the installer.

# /studio-download-dir/s1s5se-sol-sparc-en.bin

The Welcome page displays. Proceed to Step 3.

  • To start the install from the CD-ROM, follow these steps:

a. Log in to your system as a superuser using your root password.

To use the CD-ROM and enable the autorun feature to work correctly, log in to your machine as root. Do not use the su command in a terminal window as this does not enable you to install correctly when the autorun feature launches the install process.

b. Insert the product CD.

  • On Solaris 8 systems, the installer starts and the Welcome page appears. Go to Step 3.
  • On Solaris 9 systems, a File Manager window opens when you insert the CD-ROM. To start the installer, double-click the volstart icon or the install.sh icon in the File Manager window.

If the installer does not start or you do not see the File Manager window, follow these steps:

i. Open a terminal window.

ii. Change to the CD-ROM directory and start the installation.

# cd /cdrom/en_studiose_5
# ./install.sh

The Welcome page appears. Go to Step 3.

3. From the Welcome page, click Next and follow the instructions on the installer wizard pages.

The installer asks a series of questions, installs the product, and then displays the Summary page.

When prompted for the license serial number you have two options:

  • Generate a 60-day trial license serial number by using the 60-day trial button.
  • Use the license serial number listed on a card enclosed in the purchased product package. If you purchase the product online, then the serial number is provided to you at the time of purchase and download.


Note - If you specify a non-default installation directory, do not specify an NFS-mounted directory. The Sun ONE Application Server 7 cannot be installed on an NFS-mounted directory.



4. Review the Summary page.

The following properties, used by the Sun ONE Application Server, are displayed:

  • Admin Server Host: localhost
  • Admin Server Port: 4848
  • Admin User Name: admin
  • Admin User Password: adminadmin

5. Write down and save the Admin User password.

You need this password to use the Sun ONE Application Server administrative tool. The other properties can be viewed from within the IDE by looking at the Sun ONE Application Server property sheet.

6. Click Finish to exit the installation wizard.

The default installation directory on a Solaris system is /opt/studio5_se.

7. If you enabled client access, disable client access.

# xhost - your-machine-name

8. Exit from superuser privileges.

9. Continue to Chapter 5 for information about setting up the Sun ONE Studio 5 IDE.



Note - If you plan to use Sun ONE Application Server 7, read Chapter 6 before attempting to deploy your applications.




Using Command-Line Options During Installation

Command-line options for installing in silent mode are supported by the IDE installers. The procedure to use depends on whether you are installing from files on the CD-ROM or files downloaded from the web site. Some command-line options can be used with the GUI installer.

See Appendix D for details on using the command-line options and for installing in silent mode.