C H A P T E R 2 - Preparing for Installation of the RFID Software

C H A P T E R 2

Preparing for Installation of the RFID Software

This chapter contains information you should review before you install any of the modules of the Sun Java System RFID Software 3.0. Three separate installer wizards are used to install the RFID Software. Use of the wizards is described in other chapters.

The following sections are included in this chapter:

Overview of the Installation Process

Verifying Installation Readiness

Getting the RFID Software and the RFID Documentation

Deciding Which RFID Software Modules to Install

RFID Software Installation Scenarios

Overview of the Installation Process

Installing the RFID Software involves the following tasks:

1. Getting the product CDs or downloading the software from the product web site. See Getting the RFID Software and the RFID Documentation.

2. Installing the RFID Event Manager. See Chapter 3 for UNIX systems. See Chapter 6 for Microsoft Windows systems.

3. (Optional) Installing the RFID Management Console. See Chapter 4 for UNIX systems. See Chapter 6 for Microsoft Windows systems.

4. (Optional) Installing the RFID Information Server. See Chapter 5 for UNIX systems. See Chapter 6 for Microsoft Windows systems.

5. Verifying the installation of the software by starting the RFID software modules. See the chapter for the specific module and platform as indicated in Step 1 through Step 4 above.

Verifying Installation Readiness

The RFID Software is supported on several operating system (OS) platforms, application servers and databases. See the Sun Java System RFID Software 3.0 Release Notes for the latest information.

Caution - The version 3.0 RFID Information Server, also known as the EPCIS, has a new database schema that is notcompatible with the database schema used by previous versions. A data migration tool is included with version 3.0 to aid in migrating from the version 2.0 database schema to the version 3.0 database schema.

To properly prepare for installation, review the following prerequisites.

Supported platforms. Verify that your machine is using a supported platform. This release of the RFID Software is supported on the following platforms:

Solaris 9 OS and Solaris 10 OS on SPARC and x86 platforms

Red Hat Enterprise Linux ES, Version 3

Microsoft Windows 2003 Advanced Server

Java Platform, Standard Edition (J2SE). The minimum version is Java 2 Platform, Standard Edition (J2SE), version 1.4.2.

RFID modules. Decide which RFID modules you are going to install. See Deciding Which RFID Software Modules to Install.

Previous RFID Software versions. Uninstall previously installed versions of the RFID software.

Use the Sun Java System 1.0 RFID Software Installation Guide for information about uninstalling the version 1.0 software.

Use the Sun Java System RFID Software 2.0 Installation Guide for information about uninstalling the version 2.0 software.

Note - You must uninstall previous versions of this software before installing version 3.0.

Application servers. Verify that you are using a supported application server.

If you are installing the RFID Information Server, you must have Sun Java System Application Server Enterprise Edition 8.1 2005Q1, Sun Java System Application Server Platform Edition 8.1 2005Q2 UR2, or BEA WebLogic Server 8.1 SP4 installed and running.

If you are installing the web services for ALE and device access, the plug-in for SAP Auto-ID Infrastructure integration, or the RFID Management Console, you must have Sun Java System Application Server Enterprise Edition 8.1 2005Q1 or Sun Java System Application Server Platform Edition 8.1 2005Q2 UR2 installed and running.

Note - Because of a bug that affects the use of the ALE web services in the RFID Software, to use the Application Server Enterprise Edition, you must have a patched version. The application server patches are as follows - For package-based, patch numbers are: 119166-06, 119167-06 and 119168-05. For file-based, the patch numbers are: 119169-01, 119170-01 and 119171-01. These patches are for Solaris OS, Solaris x86 OS and Linux respectively. The bug is listed as fixed in 8.1eeur2_b01. The download file is sjsas_ee-8_1_02_2005Q2-p05-solaris-sparc.bin. This download file comprises a full installation of the application server.

Database software. Verify that you have a supported Oracle or PostgreSQL database installed. If you are installing the RFID Management Console, or the RFID Information Server you need a database. This release supports the installation of the RFID Management Console and the RFID Information Server using the following databases.

Oracle 9i Database

Oracle 10g Database

PostgreSQL 8.0.4

Note - If you have RFID Software version 2.0 modules installed that are using a database, you must migrate your database tables to the new database schema. See Migrating the Database Tables From Version 2.0 to Version 3.0 Database Schema.

Firewalls and port conflicts. The RFID Software uses the Jini network technology and an application server. These software components use a variety of ports. If you have a local firewall installed and enabled, you might experience various port conflicts that are not obvious. If you encounter otherwise unexplained communication issues trying to use the RFID Software, try disabling your local firewall. Ports used by various components of the RFID Software are the following:

Jini - Default port is 4160.

IMQ - Default port is 7676.

Webster - Default port is 52493.

Application server - The default admin and HTTP ports vary depending on the specific version and platform. Use the Admin Console to determine which ports are in use.

Oracle - Default port is 1521.

PostgreSQL - Default port is 5432.

Migrating the Database Tables From Version 2.0 to Version 3.0 Database Schema

If you have version 2.0 of the RFID Software installed, you need to migrate your database schema to the version 3.0 database schema. This guide does not provide step-by-step instructions for using or backing up your database software. This procedure provides a recommended process to use the data migration scripts that are provided as part of the RFID Software 3.0 release.

