Sun Java logo     Copyright      Index      Next     

Sun logo
Sun Java Enterprise System 2005Q1 Installation Guide 

Contents


List of Tables

List of Procedures

Preface
Who Should Use This Guide
How This Guide Is Organized
Conventions Used in This Guide
Typographic Conventions
Symbols
Shell Prompts
Related Documentation
Books in This Documentation Set
Accessing Sun Resources Online
Contacting Sun Technical Support
Related Third-Party Web Site References
Sun Welcomes Your Comments

Part I Installation Planning

Chapter 1   Installation Planning Overview
How Does the Java ES Installer Work?
Installer Modes
Language Selection
Preexisting Component Check
Dependency Check
Configuration Options and Parameter Settings
Uninstaller
What Installer Behavior Might Affect Installation Planning?
What Are the Installation Planning Tasks?
Next Steps

Chapter 2   Developing Your Installation Sequence
What Is an Installation Sequence?
What Does My Deployment Plan Call For?
Reviewing Your Deployment Architecture
Reviewing Your Implementation Specification
What Are the Key Installation Issues?
How Do Component Interdependencies Affect My Installation?
Can I Use an Existing Installation Example?
How Should I Plan Installation Sessions?
What Configuration Option Is Best?
Configure Later Option
Configure Now Option
How Many Installation Sessions Are Needed?
Single Installation Session
Multiple Installation Sessions
How Do I Survey Existing Hosts?
Is Java ES Software Preloaded on Solaris OS?
Are Incompatible Components Installed?
Component Versions Required for This Release
Using the Installer to Survey Installed Software
To Provide Access to Your Local Display for the Graphical Installer
To Use the Installer for Identifying Upgrade Issues
Are Your Hosts Ready?
System Requirements
Access Privileges
Memory and Disk Space Requirements
Korn Shell Required for Portal Server on Linux
Next Steps

Chapter 3   Example Installation Sequences
How to Use This Chapter
Single-Session Installation Examples
Evaluation Example
Access Manager and Portal Server Example
Application Server Only Example
Directory Server Only Example
Directory Proxy Server Example
Instant Messaging Only Example
Message Queue Only Example
Portal Server Secure Remote Access Example
Web Server Only Example
Solaris 10 Zones
Overview of Solaris Zones
Zones Scenarios Supported in this Release of Java ES
Java ES Limitations in Global Zones
Solaris 10 Zones Example
Sun Cluster Software Example
Phase I. Installing and Configuring the Sun Cluster Framework
Phase II. Installing and Configuring Components and Agents
Access Manager SDK With Container Configuration Example
Calendar Server and Messaging Server Example
Calendar-Messaging Schema 1 Example
Communications Express and Messaging Server Example
Instant Messaging and Access Manager Example
Communication and Collaboration Services Example
Identity Management Example
Web and Application Services Example
Portal Server Using a Remote Access Manager Example
Non-Root Examples
Access Manager Configured to Run as a Non-root User Example
Portal Server on a Non-root Owned Web Server or Application Server Instance Example

Chapter 4   Configuration Information
How to Use This Chapter
Default Values
Suggested Look-up Strategies
Common Server Settings
Access Manager Configuration Information
Access Manager: Administration Information
Access Manager: Web Container Information
Web Container Information: Access Manager with Web Server
Web Container Information: Access Manager with Application Server
Access Manager: Services Information
Installing Access Manager Core and Console
Installing Access Manager Console (Core Already Installed)
Installing Access Manager Console (Core Not Already Installed)
Installing Access Manager Federation Management (Core Already Installed)
Access Manager: Directory Server Information
Access Manager: Provisioned Directory Information
Existing Provisioned Directory Found
No Existing Provisioned Directory Found
Access Manager SDK Configuration Information
Access Manager SDK: Administration Information
Access Manager SDK: Directory Server Information
Access Manager SDK: Provisioned Directory Information
Existing Provisioned Directory Found
No Existing Provisioned Directory Found
Access Manager SDK: Web Container Information
Administration Server Configuration Information
Administration Server: Administration Information
Administration Server: Configuration Directory Settings Information
Application Server Configuration Information
Application Server: Administration Information
Application Server: Node Agent Information
Application Server: Load Balancing Plugin Information
Directory Server Configuration Information
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 Information
Directory Proxy Server: Port Selection Information
Directory Proxy Server: Server Root Information
Portal Server Configuration Information
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 Information
Secure Remote Access Core Configuration
Single-Session Installation
Multiple Session Installation with Sun Java System Web Server or IBM WebSphere Application Server
Multiple Session Installation with Sun Java System Application Server or BEA WebLogic
Gateway Configuration
Web Container Deployment Information
Access Manager Information
Gateway Information
Certificate Information
Netlet Proxy Configuration
Web Container Deployment Information
Access Manager Information
Netlet Proxy Information
Proxy Information
Certificate Information
Rewriter Proxy Configuration
Web Container Deployment Information
Rewriter Proxy Information
Proxy Information
Certificate Information
Web Server Configuration Information
Web Server: Administration Information
Web Server: Default Web Server Instance Information
Parameters Used Only in State Files

