# Installing WebLogic RFID Enterprise Server

# Preparing for Your Installation

The following sections provide information that you need to know before installing your BEA WebLogic RFID Enterprise Server software:

- Installation Overview
- Installation Modes
- Product Installation Components
- Product Distribution Methods
- Installation Prerequisites
- Selecting Directories for Your Installation
- Choosing the Type of Installation
- Generating a Verbose Installation Log

## Installation Overview

WebLogic RFID Enterprise Server is installed as an application suite running on WebLogic Server 9.2.

A purchase of WebLogic RFID Enterprise Server includes:

- WebLogic Server license
- WebLogic RFID Enterprise Server license, which includes all Enterprise Server components (there are no licenses for individual components)

Note: | WebLogic Server software and WebLogic RFID Enterprise Server software are available for download at http://commerce.bea.com.

The major installation and configuration steps are:

1. Install WebLogic Server 9.2.

See BEA Products Installation Guide.

Note: | WebLogic Server 9.2 is required for RFID Enterprise Server 2.0. You cannot use WebLogic Express 9.2 because the Enterprise Server requires several services which are only available in WebLogic Server.

2. Install WebLogic RFID Enterprise Server 2.0 in your WebLogic Server 9.2 BEA Home directory.

The WebLogic RFID Enterprise Server installation program provides a framework for the installation and uninstallation of the RFID Enterprise Server software product. The installation program installs all RFID Enterprise Server components. You select which components to configure when you create a domain with the Configuration Wizard.

See Starting the Installation Program.

For license information, see Installing and Updating License Files.

3. Create a domain. Use the RFID Enterprise Server Configuration Wizard to select Enterprise Server components and perform initial domain configuration steps.

See Post-Installation Information.

4. Perform additional RFID Enterprise Server configuration.

See Configuring WebLogic RFID Enterprise Server.

## Installation Modes

The WebLogic RFID Enterprise Server installation program can be used in the following modes:

- Graphical mode

Graphical-mode installation is an interactive, GUI-based method for installing your software. It can be run on Windows and Linux systems that support a Java-based GUI. See Running the Installation Program in Graphical Mode.

Note: | In order to run a graphical-mode installation, the console attached to the machine on which you are installing the software must support a Java-based GUI. All consoles for Windows systems support Java-based GUIs, but not all consoles for Linux systems do. If you attempt to start the installation program in graphical mode on a system that cannot support a graphical display, the installation program automatically starts console-mode installation.

- Console mode

Console-mode installation is an interactive, text-based method for installing your software from the command line, on either a Linux system or a Windows system. See Running the Installation Program in Console Mode.

Note: | WebLogic RFID Enterprise Server 2.0 does not support silent-mode installation.

Table 2-1summarizes the supported modes for installation, configuration, and uninstallation.

Table 2-1 Supported Modes for Installation, Configuration, and Uninstallation
| GUI Mode | Console Mode | Silent Mode
--- | --- | --- | ---
Installation | Yes | Yes | No
Configuration Wizard | Yes | No | No
Uninstallation | Yes | Yes | No

## Product Installation Components

The WebLogic RFID Enterprise Server installation program installs the following components on your system:

- Event Service and Data Exchange Service (includes Master Data Service)—The core set of services that capture and store RFID event data from the edge, create master data to associate with the event data, and define subscriptions that query the event data and send results to internal or external destinations.
- Reporting Service—Provides a set of useful pre-defined queries, which are accessed through the Reporting Service Console.
- Serial Number Assignment Service—Allocates blocks of Electronic Product Codes (EPCs) for requesting systems.
- Edge Management—Provides remote administration and monitoring of Edge Servers and RFID devices.

Note: | After installing RFID Enterprise Server 2.0, you will select a JDK when you run the Configuration Wizard. The Configuration Wizard displays a list of all the JDKs found in BEA Home. When selecting a JDK for use with WebLogic RFID Enterprise Server 2.0, you must select a JDK version 1.5 or higher.

## Product Distribution Methods

Your BEA software is distributed on both the BEA Web site and CD-ROM.

### Web Distribution

You can download your software from the BEA Web site at `http://commerce.bea.com`.

### CD-ROM Distribution

If you purchased your software from your local sales representative, you will find the following items in the product box:

- CD-ROMs containing the product software for Windows and Linux
- BEA Software License and Limited Warranty pamphlet

## Installation Prerequisites

Make sure your system meet the following requirements before installing the WebLogic RFID Enterprise Server software:

- WebLogic Server
- System Requirements
- Administrator Privileges (Windows)
- Licensing Requirements

Note: | BEA recommends that you read the WebLogic RFID Enterprise Server Release Notes before performing the installation; the Release Notes are available online at:

