Installation Guide

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Running the Installation Program in Silent Mode

The following sections describe how to run the installation program in silent mode:

 


What Is Silent-Mode Installation?

Silent-mode installation is a way of setting installation configurations only once and then using those configurations to duplicate the installation on many machines. During installation in silent mode, the installation program reads the settings for your configuration from an XML file that you create prior to beginning the installation. The installation program does not display any configuration options during the installation process. Silent-mode installation works on both Windows and UNIX systems. Using silent-mode installation implies that you consent to the BEA License Agreement. You neither see a copy of the BEA Software License Agreement nor have any means of accepting the terms of the agreement.

The instructions in this section are based on the assumption that you have already acquired the installation program, either on CD or from the BEA Web site.

 


Using Silent-Mode Installation: Main Steps

The silent-mode installation process has two primary steps:

  1. Create a silent.xml file that defines the configuration settings normally entered by a user during an interactive installation process, such as graphical-mode or console-mode installation. For example, values for the installation directory, the product directory, and the components to be installed are supplied in a silent.xml file.
  2. For a detailed procedure, see Creating a silent.xml File for Silent-Mode Installation. For a sample silent.xml file, see Sample silent.xml File for Silent-Mode Installation.

  3. Start the silent-mode installation process using the values specified in the silent.xml file.
  4. For details on starting the installation in silent mode, see Starting the Installation Program.

Important Considerations for Silent-Mode Installation

When you are performing an installation in silent mode, keep in mind the following considerations:

 


Creating a silent.xml File for Silent-Mode Installation

When you install your BEA software in silent mode, the installation program uses an XML file (silent.xml) to determine which installation options should be implemented. Therefore, before you can run the installation program in silent mode, you must first create a silent.xml file in which you specify the installation options that you want to have invoked.

Note: Incorrect entries in the silent.xml file can cause installation failures. To help you determine the cause of a failure, we recommend that you create a log file when you start the installation.

The silent.xml file is generated via the graphical installer. To create a silent.xml file for use in the silent mode installation process, run the graphical installer and include the following parameter:

-p:registry:saveProperties=<filename>

As you run the installation process via the graphical installer, all your customized configuration settings are automatically stored in your specified silent.xml file.

An example on how to run with this setting is:

java -jar BEA-aqualogic-service-registry-2.1.0.jar -p:registry:saveProperties=<filename>

For more details, see Starting in Graphical Mode.

The silent mode file is saved in BEA-style XML format.

When doing silent install, (-mode=silent), the silent file is passed using BEA standard switch:

silent_xml=<filename> 

For more details, see Starting in Silent Mode.

After the silent.xml file is generated on your system following the procedure described above, you can edit values in the XML file for running silent installs in different target environments as needed.

 


Sample silent.xml File for Silent-Mode Installation

The following listing is an example of a silent.xml file

Note: This silent.xml file is a sample only and will not work as the basis for your silent mode installations. Please follow the directions in Creating a silent.xml File for Silent-Mode Installation to create an appropriate silent.xml file.
Listing 5-1 Sample Silent.xml File
<?xml version="1.0" encoding="UTF-8" ?>
<!--  Silent installer option: -mode=silent -silent_xml=silent.xml-->
<bea-installer>
    <input-fields>
        <data-value name="BEAHOME" value="d:\alsr21" />
        <data-value name="USER_INSTALL_DIR" value="d:\alsr21" />
        <data-value name="registry.bea.home" value="d:\alsr21" />
        <data-value name="registry.install.server.admin.mail" value="akg@bea.com" />
        <data-value name="registry.install.server.admin.password" value="testinstall" />
        <data-value name="registry.install.server.admin.password.confirmation" value="testinstall" />
<data-value name="registry.localhost" value="akg.bea.com" />
        <data-value name="registry.porting.hostname" value="akg.bea.com" />
        <data-value name="registry.porting.weblogic.admin.password" value="weblogic" />
        <data-value name="registry.porting.weblogic.bea.home" value="D:\bea" />
        <data-value name="registry.porting.weblogic.home" value="D:\bea\weblogic91" />
        <data-value name="registry.porting.weblogic.java.home" value="D:\bea\jrockit90_150_04" />
    </input-fields>
</bea-installer>

 


Returning Exit Codes to the Console

When run in silent mode, the installation program generates exit codes that indicate the success or failure of the installation. These exit codes are shown in the following table.

Table 5-1 Exit Codes
Code
Description
0
Installation completed successfully
-1
Installation failed due to a fatal error
-2
Installation failed due to an internal XML parsing error

If you are launching the silent-mode installation process from a script, you can choose to have these exit codes displayed on the console. Listing 5-2 provides a sample command file that invokes the installation program in silent mode and echoes the exit codes to the console from which the script is executed.

Listing 5-2 Sample Command File Displaying Silent-Mode Exit Codes
rem Execute the installer in silent mode
@echo off
JAVA -jar BEA-aqualogic-service-registry-2.1.0.jar -mode=silent -silent_xml=C:\downloads\silent.xml -log=C:\logs\products_silent.log
@rem Return an exit code to indicate success or failure of installation
set exit_code=%ERRORLEVEL%

@echo.
@echo Exitcode=%exit_code%
@echo.
@echo Exit Code Key
@echo ---------------
@echo 0=Installation completed successfully
@echo -1=Installation failed due to a fatal error
@echo -2=Installation failed due to an internal XML parsing error
@echo.

  Back to Top       Previous  Next