The Sun Studio 11 for Solaris Platforms Release Notes contain last-minute installation details and other information about the software.

Information in this document updates and extends information in the component readme files.

You can access the readme files on the Sun Developer Network (SDN) Sun Studio portal at http://developers.sun.com/prodtech/cc/documentation/ss11/index.html.

Contents 

1. System Requirements
2. Disk Space Requirements by Installer
3. Patches
4. Installation Information
5. Update Notification
6. IDE Information
7. Performance Analyzer Information
8. dbx Issues
9. Native Connector Tool Issues
10. Features That Might Be Removed in a Future Release
11. Documentation Information

A. System Requirements

The Sun Studio 11 software for Solaris platforms can be installed on the Solaris^TM Operating System (Solaris OS) on SPARC® based systems and the Solaris OS on x86 based systems. (For information on installing the Sun Studio 11 software for Linux platforms, see the Sun Studio 11 for Linux Platforms Release Notes.) The system requirements are as follows.

To check or add swap space, see the instructions in the System Requirements section of Chapter 1 of the Sun Studio 11 Installation and Setup Guide for Solaris Platforms, which is available at http://docs.sun.com/doc/819-3052.

B. Disk Space Requirements by Installer

The suggested available disk space you need to install the Sun Studio 11 software on the Solaris OS on SPARC platforms is 1.6 GB. The suggested available disk space you need to install the Sun Studio 11 software on the Solaris on x86 platforms is 981 MB. The following table shows the size of the installed Sun Studio 11 for Solaris platforms software.

C. Patches

This section lists the required patches for this Sun Studio 11 release.

Operating System Patches

Operating system (OS) patches are provided for Sun Studio 11 software. These patches are required for the proper operation of the compilers and tools in this release.

The following required Solaris OS patches are included in this Sun Studio 11 release. These patches are installed automatically unless you change the default selection for Solaris Patches in the Select Components page in the installer or install wizard.

For proper operation of the Collector and Performance Analyzer, install the Solaris 9 08/03 OS, or ensure that you have installed all of the recommended patches for the version of Solaris you are running. You can view the list of recommended patches and download any patches you need at http://sunsolve.sun.com.

J2SE Technology Required Operating System Patches

Solaris Operating System (OS) patches are required for the proper operation of the J2SE technology. OS patches are provided in the J2SE installer.

The following required Solaris OS patches are included in the J2SE installer. These patches are installed automatically unless you change the default selection for Solaris Patches in the Select Components page in the J2SE installer.

Note: If you have at least J2SE 1.3.1 technology installed in /usr on your system and you want to install the J2SE 1.4.2_08 technology in /usr, use the pkgrm command to remove those packages first before installing the J2SE 1.4.2_08 technology using the J2SE installer. See the Installation Notes for Java 2 SDK, Standard Edition, Version 1.4.2 for complete details.

D. Installation Information

This section describes new installer features and known installation issues for this Sun Studio 11 release.

Sun Studio 11 Installer Requires J2SE 1.4.x or JRE 1.4.x Technology

If you run the Sun Studio 11 installer with a version of the J2SE technology earlier than 1.4.0, you might receive an exception during deserialization or an exception stating that the class com.sun.install.products.Product was not found. If you receive one of these exceptions when you run the installer, do one of the following:

• If the J2SE 1.4.0 technology or later is installed on the system where you are running the installer, set the root's PATH environment variable so that this version of the J2SE technology is the first one in the path. Then rerun the installer.


• If the J2SE 1.4.0 technology or later is not installed on the system where you are running the installer, install the Java^TM 2 Runtime Environment (JRE) 1.4.2_10 software by doing the following:
  1. Download the 32-bit self-extracting JRE 1.4.2_10 binary from http://java.sun.com/j2se/1.4.2/download.html.
  2. Follow the installation instructions at http://java.sun.com/j2se/1.4.2/jre/install-solaris.html to install the JRE software in any directory of your choice other than /usr/jdk.
  3. Add the path to the JRE software to your PATH environment variable.

  Then rerun the installer.

Command-Line Installer Might Not Run on SPARC Platforms

On SPARC platforms, when you try to start the command-line installer by typing ./installer -nodisplay, the GUI installer might start instead of the command-line installer.