Chapter 5   Configuration Worksheets
Access Manager Worksheets
Access Manager Deployed on Application Server
Access Manager Deployed on Web Server
Administration Server Worksheet
Application Server Worksheet
Directory Server Worksheet
Directory Proxy 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

Part II Installing and Configuring

Chapter 6   Preparing for Installation
Installation Prerequisites
Getting the Java ES Software
Distribution Bundles
Making an Installation Image
To Create an Image on Your Network

Chapter 7   Installing with the Graphical Interface
Prerequisites
Running the Installer in Graphical Mode
To Begin Installation
To Select Languages for Components
To Select Components
To Resolve Dependency and Compatibility Issues
To Specify Installation Directories and Initiate the System Check
To Specify a Configuration Type
To Specify Common Server Settings
To Specify Selected Component Settings
To Confirm Installation Readiness
To Register Products and Begin Installing Software
To Complete the Installation Session
Adding Components
Next Steps

Chapter 8   Installing with the Text-Based Interface
Prerequisites
How to Use the Text-Based Interface
Running the Installer in Text-Based Mode
To Begin Installation
To Select Languages for Installation
To Select Components
To Upgrade Shared Components
To Specify Installation Directories and Initiate the System Check
To Select a Configuration Type
To Specify Configuration Data
To Confirm Installation Readiness
To Install the Software
Adding Components
Next Steps

Chapter 9   Installing in Silent Mode
Silent Installation Process
Creating a State File
Generating a State File
Editing the State File
State File Editing Guidelines
Editing Local Parameters
Creating a Platform-Appropriate State File ID
To Generate a State File ID Using the Installer
To Generate a State File ID Using Platform-Specific Distribution Files
Running the Installer in Silent Mode
To Run the Installer in Silent Mode
To Monitor the Progress of a Silent Installation
Next Steps

Chapter 10   Configuring Components After Installation
Prerequisites
Verifying Package Installation
MANPATH Setup
To Update Your MANPATH Variable
Overview of Sun Cluster Postinstallation Configuration
Sun Cluster Framework Configuration
To Configure the Sun Cluster Framework
Configure Now Option: Procedures
Configuring Access Manager After a Configure Now Installation
When Directory Server Is Provisioned With User Data
When Directory Server Is Not Yet Provisioned With User Data
To Enable the Referential Integrity Plug-in
To Add Access Manager Indexes to Directory Server
Configuring Application Server After a Configure Now Installation
Configuring Message Queue After a Configure Now Installation
Configuring Portal Server and Portal Server Secure Remote Access After a Configure Now Installation
Configuring Portal Server and Portal Server Secure Remote Access After a Configure Now Installation on a Sun Web Container
Configuring Portal Server and Portal Server Secure Remote Access After a Configure Now Installation on a Third-Party Web Container
Configure Later Option: Procedures
Configuring Access Manager After a Configure Later Installation
Configuring Administration Server After a Configure Later Installation
To Configure Administration Server After a Configure Later Installation
Configuring Application Server After a Configure Later Installation
To Configure Application Server After a Configure Later Installation
Configuring Calendar Server After a Configure Later Installation
To Configure Calendar Server After a Configure Later Installation
Configuring Communications Express After a Configure Later Installation
To Configure Communications Express After a Configure Later Installation
Configuring Directory Proxy Server After a Configure Later Installation
To Configure Directory Proxy Server After a Configure Later Installation
Configuring Directory Server After a Configure Later Installation
To Configure Directory Server After a Configure Later Installation
To Configure Directory Server in 32-bit Mode on a 64-bit Solaris SPARC Platform
Configuring HADB After a Configure Later Installation
Configuring Instant Messaging After a Configure Later Installation
Configuring Message Queue After a Configure Later Installation
Configuring Messaging Server After a Configure Later Installation
To Configure Messaging Server After a Configure Later Installation
Configuring Portal Server and Portal Server Secure Remote Access After a Configure Later Installation
Configuring Portal Server After a Configure Later Installation on a Sun Web Container
To Configure Portal Server After a Configure Later Installation on Application Server or Web Server
Configuring Portal Server After a Configure Later Installation on a Third-Party Web Container
To Configure Portal Server After a Configure Later Installation on BEA WebLogic Server or IBM WebSphere Application Server
Configuring Sun Cluster After a Configure Later Installation
Configuring Sun Cluster Agents After a Configure Later Installation
Configuring Sun Remote Services Net Connect After a Configure Later Installation
Configuring Web Server After a Configure Later Installation
To Configure Web Server After a Configure Later Installation
Sun Cluster Data Services Configuration
Administration Server Data Service
Calendar Server Data Service
Directory Server Data Service
Message Queue Data Service
Messaging Server Data Service
Web Server Data Service
Web Server Data Service for Failover
Web Server Data Service for Scalability
Data Services for Other Products
Configuring Components with Non-root Identifiers
Configuring Access Manager with Non-root ID
Configuring Administration Server with Non-root ID
Configuring Application Server with Non-root ID
Configuring Calendar Server with Non-root ID
Configuring Directory Proxy Server with Non-root ID
Configuring Directory Server with Non-root ID
Configuring Messaging Server with Non-root ID
Configuring Portal Server with Non-root ID
Configuring Web Server with Non-root ID
Next Steps

