Installation Guide
Your BEA software requires a valid product license to run. The following sections explain how to acquire, install, and update your product license:
BEA products use an XML-format license file called license.bea
. This license file, stored in the BEA Home directory, is used for the BEA products installed in that directory. Your BEA software checks this file at run time to determine which product components you are authorized to use.
Note: If you have multiple BEA Home directories on your system, each BEA Home must have a license.bea
file that authorizes use of the products associated with that directory.
Licenses are release specific. For example, to use WebLogic Server 9.0, you must have a 9.0 license file. To convert a pre-9.0 license.bea
file to a WebLogic Server 9.0 license.bea
file, see Upgrading Licenses from Previous Software Releases.
The types of license files that can be used as the license.bea
file and the technical restrictions that they impose are described in the following table.
Note: See the End User License Agreement for specific license terms and conditions.
|
|
|
When you install your software, a non-expiring development license file (license.bea
) is installed on your system. By default, your software uses the development license installed with the product so that you can start using it immediately. Subsequently, when you install additional BEA products that include a license.bea
file, the installation program automatically adds the new product licenses to the license.bea
file.
Note: The license.bea
file conforms to the XML grammar definition. The XML definition (<?xml version="1.0" encoding="UTF-8"?>
) must be at the very beginning of the license.bea
file. There cannot be any spaces or line breaks before the XML definition.
For a description of the product offerings supported by the BEA Products license files, see the Licensing page at the following URLs:
http://download.oracle.com/docs/cd/E13179_01/common/docs90/interm/license.html
(WebLogic Server)http://download.oracle.com/docs/cd/E13179_01/common/docs20/interm/license.html
(AquaLogic Service Bus)
When you install your BEA software, the installation program generates a development license.bea
file for use with the software and installs it in the BEA Home directory. If you are installing your software in an existing BEA Home, the installation program automatically adds the development license included with your product distribution to the existing license.bea
file.
In some cases, however, you must update the license.bea
file separately, independent of the installation process. For example, you must update your license file if at least one of the following is true:
In each of these cases, you will receive a new license file from BEA, the contents of which must be included in the license.bea
file in the target BEA Home directory. To facilitate the license update process, BEA provides an UpdateLicense
utility that merges the new license into the existing license in the BEA Home directory, and deletes any expired or duplicate entries.
The UpdateLicense
merge process is not intended to modify the license attributes for any component or feature in the license files being merged. For example:
http://elicense.bea.com
.When determining how to update your license.bea
file, you should consider the following:
UpdateLicense
utility. For instructions, see Updating license.bea Using the UpdateLicense Utility.license.bea
file with a new license.bea
file, but if you do so, you run the risk of losing the product usage rights enabled by your existing license file. Note: Do not edit the license.bea
file manually. Doing so may cause operating problems for the currently installed BEA products, or result in problems later when BEA products are installed for maintenance upgrades.
To update your license.bea
file, perform the following procedure:
license.bea
, in the target BEA Home directory. For example, save the file as new_license.bea
. Use this file as the license_update_file
in step 4 of this procedure.PATH
variable by entering the following commands:In this command, JDK
represents the directory that contains the Java 2 JDK being used for this installation, for example, jdk150_03
or jrockit90_150_03
.
The format of the license.bea
file changes with each release of BEA Products software. To upgrade a license.bea
file from a previous release to a license for the current release, complete the following steps:
http://elicense.bea.com
.Note: You need a BEA eLicense account to log in to this Web site. If you do not have a BEA eLicense account, click the Register link on the Customer Support site to register for one.
You will receive an upgraded license file through e-mail. To update the license.bea
file on your system, see Updating license.bea Using the UpdateLicense Utility.
In some cases, BEA distributes software for promotional purposes on CD. Such CDs include installers that do not automatically generate a development license key. Instead, the CD folio directs you to a BEA Web site, where you can obtain a development license file after you supply a code from the CD folio. The license file you obtain allows you to begin using the software immediately, and entitles you to the same usage rights described for the development license in Table 6-1.
When you receive this license file from BEA, complete the following steps: