The Sun Studio 11 for Linux 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. Installation Information
4. Update Notification
5. IDE Information
6. Performance Analyzer Information
7. dbx Issues
8. X-Designer Issues
9. Features That Might Be Removed in a Future Release
10. Documentation Information

A. System Requirements

The Sun Studio 11 software for Linux platforms can be installed on the following platforms:

• SUSE Linux Enterprise Server 9 (en locale only, not supported in ja and zh locales)
• RedHat Enterprise Linux 4

For information on installing the Sun Studio 11 software for Solaris platforms, see the Sun Studio 11 for Solaris Platforms Release Notes.

The system requirements are as follows.

* Note: If you do not install J2SE 1.4.2_10 technology or J2SE 5.0 Update 3 technology in the ja locale or zh locale, multibyte characters will not display correctly.

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 Linux Platforms, which is available at http://docs.sun.com/doc/819-3051.

B. Disk Space Requirements by Installer

The suggested available disk space you need to install the Sun Studio 11 software on Linux platforms is 556 MB. The following table shows the size of the installed Sun Studio 11 for Linux Platforms software.

C. Installation Information

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

Installing Sun Studio 11 Software in a Different Directory

If you have the 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.

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 Linux Platforms, available on the docs.sun.com web site at http://docs.sun.com/doc/819-3051. for detailed information about batch installation and batch uninstallation.

Development Tools Package Group Needed to Run Sun Studio Software on Java Desktop System

If you are installing the Sun Studio 11 software on the Java Desktop System (JDS) software, you need to add the Development Tools package group to your JDS installation. This package group is not installed as part of a default JDS installation. It includes the packages that transform the JDS software into a development environment for native language applications, such as the compilers, linkers, and ctags. Without these packages or equivalent programs available on a server, the Sun Studio 11 software cannot perform as expected.

To install this package group, do the following:

1. Become a superuser (root) by typing:

   % su
   Password: root-password
   

2. Start the Java Desktop System Configurator by typing:

   # yast2 &
   

3. In the right panel, select Install or Remove Software. The Package Information window opens.
4. In the left panel of the Package Information window, select Development Tools; then click Accept in the bottom right corner of the window. The Installation window opens followed by a dialog box asking you to insert the appropriate CD.
5. Insert the requested CD and click OK, and the Development Tools package group installs.
6. When the installation is complete, click Close in the Configurator window.
7. Exit from superuser privileges by typing:

   # exit
   

version Command is Not Available

The version command for the Sun Studio 11 software is not available on Linux platforms. For version information on a component of the Sun Studio 11 software, use the -V option. For DistributedMake (dmake), use the -v option.

email_template.txt File is Missing

The email_template.txt referenced on the After Installation page of the installer is missing in this release.

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

E. 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/sunstudio11/docs/index.html. The default installation directory is /opt/sun.

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 Java 2 Platform Standard Edition v1.4.2_08 (J2SE) 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/sunstudio11/bin is in your $PATH and is in front of the path to any other release of Sun Studio software.
2. If you are using the J2SE 1.4.2_08 technology, type:

   sunstudio &
   

3. If you are using the J2SE 5.0 Update 3 technology, type:

   sunstudio --jdkhome path_to_32-bit_J2SE_technology &
   

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/sunstudio11/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

F. 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. To start the Performance Analyzer GUI from the command line when you are using the J2SE 5.0 Update 3 technology, type:

analyzer --jdkhome path_to_32-bit_J2SE_technology &

G. dbx Issues

When you are debugging a Java program on a Linux platform, the dbx debugger sometimes hangs while waiting for the status of a zombie thread.

Workaround:
Set the LD_ASSUME_KERNEL environment variable as follows:

setenv LD_ASSUME_KERNEL 2.4.1

H. X-Designer Issues

To run the X-Designer GUI Builder correctly on the Linux OS on an x64 based system, you must set the LD_RUN_PATH environment variable as follows:

export LD_RUN_PATH=/usr/OpenMotif-2.1.31/lib64:/usr/X11R6/lib64

I. Features That Might Be Removed in a Future Release

adb Command in dbx

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

J. 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 Linux 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. Man pages contain reference information, including command syntax, usage, and related commands.

  You can access these documents in HTML on your local system or network through the documentation index page at file:/installation_directory/sunstudio11/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 Debugging a Program With dbx, Performance Analyzer, and X-Designer User's Guide 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.