Questo articolo è la prima lezione inerente allo sviluppo dei web services sviluppati con AXIS 2, Tomcat e Netbeans,  gli argomenti che si affrontano sono l’impostazione dell’ambiente di lavoro.

Requisiti di sistema:

• Sistema Opertivo : distribuzione GNU\Linux Red Hat Based a 64Bit modalità Desktop (per questa guida CentOS5)
• Java : JDK 6 updated 22
• Tomcat 6
• Axis2 v 1.4.1 Binary Distribution
• LAMP + phpMyAdmin 2.11.11
• Netbeans IDE 6.9.1.

Si suppone di avere la distribuzione GNU/Linux Red Hat based a 64bit installata in modalità Desktop.ed aver effettuato l’accesso con i premessi di root. Occorre inoltre installare le librerie e gli strumenti da sviluppo per compilare i sorgenti.

Installazione Server

Installazione Java Development Kit e Ant

I passi per l’instalazione della piattaforma java sono :

• accedere al sistema
• scaricare presso la JDK 6u22 presso il sito http://www.oracle.com/technetwork/java/downloads/index.html
• scegliere come piattaforma Linux x64 e scaricarlo dove si vuole all’interno del file system, il file da scaricare dovrebbe avere questo nome :

jdk-6u22-linux-x64-rpm.bin

• aprire un terminale
• andare nella cartella dove si trova il file e digitare:

[...]# sh ./jdk-6u22-linux-x64-rpm.bin

• se l’installazione è andata a buon fine ci sarà in messaggio positivo :

Done.

• controllare che versione di java è installata nel sistema di default con il seguante comando:

[...]# java -version

Java HotSpot(TM) 64-Bit Server  VM (build 17.1-b03, mixed mode)

Java(TM) SE Runtime Enviroment (build 1.6.0_22-b4)

java version "1.6.0_22"

• se la versione java non corrisponde a qualla desiderata ,la JDK 6, occorre impostarla con il seguante comando

[...]# alternatives -- config java

• si visualizzerà un elenco delle JRE installate nel sistema se la JRE desiderata è nell’elenco digitare il numero associato e premere invio controllando se la versione è corretta con il comando del passo 7.
• se la versione non è presente nell’elenco occorre installarla nell’elenco delle possibili alternative nel seguante modo :
  • controllare se è stata installata correttamente il JDK andando in :

[...]# cd /usr/java/

• dove all’interno ci deve essere il seguente contenuto digitando :

[...]# ls -l

... default -> /usr/java/latest

... jdk1.6.0_22

... latest -> /usr/java/jdk1.6.0_22

• se il contenuto è quello precedente il comendo per installare la nuove JDK nell’elenco è :

[...]# alternatives --install /usr/bin/java java

/usr/java/default/bin/java 2

• se il comendo non ha dato errori la nuova JRE è installata nell’elenco
• ripetere i passi 7 a 9.
• Per completare l’ambiante Java occorre installare anche Apache Ant, software per l’automazione del processo di build Java, con il seguente comando :

[...]# yum install ant

• digitando Y alle domande successive per installare le dipendenze.

Installazione Apache Tomcat 6

I passi per l’installazione di Tomcat sono:

• Scaricare Tomcat 6 dal sito web http://tomcat.apache.org/download-60.cgi#6.0.29 scegliendo la versione tar.gz
• scompattare il file scaricato
• aprire un terminale e posizionarsi nella directory dove è stato scompattato il file
• muovere la directory creata al’interno di /opt

[...] # mv apache-tomcat-6-0-29 /opt/

• configurare il file tomcat-users.xml all’interno della directory conf
• inserire nel file il seguente codice all’interno dell’elenco degli utenti preventivamente decommentato

<role rolename="manager"/>

<role rolename="admin"/>

<user username="admin" password="tomcat" roles="admin,manager"/>

• avviare tomcat andando all’interno della directory bin ed eseguando

[...]# ./startup.sh

• verificare se il servere è avviato aprendo un browser web e andando all’inidirzzo localhost:8080 ,e se tomcat è attivo apparira una pagina di gestione. Nel menù a sinistra premere la voce Tomcat Manager , di seguito apparir auna finestra di login, immettere le credenziali e se sono corrette si accederà all’area amministrativa di Tomcat
• aggiungere librerie aggiuntive :
  • MySQL JConnector :
  • scaircare mysq-jconnector presso il sito http://www.mysql.com/downloads/connector/j/
  • scompattare il file mysql-connector-java-5.1.13.tar.gz scaricato
  • copiare nella directory lib di tomcat il file mysql-connector-java-5.1.13-bin-jar

