Installing and Uninstalling Service Pack Upgrades

 

This section provides the information you need to upgrade your WebLogic Integration installation using the service pack upgrade installer. Topics include:

• Service Pack Upgrade Installation Process

• Prerequisites to Installing a Service Pack Upgrade

• Methods of Installing a Service Pack Upgrade

• Installing the Service Pack Upgrade Using Graphics Mode

• Installing the Service Pack Upgrade Using Console Mode

 

---

Service Pack Upgrade Installation Process

The process of installing a service pack upgrade on WebLogic Integration is as follows:

1. The user specifies the BEA Home directory for the WebLogic Integration 2.1 instance targeted to receive the service pack update.

2. The service pack upgrade installer finds the product directory for the WebLogic Integration 2.1 instance and proceeds to install the service pack upgrade.

3. The service pack upgrade installer prompts you to migrate your database. You can do this immediately or later, using menu shortcuts or command scripts.

As part of the installation, the service pack upgrade installer moves the base files that will be replaced or deleted by the service pack installation into the following file:

WLI_HOME/uninstaller_servicepack/baseRest.jar

In this pathname, WLI_HOME represents the directory in which you installed WebLogic Integration 2.1. 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 Upgrade.

The service pack upgrade installer also makes backup copies of any files modified by the installer and places the copies of these files in the following directory:

WLI_HOME/servicepacks/sp_num/backup

In this pathname, WLI_HOME is the directory in which you installed WebLogic Integration 2.1 and sp_num is the service pack designation, such as SP1. The backup folder includes subfolders that match folders in the product directory. You may need to review the backup files so you can make similar modifications to the new versions of the files, if desired. The backup copies are for your use. The service pack upgrade installer and uninstaller do not use these files.

 

---

Prerequisites to Installing a Service Pack Upgrade

Before you can start the installation, you need to complete the following tasks:

• Shut down all applications running on the target WebLogic Integration platform, including WebLogic Server. For information about shutting down WebLogic Integration, see "Stopping WebLogic Integration" in Getting Started in Starting, Stopping, and Customizing BEA WebLogic Integration.

  Note: Hot installation of a service pack upgrade is not supported.

• Download the service pack upgrade installer to the target system. For details about downloading the service pack upgrade, see Downloading the Service Pack Upgrade.

• Include the path to JDK 1.3 (or higher) at the front of the PATH variable setting on the target system. JDK 1.3 is required to successfully run the BEA Installation program. You can include the path to JDK 1.3 in your PATH variable by executing the setenv command as described in Setting Up Your Environment.

Before you migrate your database repository, we recommend that you back up your entire database and export all your workflows. With this preparation, you will be able to fix the environment as necessary and start the migration again if your first migration attempt fails. You can run the migration script as many times as necessary without causing any adverse effects.

Setting Up Your Environment

To set up your environment on a Windows system, follow these steps:

1. Log in to the Windows system.

2. Open a Command Prompt window.

3. Go to the WLI_HOME directory, where WLI_HOME represents the product directory in which you installed the WebLogic Integration software.

4. Enter the following command:

   setEnv.cmd

To set up your environment on a UNIX system, follow these steps:

1. Log in to the UNIX system.

2. Open a command-line shell.

3. Go to the WLI_HOME directory, where WLI_HOME represents the product directory in which you installed the WebLogic Integration software.

4. Enter the following command:

   . ./setenv.sh

 

---

Methods of Installing a Service Pack Upgrade

Use one of the following methods of installation to install a service pack upgrade on WebLogic Integration 2.1:

• Graphics-mode installation (Windows or UNIX)

  Note: To run the installer in graphics mode, make sure the console attached to the machine on which you are installing the software supports a Java-based GUI. All consoles for Windows systems support Java-based GUIs, but not all consoles for UNIX systems do so.

  To install a service pack on a UNIX system with a non graphics console, see Installing the Service Pack Upgrade Using Console Mode.

