Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java Enterprise System 2005Q1 Installation Guide 

Chapter 3
Example Installation Sequences

This chapter provides sequencing guidelines for some common Sun Java™ Enterprise System (Java ES) installation examples.

This chapter contains the following sections:

How to Use This Chapter

The example installation sequences in this chapter are intended to provide basic guidelines for doing some common Java ES installations. These are not literal procedures, but instead provide the high-level sequential steps required to implement particular deployment scenarios.

The single-session examples describe typical steps for installing one or a number of Java ES components on a single host in a single installation session. An evaluation example is included.

The remaining examples describe situations where multiple installation sessions are performed on multiple hosts, for a variety of solutions.

Note

The Calendar-Messaging Schema 1 Example is the only example based on LDAP Schema 1. All other examples in this chapter are based on Schema 2.

For the most part, the sequences in this chapter are based on the relationships among the components as shown in Table 2-2.

At component selection, the Java ES installer identifies incompatible versions of components as well as unmet requirements. You receive warning messages that identify the problem and tell you what you need to do. Many of these messages tell you about requirements that are not yet met. Other messages tell you that incompatible versions of some or all of the components you are trying to install are already on the local host.

Tip

Installation goes smoothly if any incompatible versions of Java ES components are identified and removed or upgraded before starting the installer.

You can use the Java ES installer to identify components that are already on your local host. For instructions, refer to Are Incompatible Components Installed?.

