Skip navigation.
Downloads | Product Documentation | Support

ISV Partners' Guide

# Distributing WebLogic Server

This chapter provides details about the following topics:

- Using an ISV Redistribution License
- Distributing Files
- Service Packs and License Files

# 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
- ISV Redistribution License Technical Enforcement
- Creating an ISV Redistribution License and Linking It to the WebLogic Server Files
- Validating the ISV Redistribution License File

## 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:

- An ISV redistribution license, which is the ISV customer's run-time license to use the redistributed WebLogic Server software
- A customized `weblogic.jar` file, which links the WebLogic Server software to the ISV redistribution license

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:

- The specific set of BEA components to which your customers can have access—for example, WebLogic Server—is specified in your license distribution agreement with BEA and is enforced by the ISV redistribution license. This mechanism ensures that run-time support is restricted to the BEA components specified in that agreement.
- If your license distribution agreement is for WebLogic Server only, the ISV redistribution license prevents the run-time use of BEA products that are not included with WebLogic Server, such as WebLogic Portal.
- There is no enforced limit on the number of IP or database connections that can be made by an installation of the WebLogic Server software distributed by the ISV.
- There is no expiration date on the use of the BEA software distributed by the ISV.
- The ISV redistribution license is not tied to any specific IP address. Therefore, the BEA software that you distribute with an ISV redistribution license can be used on any machine.

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
- Step 2: Extract the License Data and Link the WebLogic Server Files

### 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:

>     prompt> cd BEA_HOME/weblogic90/server/bin

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

5. Run the appropriate script:

- Windows: `setWLSEnv.cmd`
- UNIX: `setWLSEnv.sh`

6. Add `isv.jar` to your system `CLASSPATH` by entering the appropriate command:

- Windows: `set CLASSPATH=.\isv.jar;%CLASSPATH%`
- UNIX: `export CLASSPATH=./isv.jar:$CLASSPATH`

### 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:

>     prompt> cd BEA_HOME

2. Enter the appropriate command:

- Windows:

`java -Xmx128m -Dbea.home=%BEA_HOME%
-Dbea.jar=%BEA_HOME%\weblogic90\server\lib\weblogic.jar install`

- UNIX:

`java -Xmx128m -Dbea.home=$BEA_HOME
-Dbea.jar=$BEA_HOME/weblogic90/server/lib/weblogic.jar install`

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:

>     c:\bea> RENAME license.bea license.bea.backup

3. Rename the ISV redistribution license file, `license_isv.bea`, as `license.bea`. For example, at the command prompt, enter the following command:

>     c:\bea> RENAME license_isv.bea license.bea

4. 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:

- The ISV redistribution license
- The `weblogic.jar` file associated with the ISV redistribution license

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.