Installing a WebLogic license
New XML format and directory with version 4.0.3Beginning with version 4.0, the format of the license file has been changed from a Java class file that you had to compile, to an XML-format file, text-based, that you can edit in any text editor. The WebLogicLicense.xml file can be used with the old-style class files; the class file is read first, the XML file second. You should have only one XML file, with your most recent, most permissive keys at the top; both files are parsed from the top, and the first license read for a particular service is the license that is enforced.
Beginning with version 4.0.3, the default location of the license files has been changed to the /license directory in your WebLogic home directory. This will require a change in the CLASSPATH that you use to start the Server. For more information, see Setting up and Starting WebLogic Server.
Always keep a copy of your license files (either the old-style Java or the newer-style XML) in a safe place, out of the distribution.
Note that if you are depending upon an older-style class license file and the XML-format file for keys, you should delete less-permissive keys from your WebLogicLicense.XML file.
We encourage you to use the licenseConverter utility to convert your old-style class file licenses to the newer XML license files. You should then save the new converted license file in the /license directory. These will be easier and faster to maintain.
Location of the license filesBy default, the license files (both class format and XML-format) are located in the /license directory in your WebLogic home directory.
What you will need to install your WebLogic license
The WebLogic distribution kit that you download is enabled for a 30-day evaluation period, so you can start using WebLogic immediately. To use WebLogic beyond that 30-day evaluation period or to use WebLogic's new clustering features, you will need to contact sales about further evaluation or purchasing a license for each IP address on which you intend to use WebLogic.
All WebLogic products are licensed for use on a single server with up to 3 IP addresses and cannot be used beyond the 30-day evaluation period without a license for that particular IP address. (This does not include applets that use WebLogic classes, which may run from a HTTP server that has the WebLogic classes installed.)
When you receive license keys, you will receive keys in the new XML format, which can be used with any purchased WebLogic licenses in the older class format. Keys will be emailed to you; upon receipt, save the keys into a new (or your existing) XML-format license file as WebLogicLicense.xml in your license directory (by default, in /weblogic/license).
If you purchase more than one product from WebLogic, you will have more than one entry in your license file. If you have purchased licenses for versions previous to 4.0, you may also have more than one license file. All of your license files can be used together; WebLogic will look for multiple license files in both formats in the license directory when the server starts up.
What you will need to begin:
Adding an entry to the license file
You need to add new keys to your existing license file if you have purchased more software, if you have applied for and received an extension to your 30-day evaluation, or if you get a new distribution that includes new products.
You will receive a set of non-expiring license keys by email as an attachment after purchase. If you are evaluating WebLogic's clustering feature, you may receive a set of evaluation keys for clustering.
If you also have purchased licenses prior to version 4.0, you will have a WebLogicLicense.class file, which must be located in either the /weblogic/license or /weblogic/classes directories (or in some directory in your CLASSPATH).
The server looks first for the older-style class file, and second for the XML file. It accepts the first license key it comes to for any particular product. If you have multiple keys in either your older Java license file or the newer XML-format license file, the most permissive, newest keys should be at the top of the license.
Adding an entry to an existing class format license fileThe steps for adding keys to your existing class format license file and creating the new WebLogic.class file are similar to those for adding an entry to an existing XML format license or installing a new release.
When you receive your new license keys by email from WebLogic, paste them at the top of your existing WebLogicLicense.java file (along with the old keys). Save the .java file and then recompile it, creating a new WebLogicLicense.class file. Put this file in the /weblogic/license directory that's in the CLASSPATH for your WebLogic Server.
If you need more information, see adding an entry for step-by-step instructions on this process.
Transferring a license to another IP address
You may need to transfer a permanent license to another machine during upgrades or network moves. The trivial solution, of course, if the old machine is being decommissioned, is to set the IP address of the new machine to the IP address of the decommissioned machine. Then your permanent license will work without any changes.
If you are just moving the WebLogic installation to another machine and the old machine will continue to exist, you will need to change your license file to match the IP address of the new machine. There is a simple process for this.
Checking your WebLogic license and troubleshooting problems
The most common problem with licenses is a mismatched IP address; a mismatch occurs, for example, when you apply for a license key for an IP address that is different from the IP address of the machine on which the product is installed.
Also check that your license has not expired. Beta and evaluation licenses expire after 30 days. Purchased licenses never expire. If your evaluation license has expired, or if you want an evaluation license for clustering features, follow the instructions on the Sales page at http://www.weblogic.com/. Beta licenses can be renewed online in the same process that you used to obtain your first set of license keys.
Verifying your license from the command line
You can use a command-line WebLogic utility to verify your license file installation, the utility showLicenses. Use this facility with the command:
$ java utils.showLicenses -Dweblogic.system.home=path
In version 4.0 and later, when XML-format licenses were introduced, you must either run the showLicenses application from your WebLogic home directory (by default, the root directory of your distribution, where the global properties file is located), or you must set the Java system property weblogic.system.home with a -D option on the command line.
For example, if you have installed the WebLogic distribution in the directory c:\weblogic, and you are currently at the command line in the directory c:\myapps, you can still run the showLicenses utility, with this command:
$ java utils.showLicenses -Dweblogic.system.home=c:\weblogic
The utility shows only those licenses for the machine from which you issue the command. Adding the parameter -a will show all the licenses in your license file.
If the showLicenses command gives you an error or gives you no output, your license file is not properly installed. We have collected tips on the Technical FAQ based on email from our users to help you debug your problems.
If support requests you to send them license output, use the utility writeLicense, which writes output to a file that you can email to support.
Installing a new release
If you keep your WebLogicLicense.XML file with your WebLogic distribution class files, or if you have an old-style class license and have purchased a newer license that is to be added to the WebLogicLicense.xml file, then you should do one of the following when installing an upgrade or new release:
-- or --
-- or --
You should keep a copy of your edited WebLogicLicense.xml and -- if you have old-style licenses -- your WebLogicLicense.java file, along with the original key information you received from WebLogic, outside your working Java space. If you inadvertently delete a license file, you will be able to replace the file.
How license files are foundLicense files are searched for in this order:
Placing the file there will prevent it from being accidentally erased if you delete any of your class directories.
Note that only the first .class or .xml license files found are the licenses which will be read.
Copyright © 2000 BEA Systems, Inc. All rights reserved.