ANNEX 5: ARES USER MANUAL
Contents
1. JBoss Get JBoss J2EE application server version 4 0 x from hitp www jboss org Copy the JBoss folder into your system Install a MySQL instance Get MySQL version 4 x or 5 x recommended from http www mysal org If you have already installed on your machine a different version or you have a different kind of database you can use it changing the data source parameters Section 1 1 2 1 1 2 To deploy ARES Install the Java Runtime Environment JRE If you do not have installed a J2SE SDK that already includes the JRE get the J2SE 1 4 2 JRE from http java sun com j2se Deploy the WAR file into the application server Find the deploy folder of your JBoss installation and put there the ARES war file containing all the necessary resources for running the software if for instance your JBoss is installed into C JBoss4 0 3 so normally you can find that folder in the path C JBoss4 0 3 server default deploy The package includes also all the necessary Java libraries needed by the tool including Jena 2 perio the ARES database for logs Create a new database instance If you are not using MySQL as database you have to include the appropriate JDBC driver into the system classpath or adding it into the C JBoss4 0 3 server default lib folder Run the following SQL script in the DB instance created for ARES in order to setup all the necessary tables DROP TABLE IF EXISTS LOGS CRE2. AIDIMA invoice validated ONNR 4 34 aa Level WARN Type Reconciliation Timestamp 2006 01 30 12 34 05 12 897 Logger http euproj gformula com 8080 ares Message AIDIMA invoice validated Message details Jena error code oe Figure 5 ARES logs dashboard 1 4 FAQs Why do you use JBoss and not a lighter application server such as Tomcat or Jetty JBoss is an open source project hosted by Sourceforge and its web container is the famous Tomcat It is more extensible easily deployable without any particular installation and allows to use data sources in order to implement a perfect three layer architecture ensuring the abstraction from particular DBMS Is it possible to use different databases ARES is built using standard Java JDBC based libraries that allow to use different databases Also Jena permits to deploy its persistency layer over different types of DBMS During the development MySQL has been chosen because it is free it is easily deployable and contains advanced features 1 5 Known Issues e ARES versions support The ARES tool is not tested with versions 3 x or lower of JBoss it is tested only with version 4 x and 5 0 of MySQL and JDK 1 4 2 or 1 5 so it is possible to get problems installing the tool in older and newer versions of those components 2005 2006 The ATHENA Consortium 9 ONT2 Ontology based support to Enterprise Interoperability ARES manual 1 6 Used Configura
3. ATE TABLE LOGS id VARCHAR 100 NOT NULL level INTEGER NOT NULL type VARCHAR 50 NOT NULL timestamp DATE NOT NULL message VARCHAR 200 NOT NULL messagecont TEXT PRIMARY KEY id i 2005 2006 The ATHENA Consortium 3 ONT2 Ontology based support to Enterprise Interoperability ARES manual Setup the JBoss data source In order to allow the usage of different kinds of databases the connection to the DB is managed by the tool via a JBoss data source Find the deploy folder of your JBoss installation where you have putted the ARES war file if for instance your JBoss is installed into C JBoss4 0 3 you can find that folder in the path C JBoss4 0 3 server default deploy If a previous version of the data source file does not exist the first step is the creation of an XML file called jdbc ds xml into the deploy folder Add to the jdbc ds xml file a new data source like the following XML lt datasources gt lt local tx datasource gt lt jndi name gt dat aDB lt jndi name gt lt connectionurl gt jdbc mysql localhost aresdb1 lt connection url gt lt driver class gt com mysql jdbc Driver lt driver class gt lt user name gt root lt user name gt lt password gt root lt password gt lt local tx datasource gt lt datasources gt The fields in red have to be filled with your own DB installation parameters lt connectionurl gt Should include th
4. ONT2 Ontology based support to Enterprise Interoperability ARES manual ANNEX 5 ARES USER MANUAL s European Integrated Projects Activity B6 Training 2005 2006 The ATHENA Consortium ONT2 Ontology based support to Enterprise Interoperability ARES manual ARES USER MANUAL 1 How toset upand U ARES R A A RORA 3 1 1 ET EIIE EEEE PLAE ET E A AA E A EA ETETA AEE 3 1 1 1 TINSA ARES TOO R RRE RE E RE E E RORE 3 1 1 2 TO GE DIOV ARES eienen E E A E A E a 3 1 1 3 TO TUN ARES a R a R 4 1 2 RUM ARES fareticeecisecctedete dain E E E EAEE 5 1 3 TS St TNS instaladon Ra E RER RRO A A E EO ES 5 1 4 FAQ Seiat i ai aa a aaia iii 9 1 5 AOV ISSUGS R A 9 1 6 Used Conigurdho M ssanie e a otek oa hk oleh OE 10 Dix RETETOTIS CS aries obese A E E E A EE 11 Acknowledgement ennont R neet re or aE rean das esevasenetuienbatevesuteshecdennendesnbacenstasevevaresetuiedebatededebete 12 2005 2006 The ATHENA Consortium 2 ONT2 Ontology based support to Enterprise Interoperability ARES manual 1 How to set up and run ARES 1 1 Requirements 1 1 1 To install ARES tool If you do not have a previous installation of the ARES tool Install a JDK Get J2SE version 1 4 2 SDK or higher from http java sun com j2se Set the JAVA_HOME environment variable Start Control Panel System Properties Advanced Environment Variables to point to the JDK installation directory e g C java j2sdk1 4 2_05 Install a
5. e exact sub protocol including type of connector the type of DB and the address of the DB server lt driver class gt The name of the Java connector for the specific DB lt user name gt and lt password gt Authentication parameters to access to the ARES DB instance 1 1 3 To run ARES Start the DBMS Start the database management system if it is not still running Normally on Window the DBMS are installed as automatic service and starts automatically Start JBoss If you do not have set the JAVA path in your system a Windows 2000 XP users may set their path by right clicking on My Computer and selecting Properties Under the Advanced tab there is a button that allows you to set the Environment variables Click on this and alter the Path variable so that it also contains the path to the Java executable For example if you have installed Java in c jdk and your path is currently set to C WINDOWS SYSTEM32 then you would change your path to read C WINDOWS SYSTEM32 c jdk bin b Windows 95 98 ME users may find that their path variable is stored in a different place Edit the c autoexec bat file and add the following line at the end SET PATH PATH c jdk bin This also assumes that you have installed Java in c jdk c Linux UNIX Solaris FreeBSD users must set their PATH variable to point to where the java binaries have been installed Please refer to your shell documentation if you have trouble doing thi
6. fferent ontology Ontology CRF scenario Ontology x THEMIS URL 7 Do you want to validate the RDF message Apply the full reconciliation is ver jbass Figure 4 ARES reconcili 6 Visualize the logs panel a Chose in the Logs menu the link to the Logs dashboard b In the main window appears the list of the logs stored into the system 2005 2006 The ATHENA Consortium ONT2 Ontology based support to Enterprise Interoperability ARES manual ARES By Gruppo Formula Research Group Microsoft Internet Explorer File Edit View Favorites Tools Help Qk BO Lseach XFaortes 8 3 MW a 3 Address je http 127 0 0 1 8080 aresv02 frameindex html a European Integrated Projecte Level Type Timestamp Logger Message 2006 01 30 12 13 01 23 433 2006 01 30 12 13 05 12 897 aia 2006 01 30 R y X ees Reconciliation 12 13 08 56 334 http feuproj gformula com 8080 ares Reconciliation error Validation http euproj gformula com 8080 ares AIDIMA invoice validated Reconciliation http euproj gformula com 8080 ares Semantic rule skipped 2006 01 30 Validation 12 13 22 23 763 http euproj gformula com 8080 ares AIDIMA invoice validated Validation POETA http euproj gformula com 8080 ares AIDIMA invoice validated oa 2006 01 30 y aes E 3 Validation 12 13 46 28 453 http euproj gformula com 3080 ares
7. ministrator lorenzo pondrelli formula it If you already have an account please click on the Enter the system image If you want to know more about ARES you may start reading the ARES User Manual a od Enter the system Download the manual For any further information contact lorenzo pondrelli formula it 4 Done Internet C amp NetBeans IDES Figure 1 ARES home page 3 Insert your authentication parameters company username and password 2005 2006 The ATHENA Consortium 5 ONT2 Ontology based support to Enterprise Interoperability ARES manual ARES By Gruppo Formula Research Group Microsoft Internet Explorer DESK Fie Edit View Favorites Tools Help Qsc O NA Asah krate 8 a P ODI Address http 127 0 0 1 8080 aresv02 login jsp Eco inks ronmuta ARES Utente Password Done E internet Figure 2 ARES login page 4 Setup the parameters for the integration into the ATHENA framework Chose in the Settings menu the link to the integration settings Setup the URL of the ARGOS instance that it has to be integrated Setup the URL of the THEMIS instance that it has to be integrated Chose the Reference Ontology used by the tool apogo 2005 2006 The ATHENA Consortium 6 ONT2 Ontology based support to Enterprise Interoperability ARES manual ARES By Gruppo Formula Research Group Microsoft Inte
8. ors or by other copyright holders It is understood that all persons copying these figures will adhere to the terms and constraints invoked by each copyright holder 2005 2006 The ATHENA Consortium 12
9. rnet Explorer File Edit View Favorites Tools Help EJ Osak a aA A search Krates O 2 S M VHS Address http 127 0 0 1 8080 aresv02 frameindex html European Integrated Projecte Deployment Settings ARGOS URL Functors jar file URL mems Td Ontology CR nario Ontology x z AIDIMA scenario Ontology EADS scenario Ontolog Oe c Figure 3 ARES deployment settings page 5 Test a simple reconciliation selecting in the menu called test the full reconciliation test a Choose the initial RDF schema from the list imported from THEMIS b Choose the final schema from the list imported from THEMIS c Upload the RDF instance which will be reconciliated d Execute the reconciliation 2005 2006 The ATHENA Consortium 7 ONT2 Ontology based support to Enterprise Interoperability ARES manual ARES By Gruppo Formula Research Group Microsoft Internet Explorer File Edit View Favorites Tools Help a Oik O MAG seach kras BS M OHS Address 2 http 127 0 0 1 8080 aresv02 Frameindex html s European Integrated Projecte we know how Full reconciliation Test Initial RDF message 1 ei r ERa RDFS on which is based the initial message AIDIMA Request for quotation x Final RDFS CRF Request for quotation CRF Request for quotation AIDIMA Request for quotation EADS product THEMIS URL 7 Do you want to use a di
10. s For example if you use bash as your shell then you would add the following line to the end of your bashrc export PATH path to java P ATH If you JBoss instance is not running find the bin folder under your JBoss installation path and double click ton he run bat file Wait the starting process end then check if the server encountered some errors Point with your browser to the main page of the server to check its correct execution normally the address is http localhost 8080 for local installation 2005 2006 The ATHENA Consortium 4 ONT2 Ontology based support to Enterprise Interoperability ARES manual 1 2 Run ARES 1 Open an Internet browser and point to the JBoss page on which the tool is running normally http localhost 8080 ARES for local installation 1 3 Test the installation You can test the installation of ARES following a simple tutorial test 1 Start the JBoss server 2 Load the ARES home page ARES By Gruppo Formula Research Group Microsoft Internet Explorer File Edit View Favorites Tools Help EJ Qe O MAG Asah KFt 8 3 P DS Address http 127 0 0 1 8080 aresva2 M gt E3 Links ATHENA ARES G FORMULA we know how Version 1 0 by Gruppo Formula Research Group division of Gruppo Formula developed within the Athena Project ARES is the Athena Semantic Reconciliation Engine If you don t have an account you need to contact the ARES ad
11. tion The examples in this document were tested with the following configuration Java version 1 5 0 upgrade 6 JBoss 4 0 3 MySQL 5 0 Win XP pro SP 1 2005 2006 The ATHENA Consortium ONT2 Ontology based support to Enterprise Interoperability ARES manual 2 References 1 Java home page hitp java sun com j2se 2 JBoss home page http www jboss org 3 MySQL home page Htto www mysql org 4 Jena 2 home page Http jena sourceforge net 2005 2006 The ATHENA Consortium ONT2 Ontology based support to Enterprise Interoperability ARES manual Acknowledgement The editors of this book acknowledge the following organizations for providing and revising the contents of this book UNINOVA SAP ESI TROUX DFKI TXT Formula AIDIMA SINTEF INTRACOM CRF FIAT and EADS This course has been developed under the funding of the EC with the support of the EC ATHENA IP Project A Information Society Disclaimer and Copyright Notice Permission is granted without fee for personal or educational non profit use previous notification is needed For notification purposes please address to the ATHENA Training Programme Chair at rg uninova pt In other cases please contact at the same e_mail address for use conditions Some of the figures presented in this course are freely inspired by others reported in referenced works sources For such figures copyright and all rights therein are maintained by the original auth
Download Pdf Manuals
Related Search