Sun ONE Application Server 7 Installation Guide |
Chapter 1
Preparing to InstallThe Sun Open Net Environment (Sun ONE) Application Server 7 software can be distributed and installed in a number of different ways, depending on your systems, roles, and the needs of your site. This chapter explains the software components of the product, the scope and limitations of your choices, and the system requirements for the Sun ONE Application Server environment.
The following topics are addressed here:
Read the Sun ONE Application Server Release Notes for any late-breaking installation information.
For more information about configuring the Sun ONE Application Server software after installation, refer to the Sun ONE Application Server Administrator’s Guide.
The following locations contain helpful information, including Tech Notes, Forum discussions, tools and utilities, and product downloads:
About Sun ONE Application Server InstallationThe Sun ONE Application Server product is made up of a number of software components that work together to create the Sun ONE Application Server experience. There are a number of choices you can make for your installation:
- You can install the Platform Edition or the Standard Edition edition of the product.
- You can install from the product CD or from the download site.
- You can install the evaluation distribution or the development distribution of the product.
- You can install from the command-line interface or the graphical interface.
- You can install interactively or in silent mode.
This section addresses the following topics.
Installation Components
The Sun ONE Application Server installation components are described briefly in the following sections:
Sun ONE Application Server
Includes the core components of the Sun ONE Application Server software product as described in this section. For more information on Sun ONE Application Server features, refer to the Sun ONE Application Server What’s New document.
Editions
The following editions of the Sun ONE Application Server are offered to suit a variety of needs for UNIX and Microsoft Windows environments:
Platform and Standard Editions support both single machine and multi-machine, tiered deployments. While Platform Edition is limited to a single application server instance (that is, a single JVM process) per administrative domain, Standard Edition can be configured with multiple application server instances per administrative domain.
Standard Edition provides enhanced web tier support by allowing you to partition HTTP/S traffic arriving on the same web server instance to multiple application servers in the middle tier. Load balancing from the plugin is not supported in these editions. The Standard Edition evaluation version of the product has a sixty days trial period, after which it can be converted to a fully-licensed development version.
Administration
- Admin Server—Provides administration facilities (one Admin Server per domain).
- Administration interface—Graphical interface used for performing server administration tasks. Also called the Admin Console.
- Command-line interface—Performs the same tasks as the Administration interface.
- Multiple administrative domains—Mechanism that allows different administrators to create and manage their own sets of application server instances.
The Administration interface and the command-line interface are automatically installed when you install the Sun ONE Application Server component. When the Administration interface (also called the Admin Console) has been started, the initial page of the Sun ONE Application Server graphical interface is displayed.
Both the graphical and command-line administration (browser) clients allow you to manage and configure your servers and the applications hosted on them, as well as help you deploy your applications.
Full instructions for using the administration tools are contained in the Sun ONE Application Server Administrator’s Guide, the Administration interface online help, and the asadmin man pages.
Administration Client
The administration client is the separate command-line component of the Sun ONE Application Server. It is installed automatically when the Sun ONE Application Server component is installed.
You can choose to install the command-line version of this client separately on a machine where the Sun ONE Application Server is not installed. Do this by selecting only the Sun ONE Administration Client component instead of the Sun ONE Application Server component during installation.
Sun ONE Message Queue
The Sun ONE Message Queue 3.0.1 software is a production implementation of the Java Messaging Service (JMS) 1.0.2 specification. It is automatically installed when you install the Sun ONE Application Server software.
Sun ONE Message Queue consists of three primary components:
For UNIX non-package-based distributions and for all Microsoft Windows distributions, the Sun ONE Message Queue software is automatically installed with the Sun ONE Application Server software here: install_dir/imq
PointBase
PointBase 4.2 is the database supported by the Sun ONE Application Server platform. PointBase is a pure Java Relational Database Management System (RDBMS) for client-server networked applications. It provides a reliable and scalable database for e-commerce and application servers.
PointBase 4.2 is installed here: install_dir/pointbase
Sample Applications
Sun ONE Application Server includes over sixty sample applications that are available when you install the Sun ONE Application Server software. All samples come with the source, schema, Ant build scripts, and EAR files. Any existing data associated with the database-related samples is available in the database. These sample applications are categorized as follows:
- Technology samples—Introduce you to various technical aspects of the Java 2 Platform, Enterprise Edition (J2EE) specification as well as the value added features of the Sun ONE Application Server platform.
- Interoperability samples—Provide more detailed views on how these technologies come together on the Sun ONE Application Server platform.
The sample applications are installed here: install_dir/samples
More information about the samples can be obtained here:
Sun ONE Studio 4.0, Enterprise Edition for Java
Sun ONE Studio (formerly named Forte for Java Enterprise Edition 4.0) provides the ability to create and deploy Java-based web services that conform to the SOAP 1.1 specification.
The Sun ONE Application Server platform provides support for Sun ONE Studio 4.0, which means you can use the Sun ONE Application Server software with your existing Sun ONE Studio 4 installation. When installing Sun ONE Application Server, you are prompted to enter the path to your existing Sun ONE Studio 4.0 installation, if applicable.
The Sun ONE Studio 4 files are installed here: install_dir/studio4
Java 2 Software Development Kit (J2SE)
The Sun ONE Application Server product requires the J2SE 1.4.1_01 and leverages the performance and feature improvements that are part of the 1.4 platform.
During a development installation, you can choose to reuse a J2SE that is already installed on your system as long as the J2SE version is correct.
For UNIX evaluation distributions and all Microsoft Windows distributions, the J2SE is installed here: install_dir/jdk
For unbundled Solaris non-evaluation distributions and for Solaris 9 bundled distributions, the J2SE is installed here: /usr/j2se.
Installation Methods
You can install the Sun ONE Application Server software using any of three methods:
Graphical Interface Method
If you choose to use the graphical interface for installation, you are provided with a set of interactive graphical dialogs. This is the default mode when you invoke the installation program without options:
Full instructions for using the graphical interface method are contained in “Installing for Evaluation” on page 33 and “Installing the Development Product” on page 52.
Command-Line Interface Method
If you choose to the use the command-line interface for installation, the steps are the same as for the graphical-interface installation, but a graphics-capable display is not provided. To activate the interactive command-line mode, invoke the installation program using the -console option:
If you are using Telnet to access a remote server, you can use the command-line interface to install the product in an interactive fashion.
Silent Mode
You can use silent mode to perform a scripted installation based on the presence of a parameter file that was created during a standard interactive installation (either using the graphical or command-line interface). In silent mode, the Sun ONE Application Server software is installed without any interaction by you. By referring to the parameter file, the components that were installed in the interactive model are automatically installed.
Instructions for using silent mode are contained in “Installing in Silent Mode (Non-Interactive)” on page 65.
Installation Distributions of the Product
The Sun ONE Application Server offers two types of installation distributions, depending on whether your particular usage is intended for evaluation or development.
Note
Superuser privileges are required for most installation tasks, which means on UNIX you must have root privileges, and on Microsoft Windows you must have Administrator privileges.
This section discusses the following topics:
You can install the product from the product CD or as a download from the web site. The various downloads available for the Sun ONE Application Server product can be found here:
Evaluation Distribution
If you are evaluating the Sun ONE Application Server software, or taking a “try-and-buy” approach to the product, install the evaluation version of the Sun ONE Application Server software. The evaluation version of the product does not allow you to select from installable components.
By default, the following components are automatically installed in the installation root directory when you choose the evaluation product:
An evaluation license automatically expires in 60 days. On Microsoft Windows, you can upgrade this license to the non-evaluation development license. See “Licensing Information” on page 109 for instructions.
Development (Non-Evaluation) Distribution
Developers and administrators will usually use the “non-evaluation” type of installation. This installation program is available as a download or on a CD-ROM on UNIX, and from a CD-ROM on Microsoft Windows.
The following installation components are included with the Sun ONE Application Server product:
- Sun ONE Application Server, including its graphical and command-line administrative tools
- Sun ONE Application Server Administration Client (command-line tool only)
- Sun ONE Message Queue 3.0.1
- Java 2 Software Development Kit (J2SE), Standard Edition 1.4.1_01
- PointBase Database Server and Type 4 JDBC driver (Not available in the Solaris 9 bundled version of Sun ONE Application Server.)
- Sample Applications
- Support for Sun ONE Studio 4.0, Enterprise Edition for Java
This license doesn’t expire. Refer to “Licensing Information” on page 109 for further information on licensing.
A non-evaluation type of installation on UNIX is always package-based. Refer to "Packaging Models and Directory Structure" for information on the various ways the Sun ONE Application Server software can be distributed.
Installation Distribution Summary
The following table summarizes the capabilities of the evaluation and the development distributions of the product.
Packaging Models and Directory Structure
Depending on the distribution of the product installed on your system, your Sun ONE Application Server software may either be installed under a single root directory path or be spread across several root directory paths.
Bundled Installation on Solaris 9
On Solaris, when using the Solaris package-based installation of the product and when installing the Sun ONE Application Server software as part of a Solaris 9 installation, the Sun ONE Application Server software is spread across several root directories as follows:
- /usr/appserver contains static portion of the installation image. All utilities, executables and libraries that make up the application server reside in this location. Only product patches and upgrades affect this area. Subdirectories in this location include:
- /etc/appserver/ contains installation-wide configuration information such as licenses and the master list of administrative domains configured for this installation.
- /var/appserver/domains is the default area under which administrative domains are created.
Note
Because installing the Sun ONE Application Server product as part of a Solaris 9 installation does not include initial domain creation, the domain directory does not exist until the you create an initial domain. As administrative domains are created, they can be placed in any location on the system. This area acts only as the default location in which domains are created. Refer to “Creating an Administrative Domain” on page 70 for guidelines.
Package-Based Installation on UNIX
On UNIX, the package-based model installs the components as packages.
By default, when using the package-based installation of the Sun ONE Application Server product, the installation locations are spread across three directory roots in a similar fashion to the bundled installation case.
- /opt/SUNWappserver7 contains the static portion of the installation image. All utilities, executables and libraries of the Sun ONE Application Server software reside in this location.
- /etc/opt/SUNWappserver7/config contains installation-wide configuration information such as licenses and the master list of administrative domains configured for this installation.
- /var/opt/SUNWappserver7/domains is the default area under which administrative domains are created.
Note
Because installing the Sun ONE Application Server product as part of a Solaris 9 installation does not include initial domain creation, the domain directory does not exist until the you create an initial domain. As administrative domains are created, they can be placed in any location on the system. This area acts only as the default location in which domains are created. Refer to “Creating an Administrative Domain” on page 70 for more information.
Microsoft Windows and Evaluation Installations
On Microsoft Windows, and for any installation of the evaluation product (without packages), the Sun ONE Application Server installation is rooted under a single directory path. Default directories are as follows:
In these cases, the /config and /domains directories are positioned under the installation directory root.
System RequirementsThis section lists the requirements that must be met before installing the Sun ONE Application Server product.
Platform Requirements
The following table summarizes the Sun ONE Application Server requirements.
On UNIX, you can check your operating system version using the uname command. Disk space can be checked using the du command.
For the latest information about supported directory servers, web servers, web browsers, and so on, information can be found in the Sun ONE Application Server Platform Summary here:
Solaris Patches Required
For Solaris 8 systems, the following Solaris patches or their equivalents must be installed:
The patches rquired for Solaris 8 can be retrieved from the patch finder page here:
http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access
It is recommended that Solaris 8 users have the “Recommended Patch Cluster” installed, which includes the three patches required for Solaris 8 (109326-06, 108827-26, and 110934). This patch cluster is available under Patch Portal>Recommended and Security Patches here:
Before installing the Sun ONE Application Server 7, Update 1 software, the following packages must be present on your system:
The following command will display information related to the SUNWpr package if it is present on your system:
Similarly, the following command will display information related to the SUNWtls package:
If both packages are present, you must also verify that the following patches are installed:
If the SUNWpr package, the SUNWtls package, or an appropriate patch is missing, you must install the missing piece before proceeding with the Sun ONE Application Server installation. For your convenience, both the SUNWpr and SUNWtls packages as well as the 114049-03 and 114045-02 patches are available for download at this location:
To install the components, perform these steps:
- Download the nss-nspr.tar archive onto your system and untar it to any temporary location.
- Go to your_temporary_location/nss_nspr.
- To add the SUNWpr and SUNtls packages to your system, run the following command:
- To add the appropriate patch to your system, choose one:
Note
Patches 114045 and 114049 are version specific. Patch 114049 can only be applied to a Solaris 9 system, while patch 114045 can only be applied to a Solaris 8 system.
- For Solaris 8—Go to your_temporary_location/nss_nspr/solaris8 and run the following command:
- For Solaris 9—Go to your_temporary_location/nss_nspr/solaris9 and run the following command:
patchadd -d 114049-03
Other Requirements
The following additional requirements should be met before installing the Sun ONE Application Server software:
For All Platforms
- Available ports—On all platforms, you must have four unused ports available.
- You’ll assign one for the Admin Server and another for the HTTP server default instance during installation.
- The installation program will detect used ports and assign two others for you: Sun ONE Message Queue (by default, 7676), and IIOP (by default, 3700). If either of these default port numbers are in use, the installation program will assign the next available port (for example, 7677 or 7678, and so on).
- Using the uninstall program—If you need to remove the Sun ONE Application Server from your system, it is important to use the uninstall program that is installed with the Sun ONE Application Server software. If you attempt to use another method, problems will arise when you try to reinstall the same version, or when you install a new version.
For UNIX
When installing as root, note the following:
- For non-package-based versions of the product—You can install more than one Sun ONE Application Server as root as long as each installation is in a different installation directory.
- For package-based versions of the product—You can have only one installation per system. However, one non-evaluation installation can co-exist with any number of evaluation installation(s) on the same system, as long as the installation directories are different for each.
- For both evaluation and non-evaluation distributions—You can have multiple instances running within the same installation.
- Hardened operating system—This is an operating system stripped of some features for the purpose of enhancing security. Such an operating system usually doesn't allow GUI-based applications to be run in the environment. The following two libraries are required to install and use Sun ONE Application Server 7 in a hardened operating environment:
- Starting previously-installed servers—If there are previously-installed application servers or web servers on the target machine, you must start them before you begin the Sun ONE Application Server installation process. This allows the installation program to detect ports that are in use and avoid assigning them for other uses.
For Solaris Bundled
Therefore, if you fail to uniquely name your domains and instances, you may receive the following errors when starting up the second instance with the same domain or instance name:
SEVERE: JMS5024: JMS service startup failed
SEVERE: CORE5071: An error occured during initialization
To avoid these errors, see the JMS Support chapter in the Sun ONE Application Server Administrator’s Guide.
For Microsoft Windows
- Administrator privileges—You must have administrator privileges to install the Sun ONE Application Server software on Microsoft Windows. This applies to both types of installation, evaluation or non-evaluation.
- SNMP—You must install the SNMP service before you install the Sun ONE Application Server software or installation of the SNMP subagent will fail.
- Firewall or anti-virus shutdown—You must stop any firewall or anti-virus software before installing the Sun ONE Application Server software, since some of this software disables all ports by default. The Sun ONE Application Server installation program must be able to accurately determine which ports are available.
- On a given Microsoft Windows machine, you can only install one Sun ONE Application Server.
Accessing the DocumentationThe Sun ONE Application Server documentation is provided in a number of ways:
- Manuals—You can view Sun ONE Application Server manuals and release notes in HTML and in printable PDF downloads at:
- Online help—Click the Help button in the graphical interface to launch a context-sensitive help window.
- Man pages—To view man pages at the command line, you must first add install_dir/man to your MANPATH environment variable (Solaris unbundled only). After setting the variable, you can access man pages for the Sun ONE Application Server commands by typing man command_name on the command line. For example: