D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
INFORMATION SOCIETY TECHNOLOGIES
(IST)
PROGRAMME
IST-2000-29456
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
D3.3: WebFAIR Setup Guide
WP 3 – WEBFAIR SETUP TOOLS
FEBRUARY 2003
Copyright © WebFAIR Consortium 2002
D3.3
February 2003
1 of 16
1 THE CONTENTS
1
2
3
THE CONTENTS ..................................................................................................... 2
EXECUTIVE SUMMARY ............................................................................................ 3
WEBFAIR INSTALLATION ....................................................................................... 4
3.1
3.2
3.3
INSTALLATION PROCEDURE ........................................................................................................... 4
MINIMUM SYSTEM REQUIREMENTS: ................................................................................................ 4
W EBFAIR SYSTEM ....................................................................................................................... 5
SETTING UP AN EXHIBITION FOR WEBFAIR .............................................................. 5
USING THE EXHIBITION SETUP TOOL .............................................................................................. 5
4.1.1
The Tree Selection Pane ................................................................................................ 6
4.1.2
The Information Pane ..................................................................................................... 7
4.1.3
The Map Pane ................................................................................................................ 8
4.1.4
The Menu ........................................................................................................................ 9
ADDING SITE INFORMATION ........................................................................................................... 9
4.2.1
Inserting Site information & map .................................................................................... 9
SETTING UP EXHIBITS.................................................................................................................. 10
4.3.1
Inserting Exhibits .......................................................................................................... 10
4.3.2
Setup Exhibits Locations .............................................................................................. 12
SETTING UP GUIDED TOURS ........................................................................................................ 12
4.4.1
Inserting Guided Tours ................................................................................................. 12
MAINTENANCE OF EXHIBITION DATA ............................................................................................. 13
4.5.1
Updating Sites .............................................................................................................. 13
4.5.2
Deleting Sites ................................................................................................................ 13
4.5.3
Updating Exhibits .......................................................................................................... 14
4.5.4
Deleting Exhibits ........................................................................................................... 14
4.5.5
Updating Guided Tours................................................................................................. 14
4.5.6
Deleting Guided Tours .................................................................................................. 14
STARTING & STOPPING THE SYSTEM ........................................................................................... 14
INSTALLATION PLAN CHECK LIST......................................................................... 15
CHECK LIST RATIONALE ............................................................................................................... 15
INSTALLATION CHECK LIST .......................................................................................................... 16
5.2.1
Installation of the mobile module – robotic avatar ........................................................ 16
5.2.2
Installation of the robotic navigation system ................................................................. 16
5.2.3
Installation of the Interface Server and Exhibition setup tool ....................................... 16
4
4.1
4.2
4.3
4.4
4.5
4.6
5
5.1
5.2
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
D3.3 WebFAIR Setup Guide
2 EXECUTIVE SUMMARY
This document aims to provide a comprehensive and complete guide of the procedures
required for the successful installation of the WEBFAIR system in an exhibition site.
The large scale and complexity of the overall system and the diversity of technologies,
software and hardware platforms, operating systems and requirements involved implies the
need for a concrete setup plan that will assure the correct installation of the system, as well
as predict the needs to adapt to any site where the system may be used.
Among the installation plan operational tests for each component of the system are included
that will ensure a successful installation and that the system provides the desired
functionality.
This document therefore consists of these main parts:
 the WebFAIR Installation Plan, where the installation and set-up of the entire
platform is detailed
 The Exhibition Setup procedure, where the process to setup an exhibition to become
available through the WebFAIR system is detailed
 The Installation Checklist, a table of check points that will be completed by the
administrator of the system upon installation.
D3.3
February 2003
3 of 16
D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
3 WEBFAIR INSTALLATION
3.1 Installation Procedure
In order to produce the desired results of the system and proceed to install and verify the
system in the exhibition, each of the systems modules needs to be installed and several
steps have to be performed, in specific order, in order to have a complete operational
system.
Therefore it is essential that the installation follows a specified plan, consisting of separate
steps for each component of the system as well as inter – component communication and
the operation of the system as a whole.
The components that need to be installed in order to have a complete functional WEBFAIR
system are:
 the mobile module – robotic avatar
 the robotic navigation system
 the interface server and exhibition setup tool
In the next chapters of this document, installation of each component is to be detailed,
followed by the series of operational tests that will ensure its proper functionality.
Finally, the whole installation plan is summarized in a table of check points that will be
completed by the administrator of the system upon installation.
3.2 Minimum system requirements:




D3.3
1 mobile robot; current configuration is with 1 linux PC and 1 windows PC on-board.
The lixun PC runs navigation SW, the windows PC runs the video streaming SW.
Minimum setup of sensors includes 1 laser scanner, bumpers, and 2 cameras (the
latter on the robot’s head). Optionally, sonars and IRs may be installed, which the
navigation SW uses automatically. The mobile robot, including both PCs, is setup
before delivery to the exhibition site.
1 (off-board) linux PC on which navigation SW is installed and runs.
1 (off-board) windows PC with web server, mySQL (or Microsoft SQL), JDK and
JDBC, on which the interface server and exhibition setup tool are installed and run.
Internet connection. All PCs should be connected to the net. For the on-board PCs,
wireless connection is necessary. If this is available on the exhibition site, it can be
used. Otherwise, wireless Ethernet is used, by installing 1 or more access points in
the workspace. The robot itself has the antenna(s) for wireless access.
February 2003
4 of 16
D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
3.3 WebFAIR System
Summary of Setup and Operation Actions for WebFAIR System:
Setup tasks:
 Install HW and verify net access
 Map the workspace using the site map building tool, as follows:
o Start the map-building tool.
o Joystick the robot through the environment. Take care that the relevant
aspects of the environment are covered. It is important not to move too fast,
since otherwise the robot will not be able to acquire enough information to
generate a consistent map. Additionally, abrupt turns are to be avoided.
o Ensure that all data are logged using the map-building tool.
o Use the map-building tool to generate a map. If the map appears not to be
consistent adjust parameters (robot motion noise, sensor noise) in order to
improve the quality of the map.
o Save the map as soon as it is satisfactory.
 Compile and arrange the information regarding the exhibits using the exhibition
setup tool
4 SETTING UP AN EXHIBITION FOR WEBFAIR
4.1 Using the Exhibition Setup Tool
The Exhibition Setup application starts by executing the ExhibitionSetup.bat file, residing in
the application setup directory.
The Exhibition Setup screen is divided in 3 panes as displayed in the image below:
 The Tree Selection Pane on the Left
 The Information Pane on the Top Right
 The Map Pane on the Bottom Right
D3.3
February 2003
5 of 16
D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
4.1.1 The Tree Selection Pane
The Tree selection pane is the means of navigating within the sites, exhibits and guided
tours stored in the database.
For each site, all the exhibits and guided tours are displayed, and can be selected by
clicking on them.
Once and Exhibit or a Guided tour is selected, all the relative information are displayed in
the information pane
D3.3
February 2003
6 of 16
D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
4.1.2 The Information Pane
This is where all the information about the currently selected Site, Exhibit or Guided Tour are
displayed and can be changed.
4.1.2.1 Site Information
The site information pane displays all the information regarding the currently selected site.
This information includes the Site name, map, scaling, Header and Description, as well as
images and audio.
Further information about configuring site information may be found in the corresponding
following chapter.
4.1.2.2 Exhibit Information
The exhibit information pane displays all the information regarding the currently selected
exhibit.
This information includes the Exhibit name, position, pricing and Description, as well as
images and audio.
Further information about configuring Exhibit information may be found in the corresponding
following chapter.
D3.3
February 2003
7 of 16
D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
4.1.2.3 Guided Tour information
The Guided tour information pane displays all the information regarding the currently
selected Guided Tour.
This information includes the Guided tour name, exhibits and their order.
Further information about configuring Guided Tours information may be found in the
corresponding following chapter.
4.1.3 The Map Pane
The Map pane displays the map of the currently selected site, as well as the position of the
currently selected exhibit.
The map may be of any size, and the only requirement for correct mapping of positions on
the map to real positions is the input of the appropriate scale factor for each dimension in
the site information,
The currently selected exhibit position is displayed as a red dot on the map.
D3.3
February 2003
8 of 16
D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
4.1.4 The Menu
The Application provides a complete command menu, that provides all the functionality
required for the management of exhibition setup information.
The Menu includes the following commands:
 File
o Exit: Exits the application
 Site
o Add new Site: Adds a new site
o Update Site: Updates site information
o Remove Site: Removes the currently selected site from the DB
 Guided Tour
o Add new Guided Tour: Adds a new Guided Tour
o Update Guided Tour: Updates Guided Tour information
o Remove Guided Tour: Removes the currently selected Guided Tour from the
DB
 Exhibit
o Add new Exhibit: Adds a new Exhibit
o Update Exhibit: Updates Exhibit information
o Remove Exhibit: Removes the currently selected Exhibit from the DB
4.2 Adding Site information
4.2.1 Inserting Site information & map
Once the Exhibition Setup application starts, it connects to the Database and displays all the
information stored about existing Sites and Exhibits.
Since the application is meant to be used for setting up a new exhibition site, the first step to
be done by the user should be to define a new site.
D3.3
February 2003
9 of 16
D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
To insert a new site: Menu Site/Add new Site
Once the site has been created information about it must be entered in the appropriate
fields.
The information stored for each site is:
 Site Name: The name of the site
 Map URL: a URL pointing to the Map of the site
 Scaling X: The scaling factor of the site’s map for the X – axis
 Scaling Y: The scaling factor of the site’s map for the Y - axis
 Header 1: The header to be shown in the site’s information page
 Header 2: The secondary header to be shown in the site’s information page
 Description 1: The Description text for the site’s information page
 Description 1: The secondary Description text for the site’s information page
 Audio URL 1 : The URL of the audio file to be played when the site is visited
 Audio URL 2 : The URL of the secondary audio file to be played when the site is
visited
 Image URL 1: The URL of the image to be shown in the site’s information page
 Image URL 2: The URL of the secondary image to be shown in the site’s information
page
 Site URL 1: The external URL of the site
 Site URL 1: The secondary external URL of the site
(Required information in bold)
Once a site’s information has been entered the site must be updated, for all the information
to be stored in the Database.
4.3 Setting up Exhibits
4.3.1 Inserting Exhibits
To insert a new exhibit in the currently selected site: Menu Exhibits/Add new Exhibit
The new exhibit is created and included in the currently selected site.
D3.3
February 2003
10 of 16
D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
Once the exhibit has been created information about it must be entered in the appropriate
fields.
The information stored for each site is:
 Name: The name of the exhibit
 Location X: The Location of the exhibit on the X axis
 Location Y: The Location of the exhibit on the Y - axis
 Orientation: the exhibit’s orientation in degrees
 Description : The Description text for the exhibit’s information page
 URL : The URL of the exhibit’s product page
 Audio URL : The URL of the audio file to be played when the exhibit is visited
 Image URL 1: The URL of the image to be shown in the exhibit’s information page
 Image URL 2: The URL of the secondary image to be shown in the exhibit’s
information page
 Price: The exhibit’s price
 Currency: the currency in which the exhibit’s price is displayed
 Site ID: the Id of the site where the exhibit belongs (Read Only)