Workaround:
To run the command-line installer on a SPARC platform:

1. Go to the CD1 directory:

   cd CD1
   

2. Run the command-line installer by typing:

   ./installer -nodisplay
   

3. Go to the CD2 directory:

   cd ../CD2
   

4. Run the command-line installer again.

Easy Installation and Uninstallation With Batch Install Programs

The batch_installer command and the batch_uninstall_all command allow you to install and uninstall the software product with minimal user interaction. The batch_installer command does not check for the presence of, or install, the required J2SE technology. See the Sun Studio 11 Installation and Setup Guide for Solaris Platforms, available on the docs.sun.com web site at http://docs.sun.com/doc/819-3052, for detailed information about batch installation and batch uninstallation.

Installing Sun Studio 11 Software in a Different Directory

If you have Forte Developer 6 software, Sun ONE Studio 7 software, Sun ONE Studio 8 software, Sun Studio 8 software, Sun Studio 9 software, or Sun Studio 10 software installed, be sure to follow the installation instructions and install the Sun Studio 11 software in a different directory.

Interrupting Patch Installation

Interrupting the installation of the Solaris OS patches causes a null pointer exception. Do not click the STOP button while the Web Start graphical user interface installation tool is adding Solaris OS patches.

Dismiss Button Not Visible in Detail Information Dialog Box

If you are running the installation tool on Java 2 Platform, Standard Edition v1.2.2 (J2SE) in the Solaris 9 OS, the Dismiss button might not be visible in the Detail Information dialog box.

Workaround:
Resize the dialog box to make the Dismiss button visible.

Installing on Solaris 10 System with NFS-mounted Filesystem Results in Incorrect pkginfo Data

If you run the batch installer on a system running the Solaris 10 OS to install the Sun Studio 11 software on a Solaris 8 or Solaris 9 NFS-mounted filesystem, then after installation the pkginfo file does not contain correct information. Install the Sun Studio 11 software with an NFS-mounted filesystem only when both the computer running the installer and the computer to which you are installing are running the same version of the Solaris OS.

Sun Studio 11 Installer and IDE Require GNU Bourne-Again Shell (bash)

The Sun Studio 11 installer and the sunstudio command that starts the IDE require that you have the GNU Bourne-Again shell (bash) software, no earlier than version 2.03.0(1), installed in /bin/bash, as it is in the standard installation of the Solaris OS, versions 8 (except for the Developer System), 9, and 10. If you have a custom installation of the Solaris OS, check to be sure that you have the required shell by typing ls /bin/bash.

If you are running the Solaris 8 OS Developer System, you can install the SUNWbash package from the Solaris 8 CD2. If you do not have the CD, you can download it from http://www.sun.com/software/solaris/8 by doing the following:

1. From the "At a Glance" table on the Solaris 8 Operating System web page, select the appropriate Solaris 8 OS download for your platform.
2. On the Download page, accept the License Agreement, and then download the zip file of CD2, for example, Solaris 8 2/04 HW Software 2 of 2 CD, Multi-language (sol-8-hw4-sparc-v2.zip) if you are running on a SPARC platform.
3. Uncompress the file using the unzip command.
4. If you are not currently superuser (root), become superuser. Mount the ISO CDROM image using the following commands, where lofi_device_number is the output from the lofiadm command:

   # lofiadm -a absolute_path_to_image
   # mount -F hsfs -o ro lofi_device_number /mnt
   

   For example:

   # lofiadm -a /tmp/sol-8-hw4-sparc-v2.iso
   /dev/lofi/1
   # mount -F hsfs -o ro /dev/lofi/1 /mnt
   

5. Install the SUNWbash package from the CD image.

   # pkgadd -d /mnt/Solaris_8/Product SUNWbash
   

email_template.txt File Not Updated

The email_template.txt file in the /installation_directory/SUNWspro/READMEs directory was not updated for the Sun Studio 11 release. To send an email to the developers who will be using the Sun Studio software, use the updated email_template.txt file on the SDN Sun Studio portal at http://developers.sun.com/prodtech/cc/documentation/ss11/mr/READMEs/email_template.txt.

E. Update Notification

The Update Notification feature periodically checks www.sun.com and communicates available changes related to your Sun Studio software, including patches and major software updates.

