The following sections describe how to run the installation program in silent mode:
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 before 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.
The instructions in this section are based on the assumption that you have already acquired the installation program either on DVD or from the BEA Web site.
The silent-mode installation process has two primary steps:
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 BEA Home directory, the product directory, and the components to be installed are supplied in a silent.xml
file.
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.
silent.xml
file.For information about starting the installation in silent mode, see Starting the Installation Program.
When you are running the installation program in silent mode, keep in mind the following considerations:
silent.xml
file can cause installation failures. To help you determine the cause of a failure, BEA recommends that you create a log file when you start the installation.<?xml version="1.0" encoding="UTF-8"?>
) must be at the very beginning of the silent.xml
file. Do not enter a space or line breaks before the XML definition.
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.
Note: | Incorrect entries in the silent.xml file can cause installation failures. To help you determine the cause of a failure, BEA recommends that you create a log file when you start the installation. |
To create a silent.xml
file for use in the silent-mode installation process, follow these steps:
silent.xml
file for silent-mode installation. The sample silent.xml file for the WebLogic Platform installation program is available at http://download.oracle.com/docs/cd/E13179_01/common/docs102//install/scripts/silent.xml. For information about sample silent.xml files for other installation programs, see the respective installation guides.
This sample silent.xml
file is also included in this chapter. For more information, see Sample silent.xml File for Silent-Mode Installation.
silent.xml
, in the same directory that contains the installation program.Note: | The XML definition (<?xml version="1.0" encoding="UTF-8"?> ) must be at the very beginning of the silent.xml file. Do not enter a space or line breaks before the XML definition. |
silent.xml
file that you saved on your system, edit the values for the keywords to reflect your configuration.For example, for WebLogic Platform installation, edit the values in the sample silent.xml file as shown in Table 6-1.
Note: | You must follow XML guidelines for characters when modifying values. That is, you cannot use characters reserved for use in XML, such as < , > , [ , and ] . |
The full pathname for the BEA Home directory of your choice. For more information about the BEA Home directory, see
Choosing a BEA Home Directory
.
|
|||
The full path name for the directory where you want to install BEA Workshop for WebLogic:
D:\bea\workshop_ <version>. For more information, see Choosing a Product Installation Directory.
|
|||
|
|||
If the port number is in use, the installer scans for the next available port and assigns it to the Node Manager.
|
|||
The user performing the installation must have Administrator privileges to install the Start menu shortcuts in the All Users folder. For more information, see Administrator Privileges.
|
|||
|WebLogic Portal/Workshop Portal Extension |WebLogic Portal/Portal Examples
For additional information about entering these values, see Guidelines for Component Selection.
|
|||
Specifies the optional Eclipse installation. If this key/value is not specified, the installer continues as in the normal GUI installation.
|
The following are the guidelines for specifying values for the COMPONENT_PATHS
data-value name:
<data-value name="COMPONENT_PATHS" value="WebLogic Server" />
For example to install multiple components in WebLogic Platform, enter:
<data-value name="COMPONENT_PATHS" value="WebLogic Server|Workshop for WebLogic" />
For example, to install various components of WebLogic Server and BEA WebLogic Platform (and the subcomponents that are installed by default), enter the following line in the file:
<data-value name="COMPONENT_PATHS" value="WebLogic Server/Server|
WebLogic Server/Server Examples|WebLogic Server/Workshop for WebLogic" />
COMPONENT_PATHS
data-value name in the silent.xml
file, the complete WebLogic Server, Workshop for WebLogic, and WebLogic Portal products are installed. Note: | The installation program performs dependency checking to ensure that all components that provide functionality on which other components depend for proper operation are installed. These dependencies are visible during graphical and console mode installations. The same dependencies are enforced during silent installation: components on which other components depend are installed even if they are not explicitly referenced in a silent script. |
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. For details about creating the silent.xml file, see Creating a silent.xml File for Silent-Mode Installation. See
silent.xml for the sample file for WebLogic Platform Installation.
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 as follows.
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 6-1 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.
rem Execute the installer in silent mode
@echo offplatform1020_win32.exe
-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.
For more information about installing the required patches, see Required Patches.
We recommend that you run the QuickStart application to familiarize yourself with the software and execute the samples provided. For additional information, see Post-Installation Information.
Note: | QuickStart is not invoked automatically for console-mode or silent-mode installations. You can launch QuickStart from the Start Menu (Windows), or from the command line (Windows and UNIX). For instructions, see Using QuickStart. |
For specific information about your software release, see the appropriate release notes.