To upgrade components that are already on your local host, refer to Java Enterprise System Upgrade and Migration Guide (http://docs.sun.com/doc/819-0062).

Single-Session Installation Examples

The following examples apply to installing on a single host in a single session:

Evaluation Example

This example installs all the Java ES components except Sun Cluster software on a single host in a single installation session.

An evaluation installation is generally considered a trial deployment, a quick installation to see how things go. This example uses the graphical interface and the Configure Now option. When you are presented with configuration pages, you accept defaults wherever possible.

The general steps for this type of installation include the following:

  1. Starting the Java ES graphical installer

    2. Chapter 7, "Installing with the Graphical Interface"

  2. At component selection, selecting Install All, then deselecting the Application Server and Sun Cluster components

    3. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  3. Verifying installation directories
  4. Selecting the Configure Now option

    5. Messages indicate which components cannot be configured during installation.

  5. Accepting configuration defaults when they are offered

    6. If you want to use non-default information, review the appropriate configuration tables in Chapter 4, "Configuration Information".

  6. Viewing the Installation Summary and Log
  7. Completing post-install configuration

    8. Chapter 10, "Configuring Components After Installation"

  8. Starting the components

    9. Table 11-1 contains the preferred Java ES startup sequence. Startup procedures follow the table.

    Note

    If you are using a remote component to fulfill dependencies, the remote component must be installed and running before installing any components that depend on it.

Access Manager and Portal Server Example

This example installs Portal Server with Access Manager on a single host, with Web Server as the web container.

Requirements

Portal Server requires a local copy of Access Manager or Access Manager SDK. Access Manager can be remote, but Access Manager SDK must be local. Access Manager requires Directory Server, but not necessarily a local copy. Portal Server requires a local web container which in this example is Web Server. Delegated Administrator is automatically installed with Access Manager.

The general steps for this installation example include:

  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, choosing Portal Server and Web Server

    3. Access Manager, Directory Server, and Directory Preparation Script are automatically selected.

    • To use a remote copy of Directory Server, deselect Directory Server and specify a remote copy when prompted.

      • Note

      The remote Directory Server must be running before installing any other components. For instructions on installing Directory Server, refer to Directory Server Only Example.

    • To use a remote copy of Access Manager, deselect Access Manager and specify a remote copy during postinstallation configuration.

      • Note

      The remote Access Manager must be running before installing any other components. For instructions on installing Access Manager, refer toIdentity Management Example.

  3. Resolving incompatibilities

    4. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  4. Selecting the Configure Now or Configure Later option
    1. For the Configure Now option, configuration pages are displayed for those components that allow installation-time configuration. Do not accept defaults for components that are remote; use the remote information.

      2. You will need to gather your configuration information from the tables in Chapter 4, "Configuration Information".

    2. For the Configure Later option, configuration pages are not displayed.
  5. Running the installation
  6. Viewing the Installation Summary and Log
  7. Completing any post-install configuration

    8. For Configure Now:

  8. Starting the components
  9. Accessing the default Access Manager login page

    10. http://webserver-host:port/amconsole

The following table contains additional Access Manager information.

Table 3-1  Installation Information for Access Manager 

Task

Relevant Information

Configuration information for the installer

Access Manager Configuration Information
Access Manager SDK Configuration Information

Postinstallation configuration

Configuring Access Manager After a Configure Now Installation

Configuring Access Manager After a Configure Later Installation

Starting and stopping

Starting and Stopping Access Manager

Uninstalling

Access Manager-related Post-uninstallation
Access Manager Uninstallation Behavior

Troubleshooting

Access Manager Troubleshooting Tools

Upgrading

Java Enterprise System Upgrade and Migration Guide
http://docs.sun.com/doc/819-0062

The following table contains additional Portal Server information.

Table 3-2  Installation Information for Portal Server 

Task

Relevant Information

Configuration information for the installer

Portal Server Configuration Information

Postinstallation configuration

Configuring Portal Server and Portal Server Secure Remote Access After a Configure Now Installation on a Sun Web Container

Configuring Portal Server After a Configure Later Installation on a Third-Party Web Container

Starting and stopping

Accessing the Portal Server Desktop

Uninstalling

Portal Server Uninstallation Behavior

Troubleshooting

Portal Server Troubleshooting Tools

Upgrading

Java Enterprise System Upgrade and Migration Guide
http://docs.sun.com/doc/819-0062

Application Server Only Example

This example installs Application Server by itself.

Requirements

Application Server requires a local copy of Message Queue. If you are using load balancing, a local copy of Web Server is also required.

The general steps for this type of installation include the following:

  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, choosing Application Server

    3. Message Queue is automatically selected. The Load Balancing Plugin subcomponent is not selected.

    (Optional) If you are going to implement load balancing, expand Application Server and select the Load Balancing Plugin subcomponent. Web Server is automatically selected.

  3. Resolving incompatibilities

    4. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  4. Verifying installation directories
  5. Selecting the Configure Now or Configure Later option
    1. For the Configure Now option, configuration pages are displayed for the local components that can be configured during installation.

      2. Gather your Application Server configuration information from the tables in Application Server Configuration Information.

    2. For the Configure Later option, configuration pages are not displayed.
  6. Running the installation
  7. Viewing the Installation Summary and Log
  8. Completing post-install configuration
  9. Starting Application Server (automatically starts Message Queue)

The following table contains additional Application Server information.

Table 3-3  Installation Information for Application Server 

Task

Relevant Information

Configuration information for the installer

Application Server Configuration Information

Postinstallation configuration

Configuring Application Server After a Configure Later Installation

Starting and stopping

Starting and Stopping Application Server

Uninstalling

Application Server Uninstallation Behavior

Troubleshooting

Application Server Troubleshooting Tools

Upgrading

Java Enterprise System Upgrade and Migration Guide
http://docs.sun.com/doc/819-0062

Directory Server Only Example

This example installs Directory Server by itself.

Requirements

Directory Server has no dependencies on other Java ES components.

Note

If you are using replication for encryption for Directory Server, you should also select Administration Server at component selection.

Sequence Issues

The general steps for this type of installation include the following:

  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, selecting Directory Server and (optionally) Administration Server

    3. The Directory Preparation Script is automatically selected.

  3. Resolving incompatibilities

    4. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  4. Verifying installation directories
  5. Selecting the Configure Now or Configure Later option
    1. For the Configure Now option, configuration pages are displayed for the local components that can be configured during installation.

      2. Gather your configuration information from the tables in Chapter 4, "Configuration Information".

    2. For the Configure Later option, configuration pages are not displayed.
  6. Running the installation
  7. Viewing the Installation Summary and Log
  8. Completing post-install configuration
  9. Starting the components in this order:
    1. To Start Directory Server
    2. (Optional) To Start Administration Server

The following table contains additional Directory Server information.

Table 3-4  Installation Information for Directory Server 

Task

Relevant Information

Configuration information for the installer

Directory Server Configuration Information

Postinstallation configuration

Configuring Directory Server After a Configure Later Installation

Starting and stopping

Starting and Stopping Directory Server

Uninstalling

Directory Server Uninstallation Behavior

Troubleshooting

Directory Server Troubleshooting Tools

Upgrading

Java Enterprise System Upgrade and Migration Guide
http://docs.sun.com/doc/819-0062

Directory Proxy Server Example

This example installs Directory Proxy Server with Directory Server on a single host.

Requirements

Directory Proxy Server requires Directory Server, but not necessarily a local copy. In addition, Directory Proxy Server requires a local copy of Administration Server.

The general steps for this type of installation include the following:

  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, selecting Directory Proxy Server

    3. Directory Server, Directory Preparation Script, and Administration Server are automatically selected.

    (Optional) If you are using a remote copy of Directory Server, deselect Directory Server and specify a remote copy when prompted.

    Note

    The remote Directory Server must be running before installing any other components. For instructions on installing Directory Server, refer to Directory Server Only Example.

  3. Resolving incompatibilities

    4. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  4. Verifying installation directories
  5. Selecting the Configure Now or Configure Later option
    1. For the Configure Now option, configuration pages are displayed for the local components that can be configured during installation. Do not accept defaults for components that are remote; use the remote information.

      2. Gather your configuration information from the tables in Chapter 4, "Configuration Information".

    2. For the Configure Later option, configuration pages are not displayed.
  6. Running the installation
  7. Viewing the Installation Summary and Log
  8. Completing post-install configuration
  9. Starting the components in this order:
    1. To Start Directory Server
    2. To Start Administration Server
    3. To Start Directory Proxy Server

The following table contains additional Directory Proxy Server information.

Table 3-5  Installation Information for Directory Proxy Server 

Task

Relevant Information

Configuration information for the installer

Directory Proxy Server Configuration Information

Postinstallation configuration

Configuring Directory Proxy Server After a Configure Later Installation

Starting and stopping

Starting and Stopping Instant Messaging Server and Multiplexor

Uninstalling

Directory Proxy Server Uninstallation Behavior

Troubleshooting

Directory Proxy Server Troubleshooting Tools

Upgrading

Java Enterprise System Upgrade and Migration Guide
http://docs.sun.com/doc/819-0062

Instant Messaging Only Example

This example installs Instant Messaging by itself.

It is not uncommon for Instant Messaging to be installed in a separate installation session after other components have been installed and configured.

Note

If you are using single sign-on or Access Manager managed policies, Access Manager is required. For guidelines, refer to Instant Messaging and Access Manager Example.

Sequence Issues

The general steps for this type of installation include the following:

  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, choosing Instant Messaging
  3. Resolving incompatibilities

    4. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  4. Verifying installation directories
  5. Selecting the Configure Later option

    6. Instant Messaging cannot be configured during installation.

  6. Running the installation
  7. Viewing the Installation Summary and Log
  8. Completing post-install configuration

    9. Configuring Instant Messaging After a Configure Later Installation

  9. Starting Instant Messaging (after starting any other components that Instant Messaging might depend on)

    10. To Start Instant Messaging Server and Multiplexor

The following table contains additional Instant Messaging information.

Table 3-6  Installation Information for Instant Messaging 

Task

Relevant Information

Postinstallation configuration

Configuring Instant Messaging After a Configure Later Installation

Starting and stopping

Starting and Stopping Instant Messaging Server and Multiplexor

Uninstalling

Instant Messaging Uninstallation Behavior

Troubleshooting

Instant Messaging Troubleshooting Tools

Upgrading

Java Enterprise System Upgrade and Migration Guide
http://docs.sun.com/doc/819-0062

Deployment scenarios

Sun Java System Communications Deployment Planning Guide

Message Queue Only Example

This example installs Message Queue by itself.

Requirements

Message Queue has no dependencies on other Java ES components.

Note

If you are using this component with Sun Cluster software, you must perform a precise series of tasks before installing any components. Refer to Sun Cluster Software Example to see Sun Cluster guidelines.

The general steps for this type of installation include the following:

  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, selecting Message Queue
  3. Resolving incompatibilities

    4. The installer verifies software on your host and provides guidance if incompatibilities are identified.

    • Solaris OS:

      • If a previous copy of Message Queue, Platform Edition is detected on the host, the installer will automatically update the installation with Message Queue, Enterprise Edition.

      If a previous copy of Message Queue, Enterprise Edition is detected on the host, you must exit the installer and follow the instructions for upgrading to Message Queue, Enterprise Edition in the Java Enterprise System Upgrade and Migration Guide (http://docs.sun.com/doc/819-0062).

    • Linux:

      • If a previous copy of Message Queue, (Platform or Enterprise Editions) is detected on the host, you must exit the installer and follow the instructions for upgrading and migrating to Message Queue, Enterprise Edition in the Java Enterprise System Upgrade and Migration Guide (http://docs.sun.com/doc/819-0062).

  4. Selecting the Configure Later option.

    5. Message Queue cannot be configured during installation

  5. Running the installation
  6. Viewing the Installation Summary and Log
  7. Starting Message Queue

    8. Starting Message Queue

The following table contains additional Message Queue information.

Table 3-7  Installation Information for Message Queue 

Task

Relevant Information

Postinstallation configuration

Configuring Message Queue After a Configure Now Installation

Starting and stopping

Starting Message Queue

Uninstalling

Message Queue Uninstallation Behavior

Troubleshooting

Message Queue Troubleshooting Tools

Upgrading

Java Enterprise System Upgrade and Migration Guide
http://docs.sun.com/doc/819-0062

Portal Server Secure Remote Access Example

This example installs Portal Server Secure Remote Access with Access Manager on a single host, with Web Server as the web container.

Requirements

Portal Server Secure Remote Access requires a local copy of Access Manager or Access Manager SDK. Portal Server Secure Remote Access Core requires a local copy of Portal Server except in case of Gateway, where Portal Server Secure Remote Access does not require a local copy of Portal Server and can be installed on a separate host. Directory Server is required by Portal Server, but not necessarily a local copy. Access Manager requires a local web container.

The general steps for this installation example include:

  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, choosing Portal Server Secure Remote Access and Web Server

    3. Portal Server, Access Manager, Directory Server, and Directory Preparation Script, and are automatically selected.

    • To use a remote copy of Directory Server, deselect Directory Server and specify a remote copy when prompted.

      • Note

      The remote Directory Server must be running before installing any other components. For instructions on installing Directory Server, refer to Directory Server Only Example.

    • To use a remote copy of Access Manager, deselect Access Manager and specify a remote copy during postinstallation configuration.

      • Note

      The remote Access Manager must be running before installing any other components. For instructions on installing Access Manager, refer to Identity Management Example.

  3. Resolving incompatibilities

    4. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  4. Selecting the Configure Now or Configure Later option
    1. For the Configure Now option, configuration pages are displayed for those components that allow installation time configuration. Do not accept defaults for components that are remote; use the remote information.

      2. You will need to gather your configuration information from the tables in Chapter 4, "Configuration Information".

    2. For the Configure Later option, configuration pages are not displayed.
  5. Running the installation
  6. Viewing the Installation Summary and Log
  7. Completing any post-install configuration

    8. For Configure Now:

  8. Starting the components

    9. To Start Directory Server
    To Start Web Server Administration Server and Instance (Access Manager and Portal Server start automatically.)

    To Start Portal Server Secure Remote Access Gateway

  9. Accessing the default Access Manager login page

    10. http://webserver-host:port/amserver

  10. Accessing the portal

    11. http://webserver-host:port/portal/dt

  11. Accessing the Portal Gateway

    12. http://gateway-server:port/

The following table contains additional Portal Server Secure Remote Access information.

Table 3-8  Installation Information for Portal Server Secure Remote Access 

Task

Relevant Information

Configuration information for the installer

Portal Server Secure Remote Access Configuration Information

Starting and stopping

Starting and Stopping Portal Server Secure Remote Access

Uninstalling

Portal Server Secure Remote Access Uninstallation Behavior

Troubleshooting

Portal Server Secure Remote Access Troubleshooting Tools

Upgrading

Java Enterprise System Upgrade and Migration Guide
http://docs.sun.com/doc/819-0062

Web Server Only Example

This example installs Web Server by itself.

Requirements

Web Server has no dependencies on other components.

Note

If you are using this component with Sun Cluster software, you must perform a precise series of tasks before installing any components. Refer to Sun Cluster Software Example to see Sun Cluster guidelines.

The general steps for this type of installation include the following:

  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, selecting Web Server
  3. Resolving incompatibilities

    4. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  4. Verifying installation directories
  5. Selecting the Configure Now or Configure Later option
    1. For the Configure Now option, the Web Server configuration pages are displayed by the installer.

      2. Gather your configuration information from the tables in Chapter 4, "Configuration Information".

    2. For the Configure Later option, configuration pages are not displayed.
  6. Running the installation
  7. Viewing the Installation Summary and Log
  8. Completing any post-install configuration

    9. To Configure Web Server After a Configure Later Installation

  9. StartingWeb Server

    10. To Start Web Server Administration Server and Instance

The following table contains additional information for installing Web Server.

Table 3-9  Installation Information for Web Server 

Task

Relevant Information

Configuration information for the installer

Web Server Configuration Information

Postinstallation configuration

Configuring Web Server After a Configure Later Installation

Starting and stopping

Starting and Stopping Web Server

Uninstalling

Web Server Uninstallation Behavior

Troubleshooting

Web Server Troubleshooting Tools

Upgrading

Java Enterprise System Upgrade and Migration Guide
http://docs.sun.com/doc/819-0062

Solaris 10 Zones

This section describes Solaris 10 zones support for the current release of Java ES. An installation example is included.

Overview of Solaris Zones

The Solaris 10 zones (also known as Solaris containers) feature provides a means of creating virtualized operating system environments within an instance of Solaris OS. This allows one or more processes to run in isolation from other activities on the host. For example, a process running in a zone will only be able to send signals to other processes in the same zone, regardless of user ID and other credential information.

Every Solaris 10 host contains a single global zone. The global zone is both the default zone for the host and the zone used for system-wide administrative control. All processes run in the global zone if no non-global zones are created by the global administrator.

A non-global zone can be thought of as a box. One or more applications can run in this box without interacting with the rest of the host. Each non-global zone has what appears to be its own instance of an installed Solaris 10 operating system with configuration and other information unique to that non-global zone. The default configuration for a non-global zone is to share portions of its file system with the global zone (as a read-only loopback file system mount).

Zones Scenarios Supported in this Release of Java ES

The following Java ES and zones scenarios are supported in this release of Java ES:

Java ES Limitations in Global Zones

Installing and configuring Java ES for use in the global zone is supported, but this configuration has some limitations in this release of Java ES. These limitations are due to the nature of some of the Java ES packages and how those packages are automatically propagated by the zones infrastructure to both existing and newly created non-global zones.

Solaris 10 Zones Example

This example installs Java ES software in a Solaris 10 non-global zone.

  1. Verifying that Solaris 10 is installed on your host

    2. The global zone is automatically created.

  2. Verifying that all the non-global zones specified in your implementation plan have been created by the global zone administrator as “whole root” zones with no inherited file systems

    3. For information on creating non-global zones, refer to the “Planning and Configuring Non-Global Zones (Tasks)” chapter in the System Administration Guide: Solaris Containers-Resource Management and Solaris Zones (http://docs.sun.com/doc/817-1592).

  3. Starting the Java ES installer in the desired non-global zone

    4. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  4. At component selection, choosing the components you want

    5. Some components, such as SRS Net Connect, cannot be installed in a non-global zone because they require access to global zone capabilities. Other components are not supported for Solaris 10. These components are unavailable at component selection.

  5. Running the installation
  6. Viewing the Installation Summary and Log
  7. Completing postinstallation configuration as needed

    8. Chapter 10, "Configuring Components After Installation"

  8. Starting components

    9. Chapter 11, "Starting and Stopping Components"

  9. Repeating Step 3 to Step 8 in additional non-global zones as needed

Sun Cluster Software Example

This example installs Messaging Server in a Sun Cluster framework.

Note

Components that can be configured to run in a cluster instead of on a single server include Administration Server, Calendar Server, Directory Server, Message Queue, Messaging Server, and Web Server.

Requirements

Messaging Server requires Directory Server, but not necessarily a local copy. In addition, Messaging Server requires a local copy of Administration Server. You will need the Sun Cluster Core component as well as the Sun Cluster Agents for Directory Server, Administration Server, and Messaging Server.

Sequencing Issues

Installing, configuring, and starting the components in the correct order is crucial for a successful Sun Cluster implementation. The general tasks include the following:

  1. Installing the Java ES Sun Cluster component
  2. Configuring the Sun Cluster framework
  3. Installing the additional Java ES components that are required for Messaging Server to operate in the cluster
  4. Configuring the Sun Cluster data services using the agents for the relevant Java ES components

At least two installation sessions are performed on each node in the cluster.

Phase I. Installing and Configuring the Sun Cluster Framework

The following tasks must be performed on all nodes in the cluster:

  1. Verifying that the hardware is connected correctly for the cluster
  2. Running the Java ES installer

    3. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  3. At component selection, choosing only the Sun Cluster component
  4. Selecting the Configure Later option
  5. Following the instructions to configure the Sun Cluster Framework for each host in the cluster

    6. “Installing and Configuring Sun Cluster Software” chapter of the Sun Cluster Software Installation Guide for Solaris OS (http://docs.sun.com/doc/817-6543)

    For documentation on creating resource groups and configuring data services, refer to the Sun Cluster Data Services Planning and Administration Guide for Solaris OS (http://docs.sun.com/doc/817-6564).

Phase II. Installing and Configuring Components and Agents

The following tasks must be performed on all nodes in the cluster:

  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, choosing the following:
    1. Messaging Server

      2. Directory Server, the Directory Preparation Script, and Administration Server are automatically selected.

      (Optional) If you are using a remote copy of Directory Server, deselect Directory Server and specify a remote copy when prompted.

      Note

      The remote Directory Server must be running before installing any other components. For instructions on installing Directory Server, refer to Directory Server Only Example.

    2. Sun Cluster Agents for Sun Java System

      3. All agents are selected by default.

    3. Expanding the Sun Cluster Agents for Sun Java System component and deselecting all agents except Administration Server, Directory Server, and Messaging Server
  3. Resolving incompatibilities

    4. The installer verifies software on your node and provides guidance if incompatibilities are identified.

    Tip

    During a Configure Now installation (usually where you have chosen to install all Java ES components), you are prompted whether to enable support for remote Sun Cluster configuration. If you select Yes, postinstallation configuration for Sun Cluster will be easier.

  4. Verifying installation directories
  5. Selecting the Configure Now or Configure Later option

    6. Messaging Server and Sun Cluster cannot be configured during installation.

  6. Configuring all the selected components except Sun Cluster Agents
  7. Starting all the components except Sun Cluster Agents, in this order:
    1. To Start Directory Server
    2. To Start Administration Server
    3. To Start Messaging Server
  8. Configuring the data services for the components you have installed and configured

    9. Sun Cluster Data Services Configuration

The following table contains additional Sun Cluster information.

Table 3-10  Installation Information for Sun Cluster 

Task

Relevant Information

Postinstallation configuration information

Sun Cluster Framework Configuration
Sun Cluster Data Services Configuration

Starting and stopping

Stopping and Rebooting Sun Cluster Software

Uninstalling

Sun Cluster Uninstallation Behavior

Troubleshooting

Sun Cluster Software Troubleshooting Tools

Upgrading

Java Enterprise System Upgrade and Migration Guide
http://docs.sun.com/doc/819-0062

Access Manager SDK With Container Configuration Example

This example installs Access Manager SDK, using a copy of Access Manager that is already installed on a remote host.

Requirements

Before you install Access Manager SDK, the Access Manager core services must be installed and running on a remote host. The web container information and Directory Server configuration information that you provide in this installation example must match the web container and Directory Server configuration information that you provided during installation of Access Manager core services.

Note

When the installer asks for information about the remote web container and Directory Server, default values are displayed based on the local host.

Do not accept the default values; use them only as examples of format. Instead, you must supply the correct information from the remote host.

The Java ES installer does not allow you to configure the web container when you are installing only the Access Manager SDK.

The general steps for this type of installation include the following:

On Host A

Installing and starting Access Manager core services

Identity Management Example

On Host B
  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, choosing Access Manager SDK
  3. Resolving incompatibilities

    4. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  4. Selecting the Configure Later option
  5. Running the installation
  6. Viewing the Installation Summary and Log
  7. Verifying that your web container is installed and running
  8. Completing the configuration
    1. In the AccessManager-base/SUNWam/bin directory, make a copy the amsamplesilent file.
    2. Edit the copy of the amsamplesilent file.

      3. Note

      When you edit the amsamplesilent file for the Access Manager SDK, use the same encryption key for AM_ENC_PWD as the encryption key specified during the remote installation of Access Manager.

    3. Use the edited amsamplesilent file to deploy Access Manager.

      4. ./amconfig -s ./am.sdk_install

  9. Restarting your web container

Calendar Server and Messaging Server Example

This example installs Calendar Server and Messaging Server in a 3-host Schema 2 environment. Remote copies of Access Manager and Directory Server are used.

Note

For a Schema 1 example, refer to Calendar-Messaging Schema 1 Example.

Requirements

Access Manager is required if you are implementing single sign-on or Access Manager managed policies. In this case, either Access Manager or a local copy of the Access Manager SDK is required. Access Manager SDK requires Access Manager, but not necessarily a local copy. Calendar Server and Messaging Server both require Directory Server, but not necessarily a local copy. Messaging Server requires a local copy of Administration Server.

In this example, remote copies of Directory Server and Access Manager are used. Access Manager requires a local web container.

Sequence Issues

The general steps for this type of installation include the following:

On Host A

Installing and starting Directory Server

Directory Server Only Example

On Host B

Installing and starting the web container and Access Manager (deselecting Directory Server)

Identity Management Example

On Host C
  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, selecting Calendar Server, Messaging Server, and Access Manager SDK

    3. Directory Server, Directory Preparation Script, and Administration Server are automatically selected.

  3. Deselecting Directory Server and specifying a remote copy when prompted
  4. Resolving incompatibilities

    5. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  5. Verifying installation directories
  6. Selecting the Configure Now option

    7. Calendar Server and Messaging Server cannot be configured during installation.

    Configuration pages are displayed for the local components that can be configured during installation. Do not accept defaults for components that are remote; use the remote information. Gather your configuration information from the tables in Chapter 4, "Configuration Information".

  7. Running the installation
  8. Viewing the Installation Summary and Log
  9. Completing post-install configuration, including specifying remote components

    10. Configuring Calendar Server After a Configure Later Installation

    Configuring Messaging Server After a Configure Later Installation

  10. Starting the components in this order:
    1. To Start Administration Server
    2. To Start Messaging Server
    3. To Start Calendar Server

The following table contains additional Calendar Server information.

Table 3-11  Installation Information for Calendar Server 

Task

Relevant Information

Postinstallation configuration

Configuring Calendar Server After a Configure Later Installation

Starting and stopping

Starting and Stopping Calendar Server

Uninstalling

Calendar Server Uninstallation Behavior

Troubleshooting

Calendar Server Troubleshooting Tools

Upgrading

Java Enterprise System Upgrade and Migration Guide
http://docs.sun.com/doc/819-0062

The following table contains additional Messaging Server information.

Table 3-12  Installation Information for Messaging Server 

Task

Relevant Information

Postinstallation configuration

Configuring Messaging Server After a Configure Later Installation

Starting and stopping

Starting and Stopping Messaging Server

Uninstalling

Messaging Server Post-uninstallation
Messaging Server Uninstallation Behavior

Troubleshooting

Messaging Server Troubleshooting Tools

Upgrading

Java Enterprise System Upgrade and Migration Guide
http://docs.sun.com/doc/819-0062

Calendar-Messaging Schema 1 Example

This example installs Calendar Server and Messaging Server in an LDAP Schema 1 environment on two hosts. A remote version of Directory Server is used.

Requirements

Both Calendar Server and Messaging Server require Directory Server, but not necessarily a local copy. In addition, a local copy of Administration Server is required by Messaging Server.

The general steps for this type of installation include the following:

On Host A

Installing and starting Directory Server

Directory Server Only Example

On Host B
  1. Running the Java ES installer.

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, choosing Calendar Server and Messaging Server

    3. Directory Server, the Directory Preparation Script, and Administration Server are automatically selected.

  3. Deselecting Directory Server

    4. When you are prompted to choose a local or remote Directory Server, choose remote (the Directory Server that is already installed and running on Host A).

  4. Resolving incompatibilities

    5. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  5. Selecting the Configure Now option

    6. You will receive a message that Calendar Server and Messaging Server cannot be configured during installation.

  6. Reviewing the configuration pages for Administration Server
  7. Running the installation
  8. Viewing the Installation Summary and Log
  9. Completing any post-install configuration:
  10. Starting the components in this order:
    1. To Start Administration Server
    2. To Start Messaging Server
    3. To Start Calendar Server
  11. If needed, setting up single sign-on

    12. Refer to the “Legacy SSO” chapter in the Sun Java System Messaging Server Administration Guide (http://docs.sun.com/doc/819-0105).

Communications Express and Messaging Server Example

This example installs Communications Express for messaging services in a 2-host Schema 2 environment. A remote copy of Directory Server is used.

Requirements

Communications Express requires either Access Manager or the Access Manager SDK for Schema 2. (A local copy of Access Manager SDK is always required, but you can use a remote copy of Access Manager.) Directory Server is required for Access Manager and Communications Express, but Directory Server does not need to be on the local host. Communications Express requires a local web container which can be either Application Server or Web Server.

To use messaging services, Communications Express requires a local copy of Messaging Server, which requires a local copy of Administration Server. To use calendar services, Communications Express requires Calendar Server, but Calendar Server does not need to be on the local host. This example uses messaging services.

Sequence Issues

The general steps for this type of installation include the following:

On Host A

Installing and starting Directory Server

Directory Server Only Example

On Host B
  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, choosing Communications Express, Access Manager, Messaging Server, and Web Server

    3. Administration Server, Directory Server, and the Directory Preparation Script are automatically selected.

  3. Deselecting Directory Server

    4. When you are prompted to choose a local or remote Directory Server, choose remote (the Directory Server that is already installed and running on Host A).

  4. Resolving incompatibilities

    5. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  5. Selecting the Configure Now option

    6. Communications Express cannot be configured during installation, and will require postinstallation configuration.

    Configuration pages are displayed for those components that can be configured during installation.

  6. Reviewing the configuration pages
  7. Running the installation
  8. Viewing the Installation Summary and Log
  9. Completing post-install configuration:
  10. Starting the components
  11. Using the following URL to access the default Communications Express login page:

    12. http://web-container-host:web-container-port/URI-path-CommsExpress

  12. Using the following URL to access the default Access Manager Login page:

    13. http://web-container-host:web-container-port/amserver/UI/Login

Instant Messaging and Access Manager Example

This example installs Instant Messaging with Access Manager, using a remote Directory Server, and Web Server as the web container.

Requirements

For the Instant Messaging Core subcomponent, Access Manager is required, but not necessarily a local copy. For the Instant Messaging Resources subcomponent, the Access Manager SDK must be local to Instant Messaging. Access Manager requires a web container, which can be remote. If you use Access Manager, Directory Server is required, but not necessarily a local copy. If you are using Access Manager with Instant Messaging, you must also use the Access Manager SDK.

Sequence Issues

The general steps for this type of installation include the following:

On Host A

Installing and starting Directory Server

Directory Server Only Example

On Host B
  1. Running the Java ES installer

    2. Chapter 7, "Installing with the Graphical Interface"
    Chapter 8, "Installing with the Text-Based Interface"

  2. At component selection, choosing Instant Messaging, Directory Server, and Web Server

    3. The Directory Preparation script is automatically selected.

  3. Deselecting Directory Server and specifying the remote copy when prompted

  4. Resolving incompatibilities

    5. The installer verifies software on your host and provides guidance if incompatibilities are identified.

  5. Verifying installation directories
  6. Selecting the Configure Now or Configure Later option

    7. Instant Messaging cannot be configured during installation.

    1. For the Configure Now option, configuration pages are displayed for the local components that can be configured during installation. Do not accept defaults for components that are remote; use the remote information.

      2. Gather your configuration information from the tables in Chapter 4, "Configuration Information".

    2. For the Configure Later option, configuration pages are not displayed.
  7. Running the installation
  8. Viewing the Installation Summary and Log
  9. Completing post-install configuration

    10. Configuring Web Server After a Configure Later Installation

    Configuring Instant Messaging After a Configure Later Installation
    (Optional) For remote components: During Instant Messaging configuration, specify any remote locations for Directory Server, Access Manager, and Web Server.

  10. Starting the components in this order:
    1. To Start Web Server Administration Server and Instance
    2. To Start Instant Messaging Server and Multiplexor

Communication and Collaboration Services Example

This example installs most of the Java ES components to implement communication and collaboration services across four hosts.

Note

If you are using any of these components with Sun Cluster software, you must perform a precise series of tasks before installing any Java ES components. Refer to Sun Cluster Software Example to see Sun Cluster guidelines.

Requirements

Directory Server is required for all the communications components, but not necessarily a local copy. A local copy of Administration Server is required by Messaging Server. Access Manager or the Access Manager SDK is required, but Access Manager can be remote. In this example, Web Server fulfills the Access Manager requirement for a web container. Although Calendar Server and Messaging Server do not require a local web container, Communications Express does. Communications Express can use a remote copy of Calendar Server, but Messaging Server must be local.

To implement single sign-on, Instant Messaging requires Access Manager and a local or remote web container. Portal Server Secure Remote Access requires Access Manager and a local web container. Portal Server Secure Remote Access also requires Portal Server, but not necessarily a local copy.

Sequencing Issues

For large deployments, you might deploy each component on a separate server, in approximately the same order shown in this example. For small deployments, components are installed in separate installation sessions on fewer servers.

In this example, the follow