Chapter 2 Command and Installer Descriptions

This chapter includes detailed information on the following:

• prepare_system Command

• batch_installer Command

• Graphical User Interface Installer

• Command-Line Installer

prepare_system Command

The prepare_system command lets you check the system on which you are going to run the Sun Studio 12 software for the prerequisite software, and install any missing software. You can check the system without having root privileges on the system, but you must have root privileges to install missing software.

Syntax

prepare_system [-d directory] [-R altroot] [-C | -s netbeans | java | patches | all_patches | jdk_patches | all | print_needed_steps ]

-d directory

When specifying the -s option to install missing software, use this option if you want to specify the directory in which to install the missing software. If this option is not specified, the software is installed in the standard location.

-R altroot

Use this option to specify a root directory other than the default /. Define the full path name of a directory to use as the altroot. All files, including package system information files, are relocated to a directory tree starting in the specified altroot.

-C

Check the system for the prerequisite software. Lists the missing prerequisite software, or indicates that none is missing. This option does not check for or report the absence of the patches required by the JDK software.

-s netbeans | java | patches | all_patches | jdk_patches | print_needed_steps

netbeans installs the NetBeans 5.5.1 IDE and NetBeans C/C++ Development Pack 5.5.1.

java installs J2SE Development Kit (JDK) 5.0, Update 9.

patches installs the operating system patches required by the Sun Studio 12 software.

all_patches installs both the operating system patches required by, and the operating system patches recommended for, the Sun Studio 12 software.

jdk_patches installs the patches required by the JDK software. On Solaris 10 1/06 platforms, two of these patches are kernel patches. Before using this option, see the http://developers.sun.com/sunstudio/documentation/ss12/release_notes.html for more information.

all checks whether the NetBeans 5.5.1 IDE and NetBeans C/C++ Development Pack 5.5.1, JDK software, and operating system patches required by the Sun Studio 12 software are installed, and installs them if they are missing.

print_needed_steps is an option used by the installer to list the missing software in a machine-readable format.

batch_installer Command

The simplest way to install the Sun Studio 12 software is to use the batch installer, which installs all components of the software.

Syntax

batch_installer [-R altroot] [-d installation_directory] [-a architecture] [-p netbeans | java | patches | all_patches | jdk_patches | all] [--copy-prerequisites] [--show-sla] [--accept-sla] [--no-links] [-no-prodpatch] [--zone=all|this] [-J extra_java_args]

-R altroot

Use this option to specify a root directory other than the default /. Define the full path name of a directory to use as the altroot. All files, including package system information files, are relocated to a directory tree starting in the specified altroot.

-d installation_directory

Specifies the installation directory for the Sun Studio 12 software. Use this option to install in a directory other than the default installation directory, which is /opt on Solaris platforms and /opt/sun on Linux platforms.

-a client_architecture

Allows the batch installer to install the Sun Studio 12 software on a server with a different architecture from the client systems that will use the software. To install the software on a SPARC based server for use by x86 based clients, client_architecture is intel-S2. To install the software on an x86 based server for use by SPARC based clients, client_architecture is sparc-S2.

-p netbeans | java | patches | all_patches | jdk_patches | all

netbeans installs NetBeans 5.5.1 IDE and NetBeans C/C++ Development Pack 5.5.1.

java installs J2SE Development Kit (JDK) 5.0, Update 9.

patches installs the operating system patches required by the Sun Studio 12 software.

all_patches installs both the operating system patches required by, and the operating system patches recommended for, the Sun Studio 12 software.

jdk_patches installs the patches required by the JDK software. On Solaris 10 1/06 platforms, two of these patches are kernel patches. Before using this option, see the http://developers.sun.com/sunstudio/documentation/ss12/release_notes.html for more information.

all checks whether the NetBeans 5.5.1 IDE and NetBeans C/C++ Development Pack 5.5.1, JDK software, and operating system patches required by the Sun Studio 12 software are installed, and installs them if they are missing.

--copy-prerequisites

Copies the prerequisite software to a server for use when running the prepare_system command on client systems that will run the Sun Studio 12 software. The software is copied to the prepare_system_prerequisites directory in the Sun Studio 12 installation directory. For example, if the Sun Studio 12 installation directory is the default /opt directory, the prerequisite software is copied to /opt/prepare_system_prerequisites. The prerequisite software requires 1.2 GB of disk space on SPARC platforms running the Solaris OS, 750 MB of disk space on x86 platforms running the Solaris OS, and 200 MB of disk space on Linux platforms.

--show-sla

Displays the software license agreement.

--accept-sla

Asserts that the person installing the software agrees to the terms of the software license agreement. Software installation will not take place until the software license agreement has been accepted.

--no-links

