| RFID Software Installation Guide |    
|
| RFID Software Installation Guide |
|
| C H A P T E R 4 |
|
Installing the RFID Information Server |
The RFID Information Server can be installed after your selected application server has been successfully installed and is running on the host machine. You also need an operational installation of one of the supported databases.
The following sections are included in this chapter:
Before beginning the installation of RFID Information Server, verify the following prerequisites have been met:
The RFID Information Server utilizes a JDBC database to maintain the product information reported back to the user. Before you can proceed with installation of the information server component, you must verify that you have a supported database installed.
Make a note of the following information from your database installation before proceeding to install RFID Information Server:
The RFID Information Server is deployed to the selected application server. The application server communicates with the database through JDBC to handle additions, deletions and insertions of rows for the EPC tags identified. You need to install the necessary JDBC driver for your database and application server combination.
We do not ship JDBC Drivers as part of our release. These drivers can be obtain at the following web sites:
http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html
It is necessary to download the driver to a designated directory in the application server installation path. The correct directory to use depends on the application server that you have selected. Download the JDBC driver to the location that corresponds to the application server that you are using as designated in TABLE 4-1.
|
Typically the Oracle JDBC driver is already included in the WebLogic installation. For Postgres, copy the JDBC driver to the following directory: |
The setup script for Information Server is found in the directory /rfidis.
|
1. Verify that you have a supported database properly installed and licensed.
2. Verify that your application server is running before starting this installation.
Be sure you have the correct download file for your platform:
4. Enable access to the X server.
6. Set the DISPLAY environment variable to display to your machine name. For example, using the csh:
a. Change to the directory rfid-download-dir/rfidis
The Welcome page displays. Proceed to Step 8
a. Change to the rfidis directory
The Welcome page displays. Proceed to Step 8
8. From the Welcome page, click Next and follow the instructions on the installer wizard pages.
When you select your database, the Database Configuration Panel is displayed.
9. Enter the valid configuration information for your selected database.
|
DB Server - the name of the machine where DB is installed or IP address |
|
10. Once installation is complete, you must perform some additional steps before your RFID Information Server is ready to use. See Completing Application Server Setup For RFID Information Server
Before you can use RFID Information Server, you must complete the setup of your selected application server. Use the procedure for your selected application server and database.
|
|
Note - To complete setup on a Linux OS system, follow this procedure using the Linux file locations. See TABLE C-2. |
1. Update the server.policy file, by following these steps:
a. In a terminal window, change to the directory containing the 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.
b. Copy server.policy 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.
2. Log into the application server Admin Console.
3. Create a security file realm for a user.
This user's name and password are used to log into RFID Information Server's web site to access the RFID Information Server Index page.
a. From the application server Admin Console, choose App Server Instance > Security > Realms > file.
The Create File Realm User dialog is displayed.
d. Type the requested values. For example:
g. Restart your application server.
a. Choose Configuration > Security > Realms > file.
The Create File Realm User dialog is displayed.
d. Type the requested values. For example:
Database scripts are located in the directory /install_dir/lib/sql, where the variable install_dir is your default root installation directory. See Appendix C.
The scripts listed in TABLE 4-3 are provided for use with the supported Oracle8i (8.1.7) and Oracle 10g Release 1 databases.
|
Example script for setting up an Oracle user account and tablespace |
|
The scripts listed in TABLE 4-4 are provided for use with the supported PostgreSQL 7.4.6 database.
|
Example script for setting up a PostgreSQL user account and tablespace |
|
1. If you have not done so previously, get the proper JDBC drivers and install them.
See Installing the JDBC Drivers.
2. Copy the scripts to directory on the machine where the database server is running.
3. Log in to the database server as the Oracle Unix user
4. Change to the directory where you copied the scripts.
5. Run sqlplus using the connect string <DB_USER>/<DB_PASSWD>@<ORACLE_SID>
6. At the prompt run the following SQL commands:
|
You must have the PostgreSQL 7.4.6 database installed to perform this procedure. The RFID software installer does not install this database software. This procedure shows the commands for a Solaris system. On a Linux system, the Postgres commands are in /usr/bin/psql.
1. If you have not done so previously, get the proper JDBC drivers and install them.
See Installing the JDBC Drivers.
2. (Required to use BEA WebLogic 8.1 as your application server): Add location of JDBC driver to the class path.
Copying the JDBC driver jar file to the proper directory will not be sufficient. You must also add the jar file in question to your class path environment variable, which is set inside the WebLogic start-up script. The name and location of this script file varies greatly, but should be clearly known to your system administrator. For example, the script could be named startWebLogic.sh;
CLASSPATH= ${EXISTING_CLASSPATH} to
CLASSPATH=BEA_install_dir/server/lib/postgres_jdbc.jar:${EXISTING_CLASSPATH}
3. Copy the scripts to a directory on the machine where the database server is running.
4. Change to the directory where you copied the scripts.
6. In a terminal window, change the user to postgres:
7. To create the database table, type the following:
8. To populate the table, type the following:
|
Since some of the values required changes, the reporting framework's example reporting codes won't work out-of-the-box. Please refer to the Developer's Guide to see how to configure and run them.
When the Information Server installation has been successfully completed you should be able to confirm it with presentation of the EPCIS Index page in your browser window.
|
1. Navigate to the RFID Information Server URL:
2. Login as the admin user at the login screen.
3. Click OK to be presented with the Administrative Console screen.
4. Click on Apply Changes and then Restart the configuration.
http://hostname/epcis/index.html
Where hostname specifies your application server's location. You should now see a page showing the RFID Information Server Index page similar to the one shown here.
| RFID Software Installation Guide | 819-1696-10 |
|
Copyright © 2004, Sun Microsystems, Inc. All Rights Reserved.
To Install the RFID Information Server
