Sun ONE Application Server 7 Installation Guide |
Chapter 3
Installing for DevelopmentThis chapter provides instructions for installing the Sun Open Net Environment (Sun ONE) Application Server Upgrade 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:
http://wwws.sun.com/software/download/app_servers.html
http://wwws.sun.com/software/products/appsrvr/home_appsrvr.html
What You’re InstallingIn 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".
The following installation components are included with the Sun ONE Application Server product:
- Sun ONE Application Server, including its graphical and command-line administrative tools
- Sun ONE Application Server Administration Client (command-line tool only)
- Sun ONE Message Queue
- Java 2 Software Development Kit (J2SE)
- PointBase Database Server and Type 4 JDBC driver (Not available in the Solaris 9 bundled version of Sun ONE Application Server.)
- Sample Applications
- Support for Sun ONE Studio (Not available for Solaris x86.)
See "Installation Components" for descriptions of the Sun ONE Application Server components.
Downloading from the WebThis section provides instructions for downloading the Sun ONE Application Server installation files from the web site.
Downloading for UNIX
- Select the download from the following Sun ONE Application Server download site and save it in a temporary directory on your UNIX machine.
http://wwws.sun.com/software/download/app_servers.html
- Navigate to the directory where you downloaded the file. For example:
cd /temp_dir/as7download/
- Unzip the .gz file using the gunzip command in this format:
gunzip filename.tar.gz
- Untar the unzipped file using the tar -xvf command in this format:
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.
Installing the Development ProductThe 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 software.
The following steps apply to all platforms:
- Verify that you have superuser privileges and that system requirements have been met.
- 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.
- Navigate to the directory where you unpacked the installation files.
On UNIX systems terminal window, type: ./setup
- On Microsoft Windows systems, you will see the setup.exe file.
- Select your installation method as follows:
- Read the Welcome page and click Next.
- 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).
- Specify the path to your Sun ONE Application Server installation directory.
- 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).
- Choose to install Sun ONE Message Queue, or use a preinstalled version.
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:
- Choose to install J2SE or use a preinstalled J2SE.
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 Linux—The installation program will detect if you have the correct version of the J2SE SDK preinstalled in your machine and present you with one of the following actions:
- If the correct version of the package-based J2SE SDK is installed, it will be reused. The installation program proceeds to the next step.
- If there is no package-based J2SE SDK installed, you can choose to let the installation program install the package-based J2SE SDK automatically or reuse an existing one.
- If an incorrect version of the package-based J2SE SDK is found, it is ignored. The correction version of the package-based J2SE SDK is installed.
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).
- 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 the currently supported J2SE. Then restart the Sun ONE Application Server installation. Instructions for uninstalling can be found in "Uninstalling the Sun ONE Application Server Software".
Note
On UNIX—If your J2SE requires an upgrade, you will need to reboot your machine after completing the Sun ONE Application Server installation.
- On UNIX only—Identify your server configuration directory.
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.
- On UNIX only—Identify your server domains directory.
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.
- In the Server Configuration Information page (or at the command line), enter the following:
- Admin User—Name of the user who administers the server
- Admin User’s Password—Password to access the Admin Server (min 8 characters)
- 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). 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). The installation program will check port numbers for validity and availability when you click Next.
- Enter the path of your preinstalled Sun ONE Studio, if applicable.
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.
- At the Ready to Install page, 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 is displayed. You can now decide to transition (upgrade) your license.
- Click Next to display the Upgrade License page.
You can upgrade your license later by following the instructions in "Transitioning a License".
- To upgrade your license, enter the license number and click Apply.
- Click OK.
- Click (or type) Finish to complete the installation.
The About Sun ONE Application Server page is displayed.
- Set the PATH environment variable.
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 the Sun ONE Application Administrator’s Guide.
- For Solaris 9 bundled only—There are additional tasks required for this type of installation. Refer to "Completing a Solaris 9 Bundled Installation".
- 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 the Sun ONE Application Administrator’s Guide.
On UNIX systems, run the asadmin start-domain command.
On Microsoft Windows systems, under the Sun Microsystems, Sun One Application Server program group in the Start Programs area of your desktop, do the following:
- Start Application Server.
A Sun ONE Application Server screen is dispalyed indicating that the Sun ONE Application Server has started.
- Start Admin Console.
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.
- 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:
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 Chapter 7, "Troubleshooting," 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 Jan 02 11:03:27 PDT 2004
# 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 #Application Server#Sun ONE Message Queue #Sample Applications#PointBase Server #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:
- 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:
cp statefile silent_config
- Copy the Sun ONE Application Server installation files to each machine where you plan to install the Sun ONE Application Server software.
- Copy your silent mode configuration file to each machine where you plan to install the Sun ONE Application Server software.
- If you are not in the directory already, navigate to the directory where you copied the installation files and your silent mode configuration file.
- As superuser, start silent installation at the command line using the following command format:
./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.
- Set the PATH environment variable.
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 the Sun ONE Application Administrator’s Guide.
- Start the Sun ONE Application Server software.
The Sun ONE Application Server is not automatically started during installation. Use the instructions in the Sun ONE Application Administrator’s Guide to start the server.
When the Admin Console has been started, the initial page of the Sun ONE Application Server graphical interface is displayed.