Sun ONE logo      Previous      Contents      Index      Next     

Sun ONE Application Server 7 Installation Guide

Chapter 3
Installing for Development

This chapter provides instructions for installing the Sun™ Open Net Environment (Sun ONE) Application Server 7 product for development and operational purposes. You can install this non-evaluation version of the product interactively or you can use silent mode to replicate an installation scenario on multiple machines.

The following topics are addressed here:

You should be familiar with the information in "Preparing to Install" before beginning the tasks in this chapter.

For any late-breaking updates to these instructions, check the Sun ONE Application Server Release Notes. For more information about configuring your application server after installation, refer to the Sun ONE Application Server Administrator’s Guide.

The following locations contain product downloads in addition to other useful information:

What You’re Installing

In general, you are installing the basic components that provide the functionality of the Sun ONE Application Server product. You can choose not to install some of the components (indicated as optional below). Later, if you want to add a component that you initially chose not to install, you can do an incremental installation. This allows you to add a component to your installation.

Only one Sun ONE Application Server installation can reside on a single machine for a non-evaluation installation. If an installation of the Sun ONE Application Server already exists on your system, the installation program will not overwrite it, but the pre-existing installation will be detected and you will not be allowed to proceed with the installation. For instructions on removing the product from your system, refer to “Uninstalling the Sun ONE Application Server Software” on page 75.

Note

If you need to remove the Sun ONE Application Server from your system, it is important to use the uninstall program. If you attempt another method, problems will arise when you try to reinstall the same version, or when you install a new version.

The following installation components are included with the Sun ONE Application Server product:

See "Installation Components" for descriptions of the Sun ONE Application Server components.

Downloading from the Web

This section provides instructions for downloading the Sun ONE Application Server installation files from the web site.

Downloading for UNIX

  1. Select the download from the following Sun ONE Application Server download site and save it in a temporary directory on your UNIX machine.

    2. http://wwws.sun.com/software/download/app_servers.html

  2. Navigate to the directory where you downloaded the file. For example:

    3. cd /temp_dir/as7download/

  3. Unzip the .gz file using the gunzip command in this format:

    4. gunzip filename.tar.gz

  4. Untar the unzipped file using the tar -xvf command in this format:

    5. tar -xvf filename.tar

    This process may take a little time. When the files are unpacked, you will see the sun-appserver7 directory, which contains the setup file and the pkg directory.

Downloading for Microsoft Windows

The development version of Sun ONE Application Server is only available on CD for Microsoft Windows.

However, you can upgrade your evaluation license either during installation of the Microsoft Windows evaluation version, or after installation by following the instructions in “Restart the Sun ONE Application Server software.” on page 115.

Note

On Microsoft Windows—During evaluation download, you will receive an email notification providing you with a non-expiring license key (free for developer use) that you can use to upgrade your evaluation license. You will be given the opportunity to upgrade your license at the end of the Sun ONE Application Server installation process.

Installing the Development Product

The section provides instructions for installing the Sun ONE Application Server software using graphical-interface. If you choose to use the command-line interface, the steps are identical. However, in place of graphics-based installation screens, text-based screens are displayed.

Note

You must have superuser privileges to install the non-evaluation version of the Sun ONE Application Server 7 software.

