C H A P T E R 6 - Installing the RFID Software (Microsoft Windows)

C H A P T E R 6

Installing the RFID Software (Microsoft Windows)

This chapter describes how to install the Sun Java System RFID Software 3.0 (RFID Software) modules on a Microsoft Windows system. The installation tasks are the same as for UNIX systems, except that the command format and the directories are different. The following sections are included in this chapter:

Installing the RFID Event Manager (Microsoft Windows)

Installing the RFID Management Console (Microsoft Windows)

Installing the RFID Information Server (Microsoft Windows)

Installing the RFID Event Manager (Microsoft Windows)

Use the installation wizard to install the RFID Event Manager. Review Selecting the Installation Type before deciding whether to use a typical or a custom installation.

Requirements for RFID Event Manager Installation (Microsoft Windows)

You need administrative privileges to install all RFID Software modules.

In a DHCP environment, specify localhost for the IP address of the Control Station.

The user environment variable %TEMP% must be set to a valid location on your local system to enable the installer to create the installation log files.

To Install the RFID Event Manager Using the Typical Installation Option (Microsoft Windows)

Note - You do not need to have an application server installed to perform a typical installation of the RFID Event Manger.

1. If you have not already done so, get the software.

See Getting the RFID Software and the RFID Documentation.

2. Start the installation by following these steps:

a. Change to the directory containing the unzipped download file.

b. Change to the rfidem directory.

c. Double-click setup.bat to start the RFID Event Manager installer.

The Welcome panel appears.

3. From the Welcome panel, click Next and follow the instructions on the panels to perform the installation.

4. On the Select Type of Installation panel, confirm that the Typical installation option is selected and click Next.

5. On the Select Java Home Location panel, confirm that the top level of the path to your J2SE installation is selected.

For example, if J2SE version, 1.4.2_10 is installed in the default location, the J2SE SDK Path field should contain C:\j2sdk1.4.2_10.

6. On the Station Location and Group Configuration panel, type the name or IP address of the host system and the unique Jini group name.

The group name must be unique for every control station you set up. The group name gives the control station its identity over the network. The installer defaults the group name to AutoID-hostname.

Note - If you are performing this installation in a DHCP environment (such as a laptop), type localhost for the IP address.

7. When installation is complete, click Close.

8. (Optional) Validate the RFID Event Manager installation by starting the pmlreader and tagviewer utilities. See To Start RFID Event Manager.

To Install the RFID Event Manager Using the Custom Installation Option (Microsoft Windows)

Note - If you choose to install the ALE web service or the plug-in for SAP AII , you must have your application server running before you start the RFID Event Manager installer.

1. If you have not already done so, get the software. See Getting the RFID Software and the RFID Documentation.

2. Verify that your application server is running.

You can use either Sun Java System Application Server Enterprise Edition 8.1 2005Q1 (Application Server Enterprise Edition) or Sun Java System Application Server Platform Edition 8.1 2005Q2 UR2 (Application Server Platform Edition) as your application server.

3. Begin the installation for performing a Typical Installation.

See To Install the RFID Event Manager Using the Typical Installation Option (Microsoft Windows).

4. On the Select Type of Installation panel, select Custom Installation, and select the components to install.

When you select the ALE web service or the plug-in for SAP AII, the Application Server Selection Panel appears during the installation.

5. On the Application Server Configuration panel, type the parameters appropriate to your application server.

For Sun Java System Application Server 8.1, the default values are as follows:

User Name	admin
Password	admin password
Host name	application server machine name

For the Enterprise Edition

Admin Port	4849
Instance	domain1

For the Platform Edition

Admin Port	4848
Instance	domain1

6. When installation is complete, click Close.

7. (Optional) Verify that the web services were deployed to the application server.

See To Verify the Deployment of RFID Event Manager Services.

8. (Plug-in for SAP AII only) To complete the setup of the plug-in for SAP AII, you must configure the RFID Event Manager and the SAP AII system in order to establish the proper communication between these systems.

Follow the procedures in Chapter 4 of the Sun Java System RFID Software 3.0 Administration Guide.

9. (Optional) Validate the RFID Event Manager installation by starting the pmlreader and tagviewer utilities.

See To Start RFID Event Manager.

To Start RFID Event Manager

You can use the Start Menu to start most of the components of the RFID Event Manager

1. Choose Start right arrow Programs Sun Microsystems Sun Java System RFID Software Start Station.

The RFID Control Station starts.

2. Choose Start right arrow Programs Sun Microsystems Sun Java System RFID Software Start Agent.

