Post-Installation Tasks

 

This section provides information for tasks you may need to perform after you have installed the WebLogic Integration software:

• Installing Your Software License

• What Are the Next Steps?

• Uninstalling WebLogic Integration

 

---

Installing Your Software License

WebLogic Integration cannot be used without a valid software license. You may or may not need to install a license at this point in the installation process.

You do not need to install a software license now if you have downloaded WebLogic Integration for evaluation. In this case, a 30-day evaluation license is automatically installed.

If you have not already installed your license, you must do so now, as described in this section.

Note: If you purchase the software on CD-ROM, the WebLogic Integration license is provided on a diskette in the product box. If you purchase a license for a downloaded copy of the product, the license is sent to you as an e-mail attachment.

To install the WebLogic Integration software license:

1. Save the license file from the appropriate diskette or e-mail attachment, with a name other than license.bea, in the BEA Home directory. For example, save the file as wli_license.bea. Use this file as the license_update_file in step 4 of this procedure.

   Warning: Do not overwrite the existing license.bea file.

2. Perform the step appropriate for your platform:

   • On a Windows system, open an MS-DOS session and go to the BEA Home directory.

   • On a UNIX system, go to the BEA Home directory.

3. If it is not already included, add the JDK to your PATH variable by entering one of the following commands:

   • On a Windows system:

     set PATH=BEA_HOME\jdk131\bin:%PATH%

   • On a UNIX system:

     set PATH=BEA_HOME/jdk131/bin:$PATH

4. Enter one of the following commands:

   • On a Windows system:

     UpdateLicense license_update_file

   • On a UNIX system:

     sh UpdateLicense.sh license_update_file

5. Save a copy of your updated license.bea file in a safe place outside the WebLogic Integration and application installation directories.

   Although no one else can use your license file, you should save it in a place that is protected from both malicious and innocent tampering.

Installing Your Power.Enterprise! License

Whether you download Power.Enterprise! as part of the BEA WebLogic Integration 2.1 installation or install it from CD-ROM, you must obtain your Power.Enterprise! 3.0 evaluation license from the BEA Web site, at the following URL:

http://commerce.bea.com/downloads/weblogic_integration.jsp

A Power.Enterprise! production license is provided when you purchase BEA WebLogic Integration. For more information, please contact your BEA sales representative.

The Power.Enterprise! software requires two license keys: one for the server, Power.Server!, and the other for the clients, Power.Manager! and Power.Map!. For evaluation purposes, the same license key that you download from the BEA Web site can be used for both client and server Power.Enterprise! software.

During installation of the Power.Enterprise! client and server software, you are prompted to enter the license key. Please note that the evaluation license key expires 30 days after the license key is generated. (This is different from the behavior of the BEA WebLogic Integration evaluation license, which expires 30 days after the software is installed.)

Note: Power.Enterprise! license keys are platform-specific. Thus, for example, a license key generated for a Solaris platform will not work on a Windows platform.

When you purchase a permanent license for BEA WebLogic Integration, you also receive a permanent license for the Power.Enterprise! software.

To upgrade from an evaluation license to a permanent one, use one of the following procedures:

• On Windows, launch the "License Activator (client)" or "License Activator (server)" from the PowerIt program group. A dialog box is displayed. Enter the new license key in the appropriate field.

• On UNIX, go to the Power.Enterprise!_installation_directory/bin directory and execute the license_key_activator.sh script. An X Window-based user interface is launched, allowing you to upgrade the license key.

 

---

What Are the Next Steps?

Before you can start the WebLogic Integration software, you need to configure and initialize the WebLogic Integration repository for the preconfigured domains. A database configuration wizard is provided to facilitate this task. Details about creating and initializing the database using the configuration wizard are provided in "Domain Configuration Requirements" in Getting Started in Starting, Stopping, and Customizing BEA WebLogic Integration.

