% su

Password: root-password

3. Insert the CD-ROM in the CD-ROM drive.

The product installer starts.

If the installer does not start or you are using the Solaris 9 operating environment, the autorun feature might be disabled or unsupported on your system. In this case, use one of the following methods to start the installer:

• In the File Manager window, double-click the installer icon to start the installer.
• Invoke the installer by typing:

# /cdrom/studiocc_8_sparc/installer

The installer begins installing the product and the Welcome pane appears.

4. Click Next in the Welcome pane.

The Initializing pane appears, and when initialization is complete, the Binary Code License Agreement pane appears.

5. In the Binary Code License Agreement pane, click Accept.

If you choose Decline, you cannot continue with the installation.

6. Click Next to proceed to the Component Selection pane.

7. In the Component Selection pane, select the type of installation you want for each product.

• If you select Omit, the product is not installed.
• If you select Default Install, the installer installs all components of the product and all online documentation that is associated with the components.
• If you select Custom Install, the installer allows you to select (in Step 12) which subcomponents of the product you want to install.

8. If you did not choose to install the Sun ONE Studio 8 to Forte Developer 6 update 2 (FD6u2) Connector in Step 7, skip to Step 9. If you did choose to install the connector, then the Sun ONE Studio 8 to Forte Developer 6 update 2 pane appears.

a. Type the correct path in the text field for your installed Forte Developer 6 update 2 software.

b. Click Next to continue.

After the installer checks for adequate disk space, the Ready to Install pane appears.

9. Click Next to proceed to the Select Install Directory pane.

10. Decide whether you want to change the software installation directory from /opt.

See Supporting Previous Sun ONE Studio and Forte Developer Releases if you want to install this new Sun ONE Studio release on a computer that contains previous Sun ONE Studio releases or Forte Developer releases.

• If you want to install in the /opt directory on the source computer, click Next. If you have installed a previous release of Sun ONE Studio software or Forte Developer software in the /opt directory on the source computer, you must choose a different installation directory.
• If you want to install the software in a directory other than the /opt directory on the source computer, type the new location in the text field or browse for another location. If you do not have permission to write to the directory you select, the installer asks you if you want to change permissions. You must have write permission for the selected directory before you can proceed with installation. See the chmod(1) man page for information on changing directory permissions.

11. Click Next when you have entered the installation directory.

If you selected Custom Install for any of the products in the Product Selection pane, a Subcomponent Selection pane is displayed for each of those products. If you did not select Custom Install for any of the products, skip to Step 15.

12. By default, all subcomponents are selected for installation. Deselect any subcomponents you do not want to install by clicking their checkboxes to remove the check marks. Click Next when the pane shows check marks for only the components you want to install.

13. In the Enter Serial Number pane, click the 60-day Trial Serial Number button to generate the 60-day trial serial number or enter your permanent serial number in the text box. See Locating the Product Serial Number for information on finding the serial number.

14. Click Next to install the serial number.

If you are entering a permanent serial number to upgrade from a trial serial number and your product is installed, you can exit the installer.

15. After the installer checks for adequate disk space, the Ready to Install pane appears.

Verify that the disk space shown at the top of the Ready to Install pane is sufficient to install the products you have selected.

16. In the Ready to Install pane, verify that the items you want to install are listed.

• If the products you want are listed, click Install Now.
• If you want to install more products, click Back to return to the Product Selection pane, make your selections, and click Next to return to the Ready to Install pane.

The Installing pane appears with a progress indicator. When installation is complete, the Installation Summary pane appears.

17. If you want to view the installation log file for a product, click the Details button for that product in the Installation Summary pane.

18. Click Exit to finish the Sun ONE Studio 8 software installation.

19. Remove the CD-ROM from the CD-ROM drive.

20. (Optional) If you performed the installation using a remote display, on the display computer, disable client access by typing the following:

# xhost - source-computer-name

21. Exit from superuser privileges on the source computer by typing:

# exit

22. To set up your access to the Sun ONE Studio Compiler Collection tools and man pages, set your PATH and MANPATH variables by following the steps in Setting Up Access to the Developer Tools and Man Pages.

23. (Optional) If you installed the Sun ONE Studio 8 to Forte Developer 6 update 2 connector, see the Compiler Collection IDE Options Readme accessible through the documentation index page at /install-directory/SUNWspro/docs/index.html for additional steps required for using this connector.

---

Using the Command-Line Installer

These instructions describe how to install the Sun ONE Studio 8, Compiler Collection software and serial number using the command-line interface.

---

