|
|
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.
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.
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 Platform 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:
http://e-docs.bea.com/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.
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. |
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 ]. |
The full pathname for the BEA Home directory of your choice. For details about the BEA Home directory, see
Choosing a BEA Home Directory.
|
|
The full pathname for the directory where you want to install the WebLogic SIP Server software. For details, see
Choosing a Product Installation Directory.
|
<?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\sipserver31" />
</input-fields>
</domain-template-descriptor>
To start the silent-mode installation process on a Windows system, follow these steps:
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: |
| Note: | wlssXXX_win32.exe -mode=silent -silent_xml=D:\silent.xml -log=D:\logs\platform_install.log |
| Note: | In this example, XXX represents the version number of the software you are installing. For more information, see Generating a Verbose Installation Log. |
The WebLogic Platform 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 Platform use this SDK by default, including scripts to start sample applications, the Configuration Wizard, and other WebLogic development tools. |
| 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./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: |
| Note: | wlssXXX_linux.bin -mode=silent -silent_xml=/home/silent.xml -log=/home/logs/platform_install.log |
| Note: | For more information, see Generating a Verbose Installation 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 for installation files with names ending in .jar, follow these steps:
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.
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: |
| Note: | java -jar wlssXXX_generic.jar -mode=silent -silent_xml=/home/silent.xml -log=/home/logs/platform_install.log |
| Note: | For more information, see Generating a Verbose Installation 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 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.
rem Execute the installer in silent mode
@echo off
wlss300_win32.exe -mode=silent -silent_xml=C:\downloads\silent.xml -log=C:\logs\220_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.
You can start using the product immediately after installing it for the first time. For additional information, see Configuring a WebLogic SIP Server Domain.
|