Lets you choose not to create symbolic links in the /usr/bin directory and /usr/share/man directory to the Sun Studio 12 software and man pages. These links are created by default unless you already have symbolic links in /usr/bin and /usr/share/man to a previous Sun Studio release.

--no-prodpatch

Lets you choose not to install Sun Studio 12 product patches, if any are provided.

--zone all|this

When installing on a Solaris 10 1/06 server with zones, determines whether the Sun Studio 12 software is installed in the all zones (all) or only in the zone in which you are running the batch installer (this). The batch_installer command must be issued in the zone where the software is to be installed.

-J extra_java_args

Lets you pass extra arguments to the Java^TM virtual machine (JVM) used to run the installer

The terms “Java virtual machine” and JVM mean a virtual machine for the Java platform.

Graphical User Interface Installer

The graphical user interface installer lets you choose which components and subcomponents of the Sun Studio 12 software you want to install. It automatically runs the system preparation tool to check your system for the prerequisite software, and lets you install any missing software.

To start the graphical user interface installer, type the following in the download directory:

./installer &

To install the Sun Studio 12 software on a Solaris server for use by clients with a different architecture, include the -a client_architecture option when you start the installer. To install the software on a SPARC based server for use by x86 based clients, client_architecture is intel-S2. To install the software on an x86 based server for use by SPARC based clients, client_architecture is sparc-S2.

Software License Agreement

The Software License Agreement page displays the software license agreement and offers you the choice of accepting it or not. If you click Yes (Accept License), the installer proceeds to the next page. If you click No, the installer asks you if you want to exit. You cannot continue with installation until you accept the software license agreement.

Select Options: Install Tab

The Install tab of the Select Options page includes:

• A table that displays the release name, the installation directory, and the installed components for each release of Sun Studio software installed on the system where you are running the installer.

• The Missing prerequisites field, which tells you whether the system is missing any of the prerequisite software and lets you install any missing software by clicking Update. The field does not report the absence of the patches required by the JDK software, and the installer does not install them if they are missing.

• The Installation directory field, which displays the default installation directory (/opt on Solaris platforms and /opt/sun on Linux platforms) and lets you change the installation directory by typing a directory path. If you have previously installed some components of the Sun Studio 12 software, the Installation directory field displays that installation directory, and the installer will install additional components in the same directory.

Select Options: Advanced Options Tab

The Advanced options tab of the Select Options page offers options you might want to select when installing on a server:

• If you are installing on a Solaris 10 1/06 OS system with zones, the Zone disposition buttons let you specify the zone(s) in which you want to install the software:

  • If you are running the installer in the global zone, you can select the appropriate radio button to install the software in this zone (the global zone, not visible from local zones) or all zones (the global zone, visible from local zones).

  • If you are running the installer in a local zone, you can select the this zone radio button to install the software in that local zone. The software will be accessible only from that zone.

• The Enable cross-install option lets you enable installation of the Sun Studio 12 software on a server for use by clients with a different architecture. If you select Enable cross-install, you can install the Sun Studio 12 software on a SPARC based server for use by x86 based client systems. Or you can install the Sun Studio 12 software on an x86 based server for use by SPARC based client systems. You must have specified the client architecture with the -a option when you started the installer.

• The Copy system prerequisites option lets you copy the prerequisite software to a server for use when running the prepare_system command on client systems that will run the Sun Studio 12 software. The software is copied to the prepare_system_prerequisites directory in the Sun Studio 12 installation directory. For example, if the Sun Studio 12 installation directory is the default /opt directory, the prerequisite software is copied to /opt/prepare_system_prerequisites. The prerequisite software requires 1.2 GB of disk space on SPARC platforms running the Solaris OS, 750 MB of disk space on x86 platforms running the Solaris OS, and 200 MB of disk space on Linux platforms.

• The Create /usr/bin symlinks option lets you choose not to create symbolic links in the /usr/bin directory and /usr/share/man directory to the Sun Studio 12 software and man pages. These links are created by default unless you already have symbolic links in /usr/bin and /usr/share/man to a previous Sun Studio release.

• The Alternate root field lets you specify a root directory other than the default /. All files, including package system information files, are relocated to a directory tree starting in the specified alternate root directory.

Select Components

On the Select Components page, you can select which components of the Sun Studio 12 software you want to install. The disk space requirement for each component is displayed. By default, all three components (Compilers and Tools, Performance Library, and Third-party Source Code) are installed. You can select a component you do not want to install by clicking its checkbox.

You can also choose to install only selected subcomponents of the Compilers and Tools component. To do so, click the + icon next to the component to expand it. Then select any subcomponent you do not want to install by clicking its checkbox.

Ready to Install

This page lists the Sun Studio 12 components to be installed and the total amount of disk space required. When you click Install Now, the installation begins.