Chapter 11   Starting and Stopping Components
Prerequisite
Startup Sequence for Java ES Components
Starting and Stopping Access Manager
To Start Access Manager
To Access the Access Manager Login Page
To Stop Access Manager
Starting and Stopping Administration Server and the Server Console
To Start Administration Server
To Start Server Console
To Stop Server Console
To Stop Administration Server
Starting and Stopping Application Server
To Start Application Server Instance
To Access the Admin Console
To Stop Application Server
Starting and Stopping Calendar Server
To Start Calendar Server
To Access the Calendar Server Graphical Interface
To Stop Calendar Server
Starting and Stopping Communications Express
Starting and Stopping Directory Proxy Server
To Start Directory Proxy Server
To Stop Directory Proxy Server
Starting and Stopping Directory Server
To Start Directory Server
To Stop Directory Server
Starting and Stopping Instant Messaging Server and Multiplexor
To Start Instant Messaging Server and Multiplexor
To Stop Instant Messaging
Starting Message Queue
To Start Message Queue Message Server Broker
Starting and Stopping Messaging Server
To Start Messaging Server
To Stop Messaging Server
To Access Messenger Express
Accessing the Portal Server Desktop
To Access the Portal Server Desktop from a Sun Web Container
To Access the Portal Server Desktop from BEA WebLogic
To Access the Portal Server Desktop from IBM WebSphere
Starting and Stopping Portal Server Secure Remote Access
To Start Portal Server Secure Remote Access Gateway
To Stop Portal Server Secure Remote Access
Stopping and Rebooting Sun Cluster Software
Starting and Stopping Sun Remote Services Net Connect
Starting and Stopping Web Server
To Start Web Server Administration Server and Instance
To Access the Administration Server Graphical Interface
To Stop Web Server Administration Server and Instance
Next Steps

Chapter 12   Uninstalling Components
Prerequisites
How the Uninstaller Works
General Behavior
Handling Interdependencies
Component Dependencies from Remote Hosts
Component Dependencies Resulting from Configuration
Planning for Uninstallation
Surveying Installed Java ES Software
To Use the Uninstaller for Viewing Installed Software
To Use the Solaris prodreg Utility to View Installed Software
Reviewing Uninstallation Behavior for Java ES Components
Access Manager Uninstallation Behavior
Administration Server Uninstallation Behavior
Application Server Uninstallation Behavior
Calendar Server Uninstallation Behavior
Communications Express Uninstallation Behavior
Directory Server Uninstallation Behavior
Directory Proxy Server Uninstallation Behavior
Instant Messaging Uninstallation Behavior
Messaging Server Uninstallation Behavior
Message Queue Uninstallation Behavior
Portal Server Uninstallation Behavior
Portal Server Secure Remote Access Uninstallation Behavior
Sun Cluster Uninstallation Behavior
Web Server Uninstallation Behavior
Granting Administrator Access for the Uninstaller
Running the Uninstaller
Running the Uninstaller in Graphical Mode
To Start the Graphical Uninstaller
To Select Components to Uninstall
To Grant Administrator Access
To Confirm Uninstallation Readiness
To Complete the Uninstallation Session
Running the Uninstaller in Text-Based Mode
To Start the Uninstaller in Text-Based Mode
To Select Components for Uninstallation
To Grant Administrator Access
To Confirm Uninstallation Readiness
To Complete the Uninstallation Session
Running the Uninstaller in Silent Mode
To Generate a State File
To Edit the State File for the Hosts
To Run the Uninstaller in Silent Mode
To Monitor the Progress of a Silent Uninstallation
Uninstalling Sun Cluster Software
Post-uninstallation
Access Manager-related Post-uninstallation
Application Server Post-uninstallation
Web Server Post-uninstallation
Access Manager Post-uninstallation
Messaging Server Post-uninstallation

