# Installation and Upgrade Guide

# Licensing

This appendix describes how licensing is configured for Analytics. It contains the following sections:

- Licensing Overview
- Installation Behavior
- Upgrading an Existing License
- Merging License Keys

## Licensing Overview

In order to function, Analytics requires a valid license key on the computer on which Analytics is installed. The license file containing this key must be located in the BEA_HOME directory.

By default, BEA_HOME is:

- Unix: /opt/bea
- Windows: C:\bea

Depending on your use case, a different type of license is used. Each license type is defined by the license attributes that govern the behavior of the licensed installation. The following table lists the license types, the most important attribute for each type, and how the license should be obtained.

Table C-1 Use Cases and Corresponding License Types
License Type | Key Attribute | Obtainment Method
--- | --- | ---
Standard Evaluation | Session Limit: Standard Evaluation licenses will allow up to 5 concurrent user sessions. | Standard Evaluation licenses are automatically generated by the Analytics installer.
Extended Evaluation | Expiration: Extended Evaluation licenses expire on a specific date. | Extended Evaluation licenses are obtained by contacting a BEA sales representative.
Production | IP: Product licenses are only valid on a specific IP or within a specific IP range. | Existing customers can obtain Product licenses through elicense.bea.com or licensing@bea.com.

## Installation Behavior

By default, the installer attempts to install a Standard Evaluation license file containing an Analytics key in the BEA_HOME directory.

If a license.bea file exists in the specified location, then the installer prompts you to merge a Standard Evaluation license with the existing license, overwrite the existing license with a Standard Evaluation license, or leave the existing license alone. If you elect to overwrite the existing license, then the installer places a backup of the existing license into the BEA_HOME directory.

If you are installing Analytics on a machine with another BEA products on it (for example, BEA WebLogic Server, AquaLogic Pathways, or AquaLogic Interaction Collaboration), choose to merge the license files when prompted by the installer.

## Upgrading an Existing License

If you are upgrading an existing license to an Extended Evaluation license or a Production license, you can either combine the license keys or replace the existing license file with the new license file. You can obtain product licenses through elicense.bea.com or licensing@bea.com.

If you are upgrading a license on a machine with another BEA product on it (for example, BEA WebLogic Server, AquaLogic Pathways, or AquaLogic Interaction Collaboration), you must merge the license keys for both products into a single file. For more information on merging license keys, see Merging License Keys.

## Merging License Keys

To manually combine two or more license keys into the license.bea file, either use a text editor or the tool provided in BEA_HOME.

By default:

- Unix: BEA_HOME/UpdateLicense.sh
- Windows: BEA_HOME\UpdateLicense.cmd

The path to java.exe must be in the PATH variable. Use the following command to execute the tool:

- Unix: `./UpdateLicense.sh` new_license_file
- Windows: `UpdateLicense.cmd` new_license_file

Replace new_license_file with the name of the file containing the license key you wish to add to license.bea.