Installation Guide

Licensing

Your BEA WebLogic Personal Messaging API distribution requires a valid product license to run. This chapter contains the following sections that explain how to acquire and install the BEA WebLogic Personal Messaging API license:

About WebLogic Personal Messaging API License

The WebLogic Personal Messaging API uses an XML-format license file called license.bea. The Personal Messaging API checks this file at run time to determine which BEAWebLogic software components you are authorized to use.

Note: If you have other BEA directories on your system, each BEA_HOME directory must have a license.bea file that authorizes use of the products associated with that directory.

The types of license files that can be used as the license.bea file and the technical restrictions that they impose are described in Table 2-1.

Note: See the BEA Software License Agreement for specific license terms and conditions.

Table 2-1 License Types and Descriptions

License Type

Description

Development

Used in a development environment where a developer is preparing an application to use the Personal Messaging API; a production license is required for deployment.

Enables all Providers of the Personal Messaging API.

Is not tied to the IP address of a machine.

Production

Used in full-scale production environments.

May restrict functionality to the software components that you have purchased.

Permits service interactions and connections to and from an unlimited number of IP addresses.

Must be purchased separately. For information about purchasing a production license, contact your sales representative or visit the BEA web site at http://www.bea.com.

Installing and Updating License Files

To update your license.bea file, perform the following procedure.

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 new_license.bea.

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

Merge the license file contents into your existing license.bea file using a text editor.

Note: Your license file may be found by the software in one of the following ways:

By setting the bea.home Java system property in your application (all delivered scripts do this).
By placing the license.bea file somewhere in your CLASSPATH.

Save a copy of your updated license.bea file in a safe place outside the WebLogic 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.