To view the current contents of the update file from the IDE, choose Help ->  View update information.

To initiate contact with the server and get updated information, choose Help ->  Check now for updates.

From the command line, you can view the update file at ~/.sunstudio/user_info/latest_updates.html.

If Update Notification is not able to check for updates and your system is on a network with a HTTP proxy server, you can set proxy server information by doing the following:

1. Choose Tools ->  Setup Wizard.
2. In the wizard, select the Use HTTP Proxy Server checkbox.
3. Type the proxy host name in the Proxy Server Name field and the port number in the Port field.
4. Click Finish.

You can also set the proxy server information using the ALL_PROXY environment variable; for example, setenv ALL_PROXY myproxy:8080

Note: You must exit and restart the IDE for the proxy server information to be recognized by the IDE.

To disable Update Notification, set the SUNW_NO_UPDATE_NOTIFY environment variable to any value other than false.

Usage information is communicated during the Update Notification process. This information is used by Sun Microsystems to improve future Sun Studio software releases. This information is anonymous and cannot be associated to any individual or organization.

F. IDE Information

Before using the Sun Studio 11 Integrated Development Environment (IDE), read the Integrated Development Environment (IDE) readme, which is available through the documentation index page at /installation_directory/docs/index.html. The default installation directory is /opt/SUNWspro.

This document contains important information about setup tasks you might need to perform to ensure that the IDE operates correctly. These tasks include:

• Mounting installation directories for server-based components of the product
• Ensuring that the J2SE 1.4.2_08 technology or the 32-bit J2SE 5.0 Update 3 technology is installed on your local system or available to you on the network
• Adding installation directories to your $PATH

Starting the IDE

To start the IDE:

1. Ensure that /installation_directory/bin is in your $PATH and is in front of the path to any other release of Forte Developer software, Sun ONE Studio software, or Sun Studio software.
2. Type:

   sunstudio &
   

The sunstudio command requires that you have the GNU Bourne-Again shell (bash)software, no earlier than version 2.03.0(1), installed in /bin/bash, as it is in the standard installation of the Solaris OS, versions 8 (except for the Developer System), 9, and 10. If you have a custom installation of the Solaris OS, check to be sure that you have the required shell by typing ls /bin/bash.

If you are running the Solaris 8 OS Developer System, you can install the SUNWbash package from the Solaris 8 CD2. If you do not have the CD, you can download it from http://www.sun.com/software/solaris/8 by doing the following:

1. From the "At a Glance" table on the Solaris 8 Operating System web page, select the appropriate Solaris 8 OS download for your platform.
2. On the Download page, accept the License Agreement, and then download the zip file of CD2, for example, Solaris 8 2/04 HW Software 2 of 2 CD, Multi-language (sol-8-hw4-sparc-v2.zip) if you are running on a SPARC platform.
3. Uncompress the file using the unzip command.
4. If you are not currently superuser (root), become superuser. Mount the ISO CDROM image using the following commands, where lofi_device_number is the output from the lofiadm command:

   # lofiadm -a absolute_path_to_image
   # mount -F hsfs -o ro lofi_device_number /mnt
   

   For example:

   # lofiadm -a /tmp/sol-8-hw4-sparc-v2.iso
   /dev/lofi/1
   # mount -F hsfs -o ro /dev/lofi/1 /mnt
   

5. Install the SUNWbash package from the CD image.

   # pkgadd -d /mnt/Solaris_8/Product SUNWbash
   

For information on the sunstudio command and its arguments, see the sunstudio(1) man page. To display the sunstudio(1) man page, you must have /installation_directory/man in your $MANPATH.

J2SE Technology

The IDE operates correctly with the J2SE 1.4.2_08 technology, which is included in the Sun Studio 11 release, or with the 32-bit J2SE 5.0 Update 3 technology. The IDE does not run with the 64-bit J2SE 5.0 Update 3 technology.

Java Debugging

Before starting a debugging session on a Java program, turn on Java Language Support by choosing Tools -> Java Language Support. Leave Java Language Support on until you end the debugging session.

Turning Java Language Support on or off during a debugging session can result in the following problems:

• Data or information is not displayed in any of the debugger views
• Multiple sets of tabs are displayed in the Output window

G. Performance Analyzer Information

