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 Sun 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.
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. |
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 |
% 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:
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.
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. |
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.
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 |
%su root |
Enter your superuser password when prompted.
# /studio-download-dir/s1s5se-sol-sparc-en.bin |
The Welcome page displays. Proceed to Step 3.
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.
If the installer does not start or you do not see the File Manager window, follow these steps:
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:
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. |
The following properties, used by the Sun ONE Application Server, are displayed:
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. |
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.
Copyright © 2003, Sun Microsystems, Inc. All rights reserved.