Docstoc

Download_ Installation_ Configuration_ Deployment - ProActive

Document Sample
Download_ Installation_ Configuration_ Deployment - ProActive Powered By Docstoc
					                 AGOS Project
      Architecture Grid Orientée Services




Sub-project 5: Prototypes Development

Step by Step download, installation, configuration, deployment
and execution of AGOS open-source chain of tools for the
Amadeus Use-Case



April 2010




                                            A Platform for Agile
                                                           SOA
                                               with Grids using
VERSIONS HISTORY




 Version     Date              Authors                          Update
   0.1     April 2010      F. Perrina (INRIA)     Document Creation
                        E.Salageanu (Activeeon)




                                                                         1
                                                                       Table of Content
DOWNLOAD, INSTALLATION, CONFIGURATION, DEPLOYMENT........................................... 3

Tomcat Application server............................................................................................................................................................. 3
  Download ..................................................................................................................................................................................... 3

INRIA/Activeeon Projects.............................................................................................................................................................. 4
  Parallel Services Project ............................................................................................................................................................... 4
  GetSessionIdsByRange Web Service Project .............................................................................................................................. 5
  Amadeus Log Treatment Project .................................................................................................................................................. 6
  GetSessionTraceJob Project ......................................................................................................................................................... 7
  Auxiliary Web Services ............................................................................................................................................................... 8
  AAALogsImport web service ...................................................................................................................................................... 8
  CodeArchiveRefProvider web service ......................................................................................................................................... 8

Configure and Deploy Intalio BPMN Processes .......................................................................................................................... 9
  Intalio Server .............................................................................................................................................................................. 10
  Intalio Designer .......................................................................................................................................................................... 10


USE THE INSTALLED TOOLS - RUN THE USE-CASES. ......................................................... 21

The administration interfaces ...................................................................................................................................................... 21

Run the Log treatment Process ................................................................................................................................................... 22

Run the AnalyzeSessionTracesProcess Process ......................................................................................................................... 25
  Human Task ............................................................................................................................................................................... 26




                                                                                                                                                                                                2
     Step by Step download, installation, configuration, deployment and
   execution of AGOS open-source chain of tools for the Amadeus Use-Case


Note: In order to download, install, configure and run all tools for the Agos platform, please follow this document
step by step.

Note: You should make sure you have 4G free on your hard drive.


Download, Installation, Configuration, Deployment
Tomcat Application server


Download
 We consider you already have a tomcat application server installed and configured (from previous agos tools
installation).

. If it is not the case, you can get our already configured version of tomcat:

Step1. download (if you don’t already have it)

        http://proactive.inria.fr/agos/resources/tomcatPS.zip

 Let's call your tomcat home folder TOMCAT_HOME.



Configure
We need to specify some ports for tomcat server for not having conflicts with the tomcat server.

Please download our tomcat configuration file from here

http://proactive.inria.fr/agos/resources/extra/all_config/tomcatPS_apache-dir_conf-dir/server.xml

and put in the folder $TOMCAT_HOME/conf/ (replace the existing file).




                                                                                                                      3
INRIA/Activeeon Projects


Parallel Services Project


Info: Project containing the Proactive based parallel web services.



Download
Step2. Please download this project from

http://proactive.inria.fr/agos/resources/extra/src_projects/parallel-services-update2.tar.gz