The Performance Analyzer runs with the 32-bit J2SE 5.0 Update 3 technology, but not with the 64-bit J2SE 5.0 Update 3 technology.

H. dbx Issues

If you are running the Solaris 10 OS, the dbx command-line debugger might hang immediately after loading program information for the program you are debugging. This behavior is caused by a kernel bug.

The kernel bug occurs in the following releases of the Solaris OS:

• Solaris 10 OS 3/05 HW2. To determine whether you are running this Solaris OS release, type more /etc/release.
• The Solaris 10 OS on SPARC based systems if you have installed one of the following patches:
  • 118822-19
  • 118822-20
  • 118822-21
  • 118822-22
• The Solaris 10 OS on x86 based systems if you have installed one of the following patches:
  • 118844-19
  • 118844-20
  • 118844-21
  • 118844-22

The patches that fix the kernel bug will be available soon. Please check the Latest News page on the SDN Sun Studio portal at http://developers.sun.com/prodtech/cc/latest_news.html for the most recent information regarding these patches.

Workaround: When dbx hangs, do one of the following:

• Type Control-c twice. Warnings are displayed, but dbx prompts you for a command.
• In a terminal window on the same machine where dbx is running:
  1. Use the ps command to determine the process ID of the program you are debugging.

     ps -ef | grep program_name
     

  2. Use the prun command to start the program.

     prun process_ID
     

  3. dbx prompts you for a command.

I. Native Connector Tool Issues

The Native Connector Tool (NCT) does not work with the J2SE 5.0 Update 3 technology.

To use NCT with the J2SE 1.4.2_08 technology, you must specify the stabs format for debugging information when you compile your applications:

• For C applications, you must include the -xdebugformat=stabs option.
• For C++ applications, you must include the -Qoption ccfe -stabs=no%diffmang+no%diffmbr option.

J. Features That Might Be Removed in a Future Release

The following features might not be supported in a future release of the Sun Studio software.

Native Connector Tool

The Native Connector Tool (NCT), used to create Java class wrappers for C++ library interfaces or for C library interfaces, might be removed in a future release of the Sun Studio software.

adb Command in dbx

The adb command in the dbx command-line debugger, which executes an adb-style command or sets adb mode, might be removed in a future release of the Sun Studio software.

C++ Template Options File

The C++ template options file feature might be removed in a future release of the Sun Studio software. The options file provides features for controlling template specialization and explicit instantiation, and for specifying options to locate template definitions and to control instance recompilation. The C++ compiler now supports the syntax required to declare specializations and explicit instantiation in the source code.

K. Documentation Information

This section gives information about the documentation for this Sun Studio 11 release. Information in these release notes supersedes information in any of the other documentation.

Documentation Included With the Sun Studio 11 for Solaris Platforms Release

The following documentation is available with this Sun Studio 11 release.

• Online help. The online help available through the Help menu in the IDE provides task-oriented information on using all of the components of the IDE.
• Readmes. These documents describe the new features, performance enhancements, problems and workarounds, and software corrections in the Sun Studio 11 release. The release notes might contain additional information on problems and workarounds.

  You can access these documents in HTML on the SDN Sun Studio portal through the documentation index page at http://developers.sun.com/prodtech/cc/documentation/ss11/index.html.

• Man pages. These online reference manual pages describe user commands, libraries that are supplied with the compilers, and other types of commands. Man pages contain reference information, including command syntax, usage, and related commands.

  You can access these documents in HTML in the installed software on your local system or network through the documentation index page at file:/installation_directory/docs/index.html. You can also access these documents in HTML on the SDN Sun Studio portal through the documentation index page at http://developers.sun.com/prodtech/cc/documentation/ss11/index.html.

• Sun Studio 11 manuals.

  You can access the Sun Studio 11 manuals in PDF format or HTML format on docs.sun.com through the documentation index page on the SDN Sun Studio portal at http://developers.sun.com/prodtech/cc/documentation/ss11/index.html

Documentation Requirements

To view the documentation that is available in PDF format, you need Adobe® Acrobat Reader software. To download the software, go to http://www.adobe.com/products/acrobat/readstep.html.

Copyright © 2005 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.

U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements. Use is subject to license terms.

This distribution may include materials developed by third parties.Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and in other countries, exclusively licensed through X/Open Company, Ltd.