Sun Java logo     Copyright      Index      Next     

Sun logo
Sun Java Enterprise System 2004Q2 Installation Guide 

Contents


List of Figures

List of Tables

List of Procedures

Preface
Who Should Read This Guide
Using the Documentation
Conventions
Resources on the Web
How to Report Problems
Sun Welcomes Your Comments

Chapter 1   Overview
What Is Java Enterprise System?
What Is in this Release of Java Enterprise System?
Operating Systems and Hardware Platforms
Languages
Component Products
Shared Components
How Do I Get the Java Enterprise System Software?
How Does the Java Enterprise System Installer Work?
Installer Modes
Language Selection
Installer Languages
Component Languages
Pre-existing Software Checking
Dependency Checking
Component Product Dependency Checking
Component Selection Process
Configuration Types and Parameter Setting
Uninstallation
Installation Flow

Chapter 2   Preparing for Installation
Installation Roadmap
Installation Procedures for Specific Deployment Needs
Sharing LDAP User Entries Among Component Products
High Availability Using Sun Cluster Software
Installing, Configuring, and Starting the Sun Cluster Framework
Installing and Configuring Agents and Products
Upgrading Message Queue from Platform to Enterprise Edition
32-bit Directory Server on 64-bit Solaris SPARC Platform
Portal Server on a Separate Machine from Identity Server
Identity Server on a Non-root Owned Web Server or Application Server Instance
Portal Server on a Non-root Owned Web Server or Application Server Instance
Completing Deployment of Preloaded Java Enterprise System Software
Determining Your Upgrade Needs
Component Product Dependencies
Checking for Existing Software
Verifying System Readiness
System Requirements
Access Privileges
Memory and Disk Space Requirements
Korn Shell for Portal Server on Linux
Choosing an Installation Mode
When to Choose Graphical Mode
When to Choose Text-Based Mode
When to Choose Silent Mode
Choosing a Configuration Type
When to Choose Configure Now Configuration
When to Choose Configure Later Configuration
Gathering Configuration Data
Installation Directories
Port Assignments
Next Steps

Chapter 3   Gathering Installation and Configuration Information
How to Use This Chapter
Default Values
Suggested Look-up Strategies
Installation Directories
Common Server Settings
Administration Server Configuration
Administration Server: Administration Information
Administration Server: Configuration Directory Settings Information
Application Server Configuration
Calendar Server Configuration
Communications Express Configuration
Directory Server Configuration
Directory Server: Administration Information
Directory Server: Server Settings Information
Directory Server: Configuration Directory Server Information
Directory Server: Data Storage Location Information
Directory Server: Populate Data Information
Directory Proxy Server Configuration
Directory Proxy Server: Port Selection Information
Directory Proxy Server: Server Root Information
Identity Server Configuration
Identity Server: Administration Information
Identity Server: Web Container Information
Web Container Information: Identity Server with Web Server
Web Container Information: Identity Server with Application Server
Identity Server: Services Information
Scenario 1
Scenario 2
Scenario 3
Scenario 4
Identity Server: Directory Server Information
Identity Server: Provisioned Directory Information
Existing Provisioned Directory Found
No Existing Provisioned Directory Found
Identity Server SDK Configuration
Identity Server SDK: Administration Information
Identity Server SDK: Directory Server Information
Identity Server SDK: Provisioned Directory Information
Existing Provisioned Directory Found
No Existing Provisioned Directory Found
Identity Server SDK: Web Container Information
Instant Messaging Configuration
Message Queue Configuration
Messaging Server Configuration
Portal Server Configuration
Portal Server: Web Container Information
Web Container Information: Portal Server with Web Server
Web Container Information: Portal Server with Application Server
Web Container Information: Portal Server with BEA WebLogic
Web Container Information: Portal Server with IBM WebSphere
Portal Server: Web Container Deployment
Portal Server, Secure Remote Access Configuration
Secure Remote Access Core Configuration
Single-Session Installation
Multiple Session Installation with Sun Java System Web Server or IBM WebSphere
Multiple Session Installation with Sun Java System Application Server or BEA WebLogic
Gateway Configuration
Web Container Deployment Information
Identity Server Information
Gateway Information
Certificate Information
Netlet Proxy Configuration
Web Container Deployment Information
Identity Server Information
Netlet Proxy Information
Proxy Information
Certificate Information
Rewriter Proxy Configuration
Web Container Deployment Information
Identity Server Information
Rewriter Proxy Information
Proxy Information
Certificate Information
Sun Cluster Software and Sun Cluster Agents for Sun Java System Configuration
Sun Remote Services Net Connect Configuration
Web Server Configuration
Web Server: Administration Information
Web Server: Default Web Server Instance Information
Parameters Used Only in State Files