Note - Do not use the pkgadd command to install the software. Use the provided installer.

---

1. Decide if you want to install using a remote display. See Choosing Local Display or Remote Display of the Installer for details.

2. If you are not currently superuser, become a superuser (root) by typing:

% su Password: root-password

3. Insert the CD-ROM in the CD-ROM drive.

If the GUI installer starts, choose Exit to exit from the installer.

4. From the download directory, start the command-line installation by typing:

# /cdrom/studiocc_8_sparc/installer -nodisplay

Do not run the installer in the background.

---

Note - This is a multilanguage CD-ROM. If the operating system does not recognize the correct language, use the -locales option with en for English or ja for Japanese when you invoke the installer. For example: /cdrom/studiocc_8_sparc/installer -nodisplay -locales en

---

5. The installer welcomes you. Press Enter to continue.

The Binary Software License Agreement text appears.

---

Note - The Enter key is equivalent to the Return key on some keyboards. Press the Enter key to accept the default selections during installation.

---

6. After reading the Binary Software License Agreement, type Accept at the prompt and press Enter to continue.

If you type Decline, you cannot continue with the installation.

7. The installer displays a list of the Sun ONE Studio 8 products with an installation option checked for each product.

To change the installation option for a product, type the number (0-6) that corresponds to the product and proceed to Step 8. To accept the Default installation for all products, press Enter and skip to Step 10.

---

Note - If you select Default Install for Solaris patches, the installer installs all of the required patches for the Sun ONE Studio 8, Compiler Collection software, which are listed in Appendix B. If you have previously installed these patches, installing the required patches does not downgrade your system.

---

8. Select the type of installation you want for the product you selected.

• For no installation, type 1. No Install deselects a product and the product is not installed.
• For default installation, type 2. Default Install installs all components and online documentation associated with that product.
• For custom installation, type 3. Custom Install allows you to select (in Step 10) the components of that product that you want to install.

The installer displays the updated product list.

9. To select or deselect another product for installation, type its number and return to Step 8. When you are finished selecting products and their types of installation, type 7 to continue and proceed to Step 10.

10. The installer prompts you to specify a location for installation.

• If you want to install in the /opt directory on the source computer, press Enter. If you have installed a previous release of Sun ONE Studio software or Forte Developer software in the /opt directory on the source computer, you must choose a different installation directory.
• If you want to select another directory, type the name of the new directory. If you do not have permission to write to the directory you select, the installer asks you if you want to change permissions. You must have write permission for the selected directory before you can proceed with installation. See the chmod(1) man page for information on changing directory permissions.

11. If you chose to install the Forte Developer 6 update 2 Connector, verify that the installation path of the Forte Developer 6 update 2 software is correct.

---

Note - To install the connector, you must already have Forte Developer 6 update 2 software installed.

---

a. If the path is incorrect, type the correct path at the prompt.

b. Press Enter to continue.

12. If you selected a custom installation for a product in Step 8, select or deselect a component for installation by entering the number that corresponds to the component and press Enter. When finished, type 0 and press Enter.

13. Select Serial Number to generate a Serial Number, or enter your permanent serial number. See Locating the Product Serial Number for information on finding the serial number.

If you are entering a permanent serial number to upgrade from a trial serial number and your product is installed, you can exit the installer.

After verifying the serial number, the installer checks for disk space and warns you if you have insufficient disk space.

A list of products and components is shown for verification.

14. Verify the list of products and components and do one of the following:

• Type 1 if you want to proceed with installation.
• Type 2 if you want to start over from Step 5.
• Type 3 if you want to exit installation.

If you typed 1 to proceed with installation, a progress indicator appears.

15. When installation is complete, you can view a product's log file by typing the number that corresponds to that product. When you finish viewing the log files, type the number that corresponds to Done.

16. Remove the CD-ROM from the CD-ROM drive.

17. (Optional) If you performed the installation using a remote display, on the display computer, disable client access by typing the following:

# xhost - source-computer-name

18. Exit from superuser privileges on the source computer by typing:

# exit

19. To set up your access to the Sun ONE Studio Compiler Collection tools and man page, set your PATH and MANPATH variables by following the steps in Setting Up Access to the Developer Tools and Man Pages.

20. (Optional) If you installed the Sun ONE Studio 8 to Forte Developer 6 update 2 connector, see the Compiler Collection IDE Options Readme accessible through the documentation index page at /install-directory/SUNWspro/docs/index.html for additional steps required for using this connector.

---

Using the Batch Installer

