1

EPCIS Fosstrak Installation

Alex Syaekhoni Industrial & Systems Engineering Department Dongguk University, Seoul

1. Introduction

Fosstrak EPCIS is a complete implementation of the EPCIS standard specification

(Version 1.0.1 of September 21, 2007). The Fosstrak EPCIS provides: EPCIS repository,

EPCIS Capture application using GUI, EPCIS Query application using GUI.

2. Fosstrak EPCIS Repository installation

Install the MySQL server and Tomcat. Go to

http://www.apachefriends.org/download.html.

Figure 1. Download xampp

2

Download and Install xampp 1.8 (tomcat is already included in the xampp). MySQL

server will be used by the EPCIS repository to store event data.

Figure 2. Install xampp

3

Click next until the installation has completed.

Figure 3. Installation of xampp has completed

Then click finish and automatically the Control Panel of xampp will be opened.

Figure 4. the Xampp Control Panel

4

Start the Apache, MySQL and Tomcat by clicking the start button.

Figure 5. Apache, MySQL and Tomcat is running

Open the web browser and open http://localhost:8080 to check the Tomcat, while

http://localhost/phpmyadmin to check the MySQL server.

Figure 6. Tomcat is running

5

Figure 7. http://localhost/phpmyadmin

Download the Fosstrak EPCIS repository. Go to

https://code.google.com/p/fosstrak/wiki/EpcisDownload

Figure 8. Download the Fosstrak Repository

6

Download the zip file, then extract it.

Figure 9. Extract the Fosstrak Repository

Place the WAR file in your Tomcat's webapps directory

(xampp/tomcat/webapps). Then restart the Tomcat by clicking stop the Tomcat and

click start again on the Xampp Control Panel.

Figure 10. Directory path of the Tomcat which is located inside of the xampp folder.

Download the MySQL Connector/J driver. Then extract it, copy the mysql-connector-

java-<version>-bin.jar into Tomcat's lib (xampp/tomcat/lib) directory.

7

Figure 11. Download Connector/J driver

Create and import the database. Open http://localhost/phpmyadmin on the web

browser. Then create a new database ‘epcis’ by typing ‘CREATE DATABASE epcis’

on the SQL command and execute it. Import the ‘epcis_schema.sql’ the

‘epcis_demo_data.sql’ accordingly.

8

Figure 12. Import the ‘epcis_schema.sql’ the ‘epcis_demo_data.sql’

9

Create a new user on MySQL server (username = epcis; host=localhost;

password=epcis). And check all as the Grant User.

Figure 13. Create a new grant user

10

Open the Xampp Control Panel, Restart the Tomcat and open the

http://localhost:8080/epcis-repository-0.5.0/ on the web browser.

Figure 14. open EPCIS repository

Create an xml file which contents:

<Resource

name="jdbc/EPCISDB"

type="javax.sql.DataSource"

auth="Container"

username="epcis"

password="epcis"

driverClassName="com.mysql.jdbc.Driver"

url="jdbc:mysql://localhost:3306/epcis?autoReconnect=true">

</Resource>

Rename it to ‘epcis-repository-0.5.0.xml’. And put the xml file to xampp/

tomcat/conf/Catalina/localhost.

Create an xml file which contents:

<dependency>

<groupId>mysql</groupId>

<artifactId>mysql-connector-java</artifactId>

<version>5.1.30</version>

</dependency>

Rename it to ‘pom.xml’. And put the xml file to xampp/ tomcat/webapps/epcis-

repository-0.5.0/

11

3. Execute EPCIS capture application

Download the EPCIS Fosstrak capture application on the Fosstrak web page.

Figure 15. Download capture application

Extract the zip file, then open the epcis-captureclient-0.5.0.jar

Figure 16. epcis-captureclient-0.5.0.jar

12

Click fill in example to see how to fill in the from in proper way. Choose the action as ADD,

OBSERVE or DELETE and then change the capture interface URL to be your URL

http://localhost:8080/epcis-repository-0.5.0/capture

Figure 17. Capture succeeded

4. Execute EPCIS query application

Download the EPCIS Fosstrak query application on the Fosstrak web page. Extract the zip

file, then open the epcis-queryclient-0.5.0.jar. Click fill in example to see how to fill in the

from in proper way. Change the query interface URL to be your URL

http://localhost:8080/epcis-repository-0.5.0/query

13

Figure 18. Query succeeded