and extract it into a new folder (let's call this folder PARALLEL_SERVICES_PRJ_HOME).



Configure


Step3.. Edit the file: $PARALLEL_SERVICES_PRJ_HOME/compile/build.properties and set the property
TOMCAT_HOME to the path to your $TOMCAT_HOME directory (something like c:/..../apache-tomcat-5.5.26)

Note: For windows paths, use “/” instead of “\”

Step4. Note: you should now update configuration information in the files:



  $PARALLEL_SERVICES_PRJ_HOME\compile\build-res\configprop\schedconf.properties

  $PARALLEL_SERVICES_PRJ_HOME\compile\build-res\configprop\rep.properties

  $PARALLEL_SERVICES_PRJ_HOME\compile\build-res\configprop\paramsweeping.properties



 You should already have done this during a previous install of the project. You could just copy your own old-
configuration files.




                                                                                                                 4
Deploy
Step5.

Open a command line.

Then do the following:

     cd $PARALLEL_SERVICES_PRJ_HOME/compile
     build.bat cleanAndGenerate.all
     build.bat deployOnServer

GetSessionIdsByRange Web Service Project


Info: web service that allows the retrieval of a set of session ids based on a range of attributes.



Download
Step6.

Download the archive from here:
http://proactive.inria.fr/agos/resources/extra/src_projects/GetSessionIdsByRange-WS.tar.gz

Extract the archive into a new folder. Let's call this folder GetSessionIdsByRange_HOME

Deploy
Step7.

In order to deploy this service on tomcat server please copy a file

from $GetSessionIdsByRange_HOME\build\lib\GetSIDByRange.aar to folder
$TOMCAT_HOME\webapps\axis2\WEB-INF\services\



Important Note:
Step8.

Please start the ProActive Resource Manager and Proactive Scheduler now.

Please start your tomcat server now.
Step9

Open a console:


                                                                                                      5
    $TOMCAT_HOME\bin\startup.bat -security




Amadeus Log Treatment Project


Info: contains the business code related to the amadeus log insertion and amadeus log retrieval usecases.



Download
Step10.

 Download the archive from here:
http://proactive.inria.fr/agos/resources/extra/src_projects/AmadeusLogTreatmentusecase.tar.gz

 Extract the archive into a new folder. Let's call this folder AmadeusLogTreatment_HOME

Configure
Step11.

  If your tomcat is not running on a remote machine (i.e. not on your localhost) you have to edit the file
$AmadeusLogTreatment_HOME/src_test/Amadeus_test.properties and change the value of
repository__ws_end_point property. Otherwise (tomcat running on localhost) you don’t have to do anything at
this step.



Deploy
Step12.

 Open a command line console:

    cd $AmadeusLogTreatment_HOME/compile
    build.bat build.bat upload.parsweep.codear



You should see on the screen, at the end of the execution something like:

[java] Reference id of the archive is :

[java] 1

Please note the given id number (We will refer to it, in this document, as AmadeusLogTreatmentRefId ).


                                                                                                              6
Recreate the database. Please use the sql script in file
$AmadeusLogTreatment_HOME/resources\db_scripts\createDB_mysql.sql to recreate the database

Tip: you can use the createDB_mysql_cluster.sql script if you are using a mysql cluster database.




GetSessionTraceJob Project


Info: Proactive Schedukling Job that compopses two operations (imeplemented in java):

  - Task1: the retrieval of the information in the database related to one Session ID (all the entries, in all table,
corresponing to that session ID)

 - Task2: the "fake" analysis of the previously retrieved information

Download
Step13

Please download the project's archive from:
http://proactive.inria.fr/agos/resources/extra/src_projects/getSessionTraceJob.tar.gz

Extract the archive into a new folder (let's say into GetSessionTraceJob_Project_HOME folder)

Configure
Step14

If your tomcat is not running on a remote machine (i.e. not on your localhost) you have to edit the file
GetSessionTraceJob_Project_HOME\src_utils\utils.properties and change the repository__ws_end_point property.
Otherwise (tomcat running on localhost) you don’t have to do anything at this step.



Deploy
Step15

Open a console.:

     cd GetSessionTraceJob_Project_HOME\compile
     build.bat upload.jobar




                                                                                                                        7
You should see on your screen something like:



   [java] Reference id of the archive is :

   [java] 2

BUILD SUCCESSFUL

Total time: 20 seconds



Please note the given id number (We will refer to it, in this document, GetSessionTraceJobRefId).



Auxiliary Web Services

AAALogsImport web service


Download & deploy
Download the archive

http://proactive.inria.fr/agos/resources/extra/auxiliary_web_services/AAALogsImport.aar

and copy at at location:

$TOMCAT_HOME\webapps\axis2\WEB-INF\services\ AAALogsImport.aar




CodeArchiveRefProvider web service


Download and configure


 Create a new folder for the configuration files for the auxiliary services , at a location of your choice. Let’s call this
folder $AUX_WS_CONFIG.



 Download the configuration file from


                                                                                                                              8
http://proactive.inria.fr/agos/resources/extra/all_config/aux_ws_config/arRefData.data

to the location $AUX_WS_CONFIG/arRefData.data

Edit this file and modify the archive Id (initially 1) with the value obtained at Step 12 (1, in our document).



Download the web service archive

http://proactive.inria.fr/agos/resources/extra/auxiliary_web_services/CodeArchiveRefProvider.aar

into a temporary folder.

Unzip the archive (the archive is in zip format) and edit the file arRefProv.properties

Set the value of the parameter codesArchiveRefsDataFilePath to the path of the file
$AUX_WS_CONFIG/arRefData.data

Note: use “\\” instead of “\”, like in “c:\\activeeon\\web_services\\configuration\\arRefData.data”



Deploy


Re-zip the archive and copy it to the location:

$TOMCAT_HOME\webapps\axis2\WEB-INF\services\ CodeArchiveRefProvider.aar




Configure and Deploy Intalio BPMN Processes


Step 16

Go to the intaglio designer you have previously started.




                                                                                                                  9
Intalio Server


 Info: Intalio is the application server which will expose your BPEL processes



 Download
 Step17. download intalio server ( comunity version 6.0.3) from intalio's web site:

http://community.intalio.com/downloads.html

 (direct download link:

http://community.intalio.com/docman/downloads/intalio-server-6.0.3/download.html)



Step18. extract the downloaded archive (we'll call the extracted folder INTALIO_SERVER_HOME)



 Configure


 We need to configure the timeout for 2 of our services.

 Step19. Download the file
http://proactive.inria.fr/agos/resources/extra/all_config/intalioServer_var_config/parallelsvcs.endpoint

to your local location: $INTALIO_SERVER_HOME\var\config\



Start the intalio server:

$INTALIO_SERVER_HOME/bin/startup.bat



Intalio Designer


 Info: allows you to compose web services within a BPMN process and automatically generate and deploy to intalio
server a corresponding BPEL process.




                                                                                                               10
 Download Designer


Step20. download the Intalio Designer from intalio web site:

http://community.intalio.com/downloads.html

 choose the version which best fits your operating system



- extract the designer



Download the Workspace

Step21

Create a new folder to keep your intaglio projects.

Let's call this folder INTALIO_DESIGNER_WORKSPACE.

Download the Intalio projects archive from

http://proactive.inria.fr/agos/resources/extra/intalio_designer_projects/intalio_designer_projects.tar.gz

into a temporary folder. Extract the 2 folders contained in the archive in the workspace folder you have previously
created $INTALIO_DESIGNER_WORKSPACE.

You should now have, in the $INTALIO_DESIGNER_WORKSPACE folder, two folders (AnalyzeSessionTracesProcess
and LogTreatmentProcess)



Run the designer
Step22. When asked for the workspace location, browse to the folder previously created
$INTALIO_DESIGNER_WORKSPACE



Open the Intalio | Designer perspective:

Go to Windows -> Open perspective -> Intalio | Designer



Now, in Intalio Designer, go to File-> Import… -> General -> Existing projects into workspace


                                                                                                                  11
Click next. Click the browse buttin and navigate to the $INTALIO_DESIGNER_WORKSPACE folder.

Click ok. You should see 2 projects in the Projects panel, like in the figure bellow.

Select both of them and click Finish.




 In the ProcessExplorer view you should now see 2 projects.




                                                                                              12
Configure and deploy the AnalyzeSessionTracesProcess project
Step23.

Configure


Open the file GetSIDsByRangeBP.bpm. you should see the design of the BPMN Process:




Open the data editor view: go to Windows -> show view -> Data Editor

Tip: you can double click on the data Editor tab to enlarge it. Double click again reduce its size.

We need to change the url of the database.

Please expand the GetIdsByRangeTest itme like in the figure bellow:




                                                                                                      13
Step24. Right click on the <bpel:copy> element corresponfing to the database url data assignement (see figure
above), click edit and change the url so that it corresponds to your database’s url.


                                                                                                                14
Now, we need to change the value of the scheduler’s job reference on the server.

Right-Click -> edit on the corresponding <bpel:copy> element, like in the figure bellow:




                                                                                           15
Change the numeric value to the value with the Reference id obtained at Step15 (“2”, in our document). Click Ok.

Save the GetSidsByRangeBP.bpn file.

Deploy
Step25.

Configure the AnalyzeSessionTracesProcess for deployment

Select the AnalyzeSessionTracesProcess in the process view and then click on the “Configure
AnalyzeSessionTracesProcess” button:




Now specify the intalio’s server host (normally localhost) thensave and deploy the process:




                                                                                                               16
You should see the messege Deployment successful in the Progress Pane:




                                                                         17
The first process is deplpoyed and ready to use. Let’s configure and deploy the second process:
LogTreatmentProcess




Configure and deploy the LogTreatmentProcess project


Configure


Open the file LogTreatmentProcess.bpn like in the figure bellow:




                                                                                                  18
Enlarge the data editor view, then expand the Log Treatment item, and edit the <bpel:copy> item corresponging to
the database url, like in the figure:




Step26.

Change the url’s value with your database’s url. Click Ok.

Save the LogTreatmentProcess.bpmn file.



Deploy


Select LogTreatmentProcess in the process view, then click the “Configure button”:




                                                                                                              19
Change the url for the intalio server, then click on save, then deploy:




You should see the deployment successful message in the Progress panel.



If you reached this point, everything is installed, configured and ready to run.


                                                                                   20
Use the installed tools - run the use-cases.


The administration interfaces


Step27. Check all services are installed:

Open a Web Browser and navigate to http://localhost:8070/axis2/

Then click on Services.

You should see, among others, these services installed:

       PSRepository
       CodeArchiveRefProviderService
       SchedulerInterface
       ParameterSweepingService
       AAALogsImportService
       GetSIDByRange




Step 28.

Open the Intalio Administration Console:

In a Web Browser, go to the address: http://localhost:8080/bpms-console

Use Admin/changeit as credentials.




You should see your two BPEL processes:




                                                                          21
Tip: You can start the Scheduler and Resource Manager RCPS (GUIS) if they are not already started.



Run the Log treatment Process
Step29.

Click on the LogTreatmentProcess , then on the start button:




                                                                                                     22
Please enter the URL of your logs archive, click Submit.

Note: For example, on my windows machine, the URL is:

file://c:/activeEon/agos/Prototype/AmadeusLogTreatmentusecase/resources/testArchives/files_1000_lines.zip

Then close the submission window, go to instances.

You should see the instance of your process, “In Progress”. You can click on it:




If you click on the process instance, you can see details about its state.


                                                                                                            23
On the Scheduler RCP (GUI) you should be able to see your job running:




On the Resource Manager you should see the occupied resources.

When all the jobs will finish on the scheduler, the state of the process instance, in the Intalio administration
interface, will change to Completed. All the Logs are in the database.




                                                                                                                   24
Run the AnalyzeSessionTracesProcess Process
Step30.

 On the Intalio administration interface, on the Processes page, click on the AnalyzeSessionTracesProcess, then on
the start button.

Fill in the form.

Example1:

dbUrl: jdbc:mysql://localhost/testAmadeus

dbUserName: demo

dbPassword: demo

AttributeName: field1_timestamp

minVal: 2009-09-20 08:28:53

maxVal: 2009-09-20 08:28:56

tableName: FU



Note: It analyses the data related to all session IDs corresponding to users which had left a trace in the FU table,
between 2009-09-20 08:28:53 and 2009-09-20 08:28:56.

TIP: Click on “Add child instance” in order to add more attribute ranges.




Example2:

dbUrl: jdbc:mysql://localhost/testAmadeus

dbUserName: demo

dbPassword: demo

AttributeName: field1_timestamp

minVal 2009-09-20 08:28:53

maxVal: 2009-09-20 09:09:00

tableName: ST



AttributeName: field1 field4_customer

minVal THPFP4494

maxVal: THPFP4494


                                                                                                                       25
tableName: ST



Note: It analyses the data related to all session IDs corresponding to a specific user, named THPFP4494, which had left a
trace in the ST table, between 2009-09-20 08:28:53 and 2009-09-20 09:09:00.




Human Task
Step31.

If you look at the process instance state (on the instances page, click on your process instance), you’ll see that it
waits for a human decision.

Open the Intalio User Interface:

http://localhost:8080/ui-fw

use Admin/changeit as credentials.

You will see you have a (Human) Task, called GridTreatmentAprouval. Click on it. It tells you how many sessions Ids
are to be analyzed on the grid, and asks for approval. Click on Complete.

If you go on the administration page, and refresh the process instance, you will see the state of the process
instance changed.

On the Scheduler GUI, you will see as many jobs as Session IDS to be treated.




                                                                                                                        26

				
DOCUMENT INFO