Chapter 8 Installing with the Text-Based Interface

This chapter provides instructions for using the interactive text-based interface to install the Sun Java™ Enterprise System (Java ES) software.

Prerequisites

Before beginning the procedures in this chapter, you should have developed an installation sequence, surveyed your system for incompatibilities, and fulfilled any prerequisites. Refer to Installation Prerequisites for specific information on prerequisites.

How to Use the Text-Based Interface

The text-based installer mode does not display a graphical interface, but instead prompts you for information using a series of questions. The following table describes how to respond to the installer’s text-based prompts.

Table 8-1 Responding to Text-Based Installer Prompts
Action	Input
To accept default values, as indicated in square brackets ([ ])	Press Return.
To select items from a list	Type the numbers for the items in a comma-separated sequence and press Return. Spaces are not allowed. For example, to select item 2 in a list, type 2 and press Return. To select items 1, 3, and 4, type 1,3,4 and press Return.
To deselect items from a list	Type the numbers for the items in a comma-separated sequence, entering the minus character (-) before each number, and press Return. Spaces are not allowed. For example, to deselect item 2 from the list, type -2 and press Return. To deselect items 1, 3, and 4, type -1,-3,-4 and press Return.
To provide a value to a text field	Type the value and press Return.
To provide a password	Type the password and press Return. The password will not appear on the terminal window.
To return to the previous page	Type the left angle (<) character and press Return.
To exit the session	Type the exclamation mark character (!) and press Return.

Running the Installer in Text-Based Mode

To Begin Installation

If you are not logged in as root, become superuser.

Start the text-based installation interface:



Note	A full description of options for the installer utility can be found in Installation Commands.

For CDs. Navigate to a directory that is not on the CD so that you can switch CDs during the installation session. For example:

cd /tmp

Enter the command to start the installer using the fully qualified path to the installer:

mount-point/os-arch/installer -nodisplay

In this command, mount-point is where you mounted the CD and os-arch matches your platform: Solaris_sparc, Solaris_x86 or Linux_x86.

For a DVD. Navigate to the DVD directory whose name matches your platform, then enter the command to start the installer:

./installer -nodisplay

For a Download. Navigate to the directory where you downloaded the software, then enter the command to start the installer:

./installer -nodisplay

Welcome information is displayed.

Press Enter to go to the Software License Agreement.

Press Enter to display the Software License Agreement.

Continue pressing Enter to read to the end of the Agreement.

If you accept all the terms of the License, type yes and press Enter. The Language Support page is displayed.

If you do not accept all the terms of the License, select the default no by pressing Enter. This will end the installation process.

To Select Languages for Installation

Specify the additional language packages you want to install by entering a comma-separated list of the numbers associated with them and press Return.

To Select Components

The installer first checks your system for previously installed versions of components and displays a list of the detected components, if any are found, under the title Component Products Detected on This Host. The following message is displayed:

The following component products are detected on this sytem. They will appear disabled, ‘* *’, in the following Component Selection Main Menu.

If the installer finds no previously installed versions of components, the installer displays the Component Selection Main Menu.


Note	Detected components will not be available for selection, but might require upgrading if the versions do not meet Java ES requirements or dependency requirements of other components.

Component Selection - Main Menu

-------------------------------

Note: "* *" indicates that the selection is disabled

[ ] 1. Sun Java(TM) System Calendar Server 6 2005Q1 (43.41 MB)

[ ] 2. Sun Java(TM) System Directory Preparation Script (303.30 KB)

[ ] 3. Sun Java(TM) System Web Server 6.1 SP4 2005Q1 (60.58 MB)

[ ] 4. Sun Java(TM) System Messaging Server 6 2005Q1 (125.65 MB)

[ ] 5. SunSM Remote Services Net Connect 3.1.1 (24.72 MB)

[ ] 6. Sun Java(TM) System Administration Server 5 2005Q1 (13.22 MB)

[ ] 7. High Availability Session Store (HADB) (44.34 MB)

[ ] 8. Sun Cluster 3.1 9/04 (68.22 MB)

[ ] 9. Sun Java(TM) System Access Manager 6 2005Q1 (22.19 MB)

[ ] 10. Sun Java(TM) System Communications Express 6 2005Q1 (19.04 MB)

[ ] 11. Sun Java(TM) System Message Queue 3 2005Q1 Enterprise Edition (10.02 MB)

[ ] 12. Sun Java(TM) System Application Server Enterprise Edition 8.1 2005Q1 (76.85 MB)

[ ] 13. Sun Java(TM) System Directory Proxy Server 5 2005Q1 (9.46 MB)

[ ] 14. Sun Java(TM) System Portal Server Secure Remote Access 6 2005Q1 (9.86 MB)

[ ] 15. Sun Java(TM) System Instant Messaging 7 2005Q1 (11.40 MB)

[ ] 16. Sun Java(TM) System Portal Server 6 2005Q1 (67.53 MB)

[ ] 17. Sun Cluster Agents for Sun Java(TM) System (7.24 MB)

[ ] 17. Sun Java(TM) System Directory Server 5 2005Q1 (46.09 MB)

Enter a comma separated list of products to install [] {"<" goes
back, "!" exits}:

Specify which components to install by typing a comma-separated list of numbers associated with the components you want to install, and press Return.

Continue through the installer prompts to select the subcomponents for each product you selected, if applicable.



Note	Not all components have subcomponents. These products will be displayed without interaction.

After you finish selecting components and their subcomponents, the installer performs a dependency check. If there is a problem with dependencies, the installer displays a Product Dependency Check error or warning, depending on the problem. Typical problems might include:

