test

Sun Java System Web Server 7.0 Installation and Migration Guide

Advanced Installation Options

The following procedure describes how to install the Sun Java System Web Server 7.0 in silent mode.

Installing in Silent Mode

Silent installation is a non-interactive mode that enables you to run the installer on multiple hosts using an installer configuration file (state file). To install in silent mode, generate a state file as described in Creating a State File, and then start the installation program using the --silent option (./setup --silent state_file). After the silent mode is activated, installation takes place without additional user input.

Creating a State File

The installer configuration file (state file) is created when the savestate option is used with the setup command to start an interactive installation. Settings are captured during the interactive installation and saved in a state file. This file forms the template for silent installation, which can be used to install the product on one or more systems. The state file can be modified later if necessary, as described in Changing the State File.

ProcedureTo Create a State File

  1. Navigate to the directory that contains the setup script and other installation files.

  2. Start the installation program.

    • Graphical installation mode:

      • ./setup --savestate (UNIX)

      • setup --savestate (Windows)

    • Command line installation mode:

      • ./setup --console --savestate (UNIX)

      • setup --console --savestate (Windows)

  3. Perform the installation as described in the installation steps in Installing in Graphical Mode or Installing in Command-Line Mode on UNIX and Linux.

    The state file is created and saved in the installation directory (/sun/webserver7 by default on UNIX, C:\Program Files\sun\webserver7 on Windows). The default name of the file is statefile, but the file name can be changed if desired. For information about using the state file for silent installation, see Running the Installer in Silent Mode.

Example State File

A state file on the UNIX platform might look as follows. For details about variables in the state file, see Changing the State File.

[STATE_BEGIN Sun Java System Web Server 3004128fedf19075471f3bc0422104b6ed460d76]
defaultInstallDirectory = /sun/webserver7
currentInstallDirectory = /sun/webserver7
UPGRADE = false
SELECTED_COMPONENTS = svrcore,svrcore64,admincli,devsupport,admincli_l10n,svrcore_l10n
USE_BUNDLED_JDK = true
JDK_LOCATION =
IS_ADMIN_NODE = false
STARTUP_ONBOOT = false
ADMIN_HOST = webserver.sun.com
ADMIN_SSL_PORT = 8989
ADMIN_PORT = 8800
ADMIN_UID = root
ADMIN_NAME = admin
ADMIN_PASSWD = adminadmin
NODE_HOST =
NODE_SSL_PORT =
REGISTER_NODE =
WEB_SERVERNAME = webserver.sun.com
WEB_PORT = 8080
WEB_UID = webservd
WEB_DOCROOT = /sun/webserver7/https-webserver.sun.com/docs
SIXTYFOURBIT_INSTALL = true
CONFIG_NAME = webserver.sun.com
SKIP_INSTANCE_CREATION =
[STATE_DONE Sun Java System Web Server 3004128fedf19075471f3bc0422104b6ed460d76]

Changing the State File

You can change the state file after it has been generated by editing its values and variables. The following table lists the variables in the state file, in alphabetical order.

Note –

Ensure you only edit the values and variables. The structure of the state file should not be modified.

Table 2–3 Variables in the State File

Variable Name 

Valid Values (If Applicable) 

Description 

ADMIN_PORT

0-65535 

Valid port to run the Administration Server. 

ADMIN_SSL_PORT

0–65535 

Valid port for secure connections. 

ADMIN_UID

Valid UNIX user ID 

Valid UNIX user ID to run the Administration Server. 

NODE_HOST

 

Fully qualified domain name of the computer on which you are installing the Administration Node. 

NODE_SSL_PORT

0–65535 

Valid port for secure connections. 

CONFIG_NAME

 

Default configuration name used by the Web Server to create a configuration, associate it with a node, and create an instance. The default for the Administration Server is https-config1.

IS_ADMIN_NODE

True or false 

Valid only for Administration Server and Administration Node installations; null for Administration Command Line installations. 

currentInstallDirectory

 

Specified installation directory path. 

defaultInstallDirectory

/sun/webserver7 on UNIX; C:\Program Files\Sun\WebServer7 on Windows

Default installation directory path. 

JDK_LOCATION

 

Selected Java Platform, Standard Edition (Java SETM) installation directory path.

REGISTER_NODE

True or false 

Specifies whether the Administration Node instance should be registered with the Administration Server instance at the time of installation or later. 

SELECTED_COMPONENTS

 

Comma-separated list of product components selected for installation. 

SIXTYFOURBIT_INSTALL

True or false 

Identifies a 64-bit installation. 

SKIP_INSTANCE_CREATION

True or false 

True will not create default instances.  

STARTUP_ONBOOT

True or false 

Start on system boot option. 

USE_BUNDLED_JDK

True or false 

Install the JDK bundled with the installer; if false, JDK_LOCATION cannot be empty.

WEB_DOCROOT

 

The primary document directory for the Web Server instance; if this is empty, a default document directory is created. 

WEB_PORT

0–65535 

Valid default port to run the Web Server instance server under HTTP mode. 

WEB_SERVERNAME

 

Fully qualified domain name of the computer on which the default Web Server instance is installed. 

WEB_UID

Valid UNIX user ID 

Valid UNIX user ID to use when running the default Web Server instance. 

Variables such as ADMIN_HOST ADMIN_PORT ADMIN_NAME and ADMIN_PASSWD act differently based on the configuration. The table below has more information that you have installed.

Table 2–4 Configuration for Administration Server Instance

Variable name  

Valid values (if applicable) 

Description 

ADMIN_HOST

 

