Sun Java System Application Server Platform Edition 9 Installation Guide

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

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

Creating the Installation Configuration File on Solaris and Linux

For the graphical method the syntax is:

./distribution_filename -savestate configuration_filename

For the command-line method, the syntax is:

./distribution_filename -console -savestate configuration_filename

If you do not include a path to the installation configuration file, the file is created in the directory where you are running the installation program.

Creating the Installation Configuration File on Windows

To create the installation configuration file on the Windows platform, start the installation program from the command line. Change to the directory where the executable file resides.

For the graphical method the syntax is:

distribution_filename -savestate configuration_filename

For the command-line method, the syntax is:

distribution_filename -console -savestate configuration_filename.

If you do not include a path to the installation configuration file, the file is created in the directory where you are running the installation program.

Installation Configuration File Example

The following example shows an installation configuration file created by running the installation program with the savestate option.

Example 1–1 Installation Configuration File

#
# Wizard Statefile created: Tue Apr 04 17:08:17 PDT 2006
#              Wizard path: /var/tmp/java_AAAocaG3p/appserv.class
#

#
# Install Wizard Statefile section for J2EE 1.4 SDK
#
#
[STATE_BEGIN J2EE 1.4 SDK b2e8342ca21cf327c40510acc9b263256d0eac49]
defaultInstallDirectory = /opt/SUNWappserver
currentInstallDirectory = /opt/SUNWappserver
INST_ASADMIN_USERNAME = admin
INST_ASADMIN_PASSWORD = nmdgvyigxssrgokyuhqzvanqzva
INST_MASTER_PASSWORD = pohuxqmnjckmaxhiwyqgunatrvg
INST_ASADMIN_PORT = 4848
INST_ASWEB_PORT = 8080
INST_HTTPS_PORT = 8181
STORE_ADMIN_AUTH = TRUE
ADMIN_PASSWORD_ENCRYPTED = TRUE
INST_JMS_PORT = 7676
INST_ORB_PORT = 3700
INST_ORB_SSL_PORT = 3820
INST_ORB_MUTUALAUTH_PORT = 3920
INST_JMX_PORT = 8686
CREATE_DESKTOP_SHORTCUT = FALSE
UPDATE_PATH = FALSE
SELECTED_ADDONS = 
[STATE_DONE J2EE 1.4 SDK b2e8342ca21cf327c40510acc9b263256d0eac49]

Modifying the Installation Configuration File

You can modify the installation configuration file by editing the variables and values described in the following table. This table has four columns showing variable names, valid values (if applicable), contents, and comments.

Table 1–1 Installation Configuration File Variables


Variable Name	Valid Values (if applicable)	Content	Comments
Build ID		The string of characters following the distribution in the STATE_BEGIN and STATE_END sections. This value is automatically generated.	No need to alter this value unless installing a different distribution file than the one that produced the configuration file. To find the build ID, enter `distribution_filename -id` at the command prompt.
`defaultInstallDirectory`		Default installation directory path
`currentInstallDirectory`		Selected absolute installation directory path
`JDK_LOCATION`		Selected JDK installation directory path	This entry is needed only for distributions that do not contain a bundled JDK.
`INST_ASADMIN_USERNAME`		Administrator user name for initial server instance
`INST_MASTER_PASSWORD`		SSL certificate database password for `asadmin` operations	This entry is obfuscated by default. See also description of `ADMIN_PASSWORD_ENCRYPTED` variable.
`INST_ASADMIN_PASSWORD`		Administrator password for initial server instance.	This entry is obfuscated by default. See also description of `ADMIN_PASSWORD_ENCRYPTED` variable.
`INST_ASADMIN_PORT`	0 - 65535	Administration server port number for initial server instance	Default value is 4848.
`INST_ASWEB_PORT`	0 - 65535	HTTP port number for initial server instance	Default value is 8080.
`INST_HTTPS_PORT`	0 - 65535	HTTPS port number for initial server instance	Default value is 8081.
`STORE_ADMIN_AUTH`	TRUE, FALSE	Whether to create admin authentication user preference file
`ADMIN_PASSWORD_ENCRYPTED`	TRUE, FALSE	Obfuscated admin password flag	In the initial statefile created by the product installer, this flag is set to TRUE, since the admin password value is obfuscated for security reasons. To override the value for admin password, enter `INST_ASADMIN_PASSWORD` value in clear text and set this flag to FALSE to enable silent installation to process it correctly.
`INST_JMS_PORT`	0 - 65535	JMS port number for initial server instance	If the configuration file does not include this entry, default value of 7676 is used.
`INST_ORB_PORT`	0 - 65535	ORB port number for initial server instance	If the configuration file does not include this entry, default value of 3700 is used.
`INST_ORB_SSL_PORT`	0 - 65535	Secure ORB port number for initial server instance	If the configuration file does not include this entry, default value of 3820 is used.
`INST_ORB_MUTUALAUTH_PORT`	0 - 65535	Mutual authentication ORB port number for initial server instance	If the configuration file does not include this entry, default value of 3920 is used.
`INST_JMX_PORT`	0 - 65535	JMX port number for initial server instance	If the configuration file does not include this entry, default value of 8686 is used.
`CREATE_DESKTOP_SHORTCUT`	TRUE, FALSE	Whether to create autodeploy folder desktop shortcut.	Valid for Windows platforms only and is disregarded otherwise.
`UPDATE_PATH`	TRUE, FALSE	Whether to update PATH environment variable to include Application Server `bin` directory.	Valid only for Windows platforms and is disregarded otherwise. If this entry is not present, default value of FALSE is used.
`CREATE_WINDOWS_SERVICE`	TRUE, FALSE	Whether to create the server as a Windows service.	Valid for Windows platforms only and is disregarded otherwise.
`SELECTED_ADDONS`	JBI	Add-ons selected for installation. If no add-ons are selected, the value is blank.	Valid for Java EE SDK SOA Starter Kit Preview installations only and is disregarded otherwise.

Using the Installation Configuration File to Install in Silent Mode

After creating the configuration file, use it to install Application Server in silent mode as many times as you want. Use the following procedure:

To Install in Silent Mode

Review the installation configuration file and verify that it contains the values to use for your silent installation.

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

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

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

Start silent installation at the command line using one of the following command formats:
- On Solaris or Linux:
  
  ./distribution_filename -silent configuration_filename
- On Windows:
  
  distribution_filename -silent configuration_filename
The installation program reads the specified configuration_filename, checks for adequate disk space, then installs the product based on the data in configuration_filename.

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

Start the Application Server software by using the instructions in the Sun Java System Application Server Platform Edition 9 Administration Guide.