Installing

This page displays a progress bar that tracks the progress of the installation. It includes a Stop button that allows you to stop the installation.

Post-Installation Setup

This page is displayed if there are any post-installation steps to be performed. The page lists steps you requested on Select Options page, such as installing missing prerequisite software and copying the prerequisite software to a server. If Sun Studio 12 product patches are available for installation, they are installed unless you click the Disable button.

Installation Summary

This page lists the status of the installation after it has completed. Click Details next to each component to see information on the packages that were installed. Click Close to exit the installer.

Command-Line Installer

The command-line installer offers the same series of interactive steps as the graphical user interface installer in text form.

To start the command-line installer, type the following in the download directory:

./installer -nodisplay

To install the Sun Studio 12 software on a Solaris server for use by clients with a different architecture, include the -a client_architecture option when you start the installer. To install the software on a SPARC based server for use by x86 based clients, client_architecture is intel-S2. To install the software on an x86 based server for use by SPARC based clients, client_architecture is sparc-S2.

You can exit the command-line installer at any time by typing !. To go back to a previous section of the installer, type <.

Software License Agreement

The installer displays the software license agreement. Press Enter as many times as needed to display all of the agreement. Then type yes and press Enter to accept the agreement. You cannot continue with installation until you accept the software license agreement.

Select Options

• If your system has all of the prerequisite software, the installer reports that no prerequisites are missing. If your system is missing any of the prerequisite software, the missing software is listed, and you are given a choice of installing it or not. Type 2 and press Enter to install all of the missing prerequisite software. The installer does not report the absence of the patches required by the JDK software, and does not install them if they are missing.

• The default installation directory for the Sun Studio 12 is /opt on Solaris platforms and /opt/sun on Linux platforms. To accept the default directory, press Enter. If you want to change the installation directory, type the name of the directory into which you want to install the Sun Studio 12 software and press Enter. If you have previously installed some components of the Sun Studio 12 software, the installer displays that installation directory and will install additional components in the same directory.

• If you are installing on a single-user system, type 1 and press Enter to skip the advanced options. If you are installing on a server, type 2 and press Enter to continue to the advanced options.

Advanced Options

Advanced options offers options you might want to select when installing on a server.

• If you are installing on a Solaris 10 1/06 OS system with zones, you can specify the zone in which you want to install the software:

  • If you are running the installer in the global zone, you can choose to install the software in this zone (the global zone, not visible from local zones) or all zones (the global zone, visible from local zones).

  • If you are running the installer in a local zone, you can choose this zone to install the software in that local zone. The software will be accessible only from that zone.

• The installer offers the following optional installation steps:

  • Cross-install: If you are installing the Sun Studio 12 software on a server for use by client systems with a different architecture, type 1 and press Enter to enable cross-install. You must have specified the client architecture with the -a option when you started the installer.

  • Copy system prerequisites: If you are installing the Sun Studio 12 software on a server for use by client systems, type 2 and press Enter to prerequisite software to the server for use when running the system preparation tool on client systems that will run the Sun Studio 12 software. The software is copied to the prepare_system_prerequisites directory in the Sun Studio 12 installation directory. For example, if the Sun Studio 12 installation directory is the default /opt directory, the prerequisite software is copied to /opt/prepare_system_prerequisites. The prerequisite software requires 1.2 GB of disk space on SPARC platforms running the Solaris OS, 750 MB of disk space on x86 platforms running the Solaris OS, and 200 MB of disk space on Linux platforms.

  • Create /usr/bin/symlinks: If you do not want the installer to create symbolic links in the /usr/bin directory and /usr/share/man directory to the Sun Studio 12 software and man pages, type 3 and press Enter to disable creation of these links. These links are created by default unless you already have symbolic links in /usr/bin and /usr/share/man to a previous Sun Studio release.

  • Type 0 and press Enter when you have finished selecting optional installation steps.

• To set a root directory other than the default /, type the name of the directory and press Enter. All files, including package system information files, are relocated to a directory tree starting in the specified alternate root directory.

Select Components

Select any component or subcomponent you do not want to install by typing its number and pressing Enter. When you are finished selecting the components to install, type 0 and press Enter.

Ready to Install

The installer lists the components to be installed, the installation directory, and the disk space required. When you type 1 and press Enter, the installation begins. The installer displays the progress of the installation.

Post-Installation Setup

This page is displayed if there any post-installation steps to be performed. The page lists steps you requested on Select Options page, such as installing missing prerequisite software and copying the prerequisite software to a server. If Sun Studio 12 product patches are available for installation, they are installed unless you type 2 and press Enter.

Installation Details

When the installation is complete, the installer displays the result. Type 1 to see information on the packages that were installed. Type 2 and press Enter to exit the installer.