• Console-mode installation (UNIX only)

The two methods of installation can be used by invoking the BEA Installation program in different modes. Currently, the default mode of operation is graphics-mode installation.

Note: Default means that entering the installation command without any additional command-line parameters (such as -i console) results in graphics-mode installation.

 

---

Installing the Service Pack Upgrade Using Graphics Mode

Perform the following steps to complete the upgrade installation in graphics mode on UNIX and Windows platforms.

1. Start the upgrade installer as described in the following table.

   To start the upgrade installer on this platform . . .	Perform the following steps . . .
   Windows	Log in to the Windows system. Go to the directory in which you downloaded the service pack upgrade installer. Invoke the installation procedure by double-clicking wlintegration21sp1_upgrade_win.exe. Proceed to step 2.
   UNIX	Log in to the UNIX system. Open a command-line shell. Go to the directory in which you downloaded the service pack installer. Invoke the installation procedure by entering the following: java -cp wlintegration21sp1_upgrade_unix.zip install Proceed to step 2.

   
    

2. Review the text in the Welcome dialog box and click Next.

   The Choose BEA Home Directory dialog box is displayed, as shown in the following figure.

   
    

3. Specify the BEA Home directory associated with the WebLogic Integration instance that is to receive the service pack upgrade.

4. Click Next. The upgrade installer installs the service pack upgrade on the target WebLogic Integration 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.

   When the upgrade installation is complete, the Database Migration Option dialog box is displayed. The Windows version of this dialog box is shown in the following figure.

   
    

5. Do one of the following:

   • If you want to migrate the database immediately, select Run Migration Now, and Click Done. The Choose Configuration Option dialog box from the Database Configuration Wizard is displayed. For details on migrating your database repository, see Migrating WebLogic Integration 2.1 to WebLogic Integration 2.1 Service Pack 1 in Migrating to BEA WebLogic Integration Release 2.1.

   • If you want to migrate the database at a later time, click Done. You can invoke the wizard at any time using the Start menu shortcuts (Windows only) or the command-line scripts (Windows and UNIX). For details on migrating to WebLogic Integration 2.1 SP1, see Migrating WebLogic Integration 2.1 to WebLogic Integration 2.1 Service Pack 1 in Migrating to BEA WebLogic Integration Release 2.1.

Caution: You must migrate your database before using the upgraded WebLogic Integration 2.1 SP1 installation.

Congratulations! Your installation of the service pack upgrade is complete!

 

---

Installing the Service Pack Upgrade Using Console Mode

Console-mode installation of a service pack upgrade is the text-based method of installing the service pack on WebLogic Integration 2.1. 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.

To install a service pack upgrade using console-mode installation, follow these steps:

1. Log in to the UNIX system.

2. Open a command-line shell.

3. Go to the directory in which you downloaded the service pack upgrade installer.

4. Invoke the installation procedure by entering

   java -cp wlintegration21sp1_upgrade_unix.zip install -i console

   The message Preparing to install is displayed, followed (within a couple of moments) by the message Preparing CONSOLE Mode Installation. Once preparation is complete, the following introductory message is displayed:

   =========================================================
   Introduction
   ------------
   This installer will guide you through the installation of
    'WebLogic Integration'. On each step, answer the questions
    provided.  Type "quit" at any time to exit the installer.
    
   PRESS <ENTER> TO CONTINUE:
   =========================================================

5. Press Enter to continue.

   You are prompted to choose the BEA Home directory associated with the WebLogic Integration instance that is to receive the service pack upgrade, as shown in the following text:

   ==============================================================
   Choose BEA Home Directory
   -------------------------
    
     1- /home1/bea
     2- /home2/beahome
    
   Existing BEA Home:
   ==========================================================

