This chapter provides instructions for installing the Sun Java System Application Server Platform Edition software in the Application Server distribution. The following topics are discussed:
Solaris and Linux installations support both root and non-root user installations. Users of Windows installations should have Power User or Administrator access.
The Application Server is available in Platform, Enterprise, and Standard editions. This document covers Platform Edition.
Platform Edition is Java Platform, Enterprise Edition (Java EE) 5 compatible, lightweight, small footprint product intended for developer productivity and department-level production environments.
Enterprise Edition is designed for mission-critical services and large-scale production environments. It supports horizontal scalability and service continuity with a load balancer plug-in and cluster management. Enterprise Edition also supports reliable session state management with the high-availability database (HADB).
Standard Edition provides all the features of the Enterprise Edition except for the session state failover.
The Application Server product distribution includes the following components:
Application Server software, including administrative tools and utilities
Sun Java System Message Queue
Java DB
Use the following instructions to install all distributions.
After you have verified that your system meets the requirements specified in Hardware and Software Requirements in Sun Java System Application Server Platform Edition 9 Release Notes, use either of the following procedures to install the Application Server product.
If you are installing on a Solaris 10 system, Application Server can be installed either in the global zone or a non-global zone. For more information on zones, see the Solaris 10 documentation.
If you are installing as a non-root user, you must have read/write access to the following directories:
The installation directory you select
The home directory of the installation user
The /var/tmp directory
The /tmp directory
Navigate to the directory where you downloaded the distribution file.
Change the permission of the distribution file so that you have execute access:
chmod +x distribution_filename
The distribution file name changes depending upon the distribution, version, and platform, in the format sjas_pe-version-platform.bin or java_ee_sdk-version-platform.bin. For example, for the Linux Application Server distribution, the file is sjsas_pe-9_0-linux.bin. For the Linux Java EE SDK distribution, the file is java_ee_sdk-5-linux.bin or java_ee_sdk-5–soa_kit-preview-linux.bin.
Run the installation program.
To run the installation program that uses a graphical interface, at the command prompt, type the name of the distribution file:
./distribution_filename
To run the installation program that uses the command-line interface, at the command prompt, type the name of the distribution file followed by the -console option:
./distribution_filename -console
In the Administration Configuration page (or at the command line), enter the following:
Admin User Name – Name of the user who administers the server.
Password – Admin user’s password to access the Admin Server (8-character minimum).
Prompt or Don't Prompt for Administrator User Name – The user name can be stored in a preferences file so that you do not have to provide it to perform administrative tasks.
Admin Port – Administration port number for initial server instance.
HTTP Port – Port number to access the default server instance.
HTTPS Port – Secure port number to access the default server instance.
Enter the directory where you want to install the software.
In the Installation Options page, select the options that you want.
If you select the Upgrade from Previous Version checkbox, the upgrade wizard begins after installation is completed. Upgrades from 8.0 Platform Edition, 8.1 Platform Edition, and 8.2 Platform Edition are supported. For information about upgrading, see Chapter 3, Upgrading an Application Server Installation, in Sun Java System Application Server Platform Edition 9 Upgrade and Migration Guide.
In the Java EE SDK SOA Starter Kit Preview distribution, choose whether to install Project Open ESB Starter Kit as an add-on.
Project Open ESB Starter Kit implements an enterprise service bus (ESB) runtime that incorporates the JSR 208 specification for Java Business Integration (JBI) and other open standards. Open ESB Starter Kit allows you to integrate web services and enterprise applications as loosely coupled composite applications within a service-oriented architecture (SOA).
Open ESB Starter Kit includes a Business Process Execution Language (BPEL) service engine, a Java EE service engine, an HTTP SOAP binding component, and examples that demonstrate using the BPEL service engine. Additional components, tools, and documentation are available for download. Refer to http://java.sun.com/integration/openesb/starterkit.jsp for more information on the Open ESB Starter Kit and the additional components, tools, and documentation that are available.
On the Ready to Install page click Install Now.
After the installation completes, set the PATH environment variable to include the Application Server install-dir/bin directory.
Verify the installation by following the instructions in the Sun Java System Application Server Platform Edition 9 Quick Start Guide, located in install-dir/docs/QuickStart.html or on docs.sun.com.
If you have problems with your installation, or with starting the server, see the Sun Java System Application Server Platform Edition 9 Troubleshooting Guide.
Navigate to the directory where you downloaded the .exe file.
Double-click the .exe file to start the installation program.
The executable file name changes depending upon the distribution and version, in the format sjas_pe-version-windows.exe or java_ee_sdk-version-windows.exe. For example, for the Application Server distribution, the file is sjsas_pe-9_0-windows.exe. For the Java EE SDK distribution, the file is java_ee_sdk-5-windows.exe or java_ee_sdk-5-soa_kit-preview-windows.exe.
Follow the instructions on the wizard screens of the installation program.
In the Admin Configuration page (or at the command line), enter the following:
Admin User Name – Name of the user who administers the server.
Password – Admin user’s password to access the Admin Server (8-character minimum).
Prompt or Don't Prompt for Administrator User Name – The user name can be stored in a preferences file so that you do not have to provide it to perform administrative tasks.
Admin Port – Administration port number for initial server instance.
HTTP Port – Port number to access the default server instance.
HTTPS Port – Secure port number to access the initial server instance.
Enter the directory where you want to install Application Server.
In the Installation Options page, select the options that you want.
If you select the Upgrade from Previous Version checkbox, the upgrade wizard begins after installation is completed. Upgrades from 8.0 Platform Edition, 8.1 Platform Edition, and 8.2 Platform Edition are supported. For information about upgrading, see Chapter 3, Upgrading an Application Server Installation, in Sun Java System Application Server Platform Edition 9 Upgrade and Migration Guide.
To create a Windows service, the sc.exe utility must be available on the system. Windows 2000 users may need to install the Windows 2000 Resource Kit to get this utility. For other supported Windows versions, the utility is included in the operating system.
In the Java EE SDK SOA Starter Kit Preview distribution, choose whether to install Project Open ESB Starter Kit as an add-on.
Project Open ESB Starter Kit implements an enterprise service bus (ESB) runtime that incorporates the JSR 208 specification for Java Business Integration (JBI) and other open standards. Open ESB Starter Kit allows you to integrate web services and enterprise applications as loosely coupled composite applications within a service-oriented architecture (SOA).
Open ESB Starter Kit includes a Business Process Execution Language (BPEL) service engine, a Java EE service engine, an HTTP SOAP binding component, and examples that demonstrate using the BPEL service engine. Additional components, tools, and documentation are available for download. Refer to http://java.sun.com/integration/openesb/starterkit.jsp for more information on the Open ESB Starter Kit and the additional components, tools, and documentation that are available.
On the Ready to Install page choose Install Now.
After the installation completes, if you did not select the corresponding option on the Installation Options screen, set the PATH environment variable to include the Application Server install-dir/bin directory.
Verify the installation by following the instructions of the Sun Java System Application Server Platform Edition 9 Quick Start Guide, located in install-dir/docs/QuickStart.html or on docs.sun.com.
If you have problems with your installation, or with starting the server, see Sun Java System Application Server Platform Edition 9 Troubleshooting Guide.
Silent mode installation is non-interactive. You must first provide a configuration file for information that the installer needs. The following topics are discussed:
The installation configuration file is created when you use the savestate option when starting an interactive installation. During the interactive installation, your input is collected and stored in the configuration file you specified. This file forms the template for silent installation, which you can use later to install the product on one or more machines. If needed, you can modify the installation configuration file.
For the graphical method the syntax is:
./distribution_filename -savestate configuration_filename
For the command-line method, the syntax is:
./distribution_filename -console -savestate configuration_filename
If you do not include a path to the installation configuration file, the file is created in the directory where you are running the installation program.
To create the installation configuration file on the Windows platform, start the installation program from the command line. Change to the directory where the executable file resides.
For the graphical method the syntax is:
distribution_filename -savestate configuration_filename
For the command-line method, the syntax is:
distribution_filename -console -savestate configuration_filename.
If you do not include a path to the installation configuration file, the file is created in the directory where you are running the installation program.
The following example shows an installation configuration file created by running the installation program with the savestate option.
# # Wizard Statefile created: Tue Apr 04 17:08:17 PDT 2006 # Wizard path: /var/tmp/java_AAAocaG3p/appserv.class # # # Install Wizard Statefile section for J2EE 1.4 SDK # # [STATE_BEGIN J2EE 1.4 SDK b2e8342ca21cf327c40510acc9b263256d0eac49] defaultInstallDirectory = /opt/SUNWappserver currentInstallDirectory = /opt/SUNWappserver INST_ASADMIN_USERNAME = admin INST_ASADMIN_PASSWORD = nmdgvyigxssrgokyuhqzvanqzva INST_MASTER_PASSWORD = pohuxqmnjckmaxhiwyqgunatrvg INST_ASADMIN_PORT = 4848 INST_ASWEB_PORT = 8080 INST_HTTPS_PORT = 8181 STORE_ADMIN_AUTH = TRUE ADMIN_PASSWORD_ENCRYPTED = TRUE INST_JMS_PORT = 7676 INST_ORB_PORT = 3700 INST_ORB_SSL_PORT = 3820 INST_ORB_MUTUALAUTH_PORT = 3920 INST_JMX_PORT = 8686 CREATE_DESKTOP_SHORTCUT = FALSE UPDATE_PATH = FALSE SELECTED_ADDONS = [STATE_DONE J2EE 1.4 SDK b2e8342ca21cf327c40510acc9b263256d0eac49] |
You can modify the installation configuration file by editing the variables and values described in the following table. This table has four columns showing variable names, valid values (if applicable), contents, and comments.
Table 1–1 Installation Configuration File Variables
Variable Name |
Valid Values (if applicable) |
Content |
Comments |
---|---|---|---|
Build ID |
The string of characters following the distribution in the STATE_BEGIN and STATE_END sections. This value is automatically generated. |
No need to alter this value unless installing a different distribution file than the one that produced the configuration file. To find the build ID, enter distribution_filename -id at the command prompt. |
|
defaultInstallDirectory |
Default installation directory path | ||
currentInstallDirectory |
Selected absolute installation directory path | ||
JDK_LOCATION |
Selected JDK installation directory path |
This entry is needed only for distributions that do not contain a bundled JDK. |
|
INST_ASADMIN_USERNAME |
Administrator user name for initial server instance | ||
INST_MASTER_PASSWORD |
SSL certificate database password for asadmin operations |
This entry is obfuscated by default. See also description of ADMIN_PASSWORD_ENCRYPTED variable. |
|
INST_ASADMIN_PASSWORD |
Administrator password for initial server instance. |
This entry is obfuscated by default. See also description of ADMIN_PASSWORD_ENCRYPTED variable. |
|
INST_ASADMIN_PORT |
0 - 65535 |
Administration server port number for initial server instance |
Default value is 4848. |
INST_ASWEB_PORT |
0 - 65535 |
HTTP port number for initial server instance |
Default value is 8080. |
INST_HTTPS_PORT |
0 - 65535 |
HTTPS port number for initial server instance |
Default value is 8081. |
STORE_ADMIN_AUTH |
TRUE, FALSE |
Whether to create admin authentication user preference file | |
ADMIN_PASSWORD_ENCRYPTED |
TRUE, FALSE |
Obfuscated admin password flag |
In the initial statefile created by the product installer, this flag is set to TRUE, since the admin password value is obfuscated for security reasons. To override the value for admin password, enter INST_ASADMIN_PASSWORD value in clear text and set this flag to FALSE to enable silent installation to process it correctly. |
INST_JMS_PORT |
0 - 65535 |
JMS port number for initial server instance |
If the configuration file does not include this entry, default value of 7676 is used. |
INST_ORB_PORT |
0 - 65535 |
ORB port number for initial server instance |
If the configuration file does not include this entry, default value of 3700 is used. |
INST_ORB_SSL_PORT |
0 - 65535 |
Secure ORB port number for initial server instance |
If the configuration file does not include this entry, default value of 3820 is used. |
INST_ORB_MUTUALAUTH_PORT |
0 - 65535 |
Mutual authentication ORB port number for initial server instance |
If the configuration file does not include this entry, default value of 3920 is used. |
INST_JMX_PORT |
0 - 65535 |
JMX port number for initial server instance |
If the configuration file does not include this entry, default value of 8686 is used. |
CREATE_DESKTOP_SHORTCUT |
TRUE, FALSE |
Whether to create autodeploy folder desktop shortcut. |
Valid for Windows platforms only and is disregarded otherwise. |
UPDATE_PATH |
TRUE, FALSE |
Whether to update PATH environment variable to include Application Server bin directory. |
Valid only for Windows platforms and is disregarded otherwise. If this entry is not present, default value of FALSE is used. |
CREATE_WINDOWS_SERVICE |
TRUE, FALSE |
Whether to create the server as a Windows service. |
Valid for Windows platforms only and is disregarded otherwise. |
SELECTED_ADDONS |
JBI |
Add-ons selected for installation. If no add-ons are selected, the value is blank. |
Valid for Java EE SDK SOA Starter Kit Preview installations only and is disregarded otherwise. |
After creating the configuration file, use it to install Application Server in silent mode as many times as you want. Use the following procedure:
Review the installation configuration file and verify that it contains the values to use for your silent installation.
Copy your installation configuration file to each machine where you plan to install the software.
Copy the Application Server distribution file to each machine where you plan to install the software.
Navigate to the directory where you copied the distribution file and your installation configuration file.
Start silent installation at the command line using one of the following command formats:
On Solaris or Linux:
./distribution_filename -silent configuration_filename
On Windows:
distribution_filename -silent configuration_filename
The installation program reads the specified configuration_filename, checks for adequate disk space, then installs the product based on the data in configuration_filename.
When the prompt is returned, the silent installation is complete and the installation components are installed on your systems.
Start the Application Server software by using the instructions in the Sun Java System Application Server Platform Edition 9 Administration Guide.