Sun Java Enterprise System 2005Q1 Installation Guide |
Chapter 8
Installing with the Text-Based InterfaceThis chapter provides instructions for using the interactive text-based interface to install the Sun Java Enterprise System (Java ES) software.
This chapter has the following sections:
PrerequisitesBefore 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 InterfaceThe 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.
Running the Installer in Text-Based ModeIf you have problems during installation, refer to Chapter 13, "Troubleshooting".
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.
English is always installed.
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.
Press Enter to continue to 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.
If the installer finds no previously installed versions of components, the installer displays the Component Selection Main Menu.
- 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.
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.
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.
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.
For information about upgrades, see the Java Enterprise System Upgrade and Migration Guide (http://docs.sun.com/doc/819-0062).
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:
- 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
Specify a configuration type from the following options:
- 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:
- 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
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 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 ComponentsTo 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 StepsAfter 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.