Installing WebLogic Platform
The following sections describe how to install WebLogic Platform 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.
With previous releases of WebLogic Platform, you have the option of running the Configuration Wizard as part of the silent installation process. In WebLogic Platform 8.1, the Configuration Wizard cannot be run, automatically, with the WebLogic Platform installation program; 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 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 are based on the assumption that you have already acquired the installation program, from either CD or the Web. For more information, see WebLogic Platform Distribution Methods.
Before you start to install WebLogic Platform, please review the following information:
http://download.oracle.com/docs/cd/E13196_01/platform/suppconfigs/index.html
.http://download.oracle.com/docs/cd/E13196_01/platform/suppconfigs/configs81/81_over/install_info.html
.Note: Information about obtaining and installing a licensed copy of TIBCO Rendezvous is available at the following URL:
By simply following the installation instructions provided by TIBCO for this product, you can install TIBCO Rendezvous correctly so that it is ready to be used later with WebLogic Integration. For information about using the TIBCO Rendezvous Control and Event Generator, see the TIBCO Rendezvous Control and Event Generator User Guide at the following URL:
http://download.oracle.com/docs/cd/E13214_01/wli/docs81/tibcorv/index.html
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:
net_
, for example net_platform
XXX
_solaris.bin
, where XXX
represents the version number of the software you are installing. Do not attempt to use installation programs with filenames beginning with net_
for silent-mode installation.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 a silent-mode installation, follow these steps:
silent.xml
. This file is available at http://download.oracle.com/docs/cd/E13196_01/platform/docs81/install/scripts/silent.xml
.The file is also presented later in this chapter. See Sample Template File for Silent-Mode Installation.
silent.xml
as the file name and save the file in the directory containing the WebLogic Platform installation program.Note: The first line of the template file must contain the following XML definition: <?xml version="1.0" encoding="UTF-8"?>
. The XML definition must appear at the beginning of the first line of the file; no spaces or line breaks are allowed before it.
silent.xml
file that you saved on your system, modify the values for the keywords shown in Table 4-1 to reflect your configuration.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 in which you want to install the WebLogic Platform software. For details, see Choosing a Product Installation Directory. |
|
|
|
Specify the components and subcomponents you want to install on your system:
Note: When using the WebLogic Server only installer, you can specify the WebLogic Server and WebLogic Workshop components only. |
Use the following guidelines when you specify values for the COMPONENT_PATHS
data-value name:
<data-value name="COMPONENT_PATHS" value="WebLogic Integration" />
<data-value name="COMPONENT_PATHS" value="WebLogic Server|WebLogic Workshop" />
<data-value name="COMPONENT_PATHS" value="WebLogic Portal/Portal Examples|WebLogic Portal/WebLogic Workshop Portal Extension" />
COMPONENT_PATHS
data-value name in the silent.xml
file, the complete WebLogic Platform is installed. Note: The installer performs dependency checking to ensure that all required components are installed. For more information, see Dependencies Between Installable Components.
<?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" />
<data-value name="INSTALL_NODE_MANAGER_SERVICE" value="no" />
<data-value name="COMPONENT_PATHS" value="WebLogic Server|WebLogic Workshop|WebLogic Integration|WebLogic Portal" />
</input-fields>
</domain-template-descriptor>
To start the silent-mode installation process on a Windows system, follow these steps:
If you want to install WebLogic Platform as a Windows service, you must have Administrator privileges. For information about installing WebLogic Platform as a Windows service, see "Setting Up a WebLogic Server Instance as a Windows Service" in Configuring and Managing WebLogic Server at http://download.oracle.com/docs/cd/E13222_01/wls/docs81/adminguide/winservice.html
.
filename.exe
-mode=silent -silent_xml=
path_to_silent.xml
Here filename.exe
is the name of the WebLogic Platform 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:
platform
XXX
_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.
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 Platform 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 Platform 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:
platform
XXX
_solaris.bin -mode=silent -silent_xml=/home/silent.xml -log=/home/logs/platform_install.log
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:Note: To ensure that the hardware/software configuration on which you are installing the product is supported by WebLogic Platform, see WebLogic Platform Supported Configurations at http://download.oracle.com/docs/cd/E13196_01/platform/suppconfigs/index.html
.
java -jar
filename
.jar -mode=silent
-silent_xml=/path_to_silent
.xml
Here, filename
.jar
is the name of the WebLogic Platform installation file (for example pj_platform
XXX
_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:
pj_platform
XXX
_generic.jar -mode=silent -silent_xml=/home/silent.xml -log=/home/logs/platform_install.log
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 4-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 4-1 Sample Command File Displaying Silent Mode Exit Codes
rem Execute the installer in silent mode
@echo off
platform814_win32.exe -mode=silent -silent_xml=C:\downloads\silent.xml -log=C:\logs\814platform_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 because, by default, WebLogic Platform uses the development license that is installed in BEA Home directory. We recommend that you use the QuickStart application to familiarize yourself with the software, take the WebLogic Platform Tour (if you installed the complete WebLogic Platform), and execute the samples provided. For additional information, see Performing Post-Installation Tasks.
Note: QuickStart is not invoked automatically for console 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 Release 8.1 of WebLogic Platform and WebLogic Server, see the appropriate release notes:
http://download.oracle.com/docs/cd/E13196_01/platform/docs81/relnotes/index.html
http://download.oracle.com/docs/cd/E13222_01/wls/docs81/notes/index.html