TOLJava: Gua de Instalacin y Primeros Pasos

TOLJava: Gua de Instalacin y Primeros Pasos

Por Humberto Andrs Carralero Lpez (hcarralero@gmail.com)

Tabla de Contenido
Introduccin.....................................................................................................................................................2 Qu es TOLJava?...........................................................................................................................................2 Instalacin de TOLJava...................................................................................................................................2 Paso 1: Instalacin de JDK.........................................................................................................................2 Paso 2: Instalacin de la i!lioteca TOLJava............................................................................................2 Paso ": Instalacin de la i!lioteca #ativa................................................................................................" Paso $: Instalacin de la %&licacin 'e! De(o........................................................................................" Paso $.1: Instalacin de )lass*is+..........................................................................................................$ Paso $.2: Instalacin de la i!lioteca #ativa........................................................................................., Paso $.": Instalacin de la %&licacin 'e! De(o................................................................................-

P./ina 1 de 0

TOLJava: Gua de Instalacin y Primeros Pasos

Introduccin
1n esta &ri(era /u2a se e3&lica la estructura de TOLJava desde el &unto de vista de los arc+ivos 4ue lo con*or(an5 as2 co(o los &rocesos re4ueridos &ara la instalacin del (is(o.

Qu es TOLJava?
TOLJava es una !i!lioteca de clases Java 4ue &er(ite 4ue se acceda a TOL desde una a&licacin escrita en Java5 6a sea sta ti&o consola5 de escritorio o &ara la 'e!. 7u distri!u6e co(o tres co(&onentes: 8na !i!lioteca nativa 4ue +ace de inter(ediaria entre la !i!lioteca de Java 6 la de TOL9 esta !i!lioetca es de enlace din.(ico. Para siste(as !asados en Linux se distri!u6e co(o un *ic+ero .so :libTOLJavaJNI.so;6 &ara siste(as !asados en Windows se distri!u6e co(o un *ic+ero .dll :TOLJavaJNI.dll;. 8na !i!lioteca Java 4ue i(&le(enta las clases re4ueridas &ara el acceso a TOL desde Java9 esta !i!lioteca se distri!u6e co(&ilada 6 e(&a4uetada en un *ic+ero . ar :TOLJava. ar; 6 trae incluido un &ro/ra(a !ase 4ue &er(ite co(&ro!ar la instalacin de TOLJava :el uso de este &ro/ra(a lo descri!i(os &osterior(ente en la descri&cin de la instalacin;. 8na a&licacin <e! de(ostrativa 4ue &er(ite: =o(&ro!ar 4ue la instalacin de TOLJava *unciona correcta(ente. Pro!ar e>e(&los de uso de TOLJava. ?evisar el cdi/o *uente de los e>e(&los en lo corcerniente al uso de TOLJava. Leer la docu(entacin ele!orado so!re TOLJava.

Instalacin de TOLJava
La instalacin de TOLJava co(&rende tres &asos su&oniendo 4ue se van a instalar todos los co(&onentes. 1n esta /u2a considera(os &ara la instalacin los siste(as o&erativos Windows 6 Linux 6 co(o contenedor de J7Ps@7ervlets5 Glass!is"5 el /ratuito 4ue +a desarrollado de *or(a &aralela al Java la (is(a co(unidad. Para otros servidores de a&licaciones5 consulte el (anual 6 a&li4ue &asos si(ilares a los 4ue a4u2 descri!i(os.

Paso 1: Instalacin de JDK

Para la e>ecucin de a&licaciones Java se re4uiere un entorno de e>ecucin conocido &or sus si/las J#$5 &ero esto no !asta &ara los contenedores de J%Ps&%ervlets 6a 4ue los (is(os re4uieren de las +erra(ientas de desarrollo Java conocidas co(o J'(9 &or esta raAn si se 4uiere instalar la a&licacin <e! de(ostrativa5 entonces se re4uerir. J'(5 en otro caso slo re4uerir. el J#$. 7i no tiene instalado el J'( o el J#$ :se/Bn su re4ueri(iento;5 entonces de!e descar/ar el instalador a&ro&iado de +tt&:@@>ava.sun.co( 6 se/uir los &asos de instalacin 4ue all2 se descri!en &ara su &lata*or(a.

Paso 2: Instalacin de la Biblioteca TOLJava

La )ilbioteca TOLJava co(o 6a descri!i(os es slo un arc+ivo5 TOLJava.jar9 &ara su instalacin slo se re4uiere co&iarlo en al/Bn directorio9 &or e>e(&lo5 en 'indo<s &odr2a ser *+,TOLJava,lib 6 en Linu3 P./ina 2 de 0

TOLJava: Gua de Instalacin y Primeros Pasos &usr&local&tol ava&lib :sto es slo una reco(endacin 6a 4ue &uede estar en cual4uier directorio;.

Paso 3: Instalacin de la Biblioteca Nativa

La !i!lioteca nativa &uede co&iarla a cual4uier directorio de la co(&utadora 65 lue/o5 +acerla accesi!le al entorno de e>ecucin de Java donde se e>ecute la a&licacin 4ue +ace uso de TOLJava. Para a&licaciones de consola o escritorio !astar2a &asarle a la (.4uina virtual de Java el directorio donde se +a co&iado la !i!lioteca nativa9 &or e>e(&lo5 si en Windows se co&iara el *ic+ero TOLJavaJNI.dll al directorio *+,TOLJava,lib 6 en Linu3 se co&iara el *ic+ero libTOLJavaJNI.so &ara el directorio &usr&local&tol ava&lib5 entonces los co(andos &ara e>ecutar el &ro/ra(a de &rue!as incor&orado en TOLJava. ar ser2a: 'indo<s: ava - ar -Djava.library.path=C:\TOLJava\lib *+,TOLJava,bin,TOLJava. ar Linu3: ava - ar -Djava.library.path=/usr/local/toljava/lib &usr&local&tol ava&bin&TOLJava. ar
Aqu s asu! qu s ha" usa#o los #ir ctorios su$ ri#os% si s "o &u ra l caso% "to"c s " las l" as # co!a"#os a"t rior s s # b " r !pla'ar los #iractorios usa#os (C:\TOLJava\lib y /usr/local/toljava/lib) por los qu r al! "t s usaro" " la i"stalaci*".

7i TOLJava est. correcta(ente instalado5 entonces este &ro/ra(a (ostrar. un (ensa>e indic.ndolo5 es al/o si(ilar a lo 4ue se (uestra a continuacin:

=uando no *unciona !ien5 el error (.s co(Bn es 4ue no se +a encontrado la !i!lioteca nativa 6a sea &or4ue en la l2nea de co(andos no se indic correcta(ente el directorio donde se encuentra o &or al/una raAn si(ilar a esta5 todas causadas &or4ue la (.4uina virtual de Java no encontr dic+a !i!lioteca. La si/uiente &antalla (uestra este t2&ico error:

Paso 4: Instalacin de la Aplicacin

eb De!o

1ste &aso es o&cional5 &ero si se &iensa utiliAar a TOLJava en u a&licaciones &ara la 'e!5 entonces es reco(enda!le :6 casi i(&rescindi!le; 4ue se instale la a&licacin <e! de(ostrativa 4ue viene con la distri!ucin de TOLJava9 sto /arantiAar2a 4ue TOLJava est. con*i/urado correcta(ente dentro del contenedor de J7Ps@7ervlets 4ue se usar. &ara des&le/ar las a&licaciones 4ue se desarrollen. 1ste &aso de la instalacin lo dividire(os en dos &artes5 la &ri(era es la instalacin del contenedor de J7Ps@7ervlets 6 la se/unda se re*iere a la instalacin de la a&licacin <e! de(o dentro del contenedor 6a instalado. Para este &aso usare(os co(o contenedor al Glass!is" ../ 4ue5 >unto con el Tomcat0 es to(ado co(o contenedor de re*erencia9 al (o(ento de escri!ir esta docu(entacin 6a esta!a dis&oni!le la versin ".C del Glass!is"5 &ero el autor considera 4ue no +a sido &ro!ado tan e3tensa(ente co(o las versiones anteriores5 &or lo 4ue no lo reco(ienda (o(ent.nea(ente +asta 4ue no se +a6an realiAado todas las &rue!as de *unciona(iento re4ueridas. P./ina " de 0

TOLJava: Gua de Instalacin y Primeros Pasos Los &asos dados a4u2 &udieran servir co(o !ase &ara instalar la a&licacin de(o en otro contenedor5 slo se de!en tener en cuenta los re4ueri(ientos 6 a>ustar los &rocesos al otro contenedor.

Paso 4.1: Instalacin de Glassfish

7i 6a se tiene Glass!is" instalado5 entonces &uede o!viar este &aso. Para instalar Glass!is"5 slo de!e descar/ar el *ic+ero 4ue contiene el instalador desde +tt&s:@@/lass*is+.dev.>ava.net@do<nloads@v2.1.1D*inal.+t(l esco>iendo la distri!ucin !inaria corres&ondiente a su siste(a o&erativo5 ten/a en cuenta 4ue &ara cada siste(a o&erativo +a6 una versin con so&orte slo &ara in/ls 6 otra (ultilen/ua>e Ees la 4ue include dentro de su no(!re FD(lF. Para Linu3 est.n dis&oni!les los *ic+eros /lass*is+DinstallerDv2.1.1Dlinu3.>ar 6 /lass*is+DinstallerDv2.1.1Dlinu3D(l.>ar9 &ara 'indo<s est.n los *ic+eros /lass*is+DinstallerDv2.1.1D<indo<s.>ar 6 /lass*is+DinstallerDv2.1.1D <indo<sD(l.>ar. Para el resto de la e3&licacin asu(ire(os 4ue +a descar/ado las versiones F(lF5 tanto &ara 'indo<s co(o &ara Linu3. 8na veA 4ue +a descar/ado el *ic+ero del instalador5 ase/urarse de 4ue est instalado el JDK 6 la varia!le del entorno J%G%HIOJ1 a&unte a la u!icacin donde se +a6a realiAado la instalacin. 8na veA 4ue esta varia!le a&unte a la instalacin del JDK el instalador de Glass!is" &odr. encontrarlo &ara su *unciona(iento durante la instalacin 6 &osterior(ente durante la e>ecucin del &ro&io Glass!is". Para la instalacin si/a los si/uientes &asos: Linu3+ 1. =.(!iese al directorio donde instalar. el )lass*is+5 usare(os @o&t &ara la e3&licacin+
cd /opt

2. =o&ie el instalador +acia ese directorio :&odr2a no +acerlo5 &ero en el &aso "5 entonces de!e incluir el ca(ino donde se encuentra el instalador delante del no(!re del arc+ivo. ". 1>ecute el instalador:
java -Xmx256m -jar glassfish-installer-v2.1.1-linux-ml.jar

$. =.(!iese al directorio 1lass!is" creado &or el instalador al e>ecutarse el &aso anterior:

cd glassfish

K. Dele &er(isos de e>ecucin a los &ro/ra(as de ant incluidos en el directorio de instalacin creado:
chmod -R +x li /ant/ in

,. 1>ecute el ant &as.ndole co(o &ar.(etro el arc+ivo de con*i/uracin setu2.xml:

li /ant/ in/ant -f setup.xml NOTAS:

Puede ca(!iar &ar.(etros de la instalacin tales co(o los &uertos de acceso 6 la contraseLa de acceso &ara la ad(inistracin editando el arc+ivo setu2.xml. Puede realiAar una instalacin ti&o cluster usando co(o &ar.(etro el arc+ivo de con*i/uracin setu2-cluster.xml. La con*i/uracin co(o cluster no es te(a de estudio &ara esta /uia.

Des&us de este &aso 6a 4ueda instalado en el directorio &o2t&1lass!is" el Glass!is" 3.././. Los &asos si/uientes son &ara la &rue!a de *unciona(iento. P./ina $ de 0

TOLJava: Gua de Instalacin y Primeros Pasos -. %s/urese 4ue est.n +a!ilitados los &uertos con*i/urados en setu2.xml &ara el acceso a las a&licaciones v2a <e!5 as2 co(o a la consola de ad(inistracin9 si usted no ca(!i la con*i/uracin 4ue viene &or de*ecto5 entonces stos son: 0C0C :+tt&;5 0101 :+tt&s; 6 $0$0 :+tt& &ara consola de ad(inistracin;. 0. %rran4ue el servidor:
/opt/glassfish/ in/asadmin start-domain domain1

7i el servidor arranc correcta(ente5 entonces (ostrar. varios (ensa>es entre los cuales estar.:
Domain [domain1] is running ...

1n caso de &roducirse al/Bn error en el arran4ue de!er. consultar la docu(entacin tcnica de Glass!is" &ara deter(inar la causa del error 6 &oder solucionarlo. 1sos te(as est.n *uera del alcance de esta /u2a. M. Para co(&ro!ar 4ue Glass!is" est. *uncionando correcta(ente conctese con su nave/ador *avorito a la (.4uina donde lo instal5 &or e>e(&lo5 en el caso de )ayes 4orecast +e(os +a!ilitado la 8?L +tt&:@@<<<.!a6es*orecast.co(:MCCC@ con la instalacin. 7i el Glass!is" se +a instalado correcta(ente5 entonces se (ostrar. una &antalla si(ilar a la si/uiente:

Ta(!in de!e co(&ro!ar 4ue la consola de ad(inistracin est. *uncionando5 &ara ello de!e conectarse a la (is(a direccin anterior5 &ero usando el &uerto $0$0 :si no se ca(!i el &uerto &or de*ecto durante la instalacin;9 &ara nuestro caso la 8?L ser2a: +tt&:@@<<<.!a6es*orecast.co(:$0$0. 1n este caso se de!e visualiAar la &antalla de in/reso 4ue de!e ser si(ilar a esta:

P./ina K de 0

TOLJava: Gua de Instalacin y Primeros Pasos Iasta este &unto se +a instalado 6 est. *uncionando correcta(ente el servidor de a&licaciones Glass!is". 'indo<s: 1n el caso de este siste(a o&erativo los &asos son si(ilares5 teniendo en cuenta los ele(entos si/uientes: 1n todos los &asos ca(!ie los directorios &ara los 4ue usted considere 6 ten/a en cuenta 4ue en Windows se utiliAa el 5,6 en lu/ar del 5&6 4ue se usa en Linux. Los &asos 1 6 2 son innecesarios. 1n el &aso "5 ca(!ie el no(!re del *ic+ero del instalador &or el a&ro&iado &ara Windows.

Paso 4.2: Instalacin de la iblioteca !ati"a

8na veA 4ue se +a instalado 6 con*i/urado el Glass!is"5 entonces se de!e co&iar la !i!lioteca nativa a un directorio donde l &ueda encontrarla &ara su car/a5 este directorio &uede ser el lib u!icado dentro de su directorio de instalacin9 si tene(os en cuenta 4ue en nuestro e>e(&lo el /lass*is+ +a sido instalado en &o2t&1lass!is"5 entonces el directorio a&ro&iado &ara co&iar el *ic+ero de la !i!lioteca nativa ser. &o2t&1lass!is"/lib. Para cada siste(a o&erativo +a6 una !i!lioteca5 una co(&ilada &ara siste(as de "2 !its9 los no(!res de los arc+ivos son: Linu3: libTOLJavaJNI.so TOLJavaJNI.dll 'indo<s: Ta(!in &uede usar la consola de ad(inistracin &ara aLadir al Glass!is" el directorio donde se encuentra instalada la !i!lioteca nativa a su ca(ino de !Bs4ueda9 &ara ello use las o&ciones 5Aplicactio" + rv r ==, J-. + tti"$s ==, /ath + tti"$s ==,0ativ Library /ath +u&&i1 6 en el (enB tal 6 co(o se (uestra en el /r.*ico si/uiente:

P./ina , de 0

TOLJava: Gua de Instalacin y Primeros Pasos

Paso 4.#: Instalacin de la $%licacin &eb 'e(o

La 72licacin Web 'emo es distri!uida co(o un solo *ic+ero TOLJavaWeb'emo.war 6 &ara su instalacin reco(enda(os utiliAar la consola de ad(inistracin de Glass!is"5 &ara lo cual se &ueden se/uir los si/uientes &asos: 1. In/rese a la consola de ad(inistracin de Glass!is". 2. 1sco>a las o&ciones de (enB NApplicatio"s ==, 2 b Applicatio"s ==, D ploy ... O5 a+ora &odr. su!ir al servidor el arc+ivo .war del de(o.

". 1n la &antalla (ostrada esco>a co(o Typ ==, 2 b Applicatio" (.3ar)5 co(o Locatio" ==, /ac4a$ # &il to b uploa# # to th s rv r 5 clicP en 5ro3s 5 esco>a el arc+ivo .war en la u!icacin 4ue lo tiene /uardado5 co(o Co"t 1t 6oot ==, toljava# !o 65 &or Blti(o5 +a/a clicP en O4. % continuacin el Glass!is" &rocede a la car/a de la a&licacin 6 de(orar. Nun ratoO en ter(inar5 de&endiendo del ta(aLo del arc+ivo 6 la velocidad de la cone3in 4ue se est usando. $. 8na veA 4ue la a&licacin se +a car/ado5 sta a&arecer. en el listado de a&licaciones car/adas co(o se (uestra en la &antalla si/uiente:

P./ina - de 0

TOLJava: Gua de Instalacin y Primeros Pasos

Para &ro!ar 4ue la a&licacin se +a car/ado con 3ito +a/a clicP en el enlace Lau"ch 4ue a&arece en la *ila corres&ondiente a la a&licacin su!ida9 de +a!erse car/ado e3itosa(ente a&arecer. la a&licacin de(o car/ada en una ventana del nave/ador.

P./ina 0 de 0