The RFID Execution Agent starts.

3. (Optional) Choose Start right arrow Programs Sun Microsystems Sun Java System RFID Software Start PML Reader.

The RFID PML Reader utility starts.

4. (Optional) Starting the RFID Tag Viewer requires a command line option.

For this example, change to the rfid-install-dir\bin and start the RFID Tag Viewer. Specify the start options for viewing the tags that are generated by the PML Reader utility.

C:\Program Files\Sun\RFID Software\rfidem\bin tagviewer -p PMLReader

The RFID Tag Viewer utility starts.

5. (Optional) Use the appropriate Start Menu entry for any other RFID utility that you need to start, such as the RFID Configuration Manager.

To Stop RFID Event Manager Components

1. Choose Start right arrow Programs Sun Microsystems Sun Java System RFID Software Stop Agent.

The RFID Execution Agent stops.

2. Choose Start right arrow Programs Sun Microsystems Sun Java System RFID Software Stop Station.

The RFID Control Station stops.

3. (Optional) To stop the PML Reader, use Ctrl+C .

4. (Optional) To stop the Tag Viewer, close the window.

Installing the RFID Management Console (Microsoft Windows)

In a standard installation, the RFID Management Console is installed on the same machine as the RFID Event Manager. However it is not a requirement to install them on the same machine. The RFID Management Console can be installed on any machine as long as a supported application server is installed on that machine.

Requirements for Installing the RFID Management Console

Installing the RFID Management Console has the following prerequisites:

Application server. A properly installed and licensed supported application server must be running on the system on which you are installing the RFID Management Console. The RFID Management Console is supported using the following application servers.

Application Server Platform Edition

Application Server Enterprise Edition

Server policy file. You must update your application server's policy file with the RFID server.policy file.

You can select the installer option to update the policy file during installation or you can perform this step manually after installing the RFID Management Console. See To Update the Application Server Policy File for RFID Management Console (Microsoft Windows) to perform this step manually.

Database. A supported database must be available. You need to know the configuration information for your database to proceed with installation of the RFID Management Console. This release supports the installation of the RFID Management Console using the following databases.

Oracle 9i Database

Oracle 10g Database

PostgreSQL 8.0.4

JDBC driver - Copy the appropriate JDBC JAR file for your database to the application server directory: C:\Sun\AppServer\domains\domain1\lib\ext. For information on where to find the JDBC driver for your database, see Installing the JDBC Drivers.

Web browser. A supported web browser must be available because the RFID Management Console uses a web browser- based GUI. The following web browsers are supported.

Netscape 7.1

Mozilla 4.1

Internet Explorer 5.0

Note - You cannot use BEA WebLogic Server as your application server for installing the RFID Management Console.

To Install RFID Management Console (Microsoft Windows)

1. Get the software. See Getting the RFID Software and the RFID Documentation.

2. Change to the directory rfid-download-dir\rfidmc.

3. Double-click setup.bat.

The Welcome panel appears.

4. Click Next, and follow the instructions on the installer wizard panels.

Note - When the installer prompts you to specify the path to your installation of J2SE, specify the same path that is being used by your application server.

5. When installation is complete, you might need to perform the following postinstallation steps.

Using the appropriate procedures for your application server and database.

a. Complete the configuration of your application server.

See To Update the Application Server Policy File for RFID Management Console (Microsoft Windows).

b. If you did not select the option to deploy the database tables during installation, perform the database setup procedure for your installed database.

To Set Up the Oracle Database Tables For RFID Management Console (Microsoft Windows).

To Create the RFID PostgreSQL Database Tables For RFID Management Console (Microsoft Windows).

6. When installation and setup are complete, start the RFID Management Console.

Use the procedure To Start the RFID Management Console (Microsoft Windows).

To Update the Application Server Policy File for RFID Management Console (Microsoft Windows)

Note - The RFID Management Console installer has an option to perform this task. If you selected the option to have the installer update the server.policy file, you do not need to perform this procedure.

You only need to update the application server policy file once. If you have already updated the policy file during the installation of either the RFID Event Manager or the RFID Information Server, you do not need to do it again.

1. (Required if not done by installer) Update the server.policy file, by following these steps:

a. In a terminal window, change to the directory containing the RFID policy file.

Default location: %system-drive%:Program Files\Sun\RFID Software\rfidmc\policy\server.policy

b. Find the file named server.policy.

This file needs to replace the file of the same name that is located in the application server's configuration directory.

