Download, Installation, Configuration, Deployment - ProActive - Inria

tukwilagleefulInternet και Εφαρμογές Web

31 Οκτ 2013 (πριν από 3 χρόνια και 11 μήνες)

94 εμφανίσεις






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







1



VERSIONS HISTORY




Version


Date


Authors


Update

0.1

April

2010

F. Perrina

(INRIA)

E.Salageanu (Activeeon)

Document Creation













2



Table of Content

DOWNLOAD, INSTALLATI
ON, CONFIGURATION, D
EPLOYMENT

................................
................
3

Tomcat Application server
................................
................................
................................
................................
................................
................

3

Download

................................
................................
................................
................................
................................
................................
...........

3

INRIA/Acti veeon Projects

................................
................................
................................
................................
................................
.................

4

Parallel Services Project

................................
................................
................................
................................
................................
..................

4

GetSes
sionIdsByRange Web Service Project

................................
................................
................................
................................
..............

5

Amadeus Log Treat ment 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

Inta
lio Designer

................................
................................
................................
................................
................................
...............................

10

USE THE INSTALLED TO
OLS
-

RUN THE USE
-
CASES.

................................
................................

21

The admi nistrati on i nterfaces

................................
................................
................................
................................
................................
........
21

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

Run the AnalyzeSessionTracesProcess Process
................................
................................
................................
................................
.........
25

Human Task
................................
................................
................................
................................
................................
................................
.....

26













3



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 p
latform, 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 s
erver installed and configured (from previous agos tools
installation).

.


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

Step
1
.

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).








4

INRIA/Act
iveeon 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_S
ERVICES_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 path
s
, use “/” instead of “
\


Step4
.
Note: you should now update
configur
ation

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
\
con
figprop
\
paramsweeping.properties



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










5

Deploy

Step5
.

Open a command line.

Then do the following:



cd $PARALLEL_SERVICES_PR
J_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 fr
om 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 ple
ase 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.

Pleas
e start your to
mcat server now.

Step
9

Open a console:







6



$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

Step1
0.


Download the arc
hive 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

Step1
1.


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 any
thing at
this step.


Deploy

Step1
2.


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 arch
ive is :


[java] 1

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







7



Recreate the database. Please use the sql script in file

$AmadeusLogTreatment_HOME/
resources
\
db_scripts
\
createDB_mysql.sql

to recrea
te 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 retrieva
l 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

Step
13


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

Step
14


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.


Dep
loy

Step
15

Open a console.:



cd
GetSessionTraceJob_Project_HOME
\
compile



build.bat upload.jobar








8

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 th
e 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 conf
igure



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







9

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/CodeArc
hiveRefProvider.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 Intali
o BPMN Processes


Step 16

Go to the intaglio designer you have previously started.










10


Intalio Server



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



Download


Step1
7
.

download intalio server ( comunity version 6.0.3)

from intalio's web site:

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


(direct download link:

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


Step
18
.

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 loca
l 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 cor
responding BPEL process.








11


Download Des
i
gner



Step
20
.

download the Intalio Designer from intalio web site:

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


cho
o
se the version which best fits your

operating system


-

extract the designer


Download

the Workspace


Step
21

Create a new folder to keep your intaglio projects.


Let's call this folder INTALIO_DESIGNER_WORKSPACE.

Download the
I
ntalio 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







12

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
P
rocess
E
xplorer view you should
now
see 2 projects
.










13





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 vie
w: 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:











14









Step
24
.
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.







15


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:











16


Change the numeric value to the value with the
Reference id

obtained at
Step
15


(

2

, in our document). Cl
ick Ok.

Save the GetSidsByRangeBP.bpn file.

Deploy

Step25.

Configure the

AnalyzeSessionTracesP
rocess 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:







17


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



















18

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



Configure and deploy the
LogTreatmentProcess

project


Configure


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








19

Enlarge the data editor view, then expand the Log Tre
atment item, and edit the <bpel:co
py> 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 “Confi
gure button”:







20




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.







21

Use th
e installed tools
-

r
un the use
-
cases.


The administration interfaces


Step
27.

Check all services are installed:

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

Then click on Services.

You sho
uld see, among others, these services installed:



PSRepository



CodeArchiveRefProviderService



SchedulerInterface



ParameterSweepingService



AAALogsImportService



GetSIDByRange



Step

28
.

Open the

Intalio Administration
C
onsole
:

In a Web Browser, go to the addr
ess:

http://localhost:8080/bpms
-
console

Use Admin/changeit as credentials.



You should see your two BPEL processes:







22



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


Run the Log treatment Process

Step29.

Click on the LogTreatmentProcess , then on the start button:







23



Please ent
er the

URL of your logs archive, click

Submit.

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

file://c:/activeEon/agos/Pro
totype/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, yo
u can see details about its state.







24



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 instan
ce, in the Intalio administration
interface, will change to Completed.

All the Logs are in the database.














25

Run the AnalyzeSessionTracesProcess Process

Step30.


On the Intalio administration interface, on the Processes page, click on the
AnalyzeSessi
onTracesProcess
, 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


N
ote: 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







26


ta
bleName: 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 pro
cess insta
n
ce 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 cred
entials.

You will see you have a (Human)

Task, called GridTreatmentAprouval. Click on it. It tells you how ma
ny sessions Ids
are to be analyz
ed
on the grid, and asks for appro
val. 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.