Note - Data migration scripts are not provided for the Microsoft Windows platform. Previous releases of the RFID Software did not support the Microsoft Windows platform.

To Migrate the Database Schema From Version 2.0 to Version 3.0

1. Backup your current database tables using the utilities and procedures provided with your database software.

Contact your database administrator if you are not familiar with the database backup process.

2. Locate the database migration scripts for your platform and for the appropriate RFID Software module.

The scripts are in the zip download file for each UNIX platform. When you unzip the download file to your rfid-download-dir, you can find the migration scripts as shown in the following table.

TABLE 2-1 Location of RFID Software Database Migration Scripts
RFID Module	Location of Database Migration Scripts
RFID Information Server	rfid-download-dir`/rfidis/files/scripts/migration/r2-r3`
RFID Management Console	rfid-download-dir`/rfidmc/files/scripts/migration/r2-r3`

3. Copy the RFID Software database migration scripts to the machine where your database is installed.

Use the scripts for your specific database as follows:

TABLE 2-2 Database Migration Scripts
RFID Module	Script for Oracle Database	Script for PostgreSQL Database
RFID Information Server	`oracle_rfidis_migration`	`postgres_rfidis_migration`
RFID Management Console	`oracle_rfidmc_migration`	`postgres_rfidmc_migration`

4. Run the database migration script from the command line.

5. (Optional) Connect to the database and query for known data.

Getting the RFID Software and the RFID Documentation

You can view and download additional Sun Java System RFID Software documentation at http://docs.sun.com/coll/434.2.

To Download the RFID Software

1. Download the RFID Software from http://www.sun.com/software/products/rfid/.

2. Unzip the software to your rfid-download-dir.

Be sure you get the correct download file for your platform.

Solaris OS on SPARC - RFID_SystemSoftware_SPARC.zip

Solaris OS on x86 - RFID_SystemSoftware_X86.zip

Linux - RFID_SystemSoftware_LINUX.zip

Microsoft Windows - RFID_SystemSoftware_Windows.zip

Deciding Which RFID Software Modules to Install

The RFID Software consists of several modules and additional components. Before beginning your installation, decide what you need for your RFID network.

Install the RFID Event Manager to gather, filter, and route the RFID reader information.

Install the ALE web service to get tag event reports.

Install the RFID Software plug-in for SAP Auto-ID Infrastructure to interface with the SAP Auto-ID Infrastructure module.

Install the RFID Management Console to manage your readers and RFID Event Manager from a web browser.

Install the RFID Information Server to capture and store the tag observation data gathered by the RFID Event Manager.

RFID Software Installation Scenarios

Installing the various components of the RFID Software requires an understanding of the related software requirements. This section gives an overview of those requirements. The detailed procedures can be found in the following chapters of this book.

TABLE 2-3 RFID Event Manager Installation Scenarios
Scenario	Installation Type	What You Get	What You Need	What To do
You select Typical installation to install basic RFID Event Manager on one system.	Typical	Control Station Execution Agent Common Files	Supported OS machine	(UNIX systems) See Using the Typical Installation Option. (Microsoft Windows systems) See To Install the RFID Event Manager Using the Typical Installation Option (Microsoft Windows).
You select and install Control Station on local system, and one or more Execution Agents on remote systems	Custom	RFID Event Manager for distributed system.	Supported OS machines in distributed configuration	See Creating a Distributed RFID Software Installation.
You select and install basic components (same as Typical) and web services for ALE and device access	Custom	RFID Event Manager with web services for ALE and device access	Supported OS machine plus Sun Java System Application Server 8.1 (installed and running locally)	(UNIX systems) See Using the Custom Installation Option. (Microsoft Windows systems) See To Install the RFID Event Manager Using the Custom Installation Option (Microsoft Windows).
You select and install basic components (same as typical) and plug-in for SAP AII	Custom	RFID Event Manager with Plug-in for SAP AII.	Supported OS machine plus Sun Java System Application Server 8.1 (installed and running)	(UNIX systems) See To Install the RFID Event Manager Using the Custom Installation Option. (Microsoft Windows systems) See To Install the RFID Event Manager Using the Custom Installation Option (Microsoft Windows).

TABLE 2-4 RFID Management Console Installation Scenarios
Scenario	Installation Type	What You Get	What You Need	What To Do
Install RFID Management Console	Typical	RFID Management Console	Supported OS machine Sun Java System Application Server 8.1 (installed and running locally) Supported database (can be remote) Supported web browser JDBC drivers added to the correct application server directory	(UNIX systems) See Chapter 4. (Microsoft Windows systems) SeeInstalling the RFID Management Console (Microsoft Windows).

TABLE 2-5 RFID Information Server Insta llation Scenarios
Scenario	Installation Type	What You Get	What You Need	What To Do
Install the RFID Information Server	Typical	RFID Information Server	Supported OS machine Supported application server (installed and running locally) Supported database (can be remote) JDBC drivers added to the correct application server directory	(UNIX systems) See Chapter 5. (Microsoft Windows systems) See Installing the RFID Information Server (Microsoft Windows).