c. Copy server.policy to your application server's configuration directory.

The path to this directory depends on your application server installation.

For Application Server Enterprise Edition and Application Server Platform Edition, the default location is:

C:\Sun\AppServer\domains\domain1\config\server.policy

2. (Optional) If you are performing this procedure after installing the RFID Management Console, restart your application server.

Setting Up the Database for the RFID Management Console (Microsoft Windows)

Prerequisite - To use the RFID Management Console, you must set up your database with the necessary tables. The RFID Software provides the necessary database scripts. to set up the tables and populate the tables with sample data.

Installation option - You can perform the database setup as an option during the RFID Management Console installation if your database resides on the same system on which you are installing the RFID Management Console. If you did not select this option as part of your installation or your database resides on a remote system, use these procedures to manually set up the database tables.

To Set Up the Oracle Database Tables For RFID Management Console (Microsoft Windows)

1. Copy the necessary files to a directory on the machine where the Oracle database server is running.

The scripts for the Oracle database tables are located in the directory - C:\Program Files\Sun\RFID Software\rfidmc\lib\sql. Copy the following files:

oracle_setup.bat

oracle_create_mcschema.sql

oracle_create_mcuser.sql

oracle_drop_mcschema.sql

oracle_populatemc.sql

2. Change to the directory where you copied the scripts.

3. Verify that oracle_create_mcuser.sql points to the correct datafile.

4. Set the following environment variables:

DB_ADMIN - The administrative user that is used to create the Oracle database tables.

DB_ADMIN_PASSWORD - The password for user specified in DB_ADMIN

SQLPLUSPATH - The path to the executable sqlplus.

5. In a command prompt window, run the script.

You must run the setup script as the database user with administrator privileges. To execute the setup script to perform all the setup tasks, use the option all as follows:

oracle_setup.bat all

6. (Optional) You can also run the setup script with the following options:

Oracle_setup.bat [createruser] - executes oracle_create_user.sql.

Oracle_setup.bat [createtable] - executes oracle_create_table.sql.

Oracle_setup.bat [populate] - executes oracle_populate_table.sql.

To Create the RFID PostgreSQL Database Tables For RFID Management Console (Microsoft Windows)

1. Copy the necessary files to a directory on the machine where the database server is running.

The scripts for the PostgreSQL database tables are located in the directory - C:\Program Files\Sun\RFID Software\rfidmc\lib\sql. Copy the following files:

postgres_setup.bat

postgres_create_mcschema.sql

postgres_create_table.sql

postgres_create_user.sql

postgres_drop_table.sql

postgres_populate_table.sql

2. Change to the directory where you copied the scripts.

3. Set the following environment variables:

DB_ADMIN - A user with administrator rights to the database.

DB_ADMIN_PASSWORD - The password for user specified in DB_ADMIN.

PSQL_PATH - The location of the executable psql.

4. In a command window, run the setup script.

You must run the setup script as the database admin user. To execute the setup script to perform all the setup tasks, use the option all as follows:

C:\postgres_setup.bat all

5. (Optional) You can also run the setup script with the following options:

postgres_setup.bat [createuser] - executes postgres_create_user.sql.

postgres_setup.bat [createtable] - executes postgres_create_table.sql.

postgres_setup.bat [populate]- executes postgres_populate.sql.

To Start the RFID Management Console (Microsoft Windows)

1. (Optional) Start the RFID Event Manager.

The RFID Management Console needs to connect to the Jini lookup server (part of the RFID Event Manager) in order to access information about the RFID readers. If the RFID Event Manager is not running, you will not be able to access many of the RFID Management Console screens. Use these steps.

a. Choose Start right arrow Programs Sun Microsystems Sun Java System RFID Software Start Station.

The RFID Control Station starts.

b. Choose Start right arrow Programs Sun Microsystems Sun Java System RFID Software Start Agent.

The RFID Execution Agent starts.

2. (Optional) If you want to see a running reader, you also need to start the pmlreader utility.

3. Choose Start right arrow Programs Sun Microsystems Sun Java System RFID Software Start PML Reader.

The RFID pmlreader utility starts.

4. Open a web browser and enter the RFID Management Console URL.

The URL is of the following format: http://hostname:port-number/sdui.

Host name. The variable, hostname, is the name of the machine where the management console software is deployed.

Port number. The variable, port-number, is the HTTP port number of your application server. An example is http://myhost:8080/sdui.

The RFID Management Console login screen appears.

5. Log in to the RFID Management Console by typing the default admin user name and password.

The default user name is admin. The default admin password is admin.

6. (Optional) See the Sun Java System RFID Software 3.0 Administration Guide for details on using the RFID Management Console and setting up additional users.

Installing the RFID Information Server (Microsoft Windows)

Complete the following procedures to install the RFID Information Server:

1. Review the Requirements for Installing the RFID Information Server (Microsoft Windows).

2. To Verify Communication Between the Database and the Sun Java System Application Server 8.1.

3. To Install RFID Information Server (Microsoft Windows).

Requirements for Installing the RFID Information Server (Microsoft Windows)

Installing the RFID Information Server has the following prerequisites:

Application server. A supported application server must be running on the system on which you are installing the RFID Information Server. The RFID Information Server is supported using the following application servers.

Application Server Platform Edition

Application Server Enterprise Edition

BEA WebLogic Server 8.1 SP4 8.1 SP4

Server policy file. You must update your application server's policy file with the RFID server.policy file.

You can select the installer option to have the installer update the policy file during installation or you can perform this step manually after installing the RFID Information Server. See To Update the Application Server Policy File for the RFID Information Server (Microsoft Windows) to perform this step manually.

Database. A supported database must be available. You need to know the configuration information for your database to proceed with installation of the RFID Information Server. This release supports the installation of the RFID Information Server using the following databases.

Oracle 9i Database

Oracle 10g Database

PostgreSQL 8.0.4

JDBC driver. The JDBC drivers are necessary to establish communication between the database and the application server. For information on where to find the JDBC driver for your database, see Installing the JDBC Drivers.

Copy the appropriate JDBC JAR file for your database to the application server directory: C:\Sun\AppServer\domains\domain1\lib\ext.

You can do this step either before or after you install the RFID Information Server. If you do it after installing the RFID Information Server, you will need to restart the application server before you can start the RFID Information Server.

Note - If you are using the Oracle 9i or 10g Database with the BEA WebLogic Server 8.1 SP4, you do not need to install the JDBC drivers manually. Typically, the necessary JDBC drivers are part of the BEA WebLogic Server 8.1 SP4 installation.

To Verify Communication Between the Database and the Sun Java System Application Server 8.1

Confirm communication between your Application Server and database using the procedure, To Verify Database Communication Between the RFID Information Server and Sun Java System Application Server 8.1.

To Install RFID Information Server (Microsoft Windows)

1. If you have not already done so, get the software.

See Getting the RFID Software and the RFID DocumentationChange to the directory containing the unzipped download file.

2. Start the RFID Information Server installation.

a. Change to the appropriate directory.

For web download, change to the directory rfid-download-dir\rfidis.

For CD installation, change to the windows\rfidis directory.

b. Start the installer by double-clicking the setup.bat file.

The Welcome panel displays.

3. From the Welcome panel, click Next and follow the instructions on the installer wizard panels.

4. On the Deploy Database Schema panel, indicate if you want the installer wizard to deploy the RFID database schema for you.

Caution - Data could be lost. When the installer performs this step for you, the previous RFID tables are dropped and all previous data is lost. Do not select this option of the installer unless you have backed up the existing database or you are deploying the database schema for the first time.

5. On the Database Selection panel, select your database and enter the configuration information when prompted.

The parameters are described in TABLE 6-1. The following screen captures show the Database Configuration panel.

Screen capture showing the Oracle Database Configuration Panel.Screen capture of the PostgreSQL Database Configuration Panel. [ D ]

TABLE 6-1 Database Configuration Parameters
Database	Configuration Parameters	Value or Description
Oracle	User Name Password (and confirm Password) DB Server DB Port - database port number Oracle SID Additional fields appear if you are deploying the sample data. Oracle HOME* SQLPlus Path*	This is the user that is used to create the Oracle database tables. For example, `epcis.` Password for the user - epcis The name or IP address where the database is installed. Confirm this value as the installer defaults this value to the name of the machine where the installer is running. Port number where you connect to the database. This defaults to 1521. Contact your database administrator for information if you do not know the values of these fields. The path to the location of your oracle database, `oradata`. For example: `/opt/oracle` The path to the executable `sqlplus`. For example, `/opt/oracle/product/10g/bin`
PostgreSQL	User Name Password (and confirm Password) DB Server DB Port DB Name PSQL Path* DB Admin User*	This is the user name that is used to create the database tables. Location of the database installation. The location of the executable `psql.` The user with administrator rights to the database.

6. When installation is complete, click Close.

You might need to perform additional steps before your RFID Information Server is ready to use.

