|
Installing and Uninstalling Service Packs on WebLogic Server
The following sections describe how to install and uninstall Service Packs on WebLogic Server using the same methods used to install and uninstall the WebLogic Server 6.0 base product:
A Service Pack, or SP, is a program that fixes bugs or other known issues in an application. It can also add new functions to an application, or increase the capacity of an application.
A Service Pack for WebLogic Server 6.0 contains updates and upgrades to the original WebLogic 6.0 product. "Update" means either a software modification or addition that, when made or added to the software, corrects an error or eliminates the adverse effect of the error on the customer. "Upgrade" means a revision of the software released by BEA to its customers to add new and different functions or to increase the capacity of the software. Upgrade does not include the release of a new product or added features for which there may be a separate charge.
Service Packs are available as part of the latest WebLogic Server distribution and as separately downloadable programs that you can add to your existing 6.0 release. However, if you wish to download the Service Pack as a separate upgrade you must have a BEA WebSUPPORT account.
As with most Service Packs, a Service Pack for WebLogic Server 6.0 is a cumulative collection of all previous Service Packs. What this means is that any subsequent Service Pack for WebLogic Server 6.0 will include the fixes provided by any previous Service Pack.
Service Packs for WebLogic Server 6.0
Several Service Packs are available for WebLogic Server 6.0. For a list of available Service Packs and Service Pack descriptions, see the Release Notes for WebLogic Server 6.0.
The highest-level Service Pack, which is recommended for all WebLogic Server 6.0 users, provides the latest updates and upgrades to WebLogic Server 6.0 and its component servers and applications.
Service Packs are included in the latest distributions of WebLogic Server 6.0, which you can download from http://commerce.bea.com. If you do not have WebLogic Server installed, or if your WebLogic Server installation is 5.1 or earlier, you should install this distribution.
If you already have WebLogic Server 6.0 installed, with no Service Pack or with an earlier 6.0 Service Pack, and if you have a BEA eSupport account, you can login and download the Service Pack from http://support.bea.com without downloading the entire WebLogic Server 6.0 distribution.
Note: You must have a BEA eSupport account to download from this site. If you do not have a BEA eSupport account, you can register for one on the site.
A Service Pack is part of an installer file containing new and replacement files for WebLogic Server 6.0 and a copy of the BEA Installation program. A Service Pack installer does not contain a Java Development Kit (JDK).
Service Pack Installation Process
The process of installing a Service Pack on WebLogic Server is as follows. In the process flow, the BEA installation program is referred to as the "SP installer."
As part of the installation, the SP installer moves the base files that will be replaced or deleted by the Service Pack installation into the wls_6.0_prod_dir/uninstaller_servicepack/baseRest.jar file, where wls_6.0_prod_dir represents the target product directory. To view the content of the baseRest.jar file or to recover a replaced or deleted file from the baseRest.jar file, see Viewing and Recovering Files Replaced or Deleted by a Service Pack Installation.
Prerequisites to Installing a Service Pack
Before you can start the installation, you need to complete the following tasks:
Shutting Down Applications and WebLogic Server
Before starting a Service Pack installation, you need to shut down all applications running on your WebLogic Server platform, and then shut down WebLogic Server itself. "Hot installation" of a Service Pack is not supported.
To shut down the default, examples, and Pet Store servers, see Shutting Down the Default, Examples, and Pet Store Servers. For complete information about stopping the WebLogic Server, see "Starting and Stopping WebLogic Servers" in the Administration Guide.
Downloading the Service Pack Installer
Choose any directory on the target system to receive the Service Pack installer and then download the installer to that directory.
Before starting a Service Pack installation, include the path to the JDK 1.3 (or higher) software at the front of the PATH variable setting on the target system. Java 1.3 or higher is required to start the BEA Installation program. For a list of certified JDKs for the various supported platforms, see the Platform Support page at http://download.oracle.com/docs/cd/E13222_01/wls/certifications/certifications/index.html.
To set up your environment on a Windows system, follow these steps:
wls_6.0_prod_dir\config\domain_name
where wls_6.0_prod_dir represents the product directory in which you installed the WebLogic Server software, and domain_name represents the name of the domain you specified during installation (mydomain by default).
setEnv.cmd
To set up your environment on a UNIX system, follow these steps:
wls_6.0_prod_dir/config/domain_name
where wls_6.0_prod_dir represents the product directory in which you installed the WebLogic Server software, and domain_name represents the name of the domain you specified during installation (mydomain by default).
. ./setEnv.sh
Methods of Installing a Service Pack
Use one of the following methods of installation to install a Service Pack on WebLogic Server 6.0:
The three methods of installation are different modes of operation of the BEA Installation program. Currently, the default mode of operation is GUI-mode installation.
Note: "Default" means that entering the installation command without any additional command line parameters (such as -i console) results in GUI-mode installation. In a future release, the default mode for UNIX systems will change to console-mode installation for both Service Pack and WebLogic Server 6.0 base-product installations.
GUI-Mode Installation of a Service Pack
GUI-mode installation of a Service Pack is the graphics-based method of installing the Service Pack on WebLogic Server. It can run on both Windows and UNIX systems.
To run GUI-mode installation, the console attached to the machine on which you are installing the software must support a Java-based GUI. All consoles for Windows systems support Java-based GUIs, but not all consoles for UNIX systems do.
Note: To install a Service Pack on a UNIX system with a non-graphics console, see Console-Mode Installation of a Service Pack.
Starting GUI-Mode Installation on a Windows System
To start a Service Pack upgrade using GUI-mode installation on a Windows system, follow these steps:
Starting GUI-Mode Installation on a UNIX System
To start a Service Pack upgrade using GUI-mode installation on a UNIX system, follow these steps:
java -cp filename.zip install
where filename is the name of the Service Pack installer.
The installation program prompts you to enter specific information about your system and configuration. For instructions on responding to the prompts during the Service Pack installation, see the following table.
Select the language in which to display text during the installation. |
|
Click the Next button to proceed with the installation. You may cancel the installation at any time by clicking Exit. |
|
Specify the BEA Home directory associated with the WebLogic Server instance that is to receive the Service Pack upgrade. For details about the BEA Home directory, see BEA Home Directory. |
|
No user input is required here. The installer program is installing the Service Pack on the target WebLogic Server instance. Note: It is normal for the installation progress bar to stop for a fairly long time, especially at the end. The installer is still working when this occurs. |
|
Congratulations! Your installation of the Service Pack upgrade is complete!
To determine what you need to do next, see Performing Post-Installation and Post-Uninstallation Tasks.
Console-Mode Installation of a Service Pack
Console-mode installation of a Service Pack is the text-based method of installing the Service Pack on WebLogic Server. It can be run only on UNIX systems and is intended for UNIX systems with non-graphics consoles. Console-mode installation offers the same capabilities as graphics-based installation.
Starting Console-Mode Installation
To start a Service Pack upgrade using console-mode installation, follow these steps:
java -cp filename.zip install -i console
where filename is the name of the Service Pack installer.
Running Console-Mode Installation
To complete the console-mode installation process, respond to the prompts in each section by entering the number associated with your choice or by pressing Enter to accept the default. To exit the installation process, enter quit in response to any prompt. To review or change your selection, enter back at the prompt.
Choose the language in which to display text during the installation by entering the number associated with that language. ================================= For example, if you want text to be displayed in French, enter 4 at the CHOOSE LOCALE BY NUMBER prompt. The default is English. |
|
Enter 2 to select the BEA Home directory associated with the WebLogic Server instance that is to receive the Service Pack upgrade. ==================================================== In this example, you enter 2 to display the BEA Home directories that have already been created on this system. At the Existing BEA Home: prompt, you enter 1 to specify /home3/bea as the BEA Home directory for this installation. Make sure that you enter the number associated with the BEA Home directory instead of the directory name. Note: The BEA Home directory serves as a central support directory for all BEA products installed on the target system. For details, see BEA Home Directory. |
|
No user input is required here. The installer program is installing the Service Pack on the target WebLogic Server instance. Note: It is normal for the installation progress bar to stop for a fairly long time, especially at the end. The installer is still working when this occurs. |
|
Congratulations! Your installation of the Service Pack upgrade is complete!
To determine what you need to do next, see Performing Post-Installation and Post-Uninstallation Tasks.
Silent Installation of a Service Pack
Silent installation of a Service Pack installs the Service Pack on WebLogic Server by reading the settings for your configuration from a text file that you create prior to beginning the installation. Manual intervention is not necessary during the installation process. Silent installation works on both Windows and UNIX systems.
Silent installation is a way of setting installation configurations only once and then using those configurations to duplicate the installation on many machines.
Note: Using silent installation implies your consent to the BEA License Agreement. You neither see a copy of the BEA Software License Agreement nor have any means to accept the terms of the agreement.
Using Silent Installation: Main Steps
There are two primary steps in the silent installation process:
For the detailed procedure, see Creating a Template File. Two sample template files are provided in Windows Template File and UNIX Template File.
For the detailed procedure, see Starting SP Silent Installation on a Windows System and Starting SP Silent Installation on a UNIX System.
To create a template file for use in the SP silent installation process, follow these steps:
In the template files, comment lines are preceded by hash marks.
To specify the ServerOnly install set, comment the CHOSEN_INSTALL_SET=ServerExample line and uncomment the CHOSEN_INSTALL_SET=ServerOnly line.
Starting SP Silent Installation on a Windows System
Installing the Service Pack using silent installation takes the same amount of time as a standard installation. During silent installation, an initial Installation Program window appears briefly, indicating that the installation has started. No other windows or prompts are displayed to indicate that the installation is in progress or has completed.
To start a Service Pack upgrade using silent installation on a Windows system, follow these steps:
filename.exe -f full_path/installer.properties
where filename is the name of the Service Pack installer, and full_path is the full pathname for the installer.properties file.
Starting SP Silent Installation on a UNIX System
Installing the Service Pack using silent installation takes the same amount of time as a standard installation. During silent installation, a startup message appears, followed by an "Installing . . ." message, indicating that the installation has started. A short message appears when the installation has completed.
To start a Service Pack upgrade using silent installation on a UNIX system, follow these steps:
java -cp filename.zip install -f full_path/installer.properties
where filename is the name of the Service Pack installer, and full_path is the full pathname for the installer.properties file.
Uninstalling a Service Pack removes all components installed by the Service Pack installation. It does not delete configuration or application files created after the installation.
Uninstalling a Service Pack leaves the original full installation of the WebLogic Server base product, where a base product may or may not have Service Packs already applied. The following examples help clarify the Service Pack uninstallation process.
Result: WebLogic Server 6.0 with Service Pack 1 already applied.
As demonstrated by the first example, if you install multiple Service Packs, you need only uninstall the highest-level Service Pack to revert back to the WebLogic Server base product. As demonstrated by the second example, if you install a WebLogic Server instance with a Service Pack already applied (a full installation), you cannot uninstall that Service Pack.
To uninstall a Service Pack, complete the procedures for the appropriate platform, provided in the following table.
|
|
wls_6.0_prod_dir/config/domain_name where wls_6.0_prod_dir represents the product directory in which you installed the WebLogic Server software, and domain_name represents the name of the domain you specified during installation (mydomain by default). Enter the following command at the prompt: wls_6.0_prod_dir/uninstaller_servicepack where wls_6.0_prod_dir represents the product directory in which you installed the WebLogic Server software. |
When you attempt to install a Service Pack on a WebLogic Server 6.0 instance that already has the same Service Pack installed, the BEA Installation program responds in one of two ways:
Viewing and Recovering Files Replaced or Deleted by a Service Pack Installation
To view the files replaced or deleted by a Service Pack installation, go to the wls_6.0_prod_dir/uninstaller_servicepack directory of the upgraded WebLogic Server instance and enter the following command:
jar tf baseRest.jar
To recover a file replaced or deleted by a Service Pack installation, go to the wls_6.0_prod_dir/uninstaller_servicepack directory of the upgraded WebLogic Server instance and enter the following command:
jar xf baseRest.jar filename
where filename is the name of the file you want to recover.
Performing Post-Installation and Post-Uninstallation Tasks
What you do after installing or uninstalling a Service Pack depends upon the answer to the following question: Have you created any domains in WebLogic Server other than the single domain created during the installation of WebLogic Server?
If the answer is no, proceed to Performing Post-Installation Tasks.
If the answer is yes, you must perform the following additional task after a Service Pack install or uninstall:
Replace the console.war file in each of your customer-created domains with the console.war file in the following path:
wls_6.0_prod_dir/config/mydomain/applications/console.war
where wls_6.0_prod_dir represents the product directory in which you installed the WebLogic Server software, and mydomain is the default name of the domain created during the installation of WebLogic Server.
The Service Pack installer replaces the console.war file of mydomain with a new console.war file, but does not replace the console.war file of any customer-created domain. Similarly, the Service Pack uninstaller replaces the console.war file of mydomain with the original console.war file, but does not replace the console.war file of any customer-created domain.
After you have completed this additional task (if applicable), verify that the Service Pack is installed correctly by performing the tasks in Performing Post-Installation Tasks.
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|