This chapter provides information that will help you install the Sun Java Enterprise System (Java ES) software. Before starting the tasks documented in this guide, you should have already planned your installation according to the Sun Java Enterprise System 5 Installation Planning Guide. You should also be familiar with the reference material associated with Java ES installation in Appendix B, Default Directories and Ports.
This chapter contains the following sections:
Sun Java Enterprise System (Java ES) integrates a number of Sun server-side products into a system that provides the server software needed to support distributed enterprise applications. In this document, these products are referred to as the Java ES product components. A single installer is provided for installing the Java ES product components and shared components in various combinations. Because of the complex interrelationships of these components, installation requires much more preinstallation and postinstallation effort than is required to install a single Java ES component.
Portal Server on Windows can only be used as an evaluation platform or a developer platform. It can not be used as a deployment platform. Do not use Java ES installer for Windows to install Portal Server 7.1. Use the Zipinstaller to install Portal Server. The ReadMe file provided with the installer has information on how to install Portal Server. Acess the Installer from http://www.sun.com/download/products.xml?id=465e130d
The Zipinstaller provides you a pre-configured image of Sun Java System Portal Server 7.1 Update 1. You can get a working copy of Portal Server simply by unzipping the contents of this file.
ThisJava ES software release includes the following selectable Java ES components. The abbreviated names used in this guide follow the name and version.
Access Manager 7.1
Application Server 8.2 Enterprise Edition (Application Server)
Directory Proxy Server 6.0
Directory Server Enterprise Edition 6.0 (Directory Server)
High Availability Session Store 4.4 (HADB)
Message Queue 3.7 UR1
Monitoring Console 1.0
JavaDB 10.2
Portal Server 7.1
Portal Server Secure Remote Access 7.1
Service Registry 3.1
Web Proxy Server 4.0.4
Web Server 7.0
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 Windows installer uses the Microsoft Windows Installer (MSI) framework to install Java ES system on your host. You can install the Java ES software 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.
Silent Mode. Provides the option to run the installer on multiple hosts, each time using a generated response file to specify an input to the installer. For silent mode installation, first run the installer through a wizard while you save your responses as a set of name-value pairs in a response file. For detailed information about the silent mode installation, refer to Chapter 4, Installing in Silent Mode.
The Java ES installer enables you to install multilingual packages for Java ES. The following languages are available:
English
French
German
Japanese
Korean
Spanish
Simplified Chinese
Traditional Chinese
By default, the installer automatically installs Java ES in English language.
The Java ES installer enables you to select one of the following setup types:
Default. Selecting the Default setup type installs and configures all the Java ES components.
Custom. Selecting the Custom setup type allows you to select the Java ES components you want to install.
Many Java ES components require some degree of installation-time configurationdepening on which Java ES components you select and which installation type you choose.
The following configuration types are available in the installer:
Configure Automatically During Installation: Use this option to evaluate the components on a single host. During installation, you configure components that permit installation-time configuration.
In this mode, the default values for the administrator user ID and Password are displayed but these default settings can be modified during postinstallation. All other configuration parameters such as port numbers are predetermined defaults presented at the end of installation. These default values are used for configuring the components.
The administrator user ID and password should not contain any special characters, and the password should be eight or more characters long.
Configure Manually After Installation: With this option during installation, you can provide only the minimum values that are necessary for placing the software components in their directories. Configuration is performed after installation.
When you select this option, the administrator settings dialog box is not displayed. Only the files are copied during installation. You mustmanually edit the properties file with the correct values. For more information about how to edit the properties file, refer to Chapter 5, Completing Postinstallation Configuration.
If a component is dependent on other components, ensure that you configure the dependent components first.
Depending on which configuration option you select, you might be required to provide the administrator ID and password during installation. For example, most of the components require you to specify an administrator user ID and password. By setting these common values, you are setting default values for all component administrator user IDs and passwords.
During Multi-Session installation of Java ES Components, the configuration mode, Configure Automatically during Install or Configure Manually After Installation, selected in first session install is taken as default in next successive sessions without prompting for configuration selection mode screen.
Many Java ES components depend on the presence of other components to provide their core functions. The installer does extensive cross checking of Java ES 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 Java ES components as you make your component selections.
The Java ES installer uses the following rules for handling dependencies among the Java ES components:
Selecting a Java ES Component. When you select a Java ES component for installation, in most cases the installer automatically selects all its subcomponents.
The installer also selects the components and subcomponents upon which the selected component depends. For example, if you select Application Server, the installer automatically selects Message Queue.
Deselecting a Java ES Component. If you deselect a Java ES component, in most cases the installer automatically deselects all its subcomponents.
If you deselect a component that is required locally or remotely for another selected component, the installer displays various warnings when you attempt to proceed.
Selecting a Subcomponent. If you select a subcomponent, the installer automatically selects the Java ES component to which the subcomponent belongs, but not 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 component, the installer displays various warnings when you attempt to proceed.
A Java ES component is upgraded by performing a fresh installation of the component by using the Java ES installer. Perform a fresh installation by first removing the previous version's packages and installing Release 5 in the same path. Alternatively, you can install Release 5 in a parallel path, leaving the previous version intact.
In either case must reconfigure the component by migrating the previous version's configuration data to the new installation, performing a new configuration, or doing a combination of both. For some Java ES components an utility is provided for reconfiguring or migrating configuration data for the component.
Java ES 5 Windows installer does not support in-place upgrade of previous versions of the components. Instead, the installer supports coexistence with Java ES 4. After installing Java ES 5, you need to follow the upgrade procedure described in the Sun Java Enterprise System 5 Upgrade Guide for Microsoft Windows to upgrade Java ES components. Upgrade scenarios for individual components are described in the respective upgrade guides.
When Java ES 5 installation is attempted, the installer first detects the presence of Java ES 4 on the system. On successful detection, the installer checks for pre-existing Java ES 4 shared components in the Windows SYSTEM directory, because these components cause incompatibility issues with Java ES 5. If any of the shared components are being used by Java ES 4 services, you are prompted to stop the running Java ES 4 services.
In addition, the installer automatically renames the Java ES 4 shared components. The renaming information is stored in the installer log file. If you need to start any of the Java ES 4 services, you should restore the names of shared components manually.
Java ES 4 and Java ES 5 servers cannot be started simultaneously.
During the course of installation or uninstallation, log records are generated for the operations that occur. These records are saved into a single file located at %Temp%\SUNJavaES.log.
The configuration for all the products are removed before they are uninstalled. The scripts used to remove the configuration are a part of the uninstallation program. You can uninstall the Java ES system by choosing Start>Settings>Control Panel>Add/Remove Programsor by running the uninstall program in Silent mode.
Before you start the installer, review the issues in this section.
Before you install Java ES, ensure that the hosts in your system meet the minimum hardware and operating system requirements. For the latest information on the supported platforms and software and hardware requirements, refer to “Hardware and Software Requirements” in the Sun Java Enterprise System 5 Release Notes for Microsoft Windows.
If the operating system found on the host does not satisfy Java ES recommendations, the installer cannot proceed. You must resolve this problem before installation.
To install the Java ES software, you must be logged in as an administrator or as a user with administrator privileges. A privileged user is a part of local administration group. Users in nested groups are not considered privileged users. For example, a user from a group, which is a part of the administration group, is not considered a privileged user.
To run the Java ES installer, you need 500 Mbyte of disk space in the Windows system drive and 1.5 Gbyte in the destination drive.
The installer runs a check to determine whether your host has sufficient memory and disk space for the components you selected.
If the memory found on the host does not satisfy the Java ES recommendations, the installer displays a warning but allows the installation to proceed.
If the disk space found on the host is insufficient, the installer cannot proceed. You must resolve this problem before you resume the installation.
You can solve this problem by mapping the %TEMP% to any other drive that contains required amount of free space.
The following table lists the tasks that you should perform before beginning any type of installation. The left column lists the order in which you should perform the tasks and the right column contains the location of instructions and other useful information. Not all tasks are required for all installations.
Table 1–1 Preinstallation Checklist
Task |
Instructions and Helpful Information |
---|---|
1. Plan your Java ES installation. |
Refer to the Sun Java Enterprise System 5 Installation Planning Guide. |
2. Determine that a valid version of Java 2 Standard Edition (J2SETM) for Java ES is installed on your machine. |
If the installer does not find J2SE 1.5_09 or later on the machine, the installer installs J2SE in the C:\Java directory. |
3. Determine whether any release noted issues affect your installation. |
Before performing any of the procedures described in the Installation Guide, you should read the Sun Java Enterprise System 5 Release Notes for Microsoft Windows. These notes contain installation issues that might pertain to your deployment. |
4. Verify that system requirements are met. |
Refer to Determining Whether Your Hosts Are Ready. |
5. Determine whether an installation sequence example can be used. | |
6. If you are installing Java ES components that depend on servers or services that are already installed, ensure that the existing servers and services are accessible. |
For example, if you are installing a Portal Server Secure Remote Access subcomponent, the Secure Remote Access core must be running and accessible. |
7. Ensure that the drive you are using is an NTFS drive. |
To install Java ES on a Windows operating system, the installation drive should be an NTFS drive. |
8. Stop firewall services. |
If there are any firewall running on your host system, disable and stop firewall services and restart you host system. Make sure that the firewall services are disabled after restart. Once the installation of Java ES 5 is complete, you can restart these stopped firewall services. |
The following table lists the distribution bundles for Java ES software:
Table 1–2 Windows Distribution Bundles
Distribution Bundle |
Contents Included |
Bundle Name |
---|---|---|
Windows platform |
All Java ES components and shared components Installer Uninstaller |
java_es-5-ga-windows-x86.zip |
Application Server Suite |
Access Manager Application Server Directory Server HADB Java DB Message Queue Portal Server Portal Server Secure Remote Access Service Registry Monitoring Console Web Proxy Server Web Server All shared components Installer Uninstaller |
java_es-5-appsuite-ga-windows-x86.zip |
Access Manager Suite |
Access Manager Application Server Directory Server EE (includes Directory Server and Directory Proxy Server) HADB Java DB Message Queue Monitoring Console Web Server All shared components Installer Uninstaller |
java_es-5-identsuite-ga-windows-x86.zip |
Web Server Suite |
Access Manager Application Server Directory Server EE (includes Directory Server and Directory Proxy Server) HADB Java DB Message Queue Monitoring Console Service Registry Web Proxy Server Web Server All shared components Installer Uninstaller |
java_es-5-websuite-ga-windows-x86.zip |
You can obtain the Java ES software in the following ways:
As a web download
You can download Java ES software in several formats from the Sun Download Center at http://www.sun.com/download. The following formats are available:
ISO DVD set image of all installation files for a single operating system
Compressed archive of all installation files for a single operating system
Compressed archive of all installation files for a suite
DVD
You can obtain a media kit that contains a DVD at http://wwws.sun.com/software/javaenterprisesystem/index.html or by contacting your Sun sales representative. Each DVD contains the installation files for a single operating system, the Java ES installer program, and all the component packages. The DVD contains the installation files for the operating systems, the Java ES installer program, and all the component packages.