This guide provides instructions for installing the Sun JavaTM System Application Server Platform Edition software. The following topics are discussed:
UNIX installations support both root and non-root user installations. Users of Windows installations should have Power User or Administrator access.
There are two different distribution types:
The Application Server product distribution includes the following components:
Application Server software, including administrative tools and utilities
Sun Java System Message Queue
Derby Database Server
The JavaTM 2 PlatformTM, Enterprise Edition (J2EETM) 1.4 product distribution includes the following components:
All components contained in the Application Server product distribution
JavaTM 2 Platform Edition (J2SETM) Software Development Kit (SDK)
J2EETM SDK samples, which includes BluePrints applications, such as Petstore, Adventure Builder, and SmartTicket
Use these instructions to install either distribution.
After you have verified that your system meets the requirements specified in the Sun Java System Application Server Platform Edition 8.2 Release Notes, use either of the following sets of steps to install the Application Server product.
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 j2eeskd-version-platform.bin. For example, for the Linux Application Server distribution, the file is sjsas_pe-8_2-linux.bin. For the Linux J2EE distribution, the file is j2eesdk-1_4_03–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)
Admin Port—Administration port number for default server instance
HTTP Port—Port number to access the default server instance
HTTPS Port—Secure port number to access the default server instance
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. For information about upgrading, see Chapter 3, Upgrading an Application Server Installation, in Sun Java System Application Server Platform Edition 8.2 Upgrade and Migration Guide.
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 8.2 Quick Start Guide, located in install-dir/docs/QuickStart.html or on docs.sun.com.
Navigate to the directory where you downloaded the .exe file.
The executable file name changes depending upon the distribution and version, in the format sjas_pe-version-windows.exe or j2eeskd-version-windows.exe. For example, for the Application Server distribution, the file is sjsas_pe-8_2-windows.exe. For the J2EE distribution, the file is j2eesdk-1_4_03–windows.exe.
Double click the .exe file to start the installation program.
Follow the instructions on the wizard screens of the installation program.
In the Administration Configuration page (or at the command line), enter the following:
Administrator 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—Choosing prompt means that remote asadmin commands require a user name.
Administration Port—Administration port number for default server instance.
HTTP Port—Port number to access the default server instance.
HTTPS Port—Secure port number to access the default server instance.
In the Installation Options page, select the options that you want.
If you select the “Upgrade from Previous Version” checkbox, the upgrade process begins after installation is completed. For information about upgrading, see Chapter 3, Upgrading an Application Server Installation, in Sun Java System Application Server Platform Edition 8.2 Upgrade and Migration Guide.
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 8.2 Quick Start Guide, located in install-dir/docs/QuickStart.html or on docs.sun.com.
Silent mode installation is non-interactive. You must first provide a configuration file for information that the installer needs. This section includes the following topics:
The installation configuration file is created when you use the savestate option when you start 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 filename
For the command-line method, the syntax is: ./distribution_filename -console -savestate 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 filename
For the command-line method, the syntax is: distribution_filename -console -savestate 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: Wed Nov 30 17:50:29 PST 2005 # Wizard path: /var/tmp/sjsasAAAw1a4OO/appserv.class # # # Install Wizard Statefile section for Sun Java System Application Server # # [STATE_BEGIN Sun Java System Application Server e5c7a039bcb083631fa96cc06ef f4b61f393e49e] defaultInstallDirectory = /SUNWappserver currentInstallDirectory = /opt/SUNWappserver JDK_LOCATION = /usr/j2se INST_ASADMIN_USERNAME = admin INST_ASADMIN_PASSWORD = nscsttuinhmibiayugqzvanqzva INST_MASTER_PASSWORD = pnshdkvhicjqyqsvsbxounatrvg INST_ASADMIN_PORT = 4848 INST_ASWEB_PORT = 8080 INST_HTTPS_PORT = 8181 STORE_ADMIN_AUTH = TRUE ADMIN_PASSWORD_ENCRYPTED = TRUE INST_JMS_PORT = 64289 INST_ORB_PORT = 3700 INST_ORB_SSL_PORT = 3820 INST_ORB_MUTUALAUTH_PORT = 3920 INST_JMX_PORT = 8686 CREATE_SAMPLES_DOMAIN = FALSE CREATE_DESKTOP_SHORTCUT = FALSE UPDATE_PATH = FALSE [STATE_DONE Sun Java System Application Server e5c7a039bcb083631fa96cc06ef f4b61f393e49] |
You can modify the installation configuration file by editing the variables and values described in Modifying the Installation Configuration File. This table provides 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 |
---|---|---|---|
defaultInstallDirectory |
Default installation directory path | ||
currentInstallDirectory |
Selected installation directory path | ||
JDK_LOCATION |
Selected J2SE installation directory path |
This entry is needed only for distributions that do not contain a bundled J2SE. |
|
INST_ASADMIN_USERNAME |
Administrator user name for default server instance | ||
INST_ASADMIN_PASSWORD |
Administrator password for default server instance |
This entry is obfuscated by default. See also description of ADMIN_PASSWORD_ENCRYPTED variable. |
|
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_PORT |
0 -65535 |
Administration server port number for default server instance | |
INST_ASWEB_PORT |
0 -65535 |
HTTP port number for default server instance | |
INST_HTTPS_PORT |
0 -65535 |
HTTPS port number for default server instance | |
STORE_ADMIN_AUTH |
TRUE FALSE |
Whether to create admin authentication user preference file | |
ADMIN_PASSWORD_ENCRYPTED |
TRUE FALSE |
Obfuscated admin password flag |
In initial statefile created by 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 default 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 default 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 default 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 default 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 default server instance |
If the configuration file does not include this entry, default value of 8686 is used. |
CREATE_SAMPLES_DOMAIN |
TRUE FALSE |
Whether to create additional samples server domain. | |
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. |
Once you've created the installation configuration file and modified it as needed, use it to install Application Server in silent mode.
Review the configuration file and verify that it contains the values you want to use for your silent installation.
Copy the installation configuration file to each machine where you plan to install the Application Server software.
Copy the Application Server distribution file to each machine where you plan to install the Application Server 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 config_file
On Windows: distribution_filename -silent config_file
For example:
./sjsas_pe-8_2-solaris-sparc.bin -silent myconfigfile
runs silent installation for the Solaris SPARC® Application Server distribution.
The installation program reads the specified config_file, checks for adequate disk space, then installs the product based on the data in the config_file.
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 8.2 Administration Guide.