Sun Java Studio Enterprise 7 Installation Guide

This chapter contains information that you should review before you install the Java Studio Enterprise developer environment. Java Studio Enterprise provides a full set of developer tools and servers for developing and deploying applications written in the Java programming language using J2EE concepts. See Chapter 1, TABLE 1-1 for more information on the specific versions of the component product software included in this software.

This chapter covers:

• Overview of the Installation Process
• Planning for Installation
• Verifying System Readiness
• Checking Other Prerequisites

---

Overview of the Installation Process

This section describes the general process for installing and validating the software on your system. All language versions of this software are installed using the same installer. During installation you are asked to select the language support you need. English language support is always installed.

---

Planning for Installation

To properly plan your installation, review the following sections.

• Verify that your machine is a supported platform, see Supported Platforms
• Decide what you are going to install, seeSelecting What to Install
• Verify that you do not need to uninstall previously installed software versions, see Handling Existing Installations of Component Products

Supported Platforms

Java Studio Enterprise is supported on the following platforms:

• Microsoft Windows XP Professional SP2
• Microsoft Windows XP Professional SP1a
• Microsoft Windows 2000 Professional SP4
• Solaris 9 OS Update 7 (x86)
• Solaris 8 OS Update 7 (UltraSPARC^® III)
• Solaris 9 OS Update 7 (UltraSPARC^® III)

Selecting What to Install

Java Studio Enterprise software comes in two parts, Tools Components and Optional Servers. For the basic IDE development environment, use the Tools Components installer to install the Java Studio IDE, Application Server, , and Collaboration Runtime. Use the Optional Servers installer to install Web Server, Directory Server, Access Manager, and Portal Server.

TABLE 2-1 describes the Tools Components and Optional Servers.

Sun Java Studio Enterprise 7 software can be installed from physical media or by downloading zip files from the web site. TABLE 2-3 describes where to find the Tools Components and Optional Servers on the physical media

TABLE 2-4 lists names and contents of the download files for each platform.

---

Verifying System Readiness

The installer performs the following system checks during the installation process:

• System Dependencies: Does the system have the hardware, operating system patches, and memory required for installation? See System Dependencies
• Incomplete Uninstallations: Does the system have signs of an incomplete installation of Java Studio Enterprise? This System Readiness Check is done on Microsoft Windows systems. It checks for mismatches in installed products, registry key entries, product registry entries and Windows services. When problems are detected, you see a report that lists discrepancies and corrective actions. View a sample report at FIGURE 2-1
• Software Product Dependencies and Conflicts: Does the system have installed software that is incompatible with Java Studio Enterprise software or other software conflicts. See Software Product Dependencies and Conflicts.

FIGURE 2-1 Sample Initial System Check Report (Microsoft Windows).

System Dependencies

These checks include the following:

• Appropriate access privilege to install the software
• Required and recommended amount of memory
• Sufficient disk space for the products you select
• Required operating system packages and patch level (Solaris only)

Having the Correct User Privileges

• (Solaris OS) You must have superuser (root) privileges to install.
• (Microsoft Windows) You must have administrative privileges to install.

If you do not have the proper user privileges or are unfamiliar with installing software necessitating these privileges, please contact your system administrator for assistance.

System and Disk Space Requirements

If the memory found does not satisfy the recommendations, the installer displays a warning but allows installation to proceed. If you proceed with installation with low memory you may experience poor performance during runtime usage of the software.

The operating system and disk space checks must be satisfied in order for installation to proceed.

TABLE 2-5 lists the system requirements needed to install a complete Tools Components and Optional Servers configuration on the supported platforms.

These are general guidelines. Your requirements might vary depending on which additional software you have installed for use with Java Studio Enterprise software.

The main factor in determining how much installation disk space you need is a combination of the products that you choose to install and the presence of compatible products on the target system. Other factors specific to your machine may also affect the disk space usage. The installer does not proceed with installation if insufficient disk space is detected.

TABLE 2-6 describes the baseline disk space requirements on each supported platform for the following installations:

• Full installation (all component products)
• Tools plus J2SE version 1.4.2_05 platform (includes IDE, Application Server, and Message Queue)
• Each component product server alone




TABLE 2-6 Disk Space Requirements for Java Studio Enterprise Software

Component Product	Microsoft Windows	Solaris Sparc	Solaris x86
Full Installation (all component products)	950 MB	760	650 MB
J2SE+Tools Components	600 MB	470 MB	470 MB
Application Server	140 MB	85 MB	85 MB
Message Queue	20 MB	8 MB	20 MB
Collaboration Runtime	4 MB	4 MB	4 MB
Directory Server	110 MB	50 MB	35 MB
Access Manager	85 MB	80 MB	60 MB
Portal Server	100 MB	160 MB	95 MB
Web Server	130 MB	75 MB	70 MB
swap space	2-4 GB	2-4 GB	2-4 GB

Software Product Dependencies and Conflicts

The installer helps you to identify software dependencies and conflicts by performing the following checks prior to actual installation:

• Installed Component Products: Are Java Enterprise System (Solaris OS only) or Java Studio Enterprise products already installed?
• Component Product Dependencies: Are there dependencies among component products that you select for installation?
• Shared Component Dependencies: Are there installed shared components that must be upgraded before installation?

Solaris OS only: The installer detects only the component products that were installed by means of Solaris package distributions. The installer does not detect components that were originally installed by other means. Because of this, you may want to perform an independent survey of the system or consult with others to determine what software is currently installed. For example:

• The installer ignores the Directory Server version that is distributed with Solaris. The package names for that version of Directory Server are different from the package names for the Java Studio Enterprise version.
• The installer reports the Message Queue version that is distributed with Solaris. The package names for that version are the same as the package names for the Java Studio Enterprise version.

Installed Component Product Detection

Java Studio Enterprise software detects, but is incompatible with the following:

• Message Queue preinstalled on Solaris OS systems where the Message Queue version is lower than 3.0.1 Service Pack 2
• Access Manager (formerly Identity Server) installed on web containers other than Application Server or Web Server
• Partial installation of software products, this may include products that are installed but not configured correctly

Java Studio Enterprise software can co-exist with the following:

• Solaris-bundled version of Directory Server 5.1
• Solaris-bundled version of Application Server 7
• Existing installations of (on Windows only) Java Studio Enterprise 6
• zip/tar-based installations (non-packaged based)

Handling Existing Installations of Component Products

Java Studio Enterprise IDE

The Java Studio Enterprise 7 IDE can co-exist with an existing installation of the following:

• Sun Java Studio Standard 5 update 1
• Sun Java Studio Enterprise 6 2004Q1

If you install Sun Java Studio Enterprise 7 on a machine with an existing installation of the Java Studio IDE, the installer detects the existing installation. You can proceed to install the new version of the IDE, but please note the following:

• The installer detects the existing installation of the Application Server and indicates its compatability. The installer does not attempt to upgrade your version of Application Server. To install the latest version of Application Server, you must uninstall the existing Application Server. Use the correct uninstaller to do this. You can not uninstall the old server with the Java Studio Enterprise 7 installer.
• You can not install second copies of any of the component product servers that you may have installed with Java Studio Enterprise 6.
• The new installation of the IDE will work with the previously installed servers.
• If there are servers that you did not install with Java Studio Enterprise 6, you have the option to install those now with Java Studio Enterprise.
• When you uninstall, use the correct uninstaller as the uninstaller will uninstall only those products that were installed by that version's installer.
• To uninstall your existing IDE, see the Getting Started Guide or Installation Guide for your currently installed version for the proper uninstall procedure. It is not necessary to delete your existing user directory.

Java Studio Enterprise Servers

The set of component product servers included with Java Studio Enterprise software is also distributed as part of the Sun Java Enterprise System deployment software suite. In general, component products installed by the Java Enterprise System 2004Q2 installer are compatible with this software. However, the Java Studio Enterprise installer detects only the component products that are also part of the Java Studio Enterprise software.