Note - If you did not deploy the database tables during installation, you need to deploy the tables manually. See Setting Up the Database for the RFID Information Server (Microsoft Windows)

7. Define the valid users for your RFID Information Server.

See Defining Valid Users for RFID Information Server.

8. (Optional) Validate your RFID Information Server installation by viewing the EPCIS Index page in your browser window.

See Verifying the RFID Information Server Installation.

To Update the Application Server Policy File for the RFID Information Server (Microsoft Windows)

Note - The RFID Information Server installer has an option to perform this task. If you selected the option to have the installer update the server.policy file, you do not need to perform this procedure.

You only need to update the application server policy file once. If you have already updated the policy file during the installation of either the RFID Event Manager or the RFID Management Console, you do not need to do it again.

1. In a terminal window, change to the directory containing the RFID policy file and find the file named server.policy.

This file needs to replace the file of the same name that is located in the application server's configuration directory.

The RFID Information Server policy file can be found at C:\Program Files\Sun\RFID Software\rfidis\policy

2. Copy the server.policy file to your application server's configuration directory.

The path to this directory depends on your application server installation and the location varies depending on the specific platform and version of the application server that you are using. Refer to the following table for the default location of the application server configuration directory.

TABLE 6-2 Default Location of Application Server Configuration Directory (Microsoft Windows)
Application Server	Location of Configuration Directory
Sun Java System Application Server 8.1 Enterprise Edition and Sun Java System Application Server 8.1 Platform Edition	C:\Sun\AppServer\domains\domain1\config
BEA WebLogic Server 8.1 SP4	BEA-install-dir`\server\lib\weblogic.policy`. Replace the variable BEA-install-dir with the location of your server.

3. If you are performing this procedure after installing the RFID Information Server, restart your application server.

Setting Up the Database for the RFID Information Server (Microsoft Windows)

To use the RFID Management Console, you must set up your selected database with the necessary tables. Scripts to do this are provided with the RFID software. If you did not deploy the database tables during installation, you need to deploy the tables manually using the following procedures.

To Set Up the Oracle Database Tables For RFID Information Server (Microsoft Windows)

1. Copy the necessary files to a directory on the machine where the Oracle database server is running.

The scripts for the Oracle database tables are located in the following directory - C:\Program Files\Sun\RFID Software\rfidis\lib\sql.Copy the following files:

oracle_setup.bat

oracle_create_table.sql

oracle_create_user.sql

oracle_drop_table.sql

oracle_populate.sql

2. Change to the directory where you copied the scripts.

3. Verify that oracle_create_user.sql points to the correct datafile.

4. Set the following environment variables:

DB_ADMIN - The administrative user that is used to create the Oracle database tables.

DB_ADMIN_PASSWORD - The password for user specified in DB_ADMIN

SQLPLUSPATH - The path to the executable sqlplus.

5. In a command prompt window, run the script.

You must run the setup script as the database admin user. To execute the setup script to perform all the setup tasks, use the option all as follows:

oracle_setup.bat all

6. (Optional) You can also run the setup script with the following options:

oracle_setup.bat [createruser] - executes oracle_create_use.sql

oracle_setup.bat [createtable] - executes oracle_create_table.sql

oracle_setup.bat [populate] - executes oracle_populate_table.sql

To Create the RFID PostgreSQL Database Tables For RFID Information Server (Microsoft Windows)

1. Copy the necessary files to a directory on the machine where the PostgreSQL database server is running.

The scripts for the PostgreSQL database tables are located in the directory - C:\Program Files\Sun\RFID Software\rfidis\lib\sql. Copy the following files:

postgres_setup.bat

postgres_create_table.sql

postgres_create_user.sql

postgres_drop_table.sql

postgres_populate.sql

2. Change to the directory where you copied the scripts.

3. Verify that postgres_create_user.sql points to the correct datafile.

4. Set the following environment variables:

DB_ADMIN - A user with administrator rights to the database.

DB_ADMIN_PASSWORD - The password for user specified in DB_ADMIN.

PSQL_PATH - The location of the executable psql.

5. In a command window, run the script.

You must run the setup script as the database admin user. To execute the setup script to perform all the setup tasks, use the option all as follows:

postgres_setup.bat all

6. (Optional) You can also run the setup script with the following options:

postgres_setup.bat [createuser] - executes postgres_create_user.sql.

postgres_setup.bat [createtable] - executes postgres_create_table.sql.

postgres_setup.bat [populate]- executes postgres_populate.sql.