(Required information in bold)
Once the exhibit’s information has been entered the user must update the exhibit in order
for the information to be stored in the Database.
D3.3
February 2003
11 of 16
D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
4.3.2 Setup Exhibits Locations
In order to setup the exhibit’s location on the map, the user must use the Map Pane,
displayed below the exhibit information.
A red dot indicates the exhibit’s current position on the map. The user can change the
position by clicking on the map. The exhibit is moved to the location the user clicked on.
The new position coordinates are displayed in the appropriate fields in the exhibit’s
information pane.
The location may be changed also by changing the values in the appropriate fields.
In order for the location change to become active the user must update the exhibit.
4.4 Setting up Guided Tours
Once the site and it’s exhibits have been defined, the user may insert Guided Tours into the
site.
A guided tour is a succession of visits to exhibits of the Site. The tour may contain more than
one visit for a specific exhibit.
4.4.1 Inserting Guided Tours
To insert a new exhibit in the currently selected site: Menu Guided Tour /Add new Guided
Tour
The new guided tour is created and included in the currently selected site.
D3.3
February 2003
12 of 16
D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
Once the guided tour has been created the user must select the exhibits to be included, as
well as their order. To do this the Guided Tour pane is used:
The user can add and remove exhibits in the guided tour by using the “Add” and “Remove”
buttons accordingly.
The exhibits order in the guided tour may be changed using the “Up” and “Down” buttons.
Once the guided tour information has been entered the user must update the guided tour in
order for the information to be stored in the Database.
4.5 Maintenance of Exhibition data
4.5.1 Updating Sites
To update the site’s information: Menu Sites/Update Site
4.5.2 Deleting Sites
To delete the current site: Menu Sites/Remove Site
D3.3
February 2003
13 of 16
D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
4.5.3 Updating Exhibits
To update the exhibit’s information: Menu Exhibits/Update Exhibit
4.5.4 Deleting Exhibits
To delete the current exhibit: Menu Exhibits /Remove Exhibit
4.5.5 Updating Guided Tours
To update the guided tour information: Menu Guided Tour/Update Guided Tour
4.5.6 Deleting Guided Tours
To delete the guided tour exhibit: Menu Guided Tour /Remove Guided Tour
4.6 Starting & Stopping The System
System start procedure
 Turn-on power switch on mobile robot (if shut-down); turn-on both off-board PCs (if
shut-down). The off-board windows PC launches the web server at start-up.
D3.3
February 2003
14 of 16
D3.3 WebFAIR Setup Guide
WebFAIR
Web Access to Commercial Fairs through Mobile Agents


On the on-board windows PC start the video streaming SW
On the off-board linux PC start the navigation SW (the SW also automatically starts
the modules that are executed on the on-board linux PC). The SW launches a
graphical environment for monitoring the robot status.
 On the off-board windows PC start the interface server. The server automatically
launches the administrator’s window, where run-time info about the system status
and users connected to the system is displayed. This info is also kept in a log file.
 On the on-board windows PC launch the Internet Explorer Browser, which
automatically starts the on-site exhibition interface.
System is ready now to be used by web- or on-site visitors.
System halt procedure
 To temporary halt the system: On the off-board windows PC shut-down the interface
server (users are not able to use the system any more).
 To permanently stop the system:
o On the on-board windows PC shut-down the video streaming module and the
Internet Explorer Browser
o On the off-board windows PC shut-down the interface server
o On the off-board linux PC shut-down the navigation module
o Optionally turn-off both off-board PCs and mobile robot (via power switch)
5 INSTALLATION PLAN CHECK LIST
5.1 Check list rationale
The installation plan detailed above contains a series of procedures that the administrator of
the system will have to perform in order to install a complete functional WEBFAIR system.
In order to streamline the installation process, the following Installation Plan Checklist is
provided to each installation, so the administrator may have easy access to each step of the
installation process, as well as a way to monitor installation progress.
D3.3
February 2003
15 of 16
WebFAIR
Web Access to Commercial Fairs through Mobile Agents
D3.3 WebFAIR Setup Guide
5.2 Installation Check List
5.2.1 Installation of the mobile module – robotic avatar
INSTALLATION OF THE MOBILE MODULE – ROBOTIC AVATAR
Installation step
Completed by:
Date/Time
Turn-on Robot; verify
system start-up from the
panel; verify network
access.
5.2.2 Installation of the robotic navigation system
INSTALLATION OF THE ROBOTIC NAVIGATION SYSTEM
Installation step
Completed by:
Date/Time
Run setup on the Linux
off-board PC from the
“Navigation SW” CD.
5.2.3 Installation of the Interface Server and Exhibition setup tool
INSTALLATION OF THE EXHIBITION SETUP TOOL
Installation step
Completed by:
Date/Time
Run
setup
on
the
Windows off-board PC
from the “Server-Setup
SW” CD.
D3.3
February 2003
16 of 16