A local dependency has not been met

In this situation, return to Component Selection and select the appropriate component to satisfy the local dependency.

A remote dependency will be met later during postinstallation configuration

If you do not intend to specify a remote installation, return to Component Selection and select the appropriate component to satisfy the dependency locally.

Previous versions of components are already installed on the local host

In this situation, upgrade or remove the reported components and ask the installer to check again. To upgrade components from earlier Java ES versions, refer to the Java Enterprise System Upgrade and Migration Guide (http://docs.sun.com/doc/819-0062).

If any incompatible versions of components are found, you will be asked to remove them from the host. Answer yes and press Return to have the installer remove them or select the default no by pressing Return to remove the components manually.



Caution	If you select the default no, you must remove the component before continuing with the installation.

To Upgrade Shared Components

After the installer performs a dependency check, it performs a compatibility check of any shared components already installed. If incompatible versions of shared components are detected, the installer displays a Shared Component Upgrades Required report indicating what shared components are not compatible. Review this list and determine if it is safe for the installer to automatically upgrade the shared components listed. Press Return to allow the installer to automatically upgrade the shared components listed. This upgrade does not happen until you reach the Ready to Install page.

On Solaris. If an incompatible system-wide version of the J2SE SDK is detected, the J2SE SDK Upgrade Required page is displayed. The installer performs this check only on the Solaris platform because the Linux platform does not have a specific, system-wide installation of the J2SE SDK.

To Specify Installation Directories and Initiate the System Check

A default installation directory will be displayed for each selected component. Accept this location, or replace the default for your deployment. This step must be repeated for every component selected for installation.

After the installation directory of the final, selected component is chosen, the installer will automatically perform a system check. The installer checks for disk space, memory, operating system patches and operating system resources. If operating system patches are found to be missing, do the following:


Caution	Do not upgrade shared components without checking the dependencies that exist on the host for non-JES applications. First verify that these existing applications are compatible with the required versions of the shared components.

Exit the installer.

Go to the Sunsolve site (http://sunsolve.sun.com) and click Patch Portal.

In the PatchFinder text box, enter the patch number and click Find Patch.

Download the patch you need.

The default target destination is displayed in the Selection box.

On your system, expand the patch file. For example:

unzip 112785-44.zip

A directory is created for the patch files.

Apply the patch. For example:

patchadd 117885-44

Restart the installer.

To Select a Configuration Type

Configure Now. Allows you to configure components that permit configuration at installation time.

Your Configure Now tasks include specifying the common server settings, and the configuration information for the components selected.



Note	Some components cannot be configured during a Configure Now installation. If you are warned that you will need to configure these components after installation, click Next to proceed and see Configure Later Option: Procedures for further configuration details.

Configure Later. You enter only the minimum values that are necessary for installing the packages.

The installer proceeds without doing further configuration. If you choose this option, skip to To Confirm Installation Readiness.

To Specify Configuration Data

For a Configure Now installation, you are asked to provide configuration information for the components that allow installation-time configuration. Defaults are displayed, except for passwords (which must be a minimum of 8 characters).


Tip	Your configuration values are gathered by the installer as you proceed through the configuration panels. After installation is done, you can access this information in the Installation Summary: Solaris: /var/sadm/install/logs Linux: /var/opt/sun/install/logs

Specify common server settings.

Either accept the defaults, or use alternate data to answer the installer questions regarding these global fields. Refer to Common Server Settings for information on these fields.

Specify component settings.

Either accept the defaults or use the information you gathered in the component worksheets to answer the installer questions regarding each component. For information on the configuration values on each page, refer to:

Chapter 4, "Configuration Information"

Provides details on the configuration values for each configuration page.

Chapter 5, "Configuration Worksheets"

Refer to these worksheets if you have already gathered your configuration data.

A list of your selected components and subcomponents is displayed. Review this list carefully. If you need to make changes, type < and press Return until you reach the question that requires a change.

Although shared components are not explicitly listed, they have already been verified and will be installed if they are needed.

To Confirm Installation Readiness

Although shared components are not explicitly listed, they have already been verified and will be installed if they are needed

To Install the Software

To start the installation, press Return to accept the default [1].

The installation process starts and a progress indicator bar informs you of the state of the installation. For example:

Java Enterprise System
|-1%--------------25%-----------------50%--



Note	Depending on the size and complexities of your installation, the installation process can be lengthy.

When the installation has successfully completed, the Installation Complete message is displayed.

Examine the postinstallation files, located in /var/sadm/install/logs on Solaris OS and in /var/opt/sun/install/logs on Linux.

[1] Installation Summary. Lists each component installed and the settings you specified. If you chose Configure Now configuration, this summary includes all the configuration values.

[2] Installation log. Displays the installer’s log messages for components.

A separate log file contains information about the installation of shared components.

Exit the installer.

Your installer session is done. Components that were installed will need to be started after you have completed all postinstallation tasks. Proceed to Next Steps for instructions.

Adding Components

To install additional components, you can run the installer again. The installer detects the newly-installed components and uses them to satisfy the dependencies of other components. Installed components are disabled at the Component Selection page.

For example, suppose you have installed Access Manager and its required components during this installation. Later, you decide to install Portal Server. The existing instance of Access Manager will be used to meet the Portal Server dependency on Access Manager. You will not be asked to reinstall Access Manager.

Next Steps

After you have completed the installer portion of your Java ES installation, proceed to Chapter 10, "Configuring Components After Installation" for final instructions. Although you might have done extensive configuration during your installation, most components require some additional configuration.

Previous Contents Index Next
Sun Java Enterprise System 2005Q1 Installation Guide