6. Enter the number corresponding to the directory associated with the WebLogic Integration instance that is to receive the service pack upgrade.

   The installation begins and the installation status is displayed as it progresses.

   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.

   When the installation is complete, the following text is displayed:

   ========================================================
   Install Complete
   ----------------
    
   Congratulations! The installation of Service Pack 1
   for WebLogic Integration 2.1 is complete. This service pack
   upgrade installer requires a database migration to be run.
   The migration utility can be run through the provided scripts.
    
   Press "Enter" to quit the installer:

7. Press Enter to exit the installer.

   Congratulations! Your installation of the service pack upgrade is complete!

   For details on migrating your database repository, see Migrating WebLogic Integration 2.1 to WebLogic Integration 2.1 Service Pack 1 in Migrating to BEA WebLogic Integration Release 2.1.

 

---

Uninstalling a Service Pack Upgrade

Uninstalling a service pack upgrade removes all components installed by the service pack upgrade installation. It does not delete configuration or application files created after the installation.

Uninstalling a service pack upgrade leaves the original full installation of the WebLogic Integration base product. For example, if you have WebLogic Integration 2.1 installed on your system, and you install the WebLogic Integration 2.1 Service Pack 1 upgrade, you can uninstall the service pack upgrade to revert back to the WebLogic Integration 2.1 version of the product. To uninstall the original full installation after uninstalling the service pack upgrade, see Uninstalling WebLogic Integration.

To uninstall a service pack upgrade, complete the procedure for the appropriate platform, provided in Table 4-1.

Table 4-1 Service Pack Upgrade Uninstallation Procedures

To uninstall the service pack on this platform . . .	Complete the following procedure . . .
Windows	Shut down any servers that are running. From the Windows Start menu, choose Start—>Programs—>BEA WebLogic E-Business Platform—>WebLogic Integration 2.1—>Uninstall Service Pack Upgrade. The BEA Installation program Uninstaller window appears. Click Uninstall to start the uninstall program. Click Exit in the Uninstall Complete window.
UNIX	Shut down any servers that are running. Set the PATH and CLASSPATH variables to include the location in which JDK 1.3 (or higher) is installed. You can include them as arguments on the Java command line, or by executing a sample script provided with your software. To execute the script, go to the WLI_HOME directory, where WLI_HOME represents the product directory in which you installed the WebLogic Integration software. Enter the following command at the prompt: . ./setenv.sh Go to the following directory: WLI_HOME/uninstaller_servicepack WLI_HOME represents the product directory in which you installed the WebLogic Integration software. Choose one of two methods for uninstalling the software: To use the GUI-mode installation program, go to step 5. To use the console-mode procedure, go to step 6. (GUI-mode method) Enter the sh uninstall_sp command at the prompt. In the Uninstaller window, click Uninstall to start the uninstall program, then click Exit in the Uninstall Complete window to complete the uninstallation. (Console-mode method) Enter the following command at the prompt: sh uninstall_sp -i console When the uninstall process is complete, press Enter to exit the uninstaller.

 

---

Viewing and Recovering Files Replaced or Deleted by a Service Pack Upgrade

To view the files replaced or deleted by a service pack upgrade installation, go to the WLI_HOME/uninstaller_servicepack directory of the upgraded WebLogic Integration instance and enter the following command:

jar tf baseRest.jar

To recover a file replaced or deleted by a service pack upgrade installation, go to the WLI_HOME/uninstaller_servicepack directory of the upgraded WebLogic Integration instance and enter the following command:

jar xf baseRest.jar filename

Here filename is the name of the file you want to recover.

The service pack upgrade installer also makes backup copies of files modified by the installer and places the copies in the following directory:

WLI_HOME\servicepacks\sp_num\backup

In this pathname, WLI_HOME represents the product directory in which you installed WebLogic Integration, and sp_num is the service pack designation, such as sp1. To recover a file that has been modified, locate the file in the WLI_HOME\servicepacks\sp_num\backup directory. For writable files, you can copy and paste the entire file, or portions of the file, into the new file to reinstate specific settings or other information.