Fully qualified domain name of the computer on which the Administration Server is installed 

ADMIN_PORT

0-65535 

Non-SSL port for the Administration Server 

ADMIN_NAME

 

Administrator user name for the initial server instance 

ADMIN_PASSWD

 

Administrator user password for the initial server instance, stored as plain text 

The following fields are displayed when you configure Administration Node to an Administration Server.

Table 2–5 Configuration for Administration Node Instance

Variable name 

Valid values (if applicable) 

Description 

ADMIN_HOST

 

Fully qualified domain name of the computer on which the Administration instance is installed 

ADMIN_SSL_PORT

0-65535 

SSL port for the Administration Server 

ADMIN_NAME

 

Administrator user name to log in to remote admin server 

ADMIN_PASSWD

 

Administrator user password to log into remote admin server 

Running the Installer in Silent Mode

The following procedure applies to all supported platforms.

ProcedureTo Run the Installer in Silent Mode

  1. Review the installer configuration file (state file) and verify that it contains the settings you want to use for silent installation.

  2. Copy the state file to each system on which you plan to install the Web Server software.

  3. Copy the Web Server installation files to each system on which you plan to install the Web Server software.

  4. Navigate to the directory where you copied the state file and the installation files.

  5. Start silent installation at the command line using the following syntax:

    • ./setup --silent state_file (UNIX)

    • setup --silent state_file (Windows)

    where state_file is the installer configuration file. The installer program reads thestate_file, checks for adequate disk space, and then installs the product based on the data in state_file.

    When the prompt is returned, silent installation is complete and the installation components have been installed.

Configure Later Mode (Java ES Only)

To change the configuration settings after Java Enterprise System (Java ES) installation, edit the configuration.properties file in the path install_dir/webserver7/setup/configurator.properties

Note –

Ensure you only edit the values and variables. The structure of the properties file should not be changed. Do not edit WS_IS_JES and WS_JDK_HOME values.

Table 2–6 Post Installation Configuration Settings

Variable 

Valid values (if applicable) 

Description 

WS_IS_JES

 

Set this flag to true (Java ES environment only). 

WS_JDK_HOME

 

Selected Java SE Installation directory path. 

WS_INSTALL_ROOT

 

(Required) Specify whether the default installation root should be created during installation. 

WS_INSTANCE_ROOT

 

(Required) Specify whether the default instance root should be created during installation. 

WS_DOCROOT

 

(Optional) Specify whether the default document root should be created during installation. 

WS_SERVER_NAME

 

(Required) Fully qualified domain name of the computer on which the default Java ES instance is installed. 

WS_SERVER_USER

Valid UNIX user ID 

(Required only on UNIX/Linux platforms) Valid UNIX user ID to use when running the default Java ES instance. If the Administration Server instance's runtime userID is root, the default is webservd.

WS_HTTP_PORT

0–65535  

(Required) Valid default port to run the Java ES instance server under HTTP mode. 

WS_ADMIN_SSL_PORT

0–65535 

(Required) Specify the SSL port for the Administration Server or accept the default.  

WS_ADMIN_HOST

 

(Required) Fully qualified domain name of the computer on which the Java ES Administration server is installed. 

WS_CONFIG_NAME

 

(Required) Default configuration name used by the Java ES to create a configuration and associate it with a node to create an instance. 

WS_ADMIN_SERVER_USER

 

(Required only on UNIX/Linux platforms) Valid UNIX/Linux user ID to use when running the default Java ES instance. 

WS_ADMIN_LOGIN_USER

 

(Required) Specify the administrator user name used to log in to the Administration Server.  

WS_ADMIN_LOGIN_PASSWORD

 

(Required) Specify the administrator user password used to log in to the Administration Server. 

WS_ADMIN_HTTP_PORT

0–65535 

(Optional) Non-SSL port of the Administration server. The default is 8800. 

WS_START_ON_BOOT

True or false 

(Optional) Start on system boot option. 

WS_SKIP_INSTANCE_CREATION

True or false 

(Optional) True will not create default instances. 

WS_64BIT_INSTALL

True or false 

(Optional) Identifies 64-bit installation. True will configure the server in 64 bit mode (Solaris). False will configure the server in 32 bit mode (Solaris). 

WS_ADMIN_IS_SERVER_MODE

True or false 

(Optional) True will configure server as Administration Server. False will configure server as Administration Node. 

WS_REGISTER_NODE

True or false 

(Optional) Specifies whether the Administration Node instance should be registered with the Administration Server instance at the time of installation or later. Required only if WS_ADMIN_IS_SERVER_MODE is set to false. If set to true, you must provide the name of the remote admin server host for registration.

WS_NODE_SSL_PORT

0–65535 

(Optional) SSL port of the Administration server. Required only if WS_ADMIN_IS_SERVER_MODE is set to false.

WS_NODE_HOST

 

(Optional) Fully qualified domain name of the computer on which the Administration instance is installed. 

Note –

When you configure in Configure Late Mode, you must execute configureServer script in the following location:

Solaris: install_dir/setup/configureServer

Linux/HP-UX: install_dir/setup/configureServer

Windows: jes_install_dir\webserver7\setup\

Disable Start on Boot Option

If you select Start on Boot during installation, the following scripts are created:

An asterisk * in the script name refers to the unique hashcode generated during each installation, for example webserver7–99bbdd. The script contains the variable WS_INSTANCE_ROOT which is set to 1. To disable the Start on Boot option, –-set WS_START_ONBOOT to 0

Note –

Be careful to choose the correct script for your system. Each installation includes its own script with a different hashcode.