[...]# cp mysql-connector-java-5.1.13-bin.jar /opt/apache-tomcat-6-0-29/lib

• ini4J
  • scaricare ini4j presso il sito http://ini4j.sourceforge.net/download.html
  • Scompattera il file ini4j-0.5.2-SNAPSHOT-all.zip scaricato
  • copiare nella directory lib di tomcat il file ini4j-0.5.2-SNAPSHOT.jar

[...]# cp ini4j-0.5.2-SNAPSHOT.jar

/opt/apache-tomcat-6-0-29/lib

Installazione AXIS2

I passi per installare Axis 2 sono:

• scaricare Axis 2 dal sito http://ws.apache.org/axis2/download/1_4_1/download.cgi e scefliere la distribuzione binaria
• scommattare la file scricato
• andare all’interno della directory scompattata nella directoru webapp e aprire un terminale in quella posizione
• creare il il file axis2.war digitando

[...]# ant create.war

• andare nella directory dist e se il file axis2.war è stato creata correttamente spostarlo all’interno della directory webapps di Tomcat

[...]# mv axis2.war /opt/apache-tomcat-6.0.29/webapps/

• riavviare Tomcat 6

Variabli d’Ambiente

Settare le variabili d’ambiente nel seguante modo:

• aprire un terminale e andare nella home , nel caso dell’accesso con utente root andare nella direcotry /root

[...]# cd /root

• aprire con un editor di testo il file .bashrc

[... ]# gedit .bashrc

• inserire in fondo del file le seguenti istruzioni per la confgurazione delle variabili d’ambiente JAVA_HOME e AXIS2_HOME

export JAVA_HOME= /usr/java/default

export AXIS2_HOME=direcotry dove è stata scompattata la

distribuzione binaria di axis2/axis2-1.4.1

Installazione Tools per lo Sviluppo

Installazione Piattaforma LAMP+phpMyAdmin

Installazione dela piattaforma LAMP ha i seguanti passi :

• installare i pacchetti :

[...]# yum install httpd php php-devel php-gd php-imap

php-ldap php-mysql php-odbc php-pear php-xml

php-xmlrpc curl curl-devel perl-libwww-perl

ImageMagik mysql mysql-server mysql-devel

• avviare i servizi httpd e mysqld attraverso i tool con interfaccia grafica, nel caso di CentOS con windows manager Gnome , sistema > amministrazione > servizi .
• Settare la password di root per mysql:

[...]# mysqladmin -u root password miapassword

• Scaricare phpMyAdmin presso il sito web http://www.phpmyadmin.net/home_page/downloads.php scegliendo la versione 2.11.11 e seguire la guida per l’installazione presso http://www.phpmyadmin.net/localized_docs/it/Documentation.html

Installazione Netbeans IDE 6.9.1

I passi peri installare Netbeans IDE 6.9.1 sono :

• scaricare Netbeans presso il sito http://netbeans.org/ scgliendo la versione completa
• installare netbeans avviando il file scaricato

[...]# sh netbeans-6.9.1-ml-linux.sh

• seguire i passi dell’installer controllando che non venga reinstallato Tomcat

• completata l’installazione occorre attivere i plugin , configurare il server Tomcat ed il plugin per lo sviluppo web services AXIS2:
  • nel menù Strumenti > Plugin nella scheda Installato attivare Java Web and EE
  • nel menù Strumenti > Plugin nella scheda Plugin Disponibili installare il plugin Axis2 Support
  • nel menù Strumenti > Server aggiungere un Server scegliere Tomcat 6 inserendo il percorso di installazione e il nome utente e password dell’utente amministratore

• • nel menù Strumenti > Opzioni nella scheda Axis 2 configurare il percorso di installazione Axis2 in Tomcat ed il nome utente e passwod dell’utente addministratore di Tomcat 6 per il deploy automatico.

Altri Tools

• Wsdl2java.sh , è un tool per la creazione dell’ stub lato cliet per la creazione del client del servizio , per utilizzarlo seguire la guida http://ws.apache.org/axis2/1_4_1/reference.html#wsdl2java , i comandi utilizzati sono -uri e -or

• SOAPMonitor , tool per monitorare il messaggi SOAP , per utlizzarlo seguire la guida http://ws.apache.org/axis2/1_4_1/soapmonitor-module.html