JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Studio 12.3 Installation Guide     Oracle Solaris Studio 12.3 Information Library
search filter icon
search icon

Document Information

Preface

1.  Preparing for Installation

2.  Installing the Oracle Solaris Studio 12.3 Software

Installing the Oracle Solaris Studio Software

Installing in a Zone

Installing on a Solaris Server for Use by Clients With a Different Architecture

Installing in an Alternate Root Directory

Installing on Multiple Systems

Installing the IDE on a Desktop System

Installing Oracle Solaris Studio With the Graphical User Interface Installer

Using the Graphical User Interface Installer

Installing the Runtime Libraries Only With the GUI Installer

Using the Graphical User Interface Installer

Installing Oracle Solaris Studio With the Non-GUI Installer

Using the Non-GUI Installer

Installing the Runtime Libraries Only With the Non-GUI Installer

Using the Non-GUI Installer

Installing the Required Oracle Solaris OS Patches

Setting Up Access to the Developer Tools and Man Pages

Starting the Oracle Solaris Studio 12.3 IDE

3.  Uninstalling the Oracle Solaris Studio 12.3 Software

4.  Troubleshooting

A.  Command-Line Options for the Installer,Uninstaller,and install_patches Utility

B.  Adding Swap Space

C.  Oracle Solaris 12.3 Components and Packages

D.  Patch Identification Numbers and Descriptions

E.  Version Numbers of the Oracle Solaris Studio 12.3 Components

Index

Installing the Oracle Solaris Studio Software

You can install the Oracle Solaris Studio 12.3 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 Oracle Solaris Studio software on the server.


Tip - Installation from a network location can take a significant amount of time, so if possible, make a copy of the installation bundle on each system where you plan to install the software, and run the installer locally.


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, select the Install in current zone only checkbox in the GUI installer, or specify the --current-zone-only option when starting the non-GUI installer.

Installing on a Solaris Server for Use by Clients With a Different Architecture

You can install the Oracle Solaris Studio software on a server running the Solaris OS for use by client systems with a different architecture. You can install the software on a SPARC based server for use by x86 based client systems. Or you can install the software on an x86 based server for use by SPARC based client systems. To install the software for SPARC based systems on an x86 based system, or vice versa, specify the --ignore-architecture option when you start the installer.

Installing in an Alternate Root Directory

To install the software using an alternate root directory, use the non-GUI installer with the --use-alternative-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 the IDE on a Desktop System

When you install the Oracle Solaris Studio software on a server, you can ask the installer to generate a zip file containing a distribution of the IDE (and the Code Analyzer, if you are installing it) configured for installation on a desktop system with almost any operating system. After installing the Oracle Solaris Studio software, you can unzip this distribution file on a desktop system. When you run the IDE on the desktop system, it will recognize the server on which you generated the distribution as a remote host, and access the tool collection (compilers, make tool, and debugger) in your Oracle Solaris Studio installation.

Installing Oracle Solaris Studio With the Graphical User Interface Installer

The graphical user interface (GUI) installer lets you choose the installation directory and select which components of the Oracle Solaris Studio 12.3 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 Java 2 Software Development Kit (JDK) 5, Update 3.