You can install the Sun ONE Studio Compiler Collection software, Sun Performance Library software, or Sun ONE Studio Source Distribution software with the batch installer for a default installation.

---

Note - Do not use the pkgadd command to install the software. Use the provided installer.

---

Follow these instructions for batch installation:

1. Decide if you want to install using a remote display. See Choosing Local Display or Remote Display of the Installer for details.

2. If you are not currently superuser, become a superuser (root) by typing:

% su Password: root-password

3. Use the following command to run the batch installer:

batch_installer [-s serial number] [-d dirname | -R root-path] [-h]

---

Note - Use the command batch_installer_perflib to install the Sun Performance Library software. Use the command batch_installer_src to install the Sun ONE Studio Source Distribution software

---

See TABLE 2-1 for the options that are available for the batch_installer command.

TABLE 2-1 batch_installer Options and Option Descriptions

Option Name	Option Description
-s serial number	Installs the permanent serial number. Without this option, a 60-day trial serial number is generated by default.
-d dirname	Installs in directory dirname.
-R root-path	Specifies the absolute path for the root system and product. Use this option in JumpStart installation to set the root directory.
-h	Displays usage information for the batch_installer command.

The batch_installer command and the options can be used in the scenarios shown in TABLE 2-2.

TABLE 2-2 Installation Scenarios Using the batch_installer Command and Options

Scenario	Command Typed at the Prompt
Install in the default directory and generate a 60-day trial serial number by default	#./batch_installer
Install in the default directory with the permanent serial number	#./batch_installer -s serial number
Install in a directory other than the default directory	#./batch_installer -d /dirname
Install and change the root installation	#./batch_installer -R /a/opt

4. Choose the appropriate installation scenario from TABLE 2-2 to run the batch_installer command. For example, to use the options to generate the 60-day Trial serial number and install in a directory other than the default, type the following:

# /cdrom/studiocc_8_sparc/batch_installer -d /dirname

The Binary Software License Agreement appears, and the installer checks for adequate disk space. The installer proceeds with installation, and the prompt returns when installation is complete.

5. (Optional) If you performed the installation using a remote display, on the display computer, disable client access by typing the following:

% xhost - source-machine-name

6. Exit from superuser privileges on the source computer by typing:

# exit

7. Set your PATH and MANPATH variables. See Setting Up Access to the Developer Tools and Man Pages.

---

Using the Solaris JumpStart Installer

You can use the Solaris JumpStart installer on the Solaris 9 operating environment (SPARC^® Platform Edition) and on the Solaris 9 operating environment (x86 Platform Edition) to automate the software installation process to install the Sun ONE Studio Compiler Collection software on multiple systems. An overview of the JumpStart installation steps is listed below. See the Solaris 9 Installation Guide for complete details of JumpStart installation.

---

Note - In the following instructions, substitute the download directory name for the cdrom_path that is used in the command-line examples.

---

1. Verify that you have more than one gigabyte of disk space in both the swap partition and the /opt partition on the source machine.

2. Copy the downloaded file into the $SI_CONFIG_DIR directory.

3. Create a finish script that resides on the source machine. The file must contain the following information:

#! /bin/sh cd $SI_CONFIG_DIR/cdrom_path ./batch_installer -R /a

---

Note - The batch_installer -d option does not work in JumpStart installation.

---

See Using the Batch Installer for information on the available batch_installer command options.

Refer to the Solaris 9 Installation Guide for further instruction on completing the JumpStart installation process.

---

Setting Up Access to the Developer Tools and Man Pages

Because the Sun ONE Studio Compiler Collection product components and man pages are not installed into the system directories /usr/bin/ and /usr/share/man, you must change your PATH and MANPATH environment variables to enable use of the Sun ONE Studio Compiler Collection software.

---

Note - The paths shown in this section assume that Sun ONE Studio 8 packages are installed in the default /opt directory. If you installed the software in a different directory, replace /opt in the examples with that directory.

---

Set the PATH and MANPATH variables in your home .cshrc file if you are using the C shell, or your home .profile file if you are using the Bourne shell or Korn shell.

For more information about the PATH and MANPATH environment variables, the SunOS man page csh(1) describes the PATH variable for the C shell, the sh(1) man page describes the PATH variable for the Bourne shell, and the ksh(1) man page describes the PATH variable for the Korn shell. The man(1) man page describes the MANPATH variable.

Setting Your PATH Environment Variable So You Can Access Sun ONE Studio Compiler Collection Tools

