Sun ONE logo     Previous      Contents      Index      Next     
Sun ONE Application Server 7, Standard Edition Installation Guide



Installing for Development and Operations

This section describes how to install the Sun ONE Application Server for development and operations on Windows and Unix platforms. It contains the following information:

Read this chapter before installing Sun ONE Application Server. For any late-breaking updates to these instructions, check the Release Notes.

For more information about configuring your application server after installation, refer to the Sun ONE Application Server 7 Administrator's Guide.

What You're Installing

The non-evaluation version of the Sun ONE Application Server installation program allows you to choose to install the following components:

  • Sun ONE Application Server 7

  • PointBase Database Server (not available in the Solaris 9 bundled version of Sun ONE Application Server) and Type 4 JDBC Driver

  • Sample applications

  • Support for Sun ONE Studio 4, Enterprise Edition for Java

  • Sun ONE Application Server Administration Client (command-line tool)

Depending on what software you have currently installed on your machine, you may also install J2SE 1.4.0_02, SDK.

See Installable Components for an overview of Sun ONE Application Server features and components.

Installing in Interactive Mode

The following steps enable you to install Sun ONE Application Server 7 using graphical-interface mode. If you choose to use command-line installation instead, the steps involved in that method are identical. In place of graphics-based installation screens, text-based screens are shown during a console-based installation.

The following steps apply to all platforms:


Note

You must have administrative privileges on your Windows machine to install Sun ONE Application Server 7. You cannot install more than one Sun ONE Application Server on a single Windows machine.

  1. Expand or unzip the installation bundle to a temporary directory.


    2. Note

    It is not recommended that you use gnu tar to extract the files. Use /bin/tar/ or /usr/bin/tar/ instead.


  2. If you are not in the directory already, change to the directory where you expanded the files.


    3. Note

    UNIX: If you are installing Sun ONE Application Server remotely in graphical-interface mode, you must enable the display configuration on the machine where you are installing the product.

  3. Type the following at the command prompt:

    4. #./setup

    To run command-line installation, type

    #./setup -console

    On Windows, you can also navigate using Windows Explorer to the directory where you expanded the files and double-click the setup file.

    The installation interface appears.

  4. Read the Welcome screen and click Next or hit Enter at the command line.

  5. Read the License Agreement, select the radio button or type Yes to agree to the terms of the license, and click Next or hit Enter at the command line.

    6. You must accept the license agreement to continue with the installation.

  6. Enter the path to your Sun ONE Application Server installation directory, click the ellipsis (...) to browse for a directory, or hit Enter at the command line to accept the default installation directory.

    7. If the directory does not already exist, the Create New Directory? dialog appears. Click Create Directory or type 1 at the command line. You can also click Choose New or type 2 at the command line to select an existing directory.

  7. Choose from the components listed on the component selection dialog box. (For command-line installation, type Yes or hit Enter to accept a component.)

    • Application Server

      • Sample Applications

      • PointBase 4.2

    • Application Server Administration Client (command-line tool)

    • Support for Sun ONE Studio 4.0, Enterprise Edition

    See Installable Components for more information about these components.

  8. Choose to install J2SE 1.4.0_02 SDK or use a preinstalled J2SE SDK.

  9. On Solaris only: Next, the installer will detect if you have the correct version of the J2SE SDK preinstalled in your machine's /usr/j2se directory and present you with one of the following actions:

    • If the correct version of the J2SE SDK is installed, the installation program proceeds to the next step.

    • If there is no J2SE SDK installed in /usr/j2se, you can choose to install the J2SE packages automatically or reuse an existing J2SE installation.

    • If an incorrect version of the J2SE SDK is found in /usr/j2se, then a message appears, asking if you want to upgrade your current version or cancel (exit the application server installation program).

      • Choose one of the following options:

      • Click Upgrade or type 1 at the command line to update your current installation.

      • Click Cancel or type 2 at the command line to exit the installation program.

      You must then uninstall the SDK currently located in /usr/j2se and restart the application server installation when you have uninstalled the outdated SDK.


      Note

      If your SDK requires an upgrade, it is recommended that you reboot your Solaris machine after completing the application server installation.


      Note

      Sun ONE Application Server 7 is certified to work with J2SE1.4.0_02 or higher from Sun Microsystems. Third-party J2SE development kits, even with appropriate version number, are not supported.

  10. On Solaris, enter the path to your Sun ONE Application Server configuration installation directory, click the ellipsis (...) to browse for a directory, or hit Enter at the command line to accept the default directory.

    11. If the directory does not already exist, the Create New Directory? dialog appears. Click Create Directory or type 1 at the command line. You can also click Choose New or type 2 at the command line to select an existing directory.

  11. On Solaris, enter the path to your Sun ONE Application Server domains installation directory, click the ellipsis (...) to browse for a directory, or hit Enter at the command line to accept the default directory.

    12. If the directory does not already exist, the Create New Directory? dialog appears. Click Create Directory or type 1 at the command line. You can also click Choose New or type 2 at the command line to select an existing directory.

  12. On the Server Configuration Information dialog box, enter the following:

    • Admin User: Name of the user who administers the server (for example, admin).

    • Admin User's Password: Password to access the administration server. Minimum number of characters is 8. Re-enter the password in the text box below to confirm your choice.

    • Admin Server Port: Port number to access the administration server.

      • A default port number appears (for example 4848, if that port is not in use on your machine). Change the default number if necessary. The installation program will check port numbers for validity and availability when you click Next.

    • HTTP Server Port: Port number to access the default server instance.

      • A default port number appears (for example 1024, if that port is not in use on your machine). Change the default number if necessary. The installation program will check port numbers for validity and availability when you click Next.


      Note

      The installation program automatically detects ports in use and suggests currently unused ports for the default settings. By default, if you are running as root on UNIX or are on Windows, the initial default ports are 80 and 4848 for the HTTP server and administrative server respectively. If you are running as non-root on UNIX, the HTTP server port defaults to 1024. If any of these initial default ports are being actively used on your system, the installation program will suggest alternative port numbers.

  13. Enter the path of your preinstalled Sun ONE Studio 4.0, if applicable.

  14. The Checking Disk Space dialog box appears.

  15. Click Install Now to complete the installation.

    16. An Installation Progress indicator bar appears.

    As installation ends, the Installation Complete screen appears.

  16. You can now decide to upgrade your license.

    17. See Licensing Information for details, visit http://www.sun.com/as7upgrade to obtain a license key for upgrade.

  17. Click or type Yes to upgrade your license, or choose No to complete the installation of the application server without upgrading your license.

    18. You can upgrade your license later by following the instructions in Licensing Information.

