C H A P T E R 8 - Installing the Java Studio Enterprise Software Using Silent Mode

C H A P T E R 8

Installing the Java Studio Enterprise Software Using Silent Mode

Silent installation is useful for installing the Java Studio Enterprise software on multiple hosts that share similar configurations. Silent installation requires that you run the installer once to capture input values in a state file. The state file contains your responses as a list of parameters, each representing a single prompt or field. You can then run the installer on many hosts, using the state file as input after editing certain host-specific values. This process propagates one configuration across multiple hosts in your enterprise.

Note - Before you create a state file, perform the same preinstallation steps that you perform for an interactive installation. See Before You Install the Java Studio Enterprise Software for details.

This chapter covers the following topics:

Guidelines for Using Silent Mode

Preparing a State File

Running the Installer in Silent Mode

Guidelines for Using Silent Mode

Follow these guidelines for successful silent installation:

Allow the installer to generate the state file, as described in Preparing a State File.

Do not manually create a state file. A state file generated by the installer uses the installer's real-time dependency checking and error reporting.

Save a copy of the state file before you make any changes to the file.

Do not modify parameters, except to edit their values.

Do not remove a parameter, even if it does not have a value.

Do not add a parameter.

Do not change the order in which parameters appear.

When editing the values, note the original type and format and maintain them as you enter the new value. For example:

If the old value starts with a leading slash, make sure that the new value starts with a leading slash.

Retain the case of the original value.

Replace any value that you delete. If you delete a required parameter, installation or configuration could fail.

Preparing a State File

To prepare a state file, you must first run the installer using command-line options to suppress actual installation.

To Prepare a State File for Microsoft Windows Platforms

1. Log in with administrator privileges.

2. In a command window, change to the directory where the installer program is located.

3. Start the installer and provide an absolute path name for the state file.

The format for the installer command is as follows:

jstudio_ent8_win.exe /r /f1"statefile"

where statefile specifies an absolute path and file name for the state file.

Note - Do not include a space between the f1 option and the opening double quotation mark of the statefile parameter. Be sure to include the double quotation marks in the command.

For example:

jstudio_ent8_win.exe /r /f1"C:\temp\SilentStateFile.iss"

4. Follow the instructions in Microsoft Windows: Installing and Starting the Java Studio Enterprise Software to complete the installation.

As you respond to the installer, it records all your input values in the state file. When you complete the installation, the state file is available in the location that you specified.

5. (Optional) Edit the szDir entry in the state file to customize the path for the Sun Java Studio Enterprise 8 installation directory.

szDir=install-path

The installation path cannot contain spaces.

6. (Optional) Edit the JDKInstallAction, JDKLocation, and JDKInstallLocation entries in the state file to customize J2SE Development Kit (JDK) installation parameters to fit your requirements.

JDKInstallAction=jdk-install-action JDKLocation=installed-jdk-path JDKInstallLocation=jdk-install-path

where

jdk-install-action defines the installation action for the JDK installation.

installed-jdk-path defines the path for the existing JDK installation.

jdk-install-path defines the installation directory for the JDK installation.

Use the following information to determine which values to use.

If an existing installation of JDK version 1.5.0_01 or higher does not exist:
JDKInstallAction=Install
JDKLocation=' '
JDKInstallLocation=jdk-install-path

If an existing installation of JDK version 1.5.0_01 or higher is corrupted:
JDKInstallAction=Repair
JDKLocation=' '
JDKInstallLocation=' '

If an installation of JDK version 1.5.0_01 or higher exists:
JDKInstallAction=' '
JDKLocation=installed-jdk-path
JDKInstallLocation=' '

Note - The notation ' ' above means single quotation mark followed by a single space followed by a single quotation mark.

To Prepare a State File for UNIX Platforms

1. In a terminal window, change to the directory where the installer program is located.

2. Start the installer, providing an absolute path name for the state file.

The format for the installer command is as follows:

install-launcher -options-record statefile

where

install-launcher is one of the following:

For Solaris OS on SPARC based systems:
jstudio_ent8_solaris-sparc.bin

For Solaris OS on x86 based systems: jstudio_ent8_solaris-x86.bin

For Linux platforms: jstudio_ent8_linux-jds.bin

statefile specifies an absolute path and file name for the state file.

For example:

jstudio_ent8_solaris-x86.bin -options-record SilentStateFile.txt

3. Do one of the following to complete the installation:

For Solaris OS platforms, follow the instructions in Solaris OS: Installing and Starting the Java Studio Enterprise Software.

For Linux platforms, follow the instructions in Linux: Installing and Starting the Java Studio Enterprise Software.

As you respond to the installer, it records all your input values in the state file. When you complete the installation, the state file is available in the location that you specified.

4. (Optional) Edit the state file to modify values.

Review the information in the state file for details.

Running the Installer in Silent Mode

You must run the installer on a machine that has the same operating system as the machine on which you generated the state file.

To Run the Silent Installer on Microsoft Windows Platforms

1. On the system where you want to install Sun Java Studio Enterprise 8, log in with the required permissions.

2. Disable desktop firewall software to avoid interference with the port assignment logic used by the installer.

3. Open a command window and change to the directory where the installer program is located.

4. Start the silent installer, providing an absolute path name for the state file.

The format for the silent installer command is as follows:

jstudio_ent8_win.exe /s /f1"statefile"

where statefile specifies an absolute path and file name for the state file.

For example:

jstudio_ent8_win.exe /s /f1"C:\temp\SilentStateFile.iss"

To Run the Silent Installer on UNIX Platforms

1. On the system where you want to install Sun Java Studio Enterprise 8, log in with the required permissions.

2. In a terminal window, change to the directory where the installer program is located.

3. Start the silent installer, providing an absolute path name for the state file.

The format for the silent installer command is as follows:

install-launcher -options statefile -silent

where

install-launcher is one of the following:

For Solaris OS on SPARC based systems:
jstudio_ent8_solaris-sparc.bin

For Solaris OS on x86 based systems: jstudio_ent8_solaris-x86.bin

For Linux platforms: jstudio_ent8_ea-linux-jds.bin

statefile specifies an absolute path and file name for the state file.

For example:

jstudio_ent8_solaris-x86.bin -options SilentStateFile.txt -silent