Note: | http://download.oracle.com/docs/cd/E13197_01/rfid/enterprise_server/docs20/notes/index.html

### WebLogic Server

You must install WebLogic Server 9.2 before installing WebLogic RFID Enterprise Server.

WebLogic Server 9.2 documentation is available at http://download.oracle.com/docs/cd/E13179_01/common/docs92/install/index.html.

### System Requirements

The system requirements for your installation are given in Table 2-2.

Table 2-2 System Requirements
Component | Requirement
--- | ---
Platform configuration | WebLogic RFID Enterprise Server 2.0 requires WebLogic Server 9.2 as its base platform.You cannot use WebLogic Express 9.2 as the base platform for Enterprise Server. A supported configuration of hardware, operating system, JDK, and database is required. Because WebLogic RFID Enterprise Server runs in a WebLogic Server 9.2 environment, the supported configurations for Enterprise Server are the same as those for WebLogic Server 9.2. See Supported Configurations at: http://download.oracle.com/docs/cd/E13196_01/platform/suppconfigs/index.html See Table 2-3 for a list of databases that have been tested with, and are recommended for use with, WebLogic RFID Enterprise Server 2.0.
Processor | 1-GHz CPU recommended.
Memory | 1 GB of RAM minimum.
Color bit depth display and size | For graphical user interface (GUI) mode installation, 8-bit color depth (256 colors) is required. For console-mode installation, there is no color bit depth requirement.

Table 2-3 Recommended Database Servers
Database Server | Version
--- | ---
Oracle | 9.2.0.4 10g R1 10g R2
SQL Server | 2000 SP3 2005
PointBase | For evaluation and testing purposes only, the version shipped with WebLogic Server 9.2.

### Administrator Privileges (Windows)

On Windows systems, Administrator privileges are required to create Start menu shortcuts in the All Users folder.

When you install the software as a user with Administrator privileges, you have the option to create the Start menu shortcuts in the All Users folder, or in the Local user's Start menu folder. Table 2-4 describes the options available.

Table 2-4 User Access Options (Windows)
If you select . . . | The following occurs . . .
--- | ---
All Users | All users registered on the machine are provided with access to the installed software. Subsequently, if users without Administrator privileges use the Configuration Wizard from this installation to create domains, Start menu shortcuts to the domains are not created. In this case, users can manually create shortcuts in their local Start menu folders, if desired.
Local user | Other users registered on this machine will not have access to the Start menu entries for this installation.

If a user without Administrator privileges installs the software, the Start menu entries are created in the local user's Start menu folder.

### Licensing Requirements

Your BEA software cannot be used without a valid license. When you install your software, the installation program installs an evaluation license (`license.bea`) into the BEA Home directory, to allow you to start using the product immediately.

To use your software in a full-scale production environment, you must purchase a production license. To find out how to do so, make contact with your sales representative or visit the BEA corporate Web site at http://www.bea.com.

For more information about evaluation and production licenses, see About BEA Product Licenses.

Customers who have installed a pre-2.0 version of the WebLogic RFID Enterprise Server software can call BEA customer support for assistance in upgrading to the current version. Mention that you are an existing WebLogic RFID Enterprise Server customer who is upgrading to WebLogic RFID Enterprise Server 2.0; doing so will help ensure that your request for assistance is routed to the correct people within customer support.

## Selecting Directories for Your Installation

During the installation process, you need to specify locations for the following directories:

- Choosing a BEA Home Directory
- Choosing a Product Installation Directory
- Understanding the Functions of the BEA Home Directory
- Creating Multiple BEA Home Directories

### Choosing a BEA Home Directory

When you install your BEA software, you are prompted to specify a BEA Home directory. This directory serves as a repository for common files that are used by multiple BEA products installed on the same machine. For this reason, the BEA Home directory can be considered a central support directory for all the BEA products installed on your system.

The files in the BEA Home directory are essential to ensuring that BEA software operates correctly on your system. They perform the following types of functions:

- Ensure that licensing works correctly for the installed BEA products
- Facilitate checking of cross-product dependencies during installation
- Facilitate Service Pack installation

Notes: | Because RFID Enterprise Server requires WebLogic Server 9.2, you must choose an existing BEA Home directory that contains an instance of WebLogic Server 9.2.

Note: | You can install only one instance of each version of a BEA product in a single BEA Home directory. For example, you can install only one instance of WebLogic Server 9.2 in a BEA Home directory, but that BEA Home directory may also contain an instance of WebLogic Server 9.1.

### Understanding the Functions of the BEA Home Directory

Table 2-5 describes the files and directories in the BEA Home directory.

