The following sections describe how to install WebLogic SIP Server using the installation program in silent mode on both Windows and UNIX systems:
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.
Note: The Configuration Wizard cannot be run, automatically, with the WebLogic SIP Server installation program during silent-mode installations; it must be run separately. However, you can create a simple shell script or command file that sequentially runs silent mode installation and silent mode configuration. For more information about running the Configuration Wizard in silent mode, see Creating WebLogic Configurations Using the Configuration Wizard at in the WebLogic Server 8.1 SP4 documentation at http://download.oracle.com/docs/cd/E13196_01/platform/docs81/confgwiz/index.html.
Note: 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 assume that you have already acquired the installation program, either on CD or from the Web.
Before you start the WebLogic SIP Server installation, make sure the hardware/software platform you are using is supported. See Supported Configurations for more information.
The silent-mode installation process has two primary steps:
For a detailed procedure, see Creating a Silent-Mode Installation Template File. For a sample template file, see Sample Template File for Silent-Mode Installation.
For a detailed procedure, see Starting the Silent-Mode Installation Process on a Windows System or Starting the Silent-Mode Installation Process on a UNIX System.
When you are performing an installation 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, we recommend that you create a log file when you start the installation. For more information, see Generating a Verbose Installation Log.<?xml version="1.0" encoding="UTF-8"?>) must be at the very beginning of the silent.xml template file. There cannot be any spaces or line breaks before the XML definition.
When you install WebLogic SIP Server 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.
To create a template file for use in the silent-mode installation process, follow these steps:
silent.xml in the directory containing the WebLogic SIP Server installation program. See Sample Template File for Silent-Mode Installation.<?xml version="1.0" encoding="UTF-8"?>) must be at the very beginning of the template file. There cannot be any spaces or line breaks before the XML definition.silent.xml file, modify the values for the keywords shown in Table 4-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 ].
<?xml version="1.0" encoding="UTF-8"?>
<!-- Silent installer option: -mode=silent -silent_xml=/home/me/silent.xml -->
<domain-template-descriptor>
<input-fields>
<data-value name="BEAHOME" value="C:\bea" />
<data-value name="USER_INSTALL_DIR" value="C:\bea\weblogic81" />
</input-fields>
</domain-template-descriptor>
To start the silent-mode installation process on a Windows system, follow these steps:
wlss202_win32.exe -mode=silent -silent_xml=path_to_silent.xml
Here path_to_silent.xml is the full pathname of the silent.xml template file.
Note: You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log. For example:
wlss202_win32.exe -mode=silent -silent_xml=D:\silent.xml -log=D:\logs\platform_install.log
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.
To start the silent-mode installation process using installation files with names ending in .bin, follow these steps:
chmod a+x filename.bin
filename.bin -mode=silent -silent_xml=/path_to_silent.xml
Here filename.bin is the name of the WebLogic SIP Server installation file (wlss202_linux32.bin or wlss202_solaris32.bin).
Note: You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log. For example:
wlss202_linux32.bin -mode=silent -silent_xml=/home/silent.xml -log=/home/logs/wlss_install.log
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.
If you are launching the silent-mode installation process from a script, you can choose to have these exit codes displayed to the console. Listing 4-1 provides a sample command file that invokes the WebLogic SIP Server installation in silent mode and echoes the exit codes to the console from which the script is executed.
Listing 4-1 Sample Command File Displaying Silent Mode Exit Codes
rem Execute the installer in silent mode
@echo off
wlss202_win32.exe -mode=silent -silent_xml=C:\downloads\silent.xml -log=C:\logs\wlss_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.
WebLogic SIP Server 2.0.2 is installed with evaluation licenses for WebLogic Server 8.1 SP4 and the SIP Servlet container. If you purchased a production WebLogic SIP Server license (a SIP Server container license intended for use with a separately-purchased WebLogic Server 8.1 license), follow the instructions in Licensing WebLogic SIP Server 2.0.2 for Production Use in the Release Notes. These instructions describe how to update and install an existing WebLogic Server 8.1 production license and SIP Servlet container license to the default WebLogic SIP Server 2.0.2 installation.
You can start using the product immediately after installing it for the first time because, by default, WebLogic SIP Server uses the development license that is installed in BEA Home directory. To begin working with SIP Server, use the Configuration Wizard to create a new WebLogic SIP Server domain, if you have not already done so. See Creating a New WebLogic SIP Server Domain for more information.
For specific information about this release, see the Release Notes.