BEA Products Installation Guide BEA WebLogic Server® Version 9.2 BEA WebLogic Integration™ Version 9.2 BEA Workshop for WebLogic Platform™ Version 9.2 BEA WebLogic Portal® Version 9.
Copyright Copyright © 1995-2007 BEA Systems, Inc. All Rights Reserved. Restricted Rights Legend This software is protected by copyright, and may be protected by patent laws. No copying or other use of this software is permitted unless you have entered into a license agreement with BEA authorizing such use.
Contents Preface: About This Document What You Need to Know . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -viii Product Documentation on the e-docs Web Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -viii Related Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -viii Contact Us! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9 Temporary Disk Space Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9 Administrator Privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10 Licensing . . . . . . . . . . . . . . . .
Starting Graphical-Mode Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Starting Console-Mode Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7 Starting Silent-Mode Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8 Using Installers with Filenames Ending in .jar . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9 Starting Graphical-Mode Installation . . . . . . . . . . . . . . . . . . . . . . . . .
Sample Template File for Silent-Mode Upgrade Installation . . . . . . . . . . . . 5-14 What’s Next? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14 6. Installing and Updating License Files About BEA Product Licenses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1 Updating Your license.bea File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface: About This Document This document explains how to use the BEA Products installation program on both Windows and UNIX platforms. It is organized as follows: z Chapter 1, “Preparing for the Installation,” provides the basic information you need to know before installing your BEA software. z Chapter 2, “Starting the Installation Program,” describes how to start the installation program in graphical, console, and silent modes on Windows and UNIX platforms.
z Chapter 7, “Post-Installation Information,” explains what you should do after you install the software. z Chapter 8, “Uninstalling the Software,” provides procedures for uninstalling your BEA software in graphical, console, and silent modes. What You Need to Know This document is intended for system administrators or application developers who are installing BEA Products software.
Docu ment at io n Co nve nt ion s In your e-mail message, please indicate which release of the BEA Products documentation you are using. If you have any questions about these versions of the BEA software, or if you have problems installing and running the software, contact BEA Customer Support at http://support.bea.com. You can also contact Customer Support by using the contact information provided on the quick reference sheet titled “BEA Customer Support,” which is included in the product package.
Convention Item monospace boldface text Identifies significant words in code. Example: void commit ( ) monospace italic text Identifies variables in code. Example: String expr { } Indicates a set of choices in a syntax line. The braces themselves should never be typed. [ ] Indicates optional items in a syntax line. The brackets themselves should never be typed. Example: java utils.MulticastTest -n name [-p portnumber] | Separates mutually exclusive choices in a syntax line.
CHAPTER 1 Preparing for the Installation The following sections provide information that you need to know before installing your BEA software: z Installation Overview z Installable Product Components z Product Distribution Methods z Installation Prerequisites z Selecting Directories for Your Installation z Choosing the Type of Installation z About Installing Node Manager as a Windows Service z Generating a Verbose Installation Log z Where to Find Upgrade Information Installation Overvie
z BEA Products installation program for BEA WebLogic Server, BEA Workshop for Weblogic Platform™, BEA WebLogic Integration, and WebLogic Portal. z BEA Products installation program for BEA WebLogic Server, which includes BEA WebLogic Server, BEA Workshop for Weblogic Platform™. Both programs provide the same functionality; all installation procedures described in this document apply to both versions of the installation program.
Install able Product Compone nts z Console mode Console-mode installation is an interactive, text-based method for installing your software from the command line, on either a UNIX system or a Windows system. For instructions for using this method, see Chapter 4, “Running the Installation Program in Console Mode.” z Silent mode Silent-mode installation is a noninteractive method of installing your software that requires the use of an XML properties file for selecting installation options.
z The features and capabilities of BEA JRockit, see Introduction to JRockit JDK at http://e-docs.bea.com/jrockit/geninfo/genintro/index.html. z Operating systems and hardware supported by your software, see BEA Products Supported Configurations at http://e-docs.bea.com/platform/suppconfigs/index.html WebLogic Server BEA WebLogic Server® provides the core services that ensure a reliable, available, scalable, and high-performing execution environment for your application.
Install able Product Compone nts z Message Brokering z Application Monitoring z User Interaction z Event Generation WebLogic Integration 9.2 is an Integrated Development Environment based on Eclipse platform, which aims at reducing the cost of management and operations by providing highly reliable, stable, scalable, and mission critical integration solutions.
you build in the IDE are constructed from high-level components rather than low-level API calls. Best practices and productivity are built into both the IDE and runtime. BEA Workshop for WebLogic Platform also includes the workshop examples to help you to get acquainted with the product. You can use BEA Workshop for WebLogic Platform to: z Develop Web applications. z Create sophisticated business processes. z Present new functionality in user portals.
Install able Product Compone nts The BEA JRockit JDK is fully integrated into the BEA Products installation program, in addition to being available as a standalone JDK. BEA JRockit is installed automatically when you use the BEA Products installation program to install your software on Windows and Linux 32-bit platforms.
accept the license agreement to install the tools. For more information about these tools, see http://www.mercury.com/us/products/diagnostics/. Product Distribution Methods Your BEA software is distributed on both the BEA Web site and DVD. Web Distribution You can download your software from the BEA Web site at http://commerce.bea.com.
Ins tallati on Prerequis ites z Administrator Privileges z Licensing System Requirements The system requirements for your installation are given in the following table. Table 1-1 System Requirements Component Requirement Platform configuration A supported configuration of hardware, operating system, JDK, and database is required. See Supported Configurations at http://e-docs.bea.com/platform/suppconfigs/index.html.
environment (JRE) bundled with the installation program and an uncompressed copy of the JRE that is expanded into the temporary directory. The extracted files are deleted from the temporary directory at the end of the installation process. As a general rule, installation programs require approximately 2.5 times the amount of temporary space that is ultimately required by the installed files.
Ins tallati on Prerequis ites z To install the Node Manager as a Windows service. You must have Administrator privileges to install the Node Manager as a Windows service. When the Node Manager is installed as a Windows service, it starts at the completion of the installation process, and again, automatically, each time you boot your Windows system. For more information, see “About Installing Node Manager as a Windows Service” on page 1-19. z To create Start menu shortcuts in the All Users folder.
Development and production licenses for pre-9.2 versions of WebLogic Server do not work with WebLogic Server 9.2; any such license must be upgraded to 9.2. Procedures for upgrading a license file and installing permanent licenses are provided in “Upgrading Licenses from Previous Software Releases” on page 6-6.
Sel ecting Direc to rie s for Your Instal latio n Figure 1-1 BEA Home Directory It depicts only the files and directories required in the BEA Home directory. If you choose to install the product in the BEA Home directory, you will see additional directories such as weblogic92. For more information on product directories, see “Understanding the Product Directory Structure” on page 7-4. Note: On some UNIX platforms, the installation program does not install the JDK.
Understanding the Functions of the BEA Home Directory The files and directories in the BEA Home directory are described in the following table. Table 1-3 BEA Home Directory Description Component Description jdkxxx directory Contains the software for the Sun JDK if it is installed with your software. The JDK provides the Java run-time environment (JRE) and tools for compiling and debugging Java applications.
Sel ecting Direc to rie s for Your Instal latio n Table 1-3 BEA Home Directory Description (Continued) Component Description license.bea file An XML file that contains the license keys for all the BEA products installed in the BEA Home directory. Licenses are release specific. For example, you cannot use a license from a previous release with WebLogic Server 9.2. To convert a pre-9.2 license.bea file to a WebLogic Server 9.2 license.
Note: The directory user_projects does not contain anything when the product is installed on the disk. It is used as the default location for your files when you create domains at the location. Creating Multiple BEA Home Directories Although it is possible to create more than one BEA Home directory, we recommend that you avoid doing so. In almost all situations, a single BEA Home directory is sufficient.
Choos ing the Type of Instal latio n Figure 1-2 Product Installation Directories window Here, C:\bea_dijon is the BEA Home directory and weblogic92 is the product installation directory for the WebLogic Server 9.2 software. However, you can specify any name and location on your system for your product installation directory; there is no requirement that you name the directory weblogic92 or create it under the BEA Home directory.
Complete Installation In a complete installation for WebLogic Server and BEA Workshop for WebLogic Platform, following components of BEA products are installed: z WebLogic Server program files and related sample files z Workshop for WebLogic Platform z WebLogic Integration z WebLogic Portal In a complete installation for WebLogic Server, BEA Workshop for WebLogic Platform, WebLogic Integration, and WebLogic Portal, the following components of BEA products are installed: z WebLogic Server program fi
A bo u t I n s ta l l i ng N o d e M an ag e r as a Win do ws Ser v i c e Custom Installation In a custom installation, you have the following options: z You can choose which software components to install on your system. For a description of the software components provided with your product distribution, see “Installable Product Components” on page 1-3. Sample domains preconfigured to use the PointBase database are created only for the installed components.
Note: You are prompted to install Node Manager as a Windows service only during an initial installation. If you install additional product components during a subsequent installation, you are not prompted to install Node Manager as a Windows service. To install Node Manager as a Windows service in silent mode, you need to specify the appropriate values in the silent.xml file. For more information, see “Creating a silent.xml File for Silent-Mode Installation” on page 5-3.
Genera ting a Ve rb ose Install ation Lo g z When you uninstall WebLogic Server, the Node Manager service registered with the product installation directory from which, you are uninstalling the product is uninstalled also. For more information about the product installation directory, see “Choosing a Product Installation Directory” on page 1-16.
of your custom security providers reside in the default location, then the security provider upgrade step is complete, and you do not have to perform any of the additional steps in “Upgrading a Security Provider” in Upgrading WebLogic Application Environments at http://e-docs.bea.com/common/docs92/upgrade/upgrade_sp.html.
Where to Find Upgrade Informatio n with filenames ending in .bin). For other UNIX platforms, the WebLogic Platform installation program does not include the Java 2 SDK. 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.
1-24 BEA Products Installation Guide
CHAPTER 2 Starting the Installation Program The following sections describe how to start the installation program on Windows and UNIX platforms: z Before You Start z Starting the Installation Program on Windows Platforms z Starting the Installation Program on UNIX Platforms z What’s Next? z What’s Next? Before You Start Before you start installing the software, please review the following information: z Make sure that you are installing your software on a hardware/software configuration that i
during a separate installation. However, to reinstall the same version of one of the products, you must first uninstall the previous installation, as described in Chapter 8, “Uninstalling the Software.” z If you are adding components to an existing installation of WebLogic Server, you should shut down any running servers before starting the installation.
St a rt i n g t h e I n s t al l at i o n P ro gr am o n Win do ws P l a tf o r m s If you are installing from . . . Perform the following action . . . Web download Go to the directory where you downloaded the installation program. DVD 1. Insert the software DVD into the DVD drive. 2. If the installation program does not start automatically, open Windows Explorer and double-click the DVD icon. 3. Navigate to the folder for the Windows installation. 4.
If you are installing from . . . Web download Perform the following action . . . 1. Open a command prompt window. 2. Go to the directory where you downloaded the installation program. DVD 1. Insert the software DVD into the DVD drive. Note: If autorun is enabled, the installation program may start automatically in graphical mode. You must exit the installation program to use console-mode installation. 2. Open a command prompt window. 3.
S ta rt i n g th e I n s t al l at i o n P ro gr am o n UNI X P l a tf o r m s installation. For information about creating a silent.xml file, see “Creating a silent.xml File for Silent-Mode Installation” on page 5-3. 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. 3. Complete the appropriate procedure in the following table. If you are installing from . . .
(those with filenames ending in .bin). For other UNIX platforms, the installation program does not include a JRE. Filenames for these installation programs end in .jar. To run the .jar installation programs, you must have an appropriate version of a JDK installed on your system, and include the bin directory of the JDK at the beginning of your PATH system variable.
S ta rt i n g th e I n s t al l at i o n P ro gr am o n UNI X P l a tf o r m s If you are installing from . . . Perform the following action . . . Web download Go to the directory where you downloaded the installation program. DVD 1. Insert the software DVD into the DVD drive and go to the DVD directory. 2. Navigate to the directory that contains the installation program for your platform. 3. Launch the installation by entering the following commands: chmod a+x ./
If you are installing from . . . Perform the following action . . . Web download Go to the directory where you downloaded the installation program. DVD 1. Insert the software DVD into the DVD drive and go to the DVD directory. 2. Navigate to the directory that contains the installation program for your platform. 3. Launch the installation by entering the following commands: chmod a+x ./ -mode=console Here filename.
S ta rt i n g th e I n s t al l at i o n P ro gr am o n UNI X P l a tf o r m s 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. 3. Complete the appropriate procedure in the following table. If you are installing from . . . Perform the following action . . . Web download Go to the directory where you downloaded the installation program. DVD 1.
z Starting Console-Mode Installation z Starting Silent-Mode Installation Starting Graphical-Mode Installation To start the graphical-mode installation process for installation files with names ending in .jar, follow these steps: 1. Log in to the target UNIX system. 2. Add the bin directory of the appropriate JDK to the beginning of the PATH variable definition on the target system. For example: PATH=JAVA_HOME/bin:$PATH export PATH Here JAVA_HOME represents the full path to the JDK directory. 3.
S ta rt i n g th e I n s t al l at i o n P ro gr am o n UNI X P l a tf o r m s Here, JAVA_HOME represents the full path to the JDK directory. 3. Go to the directory where you downloaded the installation program. 4. Launch the installation by entering the following command: java -jar -mode=console Here, filename.jar is the name of the BEA Products installation file, for example, server920_generic.jar.
5. Launch the installation by entering the following command: java -jar -mode=silent -silent_xml=/path_to_silent.xml Here, filename.jar is the name of the BEA Products installation file (for example, serverXXX_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 file. Note: You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log.
CHAPTER 3 Running the Installation Program in Graphical Mode The following sections describe how to run the installation program in graphical mode: z Running the Installation Program z Using the Upgrade Installer in Graphical Mode z What’s Next? Running the Installation Program Start the installation program as described in Chapter 2, “Starting the Installation Program.” The installation program prompts you to enter specific information about your system and configuration.
In this window . . . Perform the following action . . . Choose BEA Home Directory Specify the BEA Home directory that will serve as the central support directory for all BEA products installed on the target system. If you already have a BEA Home directory on your system, you can select that directory (recommended) or create a new BEA Home directory.
Running the Install ation Program In this window . . . Perform the following action . . . Choose Components Specify the components to be installed by selecting or clearing the appropriate check boxes. This window is displayed only under the following conditions: • • You selected Custom installation in the Choose Install Type window. You are adding components to an existing installation. This window displays a tree-view of all the components available for installation.
In this window . . . Perform the following action . . . Choose Product Installation Directory Specify the directory in which you want to install the software and click Next. You can accept the default product directory (weblogic92) or create a new product directory. This window is not displayed if you are adding components to an existing installation. Instead, you are prompted to confirm the product installation directory.
Us i ng t he U pg ra de I n s t all e r i n G ra ph i c a l M o d e In this window . . . Perform the following action . . . Choose Shortcut Location Specify the Start menu folder in which you want the Start menu shortcuts created. You can select from the following options: This window is displayed only under the following conditions: • You have Administrator privileges. • You are performing an initial installation. • You are installing on a Windows platform.
Note: In some cases, changes are made in the config.xml file between service packs. You may want to make backup copies of the config.xml file in any user-created domains also, in case you later want to roll back or uninstall an upgrade installation. 2. Download the upgrade installer specific to your platform from the BEA Customer Support Web site at http://support.bea.com. Note: To download updates, you will need to log in using your eSupport username and password.
Us i ng t he U pg ra de I n s t all e r i n G ra ph i c a l M o d e To start the upgrade installer on this platform . . . UNIX Perform the following steps... For installers with filenames ending in .bin: 1. Go to the directory in which you downloaded the installation program, and invoke the installation procedure by entering the following commands: chmod a+x filename.bin ./filename.bin Here
home directory and to the product directory in which the WebLogic Platform software will be updated. 7. Click Next. A progress window is displayed during the upgrade installation. When the installation is finished, the Installation Complete window is displayed. 8. Click Done on the Installation Complete window to exit the installation program. What’s Next? By default, your BEA software uses the development license file installed in the BEA Home directory so that you can start using the product immediately.
C H A P T E R 4‘ Running the Installation Program in Console Mode The following sections describe how to run the installation program in console mode: z Running Console-Mode Installation z Using the Upgrade Installer in Console Mode z What’s Next? Running Console-Mode Installation Start the installation program in console mode as described in Chapter 2, “Starting the Installation Program.
The following procedure steps you through the installation program. Use this procedure after you have started the installation program in console mode, as described in Chapter 2, “Starting the Installation Program.” 1. At the Welcome prompt, type next (or n for short) or press Enter to continue with the installation process. The BEA Systems License Agreement prompt is displayed. 2.
Running Cons ole-Mode Instal latio n Choose BEA Home Directory: -------------------------"BEA Home" = [Use default "C:\bea Input BEA Home OR [Exit][Previous][Next]> Do one of the following: – To use the default BEA Home directory, type next (or n for short), or press Enter. – To create a new BEA Home directory, enter the full path of the BEA Home directory, for example C:\beahome2. If you specify a directory that does not exist, the installation program creates it for you.
->1|Complete |Install the following software components and examples: • WebLogic Server • Workshop for WebLogic Platform • WebLogic Portal 2|Custom Installation |Choose software components to install and perform optional configuration. Enter index number to select OR [Exit][Previous][Next]> Do one of the following: – Type 1 or press Enter to choose a Complete installation. Proceed to step 6. – Type 2 to choose a Custom installation. The Choose Components to install prompt is displayed.
Running Cons ole-Mode Instal latio n | +----Integration Examples [3.3] v +----WebLogic Portal [4] v ¦ +----Portal Server [4.1] v ¦ +----WebLogic Workshop Portal Extension [4.2] v ¦ +----Portal Examples [4.
– Type 1 if you want to install the Mercury profiling tools. In the next panel you are prompted to read and accept the Mercury Tools license agreement. – Type 2 if you do not want to install the Mercury profiling tools. The Choose Product Directory prompt is displayed. Proceed to step 8. Note: For more information about the Mercury profiling tools, see “BEA JRockit JDK” on page 1-6. 7. Read the License Agreement and indicate your acceptance or rejection of its terms.
Running Cons ole-Mode Instal latio n ->1| Yes, use this product directory [C:\beahome2\weblogic92] 2| No, select another product directory Enter index number to select OR [Exit][Previous][Next]> Verify that your entry is correct, then type 1 or press Enter to proceed with the installation. Otherwise, type 2 to return to the Choose Product Directory panel, where you can modify your entry.
– Enter 2 if you do not want to install Node Manager as a Windows service. The Choose Shortcut Location prompt is displayed. 10. Specify the folder in which you want to create the Start menu shortcuts. Select the All Users folder or the local user’s folder, as shown in the following sample text: Choose Shortcut Location: ------------------------*The installer creates shortcuts to BEA components, samples, and tools.
U s i ng th e Up gr a de I ns ta l l e r i n C o nso l e M o d e ¦user may have to create Start menu shortcuts manually. Refer to ¦the documentation for more information. 2¦Go back to the previous screen and make another choice. Enter index number to select OR [Exit][Previous][Next]> Verify that your entry is correct, then type 1 or press Enter to proceed with the installation. Otherwise, type 2 to return to the previous panel, where you can modify your entry.
3. Shut down any servers that are running. Hot installation of a service pack or rolling patch is not supported. 4. Start the upgrade installer as described in the following table. To start the upgrade installer on this platform . . . Perform the following steps... Windows 1.Open an MS-DOS command prompt window. Go to the directory in which you downloaded the installation program, and invoke the installation procedure by entering the following command: filename.exe -mode=console Here filename.
U s i ng th e Up gr a de I ns ta l l e r i n C o nso l e M o d e To start the upgrade installer on this platform . . . UNIX Perform the following steps... For installers with filenames ending in .bin: 1. Go to the directory in which you downloaded the installation program, and invoke the installation procedure by entering the following commands: chmod a+x filename.bin ./filename.bin Here
directory, see “Choosing a BEA Home Directory” on page 1-12. The installation program displays the following prompt: Choose BEA Home Directory: 1| /home/bea 2| /home1/beahome2Enter index number to select OR [Exit][Previous][Next] Press Enter to use the selected BEA Home directory or type the number of the BEA Home directory that you want to select.
W ha t’ s N e x t ? What’s Next? By default, your BEA software uses the development license file installed in the BEA Home directory so that you can start using the product immediately. We recommend that you run the QuickStart application to familiarize yourself with the software, and execute the samples provided. For additional information, see Chapter 7, “Post-Installation Information.” Note: QuickStart is not invoked automatically for console-mode or silent-mode installations.
4-14 BEA Products Installation Guide
CHAPTER 5 Running the Installation Program in Silent Mode The following sections describe how to run the installation program in silent mode: z What Is Silent-Mode Installation? z Using Silent-Mode Installation: Main Steps z Creating a silent.xml File for Silent-Mode Installation z Sample silent.
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. For more information, see “Product Distribution Methods” on page 1-8. Using Silent-Mode Installation: Main Steps The silent-mode installation process has two primary steps: 1. Create a silent.
C re at i n g a s i l e n t. x ml F i l e for Silent-Mode Instal latio n z The XML definition () must be at the very beginning of the silent.xml file. There cannot be any spaces or line breaks before the XML definition. z You cannot reinstall any BEA product on top of a previously installed version of the same product—in the same BEA Home directory or in the same file location. You can, however, add products and product components to an existing installation.
Table 5-1 Values for the silent.xml File For this data-value name . . . Enter the following value . . . BEAHOME The full path name for the BEA Home directory of your choice. For details about the BEA Home directory, see “Choosing a BEA Home Directory” on page 1-12. USER_INSTALL_DIR The full path name for the directory where you want install BEA WebLogic Server. For details, see “Choosing a Product Installation Directory” on page 1-16.
C re at i n g a s i l e n t. x ml F i l e for Silent-Mode Instal latio n Table 5-1 Values for the silent.xml File (Continued) For this data-value name . . . Enter the following value . . . INSTALL_SHORTCUT_IN_ ALL_USERS_FOLDER • true, or yes, to create the shortcuts in the All Users folder. The default is true. • false, or no, to create the shortcuts in the local users folder.
Guidelines for Component Selection Use the following guidelines when you specify values for the COMPONENT_PATHS data-value name: z When you specify a product component to be installed, all subcomponents that are installed by default in a complete installation are also installed. For example, the following entry installs both WebLogic Server and the examples: Note: The Web Server Plug-Ins subcomponent is not installed by default.
Sample sil ent.xml fil e for Silent-Mode Instal latio n Sample silent.xml file for Silent-Mode Installation 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” on page 5-3. The sample file is available at http://e-docs.bea.com/common/docs92/install/scripts/silent.xml.
@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. Using the Upgrade Installer in Silent Mode When you upgrade your installation in silent mode, you define the settings in an XML file that you create prior to beginning the upgrade installation.
U s i ng t he U pg ra de I n s t all er in Si lent Mode Note: To download updates, you will need to log in using your eSupport username and password. If you do not have an eSupport account, you can register for one on the BEA Customer Support Web site. 4. Shut down any servers that are running. 5. Invoke the silent-mode upgrade installation process as described in the following table. Note: Incorrect entries in the silent.xml file can cause installation failures.
5-10 BEA Products Installation Guide
U s i ng t he U pg ra de I n s t all er in Si lent Mode To start the upgrade installer on this platform . . . Windows Perform the following steps... 1. Open an MS-DOS command prompt window. 2. Go to the directory in which you downloaded the installation program, and invoke the installation procedure by entering the following command: filename.exe -mode=silent -silent_xml=path_to_silent_xml Here filename.
To start the upgrade installer on this platform . . . UNIX Perform the following steps... For installers with filenames ending in .bin: 1. Go to the directory that contains the installation file. 2. Launch the upgrade installation by entering the following command: chmod a+x filename.bin ./filename.bin -mode=silent -silent_xml=/path_to_silent.xml Here is the name of the upgrade installation program you downloaded from the BEA Customer Support Web site, and path_to_silent.
U s i ng t he U pg ra de I n s t all er in Si lent Mode To start the upgrade installer on this platform . . . Perform the following steps... java -jar filename.jar -mode=silent -silent_xml=/path_to_silent.xml where filename.jar is the name of the upgrade installation program you downloaded from the BEA Customer Support Web site, (for example filename, pj_platformXXX_upgrade_generic.jar, in this, XXX represents the version number of the software you are installing), and path_to_silent.
Do the following to create a silent.xml file for use in the silent-mode upgrade installation process: 1. In a supported browser, display the XML template file for silent-mode upgrade installation. The sample template file, silent_upgrade.xml, is available at Sample Template File for Silent-Mode Upgrade Installation. 2. In the popup window that is displayed, choose File—> Save As... 3. Specify the file name silent_upgrade.
W ha t’ s N e x t ? For specific information about your software release, see the appropriate release notes: z BEA WebLogic Server® and WebLogic Express™ Release Notes at http://e-docs.bea.com/wls/docs92/notes/index.html. z BEA Products Installation and Configuration Release Notes at http://e-docs.bea.com/common/docs92/relnotes/index.html.
5-16 BEA Products Installation Guide
CHAPTER 6 Installing and Updating License Files Your BEA software requires a valid product license to run. The following sections explain how to acquire, install, and update your product license: z About BEA Product Licenses z Updating Your license.bea File z Upgrading Licenses from Previous Software Releases z Installing Licenses for Use with Promotional DVD Distributions About BEA Product Licenses BEA products use an XML-format license file called license.bea.
Note: See the End User License Agreement for specific license terms and conditions. Table 6-1 BEA Products License File Types License Type Description Development • Used in a development environment where a developer is preparing an application to run on top of your BEA Products software; a production license is required for deployment. • Enables all component products provided in your product distribution.
Up da ti ng Yo ur li cen se.b ea Fi le For a description of the product offerings supported by the BEA Products license files, see the Licensing page at the following URLs: z http://e-docs.bea.com/common/docs92/interm/license.html (WebLogic Server) Updating Your license.bea File When you install your BEA software, the installation program generates a development license.bea file for use with the software and installs it in the BEA Home directory.
The UpdateLicense merge process is not intended to modify the license attributes for any component or feature in the license files being merged. For example: z If you merge a WebLogic Server 8.1 production license with a WebLogic Server 9.2 development license, the development and production rights associated with the different WebLogic Server license versions are retained. The merge process creates a single license file which can be used for both WebLogic Server 8.1 production and WebLogic Server 9.
Up da ti ng Yo ur li cen se.b ea Fi le 1. Save the license update file that you received through e-mail, with a name other than license.bea, in the target BEA Home directory. For example, save the file as new_license.bea. Use this file as the license_update_file in step 4 of this procedure. WARNING: Do not overwrite or change the name of the existing license.bea file. 2.
Upgrading Licenses from Previous Software Releases The format of the license.bea file changes with each release of BEA Products software. To upgrade a license.bea file from a previous release to a license for the current release, complete the following steps: 1. Log in to the BEA eLicense Web site at http://elicense.bea.com. Note: You need a BEA eLicense account to log in to this Web site. If you do not have a BEA eLicense account, click the Register link on the Customer Support site to register for one. 2.
CHAPTER 7 Post-Installation Information This section covers the following topics: z Using QuickStart z Determining Which JDK Version You Are Using z Understanding the Windows Shortcuts z Understanding the Product Directory Structure Using QuickStart When the product installation is completed using graphical-mode installation, the QuickStart application is launched automatically, by default.
z Start WebLogic Portal GroupSpace z Upgrade applications to 9.2 z Access documentation online After installation, you can launch QuickStart as follows: z On Window systems, choose Start→ Programs→ BEA Products→ QuickStart. z On UNIX systems, perform the following steps: a. Log in to the target UNIX system. b. Go to the /common/bin subdirectory of your BEA Products installation. For example: cd /home/bea/weblogic92/common/bin c. Enter the following command: sh quickstart.
Un de rs ta nd ing t he Wi nd ows Sh or tc ut s Understanding the Windows Shortcuts When you install your BEA Products software on a Windows system, the installation program automatically creates shortcut entries on the Start Menu. Note: If the user performing the installation has Administrator privileges, the shortcut entries can be created in the All Users Start menu folder or in the user’s local Start menu folder. For more information, see “Administrator Privileges” on page 1-10.
– Access documentation online z Smart Update—launches the Smart Update program, which checks for any updates available for installed BEA products, and installs the updates as required. z Uninstall BEA Products—launches the uninstallation program. For more information, see Chapter 8, “Uninstalling the Software.” z WebLogic Server 9.2—contains a shortcut for launching the default WebLogic Server domain.
Un de rst a nd ing t he Pr od uc t Di rec to ry S t ru ct ur e Table 7-1 Product Installation Directory Structure This directory . . . Contains . . . weblogic92 Folders for files shared by all product components.
7-6 BEA Products Installation Guide
CHAPTER 8 Uninstalling the Software The following sections provide procedures for uninstalling the software: z About the Uninstallation Program z Uninstalling Your Software in Graphical Mode z Uninstalling Your Software in Console Mode z Uninstalling Your Software in Silent Mode z Reinstalling Your Software About the Uninstallation Program The following sections describe how to uninstall your BEA software on Windows and UNIX systems.
uninstallation program also removes the product directory associated with the installation unless one of the following is true: z The product directory contains user-created configuration or application files—the uninstallation program does not delete user-created configuration files, application files, or domains. z The complete installation was not uninstalled.
U ni n s t all i n g Y o u r S o f t war e i n C o nso l e M o d e Table 8-1 Starting the Uninstallation Program in Graphical Mode To start the uninstallation program on this platform . . . Perform the following steps . . . Windows 1. From the Windows Start menu, choose Start→ Programs→ BEA Products→ Uninstall BEA Products. The BEA Products Uninstaller Welcome window is displayed. 2. Proceed to step 3. UNIX 1.
1. Shut down any servers that are running. If any of these servers is configured as a Windows service, you should stop the service(s) before uninstalling the software. 2. Start the uninstallation program as described in Table 8-2. Table 8-2 Starting the Uninstallation Program in Console Mode To start the uninstallation program on this platform . . . Perform the following steps . . . Windows 1.
Uni nstalling Your So ft ware in Si lent Mode | +----Web Server Plug-Ins [1.3] +----Workshop for WebLogic Platform [2] v | +----Workshop [2.1] v | +----Workshop Examples [2.2] v +----WebLogic Integration [3] v | +----Integration Server [3.1] v | +----WebLogic Workshop Integration Extension [3.2] v | +----Integration Examples [3.3] v +----WebLogic Portal [4] v ¦ +----Portal Server [4.1] v ¦ +----WebLogic Workshop Portal Extension [4.2] v ¦ +----Portal Examples [4.
z The JDK, if it was installed with your BEA product installation z Domain directories, including those in user_projects z Any other file created or modified after your BEA software was installed You can manually delete these files. Although you can use silent-mode uninstallation to manually uninstall your software, silent-mode uninstall is intended for use in scripts. You can adapt the steps in Table 8-3 for use in scripts.
Rein st all ing Y our S of tw ar e Notes: When you run the uninstallation program in silent mode, no messages are displayed indicating the uninstallation is in progress or has completed successfully, even if errors are encountered. You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log. For example: uninstall -mode=silent -log=C:\logs\weblogic_uninstall.log For more information, see “Generating a Verbose Installation Log” on page 1-21.
8-8 BEA Products Installation Guide
Index A starting on UNIX platforms .bin installers 2-6 .jar installers 2-10 starting on Windows platforms 2-2 administrator privileges 1-10 B BEA Home directory about 1-12 component descriptions 1-14 sample structure 1-12 C complete installation 1-18 console-mode installation 4-1 starting on UNIX platforms .bin installers 2-7 .
M Mercury profiling tools 1-7 N node manager installation considerations 1-20 installing as Windows service 1-19 P product components 1-3 product installation directory about 1-16 structure 7-4 Q QuickStart, using 7-1 R registry.xml 1-15 reinstallation 8-7 requirements system 1-9 temporary disk space 1-9 U uninstall about 8-1 console mode 8-3 graphical mode 8-2 silent mode 8-5 UNIX installation starting in console mode .bin installers 2-7 .jar installers 2-10 starting in graphical mode .
BEA Products Installation Guide Index-3
Index-4 BEA Products Installation Guide