Note: If you upgraded your installation from WebLogic Integration 2.1 to WebLogic Integration 2.1 SP1, you need to migrate your database as described in Migrating WebLogic Integration 2.1 to WebLogic Integration 2.1 Service Pack 1 in Migrating to BEA WebLogic Integration Release 2.1.

After you configure the database, we recommend that you execute the sample applications. The samples offer a variety of benefits: they verify that the software is installed correctly, they provide sample code, and they demonstrate implementation techniques. Before executing any samples, perform the procedure provided in "Configuring and Starting the Samples Domain" in Getting Started in Starting, Stopping, and Customizing BEA WebLogic Integration. Complete information about running the samples is provided in the following documents:

• Learning to Use BEA WebLogic Integration

• Running the B2B Integration Samples

• Learning to Use BPM with WebLogic Integration

 

---

Uninstalling WebLogic Integration

This section provides platform-specific procedures for uninstalling WebLogic Integration 2.1 and WebLogic Integration 2.1 Service Pack 1 (installed using the full SP1 installer).

Note: If you installed Service Pack 1 using the upgrade installer, you should first uninstall the upgrade, then uninstall WebLogic Integration 2.1. For details about uninstalling the service pack upgrade, see Uninstalling a Service Pack Upgrade.

See the section appropriate for your platform:

• Uninstalling WebLogic Integration from a Windows System

• Uninstalling WebLogic Integration from a UNIX System

Uninstalling WebLogic Integration from a Windows System

To uninstall WebLogic Integration from a Windows system:

1. Do one of the following:

   • Choose Start—>Programs—>BEA WebLogic E-Business Platform—>WebLogic Integration 2.1—>Uninstall WebLogic Integration 2.1 (sp1).

     Note: (sp1) appears on the Start menu only if you installed WebLogic Integration 2.1 SP1 using the full installer.

   • Choose Start—>Run. Click Browse in the Run dialog box, then locate and execute the uninstall.exe file. This file is in the wlintegration2.1\uninstaller subdirectory of the BEA Home directory.

   The Uninstaller dialog box is displayed.

2. Click Uninstall to remove WebLogic Integration. When the program has been removed, the Uninstall Complete dialog box is displayed.

3. Click Exit to dismiss the dialog box.

Uninstalling WebLogic Integration from a UNIX System

You can uninstall WebLogic Integration on UNIX systems using either graphics mode or console mode.

Graphics Mode

Use the following procedure to uninstall WebLogic Integration from a UNIX system with a graphics (windowing) terminal or workstation:

1. Go to the BEA Home directory that contains the copy of WebLogic Integration 2.1 that you want to uninstall.

2. Enter the following command:

   sh wlintegration2.1/uninstaller/uninstall

   When the uninstallation process is complete, the message Uninstall Complete is displayed.

Console Mode

Use the following procedure to uninstall WebLogic Integration from a system that does not include a graphics terminal or workstation:

1. Go to the BEA Home directory that contains the copy of WebLogic Integration 2.1 that you want to uninstall.

2. To start the uninstaller, enter the following command at the prompt:

   sh wlintegration2.1/uninstaller/uninstall -i console

   The message Preparing CONSOLE uninstall is displayed. Once preparation is complete, a message announcing that the uninstallation process is about to begin is displayed, as shown in the following text:

   ===============================================================
   WebLogic Integration 2.1  (InstallAnywhere Uninstaller by Zero G)
   ---------------------------------------------------------------
    
   About to uninstall...
    
      WebLogic Integration 2.1
    
   This will completely remove all components installed by
   InstallAnywhere.  It will not remove files and folders created
   after the installation.
    
   PRESS <ENTER> TO BEGIN THE UNINSTALL, OR 'QUIT' TO EXIT THE
   UNINSTALLER:
   ===============================================================

3. Press Enter to start uninstalling WebLogic Integration.

   When the uninstallation process is complete, the Uninstall Complete message is displayed. Any directories that the uninstaller cannot remove are listed.

4. Press Enter to exit the uninstaller.