Installing in Silent Mode

During Silent installation, the installation program runs without any user input. A text file called a statefile provides the installer with the information needed to install the product. Before using Silent installation, you must perform a model installation using an interactive mode of install. Your user input is collected in the statefile during this model installation and used to install the product silently later on one or more machines.

The procedure below describes how to perform a model installation and subsequently use the statefile to install the product silently.

Creating the Statefile

Each time the product is installed, a statefile is created in the installation directory to collect user input. To create this statefile, follow the installation procedure as described in Installing in Interactive Mode, keeping in mind that your input is saved to the statefile for future installations.

When installation is complete, a statefile is created similar to the one shown in the following text box:

#
# Wizard Statefile created: Tue Sep 03 11:03:27 PDT 2002
# Wizard path: /temp_dir/sun-appserver7//temp_dir/sun-appserver7/appserv.class
#

#
# Wizard Statefile section for Sun ONE Application Server
#
[STATE_BEGIN Sun ONE Application Server 808daad84da2817ce79da504cae4c78ffb57d50e]
defaultInstallDirectory = /opt/SUNWappserver7
currentInstallDirectory = /opt/SUNWappserver7
SELECTED_COMPONENTS = Java 2 SDK, Standard Edition 1.4.0_02#Application Server#Sun ONE Message Queue 3.0.1#Sample Applications#PointBase Server 4.2#Uninstall#Startup
USE_BUNDLED_JDK = TRUE
JDK_LOCATION = /usr/j2se
JDK_INSTALLTYPE = PREINSTALLED
AS_INSTALL_DEFAULT_CONFIG_DIR = /etc/opt/SUNWappserver7
AS_INSTALL_CONFIG_DIR = /etc/opt/SUNWappserver7
AS_INSTALL_DEFAULT_VAR_DIR = /var/opt/SUNWappserver7
AS_INSTALL_VAR_DIR = /var/opt/SUNWappserver7
DOMAINS_DIR = /var/opt/SUNWappserver7/domains
INST_ASADMIN_USERNAME = admin
INST_ASADMIN_PASSWORD = password
INST_ASADMIN_PORT = 4848
INST_ASWEB_PORT = 80
AS_INSTALL_DEFAULT_STUDIO_DIR = /
AS_INSTALL_STUDIO_DIR = /
INSTALL_STATUS = SUCCESS
[STATE_DONE Sun ONE Application Server 808daad84da2817ce79da504cae4c78ffb57d50e]

Using the Statefile for Silent Installation

Before you being this procedure, you must complete the steps in the previous section, Creating the Statefile.

  1. Unbundle the Sun ONE Application Server installation files to each machine where you plan to install Sun ONE Application Server.

  2. Copy the statefile to each machine where you plan to install the server.

  3. If you are not in the directory already, change to the directory where you unbundled the installer files and copied your statefile.

  4. Type the following at the command prompt:

    5. #./setup -silent statefile_name.

The installer reads the specified statefile, checks for adequate disk space, then installs the product based on the data in the statefile. No further user interaction is required.

Uninstalling the Application Server

See Uninstalling Sun ONE Application Server.

Previous      Contents      Index      Next     
Copyright 2002 Sun Microsystems, Inc. All rights reserved.

Last Updated October 04, 2002