Sun Studio 12 Update 1 Installation Guide

Installing the Sun Studio Software

You can install the Sun Studio 12 Update 1 software and the required OS patches on a single‐user system. Or you can install the software and OS patches on a server for use by client systems with the same architecture, and then install the OS patches on each client system that will access the Sun Studio software on the server.

Determining Which Installer You Have

Before running the package installer, it is important to know which version of the installer you have. The English-only version of the installer installs the English-only release of the Sun Studio 12 Update 1 software. The multi-language version installs the multi-language release of the software. The two versions provide slightly different options, so be sure that you know which one you have before you start it from the command line.

To determine which installer you have, in the directory that contains the installer, type:


./SunStudio12u1-OS-platform-packages.sh --help

If you have the multi-language installer, the first line of the help output is:


Sun Studio 12 Update 1 multi-language installer

If you have the English-only installer, the line above is not included in the help output.

Installing in a Zone

To install the software in a zone on a Solaris 10 system, run the installer in that zone. If you are installing in the global zone and want the software to be available in that zone only, specify the -‐current-zone-only when starting the installer.

If you install the software in the global zone and want to be able to run the IDE from non-global zones, you must copy the /installation_directory/netbeans directory from the global zone to each non-global zone.

Installing in an Alternate Root Directory

To install the English-only software using an alternate root directory (the default root directory is /), use the GUI installer with the -‐use-alternate-root directory option.

To install the multi-language software using an alternate root directory, use either the GUI installer or the non-GUI installer with the -‐use-alternate-root directory option.

Installing on Multiple Systems

To install the software on multiple systems, you can use the -‐record state_file.xml option when starting the GUI installer to record an installation that you can repeat using the -‐state state_file.xml option with the non-GUI installer.

Installing With the Graphical User Interface Installer

The graphical user interface (GUI) installer lets you choose the installation directory and select which components of the Sun Studio 12 Update 1 software you want to install. For a complete list of the valid command-line options when starting the GUI installer, see Command-Line Options for the GUI Installer.

The GUI installer requires the JavaTM 2 Software Development Kit (JDK) 5, Update 16.

ProcedureUsing the Graphical User Interface Installer

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


    su
    Password: root-password
    
  2. In the directory that contains the installer, start the installer by typing:


    ./SunStudio12u1-OS-platform-packages.sh
    
  3. On the License Agreement page, review the license agreement and then select the checkbox to accept the terms in the license agreement. Click Next.

  4. If you are running the multi-language installer, the Locales page offers you the opportunity to select additional locales for which to install the software. Click the checkboxes for any additional locales for which you want to install. Then click Next.

  5. The System Analysis page tells you if your system is missing any of the required OS patches.

    If you are running the multi-language installer, click More info, and then click Execute install_patches.sh now. The install_patches.sh utility runs in your terminal window. When it displays Execution finished, press Enter to exit the utility.

    If you are running the English-only installer and you need to install these patches, you can do so later by running the install_patches.sh utility from the command line.

    For a complete list of the valid command-line options when starting the install_patches.sh utility, see Command-Line Options for the install_patches.sh Utility

    The required OS patches must also be installed with the install_patches.sh utility on client systems that will use the Sun Studio 12 Update 1 software on a server. For more information, see Installing the Required Solaris OS Patches.

  6. The Sun Studio Installer page gives you the option of selecting which components of the Sun Studio software to install:

    1. Click Next if you want to install all components of the software.

    2. Click Customize if you want to select which components of the software to install. The Customize Installation dialog box lists the components and indicates which, if any, components are already installed. Click the checkbox for any component you do not want to install to remove the checkmark. Click OK, then click Next.

  7. On the Sun Studio Installation page:

    1. Specify a different installation directory if you do not want to install the software in the default installation directory /opt. If you already have some components of Sun Studio 12 Update 1 software installed, the installer will install additional components only in the same directory.

    2. By default, the installer creates symbolic links in the /usr/bin directory and the /usr/share/man directory to the Sun Studio 12 Update 1 software and man pages. If you already have symbolic links in /usr/bin and /usr/share/man to a previous Sun Studio release, the links to Sun Studio 12 Update 1 will replace them. If you do not want the symbolic links created, or you do not want links to a previous release replaced, click the checkbox to remove the checkmark. (If you already have the links to Sun Studio 12 Update 1 installed, the checkbox is not displayed.)

  8. On the Summary page, verify that the list of components to be installed is correct and that you have adequate space on your system for installation. Then click Install to start the installation.

  9. When the installation is complete, the Setup Complete page is displayed. Click Finish to exit the installer.

  10. After installation, the installer opens a web browser and asks you to use your Sun Online Account to register your copy of Sun Studio with the Sun Inventory. Registration is not required, but it allows you to organize your products in the Sun Inventory and receive timely information from Sun. The installer also registers this copy of Sun Studio in your local Service Tags database (if this service is available).

  11. If the Sun Studio 12 Update 1 is going to be used from client systems, then on each client system, set the PATH and MANPATH to access the Sun Studio 12 Update 1 software and man pages on the server (see Setting Up Access to the Developer Tools and Man Pages).

  12. If you installed the Sun Studio 12 Update 1 software on a single-user system, type the following to determine whether you need to set up your access to the Sun Studio 12 Update 1 software tools and man pages:


    /usr/bin/version
    
    1. If you receive the message /usr/bin/version: not found or the command reports an earlier version of Sun Studio software, see Setting Up Access to the Developer Tools and Man Pages for information on setting your PATH and MANPATH to point to the Sun Studio 12 Update 1 software.

    2. If the command reports Sun Studio 12 Update 1 software, you do not need to set yourPATH and MANPATH.

Installing With the Non-GUI Installer

The non‐GUI installer installs all components of the Sun Studio 12 Update 1 software silently. For a complete list of the valid command-line options when starting the non‐GUI installer, see Command-Line Options for the Non-GUI Installer.

ProcedureUsing the Non-GUI Installer

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


    su
    Password: root-password
    
  2. In the directory that contains the installer, print the license agreement.

    1. If you are using the multi-language installer, type:


      ./SunStudio12u1-OS-platform-packages.sh --print-license
      
    2. If you are using the English-only installer, do one of the following:

      If you are using the Bourne shell or Korn shell, type:


      ./SunStudio12u1-OS-platform-packages.sh --print-license 2>&1 | more
      

      If you are using the C shell, type:


      ./SunStudio12u1-OS-platform-packages.sh --print-license |& more
      

    The installer displays startup messages and then prints the license agreement. Review the license agreement.

  3. Accept the terms of the license agreement and start the installer by typing:


    ./SunStudio12u1-OS-platform-packages.sh --non-interactive-accept-license
    
  4. The installer runs silently and returns your prompt when installation is complete. It writes a log file in the /root/.nbi/logs directory.

  5. If the Sun Studio 12 Update 1 is going to be used from client systems, then on each client system, set the PATH and MANPATH to access the Sun Studio 12 Update 1 software and man pages on the server (see Setting Up Access to the Developer Tools and Man Pages).

  6. If you installed the Sun Studio 12 Update 1 software on a single-user system, type the following to determine whether you need to set up your access to the Sun Studio 12 Update 1 software tools and man pages:


    /usr/bin/version
    
    1. If you receive the message /usr/bin/version: not found or the command reports an earlier version of Sun Studio software, see Setting Up Access to the Developer Tools and Man Pages for information on setting your PATH and MANPATH to point to the Sun Studio 12 Update 1 software.

    2. If the command reports Sun Studio 12 Update 1 software, you do not need to set your PATH and MANPATH.