Chapter 4   Installing Software Using the Graphical Interface
Preinstallation Checklist
Identifying Component Upgrade Needs
Running the Installer in Graphical Mode
Adding Components
Next Steps

Chapter 5   Installing Software Using the Text-Based Interface
How to Use Text-Based Mode
Preinstallation Checklist
Identifying Component Upgrade Needs
Running the Installer in Text-Based Mode
Adding Components
Next Steps

Chapter 6   Installing Software in Silent Mode
Overview of Silent Installation
Generating a State File
Editing the State File
Editing Local Parameters
Creating a Platform-Appropriate State File ID
Running the Installer in Silent Mode
Next Steps

Chapter 7   Postinstallation Configuration and Startup
Overview of Postinstallation Configuration
Configure Now Mode
Configure Later Mode
Verification of Installation and Configuration
Sun Cluster Configuration Tasks
Configuring Component Products
Path Names Used in Configuration Procedures
Administration Server Configuration
Application Server Configuration
Calendar Server Configuration
Communications Express Configuration
Directory Server Configuration
Directory Proxy Server Configuration
Identity Server Configuration
Instant Messaging Configuration
Message Queue Configuration
Messaging Server Configuration
Portal Server Configuration
Sun Remote Services Net Connect Configuration
Web Server Configuration
Starting and Stopping Component Products
Startup Sequence for Java Enterprise System
Starting and Stopping Administration Server
Starting and Stopping Application Server
Starting and Stopping Calendar Server
Starting and Stopping Directory Server
Starting and Stopping Directory Proxy Server
Starting and Stopping Identity Server
Starting and Stopping Instant Messaging
Starting Message Queue
Starting and Stopping Messaging Server
Starting and Stopping Portal Server
Starting and Stopping Portal Server Secure Remote Access
Stopping and Rebooting Sun Cluster Software
Starting and Stopping Sun Remote Services Net Connect
Starting and Stopping Web Server
Next Steps

Chapter 8   Upgrading from Java Enterprise System 2003Q4
Preparing for Upgrades
Product Dependencies
Upgrading Shared Components
Applying Patch Clusters
Upgrading J2SE Packages
Patch Contents
Administration Server Upgrade Information
Application Server Upgrade Information
Calendar Server Upgrade Information
Directory Server Upgrade Information
Upgrading From HAStorage to HAStoragePlus
Why Use HAStoragePlus
Performing the Upgrade
Directory Proxy Server Upgrade Information
Identity Server Upgrade Information
Backing up Web Container Customized Files
Upgrading Web Container Software
Running the Pre-Upgrade Script
Installing Identity Server
Running the Post-Upgrade Script
Verifying the Upgrade
Upgrading Multiple Instances of Identity Server
Instant Messaging Upgrade Information
Message Queue Upgrade Information
Messaging Server Upgrade Information
Prerequisites
Mobile Access Upgrade Information
Migration Scenarios and Strategies
Migrating Customized Environments
Differences Between Mobile Access 6.2 and Mobile Access for Java Enterprise System 2004Q2
Configuration Files
/etc/opt/SUNWma/config.properties
/etc/opt/SUNWps/MAConfig.properties
Portal Desktop Types
Client Data
Portal Server Upgrade Information
Accessing Patches for Upgrading Portal Server
Backing up Web Container Customized Files
Upgrading the Sun Web Container Software
Upgrading Identity Server
Using Third-Party Web Containers
Upgrading Portal Server
Verifying the Upgrade
Sun Cluster Upgrade Information
Upgrade Requirements and Restrictions
Choosing a Sun Cluster Upgrade Method
Nonrolling Upgrade
Rolling Upgrade
Web Server Upgrade Information
Java Enterprise System 2004Q2 Compatibility Information
Data Preservation
Configuration Preservation
API Compatibility
Protocol Compatibility
Command-Line Interfaces
Log File Compatibility
Architectural Considerations
Deprecated and End-of-Feature Items
Features Removed in This Release
Previously Deprecated or Ended Features
New Deprecation Announcements
Performance

Chapter 9   Upgrading Components from Versions Predating Java Enterprise System
Administration Server Migration Information
Application Server Migration Information
Upgrading from Application Server 7
Upgrading from Application Server 6.x
Calendar Server Migration Information
Directory Server Migration Information
Directory Proxy Server Migration Information
Upgrading from Directory Access Router 5.0 or 5.0 SP1
Preparing for Migration
Performing Migration
Recovering From a Failed Migration
Identity Server Migration Information
Upgrading from Identity Server 6.0 or 6.0 SP1
Upgrading from DSAME 5.1
Instant Messaging Migration Information
Message Queue Migration Information
Upgrading from Message Queue 3.0 Through 3.5
Upgrading from iPlanet Message Queue 2.0 or 2.0 SP1
Messaging Server Migration Information
Portal Server and Portal Server, Secure Remote Access Migration Information
Sun Cluster Migration Information
Sun Remote Services Net Connect Migration Information
Web Server Migration Information
Upgrading from Web Server 6.0
Upgrading from Web Server 4.1
Shared Component Upgrade Information
J2SE Platform Upgrade Information