Using 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:
    ./solarisstudio.sh
  3. The System Analysis page tells you:
    • If your system is missing any of the required OS patches. (If you specified the --nfs-server when you started the installer, the installer does not check your system for the patches.)

      If you need to install these patches, you can do so by:

      • Clicking More Info and then clicking Execute install_patches.sh now.


        Note - If you are running the installer on a system running Oracle Solaris 10/09 or Oracle Solaris 9/10, you might see one of following messages when the install_patches.sh utility is running.

        For patch 147463-01, required patch 137137-09 does not exist.
        For patch 147464-01, required patch 137138-09 does not exist

        You can ignore the message because patch 147436-01 (SPARC platforms) or patch 147437–01 (x86 platforms) is required only on systems running Oracle Solaris 8/11.


      • Running the install_patches.sh utility from the command line after you have installed Oracle Solaris Studio.

      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 Oracle Solaris or Linux client systems that will use the Oracle Solaris Studio 12.3 software on a server. For more information, see Installing the Required Oracle Solaris OS Patches.

    • If your system does not have JDK 6, Update 24, which is required for running the IDE, dbxtool, DLight, and the Code Analyzer. If you plan to use these tools, you can download the required JDK from http://www.oracle.com/technetwork/java/javase/downloads/index.html.

  4. The Oracle Solaris Studio Installer page gives you the option of selecting which components of the Oracle Solaris 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.

    Note - To install only the runtime libraries, you must have specified the --libraries-only option when you started the installer (see Installing the Runtime Libraries Only With the GUI Installer).


  5. On the Oracle Solaris 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 Oracle Solaris Studio 12.3 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 Oracle Solaris Studio 12.3 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 Oracle Solaris Studio 12.3 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 Create symbolic links in /usr/bin checkbox to remove the checkmark. (If you already have the links to Oracle Solaris Studio 12.3 installed or you specified the --nfs-server when you started the installer, the checkbox is not displayed and the links are not installed.)
    3. If you are running the installer on a system that has zones, the Install Oracle Solaris Studio software to current zone only checkbox is displayed. By default, the installer installs the software to the current zone only. If you want the software installed to all zones, click the checkbox to remove the checkmark. When you run the installer in the global zone, installing in the current zone only makes the installed product visible only in the global zone.
    4. If you are installing the IDE component and you want the installer to generate a zip file containing a distribution of the IDE (and the Code Analyzer, if you are installing it) configured for a desktop operating system, select the Generate Desktop Distribution during installation checkbox to add a checkmark. The generated zip file is placed in the lib directory in your Oracle Solaris Studio installation.
    5. Click Next.
  6. 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.
  7. When the installation is complete, the Setup Complete page is displayed. By default, the Register my Oracle Solaris Studio Software after finishing the installation checkbox contains a checkmark. If you do not want to register your Oracle Solaris Studio installation at this time, click the checkbox to remove the checkmark. Click Finish to exit the installer.
  8. If you chose to register your installation, the installer opens a web browser to a page where you can register your copy of Oracle Solaris Studio. Registration is not required, but it allows you to organize your products and receive timely information from Oracle.
  9. If Oracle Solaris Studio 12.3 is going to be used from Solaris or Linux client systems, then on each client system, set the PATH and MANPATH to access the Oracle Solaris Studio 12.3 software and man pages on the server (see Setting Up Access to the Developer Tools and Man Pages).
  10. If you installed the Oracle Solaris Studio 12.3 software on a single-user system, type the following to determine whether you need to set up your access to the Oracle Solaris Studio 12.3 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 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 Oracle Solaris Studio 12.3 software.
    2. If the command reports Oracle Solaris Studio 12.3 software, you do not need to set your PATH and MANPATH.

Installing the Runtime Libraries Only With the GUI Installer

You can use the GUI installer to install the Oracle Solaris Studio runtime libraries only.


Note - If you run the installer to install only the libraries, you cannot run the installer later to install additional components without first running the uninstaller to uninstall the libraries.


Using 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:
    ./solarisstudio.sh --libraries-only
  3. On the Oracle Solaris Studio Installer page, click Next.
  4. On the Oracle Solaris Studio Installation page, specify a different installation directory if you do not want to install the libraries in the default installation directory /opt.
  5. On the Summary page, verify that you have adequate space on your system for installation. Then click Install to start the installation.
  6. When the installation is complete, the Setup Complete page is displayed. Click Finish to exit the installer.

Installing Oracle Solaris Studio With the Non-GUI Installer

By default, the non-GUI installer installs all components of the Oracle Solaris Studio 12.3 software silently in the default installation directory. You can select which components you want to install by specifying the --install-components option when you start the installer. Use the --print-components-description option or see Command-Line Options for the Non-GUI Installer for a list of the component names you can specify with this option.

You can start the installer with the --installation-location directory option to install the components in a directory of your choice. You can start the installer with the --libraries-only to install the runtime libraries only (see Installing the Runtime Libraries Only With the Non-GUI Installer). 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.

Using 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, start the installer by typing:
    ./solarisstudio.sh --non-interactive

    If you want to install only selected components of the Oracle Solaris Studio software, include the --install-components option with the names of the components you want to install.

    If you are installing the IDE component and you want the installer to generate a zip file containing a distribution of the IDE (and the Code Analyzer, if you are installing it) configured for a desktop operating system, include the --generate-desktop-dir option. The generated zip file is placed in the lib directory in your Oracle Solaris Studio installation.

  3. The installer runs silently and returns your prompt when installation is complete. It writes a log file in the /root/.nbi/logs directory.
  4. If the Oracle Solaris Studio 12.3 is going to be used from Solaris or Linux client systems, then on each client system, set the PATH and MANPATH to access the Oracle Solaris Studio 12.3 software and man pages on the server (see Setting Up Access to the Developer Tools and Man Pages).
  5. If you installed the Oracle Solaris Studio 12.3 software on a single-user system, type the following to determine whether you need to set up your access to the Oracle Solaris Studio 12.3 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 Oracle Solaris Studio 12.3 software.
    2. If the command reports Oracle Solaris Studio 12.3 software, you do not need to set your PATH and MANPATH.

Installing the Runtime Libraries Only With the Non-GUI Installer

You can use the non-GUI installer to install the Oracle Solaris Studio Runtime Libraries only.


Note - If you run the installer to install only the libraries, you cannot run the installer later to install The Oracle Solaris Studio software without first running the uninstaller to uninstall the libraries.


Using 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, start the installer by typing:
    ./solarisstudio.sh --non-interactive --libraries-only
  3. The installer runs silently and returns your prompt when installation is complete. It writes a log file in the /root/.nbi/logs directory.