Chapter 1 Installing Application Server Software

This guide provides instructions for installing the Sun Java^TM System Application Server Platform Edition software. The following topics are discussed:

• What You Are Installing

• Installing the Application Server Software

• Installing in Silent Mode

UNIX installations support both root and non-root user installations. Users of Windows installations should have Power User or Administrator access.

What You Are Installing

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

• PointBase Database Server

The Java^TM 2 Platform^TM, Enterprise Edition (J2EE^TM) 1.4 product distribution includes the following components:

• All components contained in the Application Server product distribution

• Java^TM 2 Platform Edition (J2SE^TM) Software Development Kit (SDK)

• J2EE^TM SDK samples, which includes BluePrints applications, such as Petstore, Adventure Builder, and SmartTicket

Use these instructions to install either distribution.

Installing the Application Server Software

After you have verified that your system meets the requirements specified in the Sun Java System Application Server Platform Edition 8.1 2005Q4 Release Notes, use either of the following sets of steps to install the Application Server product.

To Install on UNIX or Linux

Steps

1. Navigate to the directory where you downloaded the bundle file.

2. Change the permission of the bundle file so that you have execute access:

   chmod +x bundle_filename

3. Run the installation program.

   • To run the installation program that uses a graphical interface, at the command prompt type the name of the bundle file:

     ./bundle_filename

   • To run the installation program that uses the command-line interface, at the command prompt type the name of the bundle file followed by the -console option:

     ./bundle_filename -console

4. 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)

   • 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

5. 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 the Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Upgrade and Migration Guide.

6. Set the PATH environment variable to include the Application Server install_dir /bin directory.

7. Verify the installation by following the instructions in the Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Quick Start Guide, located in install_dir/docs/QuickStart.html or online at http://docs.sun.com/ .

To Install on Windows

Steps

1. Navigate to the directory where you downloaded the .exe file.

2. Double click the .exe file to start the installation program.

3. Follow the instructions on the wizard screens of the installation program.

4. 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)

   • 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

5. 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 theSun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Upgrade and Migration Guide.

6. 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.

7. Verify the installation by following the instructions of the Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Quick Start Guide, located in install_dir/docs/QuickStart.html or at http://docs.sun.com.

Installing in Silent Mode

Silent mode installation is non-interactive. You must first provide a configuration file for information that the installer needs. The following topics are discussed:

• Creating the Installation Configuration File

• Running the Installer in Silent Mode

Creating the Installation Configuration File

The installation configuration file is created when you use the savestate option with a setup command to start a interactive installation. During the interactive installation, your input is collected and stored in the configuration file you specified. This 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.

The following topics are addressed:

• Syntax for Creating the Installation Configuration File

• Modifying the Installation Configuration File

Syntax for Creating the Installation Configuration File

The syntax for creating an installation configuration file is as follows:

For graphical method: ./bundle_filename -savestate filename

For command-line method: ./bundle_filename -console -savestate filename.

Example 1–1 Example Installation Configuration

#
# Wizard Statefile created: Mon Aug 25 19:26:08 PDT 2003
#              Wizard path: /j2ee_app_sol/appserv.class
#
# Wizard Statefile section for Sun Java System Application Server
#
[STATE_BEGIN Sun Java System Application Server a2512d6e8bdfa24acaf5e6bb5d0d46a803690279]
defaultInstallDirectory = /SUNWappserver
currentInstallDirectory = /opt/SUNWappserver
JDK_LOCATION = /share/builds/components/jdk/1.4.2/SunOS
INST_ASADMIN_USERNAME = admin
INST_ASADMIN_PASSWORD = adminadmin
INST_ASADMIN_PORT = 4848
INST_ASWEB_PORT = 8080
INST_HTTPS_PORT = 1043
INST_JMS_PORT = 7676
INST_ORB_PORT = 3700
INST_ORB_SSL_PORT = 1060
INST_ORB_MUTUALAUTH_PORT = 1061
INST_JMX_PORT = 8686
INST_POINTBASE_PORT = 9092
ADMIN_PASSWORD_ENCRYPTED = FALSE
STORE_ADMIN_AUTH = FALSE
CREATE_SAMPLES_DOMAIN = FALSE
CREATE_DESKTOP_SHORTCUT = FALSE
UPDATE_PATH = FALSE
[STATE_DONE Sun Java System Application Server a2512d6e8bdfa24acaf5e6bb5d0d46a803690279]

Modifying the Installation Configuration File

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.

Running the Installer in Silent Mode

To install the Sun Java System Application Server software in silent mode:

To Install in Silent Mode

Steps

1. Review configuration file and verify that it contains what you want to use for your silent installation.

2. Copy your installation configuration file to each machine where you plan to install the Application Server software.

3. Copy the Application Server distribution file to each machine where you plan to install the Application Server software.

4. Navigate to the directory where you copied the distribution file and your installation configuration file.

5. Start silent installation at the command line using the following command format: ./ bundle_filename -silent config_file

   The installation program reads the specified config_file, checks for adequate disk space, then installs the product based on the data in config_file.

   When the prompt is returned, the silent installation is complete and the installation components are installed on your systems.

6. Start the Application Server software by using the instructions in the Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Administration Guide

   When the Admin Console is started, the initial page of the Application Server graphical interface is displayed.