Chapter 10   Uninstalling Software
Planning for Uninstallation
Overview
How Product Interdependencies Affect Uninstallation
Recognized Dependencies
Unrecognized Interdependencies
Pre-uninstallation Checklist
Reviewing the Installed Java Enterprise System Components
Administrator Access for the Uninstaller
Running the Uninstaller in Graphical Mode
Running the Uninstaller in Text-Based Mode
Running the Uninstaller in Silent Mode
Post-uninstallation Tasks
Messaging Server Tasks
sendmail Configuration
Identity Server Tasks
Sun Cluster Software and Sun Cluster Agents for Sun Java System

Chapter 11   Troubleshooting
General Troubleshooting Methods
Examine Installation Log Files
Examine Component Product Log Files
Verify Product Dependencies
Check Resources and Settings
Run Verification Procedures
Check the Distribution Media
Check Directory Server Connectivity
Remove Web Server Files and Directory
Verify Passwords
Use the prodreg or pkginfo to Examine and Uninstall Components
Verify Administrator Access
Installation Problems
Installation Fails Due to Leftover Files During Uninstallation
Cannot Configure IBM WebSphere as the Portal Server Web Container
Unexpected External Error Occurs
Graphical Installer Seems Unresponsive
Silent Installation Fails: “State File is Incompatible or Corrupted”
Silent Installation Fails
Uninstallation Problems
You Cannot Find the Uninstaller
Uninstallation Fails, Leaving Behind Files
Product Registry Is Corrupted
Uninstaller Cannot Connect to Configuration Directory Server
Component Product Troubleshooting Information
Administration Server
Application Server
Calendar Server
Communications Express
Directory Proxy Server
Directory Server
Identity Server
Instant Messaging
Message Queue
Messaging Server
Portal Server
Portal Server, Secure Remote Access
Sun Cluster Software and Sun Cluster Agents for Sun Java System
Sun Remote Services Net Connect
Web Server

Appendix A   Worksheets for Gathering Information
Common Server Settings Worksheet
Administration Server Worksheet
Application Server Worksheet
Calendar Server Worksheet
Directory Server Worksheet
Directory Proxy Server Worksheet
Identity Server Worksheets
Identity Server Deployed on Application Server
Identity Server Deployed on Web Server
Instant Messaging Worksheet
Messaging Server Worksheet
Portal Server Worksheets
Portal Server Deployed on Application Server
Portal Server Deployed on Web Server
Portal Server Deployed on BEA WebLogic Server
Portal Server Deployed on IBM WebSphere Application Server
Portal Server Secure Remote Access Worksheet
Web Server Worksheet

Appendix B   Setup Instructions for Network Installation
Appendix C   Installer Command-line Options
Java Enterprise System Installer
Java Enterprise System Uninstaller

Appendix D   Component Port Numbers
Appendix E   List of Installable Packages
Solaris Packages
Uninstaller Packages for Solaris
Solaris Packages Installed for Component Products
Administration Server
Application Server
Calendar Server
Communications Express
Directory Server
Directory Proxy Server
Identity Server
Instant Messaging
Message Queue
Messaging Server
Portal Server
Portal Server, Secure Remote Access
Sun Cluster Software and Agents
Sun Remote Services Net Connect
Web Server
Solaris Packages Installed for Shared Components
Localized Solaris Packages for Component Products
Simplified Chinese
Traditional Chinese
French
German
Japanese
Korean
Spanish
Linux Packages
Uninstaller Packages for Linux
Linux Packages Installed for Component Products
Administration Server
Application Server
Calendar Server
Communications Express
Directory Server
Directory Proxy Server
Identity Server
Instant Messaging
Message Queue
Messaging Server
Portal Server
Portal Server, Secure Remote Access
Web Server
Linux Packages Installed for Shared Components
Localized Linux Packages for Component Products
Simplified Chinese
Traditional Chinese
French
German
Japanese
Korean
Spanish

Appendix F   Distribution Directory Structure
Appendix G   Component Product Uninstallation Details
Administration Server
Application Server
Calendar Server
Communications Express
Directory Server
Directory Proxy Server
Identity Server
Instant Messaging
Messaging Server
Message Queue
Portal Server
Portal Server, Secure Remote Access
Sun Cluster
Web Server

Glossary

Index


Copyright      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.