Skip navigation.

ISV Partners' Guide

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents Index View as PDF   Get Adobe Reader

Distributing WebLogic Server

This chapter provides details about the following topics:


Using an ISV Redistribution License

This section includes the following topics, which describe the contents and terms of an ISV redistribution license, and how to install the license:

About the ISV Redistribution License

The WebLogic Server package available from BEA normally includes a license that prohibits the buyer from redistributing the software. However, for partners—Independent Software Vendors (ISVs) in the business of redistributing WebLogic Server—BEA provides a mechanism for creating a redistribution license. Although the purpose of all ISV redistribution licenses is the same (to give an ISV's customers the right to run the WebLogic Server software that has been redistributed by the ISV), each ISV redistribution license is unique, linked specifically to a particular partner.

If you intend to redistribute WebLogic Server, you need to sign a BEA standard Channel License Agreement (CLA), available from your BEA partner account representative. The terms of the CLA define how and when the ISV redistribution license will be distributed. After you sign the CLA, BEA sends you an isv.jar file, which enables you to create two things:

To run the ISV's value-added solution with the redistributed WebLogic Server software, ISV customers must have both the ISV redistribution license and the weblogic.jar file properly installed on their systems.

To learn how to create this license and the weblogic.jar file, see Creating an ISV Redistribution License and Linking It to the WebLogic Server Files.

ISV Redistribution License Technical Enforcement

The ISV redistribution licenses that you create and distribute enable your customers to use WebLogic Server functionality as follows:

Note that while you are constrained to use your WebLogic Server software on only the specific set of machines for which you are licensed, the ISV redistribution license does not similarly constrain your customers to use the WebLogic Server software on specific machines. In this sense, the ISV redistribution license may be somewhat less restrictive for your customers when compared to a license that is tied to one or more IP addresses.

The ISV redistribution license is intended to restrict the usage of WebLogic Server to the usage required by the ISV's software, in accordance with the terms of the ISV's redistribution agreement with BEA. An ISV redistribution license is not intended to grant the ISV's customer unlimited rights to use WebLogic Server software independently of the ISV's application.

Creating an ISV Redistribution License and Linking It to the WebLogic Server Files

To create an ISV redistribution license and link it to the WebLogic Server files, complete the following two-step procedure:

Step 1: Prepare to Create an ISV Redistribution License

Before you create an ISV redistribution license file, complete the following steps:

  1. If you have not already done so, install your WebLogic Server software as described in BEA Products Installation Guide.
  2. Note the location of the BEA Home directory on your system. This directory contains the file license.bea, which is updated during subsequent steps in this procedure. For more information about the BEA Home directory and the license.bea file, see "Selecting Directories for Your Installation" in Preparing for Your Installation in BEA Products Installation Guide.
  3. Copy the isv.jar file you received from BEA into the BEA Home directory associated with this installation.
  4. Open a command shell and go to the server/bin directory for WebLogic Server. For example:
  5. prompt> cd BEA_HOME/weblogic90/server/bin

    Here, BEA_HOME is the environment variable representing the BEA Home directory on your system.

  6. Run the appropriate script:
  7. Add isv.jar to your system CLASSPATH by entering the appropriate command:

Step 2: Extract the License Data and Link the WebLogic Server Files

To extract the ISV redistribution license data and associate it with your WebLogic Server files, complete the following steps:

  1. Go to the BEA Home directory on your system:
  2. prompt> cd BEA_HOME
  3. Enter the appropriate command:

Caution: Do not interrupt this process once it starts!

This command does two things:

  1. Generates a file named license_isv.bea in the BEA Home directory. The license_isv.bea file contains the ISV redistribution license data.
  2. Modifies the weblogic.jar file in your WebLogic Server installation to create a link between that file and the ISV redistribution license data in the license_isv.bea file.

Only the weblogic.jar file in the BEA Home directory tree for which you ran this command can use the ISV redistribution license data extracted to the license_isv.bea file. The linkage and association between those two files is unique.

Note: On some operating systems and JDKs, you might encounter an "Out of Memory Error" message. To address this error, increase the value for the -Xmx argument, which sets the maximum heap size in megabytes, and run the command again. For example, if you specify -Xmx150m on the command line, the default heap size is increased to 150 MB.

Validating the ISV Redistribution License File

To validate that the updated weblogic.jar file works with the newly generated license_isv.bea file, which you created in Step 2: Extract the License Data and Link the WebLogic Server Files, complete the following steps:

  1. Open Windows Explorer or a command shell and navigate to the BEA Home directory from which you generated the ISV redistribution license, typically c:\bea.
  2. Make a backup copy of your license.bea file. For example, at the command prompt, enter the following command:
  3. c:\bea> RENAME license.bea license.bea.backup
  4. Rename the ISV redistribution license file, license_isv.bea, as license.bea. For example, at the command prompt, enter the following command:
  5. c:\bea> RENAME license_isv.bea license.bea
  6. Test your value-added solution in this BEA Home directory to ensure that no error conditions associated with license usage are generated.


Distributing Files

After you have validated that your value-added solution operates properly with the WebLogic Server software that you plan to redistribute, you need to create a process for ensuring that your customers install the following items in the proper locations on their systems:

You have a variety of choices for ensuring that the preceding two files are installed properly by your customers. For example, you can create a custom installer, or a silent-installation script that can be used by the installation program. However, note that there may be circumstances in which your customers might need to replace a pre-existing BEA license file with the ISV redistribution license. In these cases, make certain that your customers use the proper installation method, or follow instructions that you provide, to ensure that all necessary files are installed properly.

If your installation process does not result in both files being installed correctly, your customer will not be able to start your embedded WebLogic Server software.

Note: You can use the same two files for all customer installations.


Service Packs and License Files

The license.bea file that you generate and distribute, as described in Using an ISV Redistribution License, will continue to be valid for any customers who later use the Upgrade Installer to upgrade their installations with service packs for WebLogic Server. As a result, customers who install your distribution of the initial release of WebLogic Server 9.0 can later use the Upgrade Installer to install a service pack without obtaining a new license.

If, however, you provide an upgrade to your existing customers by supplying a whole new version of WebLogic Server that includes a service pack, then you must generate a new license.bea file and include it in your distribution.


Skip navigation bar  Back to Top Previous Next