The following steps apply to all platforms:

  1. Verify that you have superuser privileges and that system requirements have been met. See "System Requirements" for information on requirements.
  2. Start all the processes on your system that use ports and are expected to run at the same time as the Sun ONE Application Server software. This allows the installation program to detect what ports are in use and avoid assigning them for other purposes.
  3. If you are not in the directory already, navigate to the directory where you unpacked the installation files. You will see the setup.exe file.

    4. Note

    On UNIX—If you are installing the Sun ONE Application Server software remotely using the graphical interface, you must enable the display configuration on the machine where you are installing the product. Do this by setting the DISPLAY environment variable. DISPLAY contains the name of the server and display using this format: host_name.domain_name.com:0.0

  4. Select your installation method as follows:
    • To run the installation using the graphical interface, type the following at the command prompt (in Microsoft Windows, you can double-click the setup.exe file):

      • ./setup

    • To run the installation using the command-line interface, type:

      • ./setup -console

      The Welcome page of the installation program is displayed as follows.


      This screen capture shows the Welcome page of the installation program.

      Note

      Click the Help button to display context-sensitive information for a page.

  5. Read the Welcome page and click Next.

    6. The following License Agreement page is displayed.


    This screen capture shows the License Agreement page of the installation program.

  6. Read the License Agreement and click Yes to agree to the terms of the license, then click Next (or type Yes at the command line).

    7. Note

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

    After you accept the License Agreement, the following Select Installation Directory page is displayed.


    This screen capture shows the Select Installation directory page of the installation program.

  7. Specify the path to your Sun ONE Application Server installation directory.
    • Click Browse to browse for a directory (or press Enter at the command line to accept the default installation directory).
    • If you enter a directory name that does not already exist, the Create New Directory? dialog is displayed.
      • Click Create Directory (or type 1 at the command line) to create a new directory.
      • Click Choose New (or type 2 at the command line) to return to the Select Installation Directory page.

        • The component selection dialog box displays the available components.

  8. Choose from the components listed on the component selection dialog box (or type Yes or press Enter to accept a component from the command line).
    • Application Server
    • Sample Applications
    • PointBase 4.2
    • Application Server Administration Client
    • Support for Sun ONE Studio 4.0, Enterprise Edition
  9. Choose to install Sun ONE Message Queue 3.0.1, or use a preinstalled version.

    10. On Microsoft Windows—The required version of the Sun ONE Message Queue is always installed even if you already have another version of Sun ONE Message Queue on your system.

    On Solaris—The installation program will detect if you have the correct version of the Sun ONE Message Queue preinstalled in your system and present you with one of the following actions:

    • If the correct version of the package-based Sun ONE Message Queue is installed, it will be reused. The installation program will proceed to the next step.
    • If there is no package-based Sun ONE Message Queue installed, you can choose to let the installation program install the Sun ONE Message Queue packages automatically
    • If an incorrect version of the package-based Sun ONE Message Queue is found, a message is displayed, asking if you want to upgrade your current version or cancel. Choose one of the following options:
      • To have the installation program update your current Sun ONE Message Queue, click Upgrade (or type 1 at the command line).
      • To exit the installation program, click Cancel (or type 2 at the command line).
  10. Choose to install J2SE 1.4.1_01 or use a preinstalled J2SE.

    11. On Windows—The installation program detects if you have the correct version of the J2SE preinstalled in your machine.

    • If the correct version of the J2SE is installed, it will be reused or you can enter the path to another correct version. The installation program proceeds to the next step.
    • If there is no J2SE installed, you can choose to let the installation program install the J2SE package automatically or reuse an existing J2SE installation.

      • On Solaris—The installation program detects if you have the correct version of the J2SE preinstalled in your machine and present you with one of the following actions:

    • If the correct version of the package-based J2SE is installed, it will be reused or you can enter the path to another correct version. The installation program proceeds to the next step.
    • If there is no package-based J2SE installed, you can choose to let the installation program install the J2SE package automatically or reuse an existing J2SE installation.
    • If an incorrect version of the package-based J2SE is found, a message is displayed asking if you want to upgrade your current version or cancel. Choose one of the following options:
      • To have the installation program update your current J2SE version, click Upgrade (or type 1 at the command line).

        • Note

        Because other applications might be running and using this J2SE installation, upgrading J2SE is a potentially disruptive process. You may prefer to cancel the current installation and take care of all dependencies (such as gracefully shutting down processes).

        If you choose not to upgrade the J2SE version yourself, you can let the installation program do it.

      • To exit the installation program, click Cancel (or type 2 at the command line).

        • Before continuing with the installation, you must uninstall the J2SE currently located in /usr/j2se or upgrade it to J2SE 1.4.1_01. Then restart the Sun ONE Application Server installation. Instructions for uninstalling can be found in “Uninstalling the Sun ONE Application Server Software” on page 75.

        Note

        On UNIX—If your J2SE requires an upgrade, you will need to reboot your machine after completing the Sun ONE Application Server installation.

        Note

        The Sun ONE Application Server 7 software is certified to work with J2SE1.4.1_01 from Sun Microsystems. Third-party J2SE development kits, even with appropriate version number, are not supported.

  11. On UNIX only—Identify your server configuration directory.

    12. Enter the path to your Sun ONE Application Server configuration installation directory.

    • Click the ellipsis (...) to browse for a directory (or press Enter at the command line to accept the default installation directory).
    • If the directory does not already exist, the Create New Directory? dialog is displayed.
    • 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 UNIX only—Identify your server domains directory.

    13. Enter the path to your Sun ONE Application Server domains installation directory.

    • Click the ellipsis (...) to browse for a directory (or press Enter at the command line to accept the default installation directory).
    • If the directory does not already exist, the Create New Directory? dialog is displayed.
    • 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.

      • The following Server Configuration Information page is displayed.


      This screen capture shows the Server Configuration Information page.

  13. In the Server Configuration Information page (or at the command line), enter the following:
    • Admin User—Name of the user who administers the server (for example, admin).
    • Admin User’s Password—Password to access the Admin Server. Minimum number of characters is 8. For example, adminadmin. Re-enter the password to confirm your choice.
    • Admin Server Port—Port number to access the Admin Server.

      • A default port number is displayed (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 is displayed (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 installing as root on UNIX or are on Microsoft Windows, the initial default ports are 80 for the HTTP server and 4848 for the Admin Server.

      If these initial default ports are being actively used on your system, the installation program will suggest alternative port numbers.

  14. Enter the path of your preinstalled Sun ONE Studio 4.0, if applicable.
  15. Click Next.

    16. The installation program proceeds to verify that you have enough disk space to install the product. The Checking Disk Space progress indicator bar is displayed.

    • If you do not have enough disk space, an error message is displayed.

      • You will need to exit the installation program, create enough space, and restart the installation. Information on space requirements is contained in "Platform Requirements".

    • If you have enough disk space, a Ready to Install page similar to the following is displayed.


      • This screen capture shows the Ready to Install page.

  16. You have the following choices:
    • Click Back if you want to return to the Server Configuration Information page. Disk space is rechecked if you do this.
    • Click Install Now (or type 1 at the command line) to start the installation process.
    • Click Cancel to exit the installation program.

      • An Installation progress indicator bar is displayed.

      When installation finishes, an Installation Complete page similar to the following is displayed.


      This screen capture shows the Installation Complete page.

      You can now decide to transition (upgrade) your license.

      Note

      You cannot transition the evaluation license of the Solaris non-package-based Sun ONE Application Server software.

  17. Click Next to display the following Upgrade License page.


    18. This screen capture shows the Upgrade License page.

    If you change your mind about upgrading the license now, click Back to return to the previous screen.

    Note

    You can upgrade your license later by following the instructions in “Transitioning a License” on page 112.

  18. To upgrade your license, enter the license number and click Apply.

    19. The License Upgrade Successful dialog displays.

  19. Click OK.
  20. Click (or type) Finish to complete the installation.

    21. The About Sun ONE Application Server page is displayed.

  21. Set the PATH environment variable.

    22. You will need to configure your environment to include the bin directory of the Sun ONE Application Server. Instructions for doing this are contained in “Setting the PATH Environment Variable” on page 91.

  22. For Solaris 9 bundled only—There are additional tasks required for this type of installation. Refer to “Completing a Solaris 9 Bundled Installation” on page 69.
  23. The Sun ONE Application Server environment is not automatically started, so you will need to start it to verify that installation was successful. Instructions for various methods of starting the server are contained in “Starting and Stopping the Server” on page 95.

    24. Under the Sun Microsystems, Sun One Application Server program group in the Start Programs area of your desktop, do the following:

    1. Start Application Server.

      2. A screen similar to the following indicates that the Sun ONE Application Server has started:


      This screen capture shows the message that displays when the Application Server is started.

    2. Start Admin Console.

      3. When Administration interface (also known as the Admin Console) has been started, the initial page of the Sun ONE Application Server graphical interface is displayed.

  24. You can determine whether the Sun ONE Application Server has started successfully by accessing the application server instance's HTTP server listener. Using a browser, access the following location:

    25. http://host_name:port_number

    where port_number is the HTTP server port number specified during installation. The default HTTP server port number is 80, but it may be different based on the ports in use during installation.

Refer to for information on resolving problems.

Installing in Silent Mode (Non-Interactive)

If you choose to install the Sun ONE Application Server software in silent mode, the installation program runs without any user input. This is made possible when the installation program accesses a text file that provides the installation program with the configuration information it needs.

The following topics are discussed in this section:

How the Configuration File Is Created

The configuration file is automatically created in the installation directory during a standard interactive installation. Your user input is collected. This forms the model for the silent installation which you can use later to install the product on one or more machines.

After a standard installation is complete, a configuration file similar to following exists:

# 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]

Installing in Silent Mode

To install the Sun ONE Application Server software in silent mode, perform these steps:

  1. With a text editor, examine the current installation configuration file (called statefile) and verify that it contains what you want to use for your silent installation. You can save this file with any name. For example:

    2. cp statefile silent_config

  2. Copy the Sun ONE Application Server installation files to each machine where you plan to install the Sun ONE Application Server software.
  3. Copy your silent mode configuration file to each machine where you plan to install the Sun ONE Application Server software.
  4. If you are not in the directory already, navigate to the directory where you copied the installation files and your silent mode configuration file.
  5. As superuser, start silent installation at the command line using the following command format:

    6. ./setup -silent config_file_name

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

    When the prompt is returned, the silent installation is completed.

  6. Set the PATH environment variable.

    7. You will need to configure your environment to include the bin directory of the Sun ONE Application Server. Instructions for doing this are contained in “Setting the PATH Environment Variable” on page 91.

  7. Start the Sun ONE Application Server software.

    8. The Sun ONE Application Server is not automatically started during installation. Use the instructions on “Starting and Stopping the Server” on page 95 to start the server.

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



Previous      Contents      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.