Table 2-5 BEA Home Directory Description
Component | Description
--- | ---
`jdk` `xxx` directory | Contains the software for the Sun JDK if it is installed with your software. The JDK provides the Java run-time environment (JRE) and tools for compiling and debugging Java applications. In this directory name, `xxx` indicates the version of the Sun JDK installed on your system, for example `jdk150_06`.
`jrockit90_``xxx` directory (Windows and Linux only) | Contains the software for the BEA JRockit JDK if it is installed with your software. The JDK provides the Java run-time environment (JRE) and tools for compiling and debugging Java applications. In this directory name, `xxx` indicates the version of the JRockit JDK installed on your system, such as `jrockit90_150_06`.
`license.bea` file | An XML file that contains the license keys for all the BEA products installed in the BEA Home directory. Licenses are release-specific. To update your `license.bea` file for additional features, see Updating Your license.bea 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.
`logs` directory | Contains a history file of installation and uninstallation for the BEA Home directory.
`registry.xml` file | A registry file that contains a persistent record of all BEA products installed on the target system. This registry contains product-related information, such as version number, service pack number, and location of the installation directory.
Note: | Do not edit this file manually. Doing so may cause operating problems for the currently installed BEA products, or result in installation problems when future BEA products or maintenance upgrades are installed.
See "Using the BEA Registry API" in ISV Partners' Guide at the following URL: `http://download.oracle.com/docs/cd/E13179_01/common/docs92/isv/detect.html`
`rfid_enterprise` `xx` directory | The directory containing the WebLogic RFID Enterprise Server software. In this directory name, xx indicates the version of the WebLogic RFID Enterprise Server installed on your system; for example, `rfid_enterprise20`. See Choosing a Product Installation Directory.)
`UpdateLicense` (`.cmd/.sh`) | A command file (Windows) or a shell script (Linux) that updates the current `license.bea` file with new license sections. The result is a merged license that contains both the existing and new license sections. See Updating Your license.bea File.
`utils` directory | Contains utilities that support the installation of all BEA products installed in this BEA Home directory. The `utils.jar` file contains code that supports the `UpdateLicense` utility.

### Creating Multiple BEA Home Directories

Although it is possible to create more than one BEA Home directory, it is recommended that you avoid doing so. In almost all situations, a single BEA Home directory is sufficient. There may be circumstances, however, in which you prefer to maintain separate development and production environments, with a separate product stack for each. With two directories, you can update your development environment (in a BEA Home directory) without modifying the production environment until you are ready to do so.

### Choosing a Product Installation Directory

The product installation directory contains all software components that you choose to install on your system, including program files and examples. You are prompted during your initial installation to choose a product installation directory. If you accept the default on a Windows system, for example, your software is installed in the following directory:

`C:\bea\rfid_enterprise` `xx`

Here, `C:\bea` is the BEA Home directory (`BEA_HOME`) and `rfid_enterprise` `xx` is the product installation directory for the RFID Enterprise Server software, referred to in this document as `RFID_ENTERPRISE_HOME`. You can specify any name for your product installation directory.

## Choosing the Type of Installation

Although WebLogic Server provides two installation types (Complete and Custom), WebLogic RFID Enterprise Server provides only one installation type (Complete).

When you install WebLogic RFID Enterprise Server, all components are installed. You select which components are configured when you create a domain with the Configuration Wizard, as described in Post-Installation Information.

## Generating a Verbose Installation Log

If you launch the installation from the command line or from a script, you can specify the `-log` option to generate a verbose installation log. The installation log stores messages about events that occur during the installation process, including informational, warning, error, and fatal messages.

Note: | You may see some warning messages in the installation log. However, unless a fatal error occurs, the installation program completes the installation successfully. The installation user interface indicates the success or failure of each installation attempt, and the installation log file includes an entry indicating that the installation was successful.

To create a verbose log file during installation, include the `-log=``full_path_to_log_file` option in the command line. For example:

    rfid_enterprise200_win.exe -log=C:\logs\server_install.log

The path must specify a file. You cannot create a folder simply by including a name for it in a pathname; your path should specify only existing folders. If your path includes a nonexistent folder when you execute the command, the installation program does not create the log file.

## Where to Find Upgrade Information

Because an upgrade requires a full installation of WebLogic RFID Enterprise Server 2.0 and a migration of the 1.x database, customers who have installed a pre-2.0 version of the WebLogic RFID Enterprise Server software can call BEA customer support for assistance in upgrading to the current version. Mention that you are an existing WebLogic RFID Enterprise Server customer who is upgrading to WebLogic RFID Enterprise Server 2.0; doing so will help ensure that your request for assistance is routed to the correct people within customer support.