| products | dev2dev | support | askBEA
 Download Docs   Site Map   Glossary 

Installation Guide

 Previous Next Contents Index View as PDF  

Installing and Updating a WebLogic Server License

WebLogic Server requires a valid product license to run. The following sections explain how to acquire, install, and update a WebLogic Server license:


About the WebLogic Server License

WebLogic Server uses an XML-format license file called license.bea. This license file, stored in the BEA Home directory, is used for the BEA WebLogic products installed on the target system. For details about the BEA Home directory, see BEA Home Directory.

Evaluation Licenses

The first time you download and install a BEA WebLogic product, the installation program installs a 90-day evaluation license so that you can start using the product immediately. Subsequently, when you download and install additional BEA products that contain a license.bea file as part of the distribution, the installer program automatically adds the new evaluation product licenses to the license.bea file, but does not extend the evaluation period.

To use WebLogic Server beyond the 90-day evaluation period, contact your salesperson about extending the evaluation period or purchasing a development or production license.

All WebLogic Server evaluation products are licensed for use on a single server machine and allow up to 20 connections to the server.

Development and Production Licenses

When you purchase a WebLogic Server development or production license, you receive a license through e-mail to replace the evaluation license installed with WebLogic Server. After installing the WebLogic Server software and receiving the development or production license, you must update the existing license.bea file with the license file you received. See Updating Your license.bea File.


Updating Your license.bea File

You must update your license.bea file if at least one of the following is true:

In each case, you receive a license update file in an e-mail attachment. You then update your license.bea file by performing the following procedure:

Note: Enabling 128-bit encryption requires that the 128-bit encryption license be present in the license.bea file before you install the WebLogic Server software. For details, see Enabling 128-Bit Encryption.

  1. Save the license update file that you received through e-mail with a name other than license.bea, in the target BEA Home directory. For example, save the file as platform_license.bea. Use this file as the license_update_file in step 4 of this procedure.

    Warning: Do not overwrite or change the name of the existing license.bea file.

  2. Open a command shell and go to the target BEA Home directory.
  3. If it is not already included, add the JVM to your PATH variable by entering the following commands:

    Note: If you are using a JVM other than the Sun Java 2 SDK 1.4.1, modify the commands above to fit your environment.

  4. Merge the license update file into your existing license by entering one of the following commands:

    license_update_file is the name to which you saved the license update file in step 1.

  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.


Enabling 128-Bit Encryption

Two levels of secure sockets layer (SSL) encryption are available for WebLogic Server: 56-bit and 128-bit. An evaluation license comes with only 56-bit encryption enabled, whereas a developer or production license may be purchased with either 56-bit or 128-bit encryption enabled.

The installer program must find the 128-bit encryption license in the license.bea file before the installer enables 128-bit encryption for the WebLogic Server installation. If the installer program does not find a WebLogic Server license in the license.bea file, or finds only a 56-bit encryption license for WebLogic Server in the license.bea file, the installer includes 56-bit SSL plug-ins in the WebLogic Server installation. If the installer program finds a 128-bit encryption license for WebLogic Server in the license.bea file, the installer includes both 56-bit and 128-bit SSL plug-ins in the WebLogic Server installation.

Note: A 128-bit license is required to be available before installation due to United States Export control laws. BEA is not allowed, by U.S. law, to install 128-bit capable code on any machine that does not have the appropriate license. If you already installed WebLogic Server without the 128-bit encryption license and you want 128-bit encryption, you need to uninstall the software, place the 128-bit encryption license for WebLogic Server in the BEA Home directory, and then reinstall WebLogic Server.

When creating a brand new BEA Home directory for a WebLogic Server installation intended for 128-bit encryption, proceed as follows:

  1. Acquire a 128-bit encryption license for WebLogic Server.

    For details, contact BEA Sales at

  2. Create a new directory that you want use as a BEA home directory and place the 128-bit encryption license in the new directory. The license file must be named license.bea.
  3. Install the WebLogic Server software.

    For instructions, see one of the following installation procedures:


Upgrading Licenses from WebLogic Server 6.x and 7.x

The format of the license.bea file changes with each release of WebLogic Server. To convert a license.bea file from a previous release of a WebLogic Server component product to a license for the current version, complete the following steps. Be sure the license.bea license file from the previous release is available on the machine on which you perform this procedure.

For information about upgrading your WebLogic Server installation, see the Upgrade Guide.

  1. Log in to the BEA Customer Support Web site at

    Note: You need a BEA eSupport account to log in to this Web site. If you do not have a BEA eSupport account click the Register link on the Customer Support site to register for an account.

  2. Go to the Product Update and License Key Forms section. You may need to scroll down.
  3. Click the appropriate link to update your WebLogic Server license.
  4. Browse and select the license files to be converted, or enter the pathname in the box provided. Then click I Accept to agree to the terms listed and to submit license files for conversion.
  5. You will receive the converted license file through e-mail. To update the license.bea file on your system, see Updating Your license.bea File.


Back to Top Previous Next