Installing WebLogic SIP Server

Installing WebLogic SIP Server Using Silent-Mode Installation

The following sections describe how to install WebLogic SIP Server using the installation program in silent mode on both Windows and UNIX systems:

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.

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. For more information, see WebLogic SIP Server Distribution Methods.

Using Silent-Mode Installation: Main Steps

The silent-mode installation process has two primary steps:

Create a template 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-mode template file.

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.

Start the silent-mode installation process using the values specified in the template file.

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.

Important Considerations for Silent-Mode Installation

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

Silent-mode installation requires the same amount of temporary disk space and uses the same temporary storage directories as a standard installation. For more information, see Temporary Disk Space Requirements. The installation program does not alert you if there is not enough space in the temporary directory.
A silent-mode installation takes the same amount of time as a standard installation. At the beginning of a silent-mode installation, an initial installation program window or message is displayed briefly, indicating that the installation has started. No messages are displayed to indicate that the installation is in progress or has completed successfully. You can, however, specify that an exit code be displayed to the console if you initiate the installation using a script. For more information, see Returning Exit Codes to the Console.
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. For more information, see Generating a Verbose Installation Log.
The XML definition (<?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.
You cannot reinstall WebLogic SIP Server components on top of a previously installed version of the same component. You can, however, add components to an existing installation. For example, you can install WebLogic SIP Server during one installation, and WebLogic Integration or WebLogic Portal during a separate installation. However, to reinstall the same version of one of the product components, you must first uninstall the component or install in another location.

Creating a Silent-Mode Installation Template File

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:

In a supported browser, display the sample template file for silent-mode installation. The sample template file is available at http://download.oracle.com/docs/cd/E13196_01/platform/docs81/install/silent.html#template.

This template is also presented later in this chapter. See Sample Template File for Silent-Mode Installation. Note that not all entries in the template file are applicable to installing WebLogic SIP Server.

Copy the contents of the template file and save it as a text file named silent.xml in the directory containing the WebLogic SIP Server installation program.

Note: The XML definition (<?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.

In the silent.xml file, modify the values for the keywords shown in Table 5-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 ].

Table 5-1 Silent-Mode Installation Template Values

For this data-value name . . .	Enter the following value . . .
`BEAHOME`	The full pathname for the BEA Home directory of your choice. For details about the BEA Home directory, see Choosing a BEA Home Directory.
`USER_INSTALL_DIR`	The full pathname for the directory where you want to install the WebLogic SIP Server software. For details, see Choosing a Product Installation Directory.

Sample Template File for Silent-Mode Installation

<?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\wlss210" /> 
</input-fields> 
</domain-template-descriptor>

Starting the Silent-Mode Installation Process on a Windows System

To start the silent-mode installation process on a Windows system, follow these steps:

Open an MS-DOS command prompt window.

Go to the directory that contains the installation file and launch the installation procedure by entering the following command:

filename.exe -mode=silent -silent_xml=path_to_silent.xml
Here filename.exe is the name of the WebLogic SIP Server installation file, and 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:

wlssXXX_win32.exe -mode=silent -silent_xml=D:\silent.xml -log=D:\logs\platform_install.log
In this example, XXX represents the version number of the software you are installing. For more information, see Generating a Verbose Installation Log.

Starting the Silent-Mode Installation Process on a UNIX System

The WebLogic SIP Server installation program requires a Java run-time environment (JRE) to run. A JRE is bundled in the Windows installation program, and in some UNIX installation programs (those with filenames ending in .bin). For other UNIX platforms, the WebLogic SIP Server installation program does not include the JRE. Filenames for these installation programs end in .jar. To run the .jar installation programs, you must have an appropriate version of a Java 2 SDK installed on your system, and include the bin directory of the Java 2 SDK at the beginning of your PATH system variable.

Note: It is important that you use an SDK because the installation process sets the JAVA_HOME and related variables to point to this directory. All scripts installed with WebLogic SIP Server use this SDK by default, including scripts to start sample applications, the Configuration Wizard, and other WebLogic development tools.

Starting Silent-Mode Installation for .bin Installation Files

To start the silent-mode installation process using installation files with names ending in .bin, follow these steps:

Go to the directory that contains the installation file.

Launch the installation by entering the following command:

chmod a+x filename./filename.bin -mode=silent -silent_xml=/path_to_silent.xml
Here filename.bin is the name of the WebLogic SIP Server installation file, and 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:

wlssXXX_linux.bin -mode=silent -silent_xml=/home/silent.xml -log=/home/logs/platform_install.log
For more information, see Generating a Verbose Installation Log.

Starting Silent-Mode Installation for .jar Installation Files

To start the silent-mode installation process for installation files with names ending in .jar, follow these steps:

Add the bin directory of the appropriate SDK to the beginning of the PATH variable definition on the target system. For example:

PATH=JAVA_HOME/bin:$PATH export PATH
Here JAVA_HOME is the full path of the SDK directory.

Go to the directory that contains the installation file.

Launch the installation by entering the following command:

java -jar filename.jar -mode=silent -silent_xml=/path_to_silent.xml
Here, filename.jar is the name of the WebLogic SIP Server installation file (for example wlssXXX_generic.jar, where XXX represents the version number of the software you are installing) and path_to_silent.xml is the full path to 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:

java -jar wlssXXX_generic.jar -mode=silent -silent_xml=/home/silent.xml -log=/home/logs/platform_install.log
For more information, see Generating a Verbose Installation Log.

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.

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 to the console. Listing 5-1 provides a sample command file that invokes the WebLogic Platform installation in silent mode and echoes the exit codes to the console from which the script is executed.

Listing 5-1 Sample Command File Displaying Silent Mode Exit Codes

rem Execute the installer in silent mode
@echo off
wlss210_win32.exe -mode=silent -silent_xml=C:\downloads\silent.xml -log=C:\logs\210_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.

What's Next?

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. For additional information, see Configuring a WebLogic SIP Server Domain.