Chapter 13   Troubleshooting
Troubleshooting Techniques
Examine Installation Log Files
Examine Component Log Files
Verify Product Dependencies
Check Resources and Settings
Check Postinstallation Configuration
Check the Distribution Media
Check Directory Server Connectivity
Remove Web Server Files and Directory
Verify Passwords
Examine the Installed or Uninstalled Components
Verify Administrator Access
Installation Problems
Installation Fails Due to Leftover Files During Uninstallation
To Clean up a Partial Installation
Cannot Configure IBM WebSphere as the Portal Server Web Container
Check the Configuration
Create New Instances
Unexpected External Error Occurs
Graphical Installer Seems Unresponsive
Silent Installation Fails: “State File is Incompatible or Corrupted”
Generate a New State File
Create a New Platform-Appropriate ID
Silent Installation Fails
Man Pages Do Not Display
Uninstallation Problems
Cannot Find Uninstaller
Uninstallation Fails, Leaving Behind Files
To Manually Clean Up Packages
Product Registry Is Corrupted
Common Agent Container Problems
Port Number Conflicts
Compromised Security Around the Root Password
Error Notification About Lock File
Component Troubleshooting Tips
Access Manager Troubleshooting Tools
Administration Server Troubleshooting Tools
Application Server Troubleshooting Tools
Calendar Server Troubleshooting Tools
Communications Express Troubleshooting Tools
Directory Proxy Server Troubleshooting Tools
Directory Server Troubleshooting Tools
Instant Messaging Troubleshooting Tools
Message Queue Troubleshooting Tools
Messaging Server Troubleshooting Tools
Portal Server Troubleshooting Tools
Portal Server Secure Remote Access Troubleshooting Tools
Sun Cluster Software Troubleshooting Tools
Sun Remote Services Net Connect Troubleshooting Tools
Web Server Troubleshooting Tools
Additional Troubleshooting Information

Part III Installation Reference

Appendix A   Java Enterprise System Components
Selectable Components
Shared Components

Appendix B   Default Installation Directories
Appendix C   Default Port Numbers
Appendix D   Installation Commands
Installer Command
Uninstall Command

Appendix E   Example State File
Appendix F   List of Installable Packages
Solaris Packages
Uninstall Packages for Solaris OS
Solaris Packages Installed for Components
Access Manager Solaris Packages
Administration Server Solaris Packages
Application Server Solaris Packages
Calendar Server Solaris Packages
Communications Express Solaris Packages
Directory Server Solaris Packages
Directory Proxy Server Solaris Packages
HADB Solaris Packages
Instant Messaging Solaris Packages
Message Queue Solaris Packages
Messaging Server Solaris Packages
Portal Server Solaris Packages
Portal Server Secure Remote Access Solaris Packages
Sun Cluster Software and Agents Solaris Packages
Sun Remote Services Net Connect Solaris Packages
Web Server Solaris Packages
Solaris Packages Installed for Shared Components
Localized Solaris Packages for Components
Simplified Chinese Solaris Packages
Traditional Chinese Solaris Packages
French Solaris Packages
German Solaris Packages
Japanese Solaris Packages
Korean Solaris Packages
Spanish Solaris Packages
Linux Packages
Uninstall Packages for Linux
Linux Packages Installed for Components
Access Manager Linux Packages
Administration Server Linux Packages
Application Server Linux Packages
Calendar Server Linux Packages
Communications Express Linux Packages
Directory Server Linux Packages
Directory Proxy Server Linux Packages
HADB Linux Packages
Instant Messaging Linux Packages
Message Queue Linux Packages
Messaging Server Linux Packages
Portal Server Linux Packages
Portal Server Secure Remote Access Linux Packages
Web Server Linux Packages
Linux Packages Installed for Shared Components
Localized Linux Packages for Components
Simplified Chinese Linux Packages
Traditional Chinese Linux Packages
French Linux Packages
German Linux Packages
Japanese Linux Packages
Korean Linux Packages
Spanish Linux Packages

Glossary

Index


Copyright      Index      Next     

Part No: 819-0056-11.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.