Different versions of Directory Server, Access Manager, and Portal Server are installed depending on the platform (Microsoft Windows or Solaris OS), see Chapter 1, TABLE 1-1 for details.

Java Studio Enterprise software detects and is compatible with the following product installations (platform differences apply):

• Sun Java System Application Server 7 Standard Edition, Update 1 when installed by any of the following methods:
• Java Studio Enterprise 6 (previous release)
• stand-alone installer

• Sun Java System Directory Server 5.2 or Sun Java System Directory Server 5 2004Q2 (installed by Java Enterprise System installer or installed by Java Studio Enterprise installer)
• Sun Java System Web Server 6 2004Q1 Update 1, Service Pack 2 (installed by Java Enterprise System installer or installed by Java Studio Enterprise installer)
• Sun Java System Access Manager 6.1 (formerly Identity Server) or Sun Java System Access Manager 2004Q2 (installed by Java Enterprise System installer or installed by Java Studio Enterprise installer)
• Sun Java System Message Queue 3.5 SP 1: installed by the following methods:
• Stand-alone installer (On Microsoft Windows machines, this product must be installed in a location that does not contain spaces in the installation directory path name.)
• When installed with Sun Java System Application Server Standard Edition 7 2004Q2

• Sun Java System Portal Server 6.2 or Sun Java System Portal Server 2004Q2 (installed by Java Enterprise System installer or installed by Java Studio Enterprise installer)

If a component product server of the correct version is installed, but not configured, you should uninstall it first and then reinstall it with the Java Studio Enterprise installer.

Component Product Dependencies

It is useful to know the interdependencies among the component products so that you can understand the behavior of the Product Selection page displayed during installation and properly plan your installation. TABLE 2-7 lists the dependencies that each component product has for other component products. It does not include dependencies on shared components, such as the J2SE platform.

To use this table, find the product you want to install in column one, then look at column two. The products listed in column two must also be installed for proper behavior. Column four lists whether the dependent products must be on the same machine as the column one product. The installer makes these selections for you during the installation process. The information is presented here for planning purposes.

Shared Component Dependencies (Solaris OS)

The installer ensures that software that is already installed on the machine is compatible with Java Studio Enterprise software.

Many systems already have shared components, such as Ant or NSS. The Java Studio Enterprise installer checks shared components on the machine. If it finds shared components whose version is incompatible with Java Studio Enterprise, it lists them. If you proceed with installation, the installer upgrades the shared components to the newer versions.

It is important that you verify that it is safe to upgrade shared components. You need to check that existing programs that use the older shared components will be compatible with the newer versions. See Appendix F for a list of shared components.

Upgrade Path for Component Product Servers (Solaris OS)

The installer does not perform any upgrading of the server runtimes from one version to the next. See Chapter 8 of the Sun Java Enterprise System 2004Q2 Installation Guide at http://docs.sun.com/db/coll/entsys_04q2, for information on upgrading the server runtimes if you prefer to upgrade, rather than uninstall the Java Enterprise System 6 version and reinstall the Java Studio Enterprise 7 version of the server.

J2SE Handling

The Java Studio Enterprise installer searches for the existence of compatible versions of the Java 2 Platform, Standard Edition (J2SE platform) on the target system. Based on the findings the installer presents one of the following two choices:

• When no compatible J2SE platform is found on the installation machine, the installer prompts you for a location to install the recommended J2SE version 1.4.2_05 platform.
• When multiple compatible J2SE versions are found on the system, the installer lists the locations and the version numbers of all the detected compatible versions. You select a version for the installer to use.

---

Checking Other Prerequisites

• Verify that the DNS suffix is correctly set. See Verifying the DNS Suffix.
• Download directories and installation directories may not contain spaces or other special characters in the path name.

^{1 (TableFootnote) The component product versions vary by platform. Review TABLE 1-1 for details.}

Sun Java Studio Enterprise 7 Installation Guide

817-7971-10

Copyright © 2004, Sun Microsystems, Inc. All Rights Reserved.