Sun Java Enterprise System (Java ES) integrates a number of Sun server-side products to support distributed enterprise applications. In this document, these products are referred to as the Java ES product components. A collection of supporting software, called the shared components, is also included. The Java ES installer installs the Java ES product components and shared components in various combinations, one host at a time. Because of the complex interrelationships of the components, installation requires more preinstallation and postinstallation effort than is required to install a single product component.
The Java ES installer adds component packages (Solaris OS), RPMs (Linux), or Depots (HP-UX) on the local host. To uninstall a product component, an uninstallation utility with an unconfiguration interface is provided. During the course of operation, log records are generated and saved into files.
This section contains the following subsections:
The installation utility (installer) is located in the platform directory where you are installing Java ES, for example, /jes5install/Solaris_sparc. You will see a Product directory, a text file called release_info, and the executable installer script. This is the location for invoking the installer unless your installer has been patched.
There is another directory that contains a packaged version of the installer that is used for patching. The patch installation script (install) is located in the following directory along with the Log Viewer utility (viewlog):
Solaris OS: /var/sadm/prod/SUNWentsys5i
Linux and HP-UX: /var/sadm/prod/sun-entsys5i
If there is a bug in the installer, Sun can fix the installer and create a patch for the installer package. After the patch is applied, the packaged version of the installer should thereafter be used for the release, thus launching the version of the installer that contains the fixes from the patch.
You only use the patch utility if your deployment is using a patched version of the Java ES installer.
After installation, the Java ES uninstallation utility (uninstall) is located here:
Solaris OS: /var/sadm/prod/SUNWentsys5
Linux and HP-UX: /var/sadm/prod/sun-entsys5
Syntax and examples for the Java ES installation utilities are contained in Appendix B, Installation Commands.
The Java ES software consists of a collection of Sun server-side products and their supporting shared components that work together to support distributed applications across a network. The Java ES 5 release presents the following selectable components, many of which have selectable subcomponents.
Any alternate or abbreviated names used in this guide are in parentheses following the component name and version.
HP-UX does not support Sun Cluster components, Directory Preparation Tool, HADB, or third-party web containers. Linux does not support Sun Cluster components, and only supports the BEA WebLogic third-party container for Configure Now.
Access Manager 7.1
Application Server 8.2 Enterprise Edition + patches (Application Server)
Directory Preparation Tool 6.4
Directory Proxy Server 6.0
Directory Server Enterprise Edition 6.0 (Directory Server)
High Availability Session Store 4.4 (HADB)
Java DB 10.1
Message Queue 3.7 UR1
Monitoring Console 1.0
Portal Server 7.1
Portal Server Secure Remote Access 7.1
Service Registry 3.1
Sun Cluster 3.1 8/05 (Sun Cluster software)
Sun Cluster Agents 3.1
Sun Cluster Geographic Edition 3.1 2006Q4 (Sun Cluster Geographic)
Web Proxy Server 4.0.4
Web Server 7.0
The Directory Preparation Tool is only used with Communications products, and is included with Directory Server in the Java ES release as a convenience. Information on the Directory Preparation Tool can be found in Chapter 8, Directory Preparation Tool (comm_dssetup.pl), in Sun Java Communications Suite 5 Installation Guide.
To see the full list of services and subcomponents as displayed in the Java ES installer, refer to Appendix A, Java ES Components for This Release. This appendix also lists the shared components that are provided with this release.
The Java ES installer is an installation framework that uses the Solaris pkgadd, Linux rpm, or HP-UX swinstall utility to transfer Java ES software to your system. You can install Java ES interactively or by means of a reusable script.
Graphical Mode (Interactive). Provides an interactive graphical wizard that leads you through the tasks of installing the Java ES software on a graphical workstation.
Text-based Mode (Interactive). Provides the same functionality as that of graphical mode, but you are prompted for responses on a line-by-line basis in a terminal window.
Silent Mode. Provides the ability to run the installer on multiple hosts, using a generated state file to specify input.
You can run the Java ES installer without installing software. This is useful for surveying existing Java ES software on your hosts.
The interactive Java ES installer runs in the language specified by the operating system locale setting on the host. The following languages are available:
If your operating system language is not listed, the installer runs in English. The installer automatically installs English versions of all Java ES components. By default, multilingual packages are selected when components are selected for installation.
The installer cannot install additional language packages for previously-installed components. However, you can use the pkgadd, rpm, or swinstall utilities to install localization packages at any time. Language packages are list in Chapter 5, List of Installable Packages, in Sun Java Enterprise System 5 Installation Reference for UNIX.
During installation, the Java ES installer surveys the software that is already installed on the host where you are installing and identifies the following:
Compatible Java ES product components
Compatible product components do not need to be reinstalled and will not be available for selection in the installer.
Incompatible Java ES product components
If the installer identifies incompatibilities between product components you have selected and product components that are already installed locally, you will need to remove or upgrade the incompatible installed product components. On Solaris OS, some bundled components can be upgraded by the installer (Application Server, Message Queue, HADB). Other incompatible components will need to be removed or upgraded manually. The installer cannot continue until these incompatibilities are resolved. For more information, refer to How Upgrading Works.
Incompatible Java ES shared components
It is not uncommon for existing hosts to already contain versions of Java ES shared components, such as NSS. If the installer finds shared components whose version is incompatible with the version of Java ES you are installing, those shared components are listed. If you proceed with installation, the installer automatically upgrades the shared components to compatible versions.
Many product components depend on the presence of other components to provide their core functions. The installer does extensive cross checking of product components to verify that the components you select during installation will function properly together. For this reason, the installer might prompt you to include certain product components as you make your selections.
In general, the installer uses the following rules for handling dependencies among the Java ES product components:
Selecting a Product Component. In most cases, when you select a product component for installation, the installer automatically selects all its subcomponents.
The installer also selects the components and subcomponents upon which the selected product component depends. For example, if you select Application Server, the installer automatically selects HADB, Java DB, and Message Queue.
Deselecting a Product Component. In most cases, when you deselect a product component, the installer automatically deselects all its subcomponents.
If you deselect a product component that is required locally or remotely for another selected product component, the installer displays various warnings when you attempt to proceed.
Selecting a Subcomponent. If you select a subcomponent, the installer automatically selects the product component to which it belongs, but not necessarily the other subcomponents.
If the selected subcomponent depends on other components or subcomponents, the others are automatically selected.
Deselecting a Subcomponent. If you deselect a subcomponent, the installer deselects only that subcomponent and not the other subcomponents.
If you deselect a subcomponent that is required locally or remotely for another selected product component, the installer displays various warnings when you attempt to proceed.
After the components you have selected are found to be acceptable for installation and you have indicated their target installation directories, the Java ES installer performs a system check to determine if your host meets the requirements for the components you selected.
The installer checks for disk space, memory, swap space, operating system, patches and operating system resources based on the selected components and the installation directories provided. The following messages inform you about the state of your host:
System is ready for installation. When this message is displayed, the installer can proceed.
System is ready for installation, however, a resource, such as memory, is not at the recommended level. When this message is displayed, the installer can proceed but you should consider providing additional resources.
System does not meet the minimum system requirements. When this message is displayed, in most cases the installer cannot proceed. A typical situation is when patches are missing. You must install most missing patches before proceeding with installation. In some situations, you are allowed to proceed without installing a missing patch. In this case, if you choose to proceed, you are warned that installation might fail or software might malfunction. To continue with installation, you must confirm that you want to proceed without installing the missing patches. For more information on patches, refer to Patch Requirements or To Install a Patch.
Many Java ES product components are eligible for some degree of installation-time configuration. The extent of installation-time configuration you are required to perform depends on which product components you select and which installation type you choose.
The following components cannot be configured by the Java ES installer, and, therefore, must the configured after installation: Directory Proxy Server, Java DB, Monitoring Console, Service Registry, and Sun Cluster components.
The following configuration types are available in the installer:
Configure Later. During installation, you enter only the minimum values that are necessary for installing, then perform postinstallation configuration.
Configure Now. During installation, you provide configuration information for product components that permit installation-time configuration. The information you specify might be just a few common parameters (common server settings), or it might include detailed component-specific parameters (product component settings).
It is important to keep track of the configuration information values as you proceed through installation-time configuration or postinstallation configuration. Many of the product components rely on the specifics of other component configuration parameters in order to function correctly. At the end of a Configure Now installation, you can view the configuration parameters that were specified by examining the Installation Summary.
Common server settings are parameters that affect multiple product. For example, most product components require that you specify an administrative ID and password. By setting the these common values, you are setting default administrative IDs and passwords for the product components you are installing.
Product component configuration settings are parameters that apply to a particular product component. These settings are requested during installation only if you have selected the Configure Now type. Some of these settings are populated from the common server settings.
The Java ES installer automatically upgrades shared components for the selected product components to match the level required for the release of Java ES. If you want to upgrade shared components manually, you must exit the installer, upgrade the shared component, then return to the installer. Shared components can also be installed or upgraded in a dedicated installation session that installs only shared components, enabling them to be synchronized to the current release. If you choose to install the Shared Components item, all required shared components for the Java ES release are installed or upgraded.
If the installer is run in a non-global Solaris zone with a sparse root file system, the Shared Component item is not available for selection.
On Solaris OS, some product components are already installed with the operating system. In this case, you can upgrade these product components using the Java ES installer. In a graphical installation session, if upgradable product components are detected on your host, the Status column of the Choose Software Components page indicates Upgradable. For the text-based installer, a separate list displays the upgradable product components. The components that can be upgraded by the installer are listed in the following table, along with explanation on any Solaris zones issues that might apply.Table 1–1 Upgrade Support Within the Java ES Installer
Situation Where the Java ES Installer Can Upgrade
Solaris Zones Issues
Application Server 7.0 bundled with Solaris 9
Application Server 8.0 bundled with Solaris 10
Application Server 8.1.0 installed with Java ES 3 (2005Q1)
Application Server 8.1.2 installed with Java ES 4 (2005Q4)
Before Application Server can be installed into a non-global sparse-root zone, the bundled version must be removed from the global zone.
Upgrading Application Server in the global zone will replace the existing version in the global zone and any versions in whole root or sparse root zones.
HADB installed with Java ES 2005Q1 (release 3)
HADB installed with Java ES 2005Q4 (release 4)
Message Queue bundled with Solaris 9
Message Queue bundled with Solaris 10
Message Queue installed with Java ES 3 (2005Q1)
Message Queue installed with Java ES 4 (2005Q4)
Message Queue can only be installed in the global zone, or in a whole root non-global zone.
From the global zone, Message Queue always propagates to non-global zones.
If the installer identifies incompatible versions of product components that cannot be upgraded by the installer, you will receive messages saying that certain product components must be removed or manually upgraded before you can continue with installation. Such upgrading is fully documented in the Sun Java Enterprise System 5 Upgrade Guide for UNIX.
During the course of installation or uninstallation, log records are generated for the operations that occur. These records are saved into a single file in a format called Unified Logging Format (ULF). The Java ES installer Log Viewer utility (viewlog) provides a user-friendly interface for examining these log records. After Java ES installation is complete, the Log Viewer is located here:
Solaris OS: /var/sadm/prod/SUNWentsys5i
Linux and HP-UX: /var/sadm/prod/sun-entsys5i
After uninstallation, the viewlog utility is removed. The ULF logs themselves are not removed, and are located here:
Solaris OS: /var/sadm/install/logs
Linux and HP-UX: /var/opt/sun/install/logs
For instructions on using the Java ES logs and Log Viewer, refer to Examining Installation Log Files.
Java ES Reporter is a command-line utility that performs anonymous product registration after a successful interactive Java ES installation session. Immediately after the Java ES components are installed, the Reporter installation starts. On the command line, you are prompted to enter the URL or IP address of a proxy that Reporter will use to access Sun through the internet. The installation proceeds silently and no further action is required.
If you do not want to install Reporter, you can specify the -noreporter option to the installer command when you start the Java ES installation session. To install only Reporter (after using the –noreporter option, or after a silent Java ES installation), there is another option available (-reporter) on UNIX platforms. The Reporter options for the Java ES installer are explained in installer or install Command.
After Reporter is installed, you can enable or disable Reporter by editing a configuration file. These instructions are contained in Java ES Reporter Postinstallation Configuration.
Because Reporter is not a Java ES component of the installer, it cannot be uninstalled using the Java ES uninstaller. Instructions for uninstalling Reporter are contained in Uninstalling Java ES Reporter.
Java ES provides an uninstallation utility (uninstall) for removing component products that were installed on the local host using the Java ES installer. The Java ES uninstaller checks product dependencies for the host on which it is running, issuing warnings when it discovers a dependency. For some product components, certain files remain after uninstallation and might need to be removed manually. For uninstallation specifics on each product component, refer to Reviewing Uninstallation Behavior for Java ES Product Components.
The uninstaller can be run in graphical, text-based, or silent mode. After Java ES installation is complete, the uninstaller is located here:
Solaris OS: /var/sadm/prod/SUNWentsys5
Linux and HP-UX: /var/sadm/prod/sun-entsys5
After uninstallation, the uninstall utility is removed from the host. For instructions on using the uninstaller, refer to Chapter 8, Uninstalling.
Shared components cannot be removed using the Java ES uninstaller. Shared components are upgraded by the Java ES installer when you install a later version of Java ES. Some shared component can be manually upgraded using procedures in the Sun Java Enterprise System 5 Upgrade Guide for UNIX. Instructions for uninstalling Java ES Reporter are contained in Uninstalling Java ES Reporter.
An installed version of Sun Cluster software cannot be removed using the Java ES uninstaller. For information on uninstalling Sun Cluster software, refer to Uninstalling Sun Cluster Software and Sun Cluster Software and Sun Cluster Geographic Edition Uninstallation Behavior.