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. If the NetBeans C/C++ Development Pack 5.5.1 is installed, netbeans is listed as 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 update 1. If the Netbeans C/C++ Development Pack 5.5.1 is installed, it is replaced with the NetBeans C/C++ Development Pack 5.5.1 update 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_notesML.html for more information.

all checks whether the NetBeans 5.5.1 IDE and NetBeans C/C++ Development Pack 5.5.1 update 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 update 1. If the Netbeans C/C++ Development Pack 5.5.1 is installed, it is replaced with the NetBeans C/C++ Development Pack 5.5.1 update 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_notesML.html for more information.

all checks whether the NetBeans 5.5.1 IDE and NetBeans C/C++ Development Pack 5.5.1 update 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 recommended 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 Locale

On the Locale Selection page, click the Japanese checkbox or the Chinese checkbox to add the check mark if you want to install the localized Sun Studio 12 software in either of these languages.

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 to delete the check mark.

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 to delete the check mark.

Select Options: Install Tab

The Install tab of the Select Options page includes:

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

• The Missing prerequisites field, which tells you whether the system is missing any of the prerequisite software required by the components you are installing.The missing software is installed by default unless you click the Update checkbox to delete the check mark. 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.

• If you started the installer with the -a option to enable installation of the Sun Studio 12 software on a server for use by clients with a different architecture, the message Notice: Cross-installing! is displayed.

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

• If recommended product patches are available, they are installed by default unless you click the Install Product Patches checkbox to delete the check mark.

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

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 to be performed. When you click Setup Now, post-installation setup begins. The installer displays the progress of the post-installation setup.

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

Select Options

• If your system has all of the prerequisite software required by the components you are installing, the installer reports that no prerequisites are missing. If your system is missing any of the prerequisite software required by the components you are installing, 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.

• If you have any release of Sun Studio software installed on the system where you are running the installer, the release name, the installation directory, and the installed components are listed for each release.

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

• If you started the installer with the -a option to enable installation of the Sun Studio 12 software on a server for use by clients with a different architecture, the message Notice: Cross-installing! is displayed.

• The installer offers the following optional installation steps:

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

  • Install product patches: If recommended product patches are available, they are installed by default unless you choose not to install them by typing 4 and pressing Enter.

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

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. When you type 1 and press Enter, the post-installation setup begins. The installer displays the progress of the post-installation setup.

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.