To use the Sun ONE Studio Compiler Collection commands, your PATH environment variable must contain the path /opt/SUNWspro/bin. To determine whether you need to set your PATH environment variable, follow these steps:

1. Display the current value of the PATH variable by typing:

% echo $PATH

2. Review the output for a string of paths that contain /opt/SUNWspro/bin.

• If you find the path, your PATH variable is already set to access Sun ONE Studio Compiler Collection tools. (The /opt path can be replaced by an alternative install path.)
• If you do not find the path, set your PATH variable as described in the next step.

3. Add the path /opt/SUNWspro/bin/ to your PATH environment variable.

• If you are using the C shell, edit your home .cshrc file to add the path.
• If you are using the Bourne shell or Korn shell, edit your home .profile file to add the path.

Setting Your MANPATH Environment Variable So You Can Access Sun ONE Studio Compiler Collection Man Pages

To access Sun ONE Studio Compiler Collection man pages with the man command, your MANPATH environment variable must contain the path /opt/SUNWspro/man. To determine whether you need to set your MANPATH environment variable, follow these steps:

1. Request the dbx(1) man page by typing:

% man dbx

2. Review the output, if any.

If the man dbx command cannot find the dbx(1) man page, or if the page that is displayed is not for the version of the software you just installed, you do not have the MANPATH variable set correctly. Set your PATH variable as described in the next step.

3. Add the path /opt/SUNWspro/man/ to your MANPATH environment variable.

• If you are using the C shell, edit your home .cshrc file to add the path.
• If you are using the Bourne shell or Korn shell, edit your home .profile file to add the path.

Adding the Changes to the Appropriate Environment Variable

The following procedure lets you permanently add the paths for the Sun ONE Studio 8 tools and man pages to the appropriate environment variables so that all Sun ONE Studio 8 components are always available. These commands can also be entered at a shell prompt to temporarily enable that shell only.

1. Add the Sun ONE Studio Compiler Collection software to your PATH and MANPATH variables.

---

Note - The PATH and MANPATH variables must be set to include Sun ONE Studio Compiler Collection software in each user's environment, which allows each user to use the installed software.

---

• If you are using the C shell (csh), first determine if your MANPATH variable is already set. At a shell prompt, type the command:

% echo $MANPATH

If the response is "Undefined variable" (C shell) or an empty line (Bourne shell or Korn shell), the MANPATH variable is not set. If paths to one or more man directories are displayed, the variable is set.

Now edit the .cshrc file in your home directory and add the following line at the end of the file:

set path=(/opt/SUNWspro/bin $path)

If the MANPATH variable is not already set, add the following line:

setenv MANPATH /opt/SUNWspro/man:/usr/share/man

If the MANPATH variable is already set, add the following line instead:

setenv MANPATH /opt/SUNWspro/man:$MANPATH

• If you are using the Bourne or Korn shells (sh or ksh), edit the .profile file in your home directory and add the following lines:

PATH=/opt/SUNWspro/bin${PATH:+:}${PATH} MANPATH=/opt/SUNWspro/man:${MANPATH:=/usr/share/man}

Do not type any spaces in these two lines.

2. Save the .cshrc file or .profile file that you modified in Step 1.

3. Reinitialize your shell by executing the following command:

For the C shell, type:

source ~/.cshrc

For the Bourne shell or Korn shell, type:

. ~/.profile

---

Viewing the Sun ONE Studio 8, Compiler Collection Documentation

You can access the documentation for the Sun ONE Studio Compiler Collection software at the following locations:

• Release Notes: Available at http://docs.sun.com/doc/816-6727. Information in the release notes updates and extends information in all readme files.
• Compiler Collection Documentation: Product man pages, HTML versions of readmes, and manuals can be accessed from /opt/SUNWspro/docs/index.html.
• Compiler Collection Developer Resources Portal: For compiler collection documentation, see the documentation index on the Compiler Collection Developer Resources Portal. Point your browser to http://www.sun.com/developers/studio, click Compiler Collection, and then click Documentation. The portal also contains technical articles and knowledge base items.

---

Note - If your compiler collection software has not been installed in the default /opt directory, ask your system administrator for the equivalent path on your system.

---

You are now ready to use your Sun ONE Studio 8, Compiler Collection software.

---

Registering the Compiler Collection Software

After you have completed your installation, you can register your product with Sun to receive information on updates and product news. Go to the product registration page at
https://www.sun.com/cgi-bin/software/sundev/prodreg.cgi?scc.

Installation Guide

817-0642-10

Copyright © 2003, Sun Microsystems, Inc. All rights reserved.