A Plants By WebSphere példa összeépítése az Ant összeépítési eszköz használatával



J2EE hordozhatóság
A példatárban szereplő példák újraépítése
Kezdeti lépések
A könyvtárszerkezet felismerése
A példa újraépítése és telepítése

J2EE hordozhatóság

A J2EE platformon végzett alkalmazásfejlesztés egyik legnagyobb előnye a hordozhatóság.  A példatárban található összes program munkaállomásokon készült, mégis egyetlen Java programsor módosítása nélkül futtatható z/OS és iSeries rendszereken. J2EE alkalmazások Intel vagy UNIX rendszereken történő fejlesztésével a programozók kiküszöbölhetik az EBCDIC-ASCII fájlátalakítások nehézségeit.  Az eszközök elérhetősége a fejlesztők számára lehetővé teszi, hogy fejlesztő munkaállomáson írják és teszteljék, majd z/OS és iSeries platformokra telepítsék a vállalati archívum (EAR) fájlt.

A példatárban lévő példák újraépítése

Minden WebSphere Application Server (alkalmazáskiszolgáló) for z/OS, illetve iSeries vásárlónak joga van az alkalmazáskiszolgáló használatához több platformon. Ha a WebSphere alkalmazáskiszolgáló alapterméket és a példákat a csomag által támogatott platformok bármelyikén telepíti, akkor ugyanazt a példatárat fogja látni. Ez alól az egyetlen kivétel, amikor a példa_neve > Összeépítés Ant segítségével > platform > A sample.ear fájl újraépítése és telepítése lehetőségre kattint; ilyenkor az adott platformra vonatkozó útmutatásokat kapja az EAR fájl összeépítéséhez.  Mivel az EAR fájlban található szövegfájloknak (XML, xmi, JavaServer Pages (JSP) oldalak, stb.) ASCII formátumban kell lennie, ezért egyszerűbb ezeket a fájlokat ASCII gépen szerkeszteni.  Ha módosításokat eszközöl egy ASCII gépen, akkor az eredményként létrejövő EAR fájlt EBCDIC-ASCII átalakítás nélkül bevezetheti és telepítheti z/OS vagy iSeries platformon. 

Kezdeti lépések

Telepítse a WebSphere Application Server kiszolgálót tetszőleges osztott platformon, és jelezze az Alkalmazáskiszolgáló példaalkalmazások telepítését is.

Készítsen egy biztonsági másolatot a <profil_gyökér>/samples  könyvtárról a példák módosításának vagy újraépítésének megkezdése előtt. Hozzon létre egy zip fájlt a samples könyvtárról. A zip fájl kicsomagolásával vissza tudja állítani a samples könyvtárat eredeti állapotába.

A könyvtárszerkezet felismerése

A példák az alábbi könyvtárakba vannak telepítve:


<profil_gyökér>/samples/src/PlantsByWebSphere A Plants by WebSphere példa forráskódját tartalmazza.
<profil_gyökér>/samples/lib/PlantsByWebSphere A Plants By WebSphere példa web archívum (WAR) fájlait, a Java archívum (JAR) fájlait és a végső PlantsByWebSphere.ear fájlt tartalmazza. Ez a könyvtár a Plants by WebSphere példa újraépítése után jön létre.
<profil_gyökér>/samples/javadoc/PlantsByWebSphere Tartalmazza a Javadoc dokumentációt. Ez a könyvtár a Plants by WebSphere példa újraépítése után jön létre.
<profil_gyökér>/samples/bld/PlantsByWebSphere Az előállított osztályfájlokat tartalmazza. Ezen osztályfájlokkal előállítható a végső PlantsByWebSphere.ear fájl. Ez a könyvtár a Plants by WebSphere példa újraépítése után jön létre.

A példa újraépítése és telepítése

A Plants by WebSphere példa automatikusan telepítésre kerül a WebSphere alkalmazáskiszolgálóval. A Plants by WebSphere példát nem kell összeépíteni használatának megkezdése előtt. A következő útbaigazítások a példaújraépítés lépéseit, továbbá kiegészítő információkat tartalmaznak azok módosításáról.


A példa összeépítési parancsfájl futtatása
Az újraépített PlantsByWebSphere.ear fájl átvitele
A PlantsByWebSphere.ear fájl eltávolítása és újratelepítése

A példa összeépítési parancsfájl futtatása

A példa újraépítéséhez ellenőrizze, hogy a profil_gyökér/bin szerepel-e a PATH környezeti változóban. Tegye a következőket a példa-összeépítési parancsfájl futtatásához, amely így összeépíti a példát:

  1. Parancssor megnyitása.
  2. A parancssorban váltson át a <profil_gyökér>/samples/src/PlantsByWebSphere könyvtárra.
  3. Futtassa le a példaösszeépítési parancsfájlt:

  4. Írja be a következő parancsot:


    <profil_gyökér>\samples\bin\PlantsByWebSphere\buildplantsby.bat


    • Windows fejlesztési platformokon írja be a következő parancsot:

      <profil_gyökér>\samples\bin\PlantsByWebSphere\buildplantsby.bat


    • UNIX és LINUX fejlesztési platformokon írja be a következő parancsot:

      . <profil_gyökér>/samples/bin/PlantsByWebSphere/buildplantsby.sh

Ekkor a példa összeépítésre kerül.

A buildplantsby.bat és a buildplantsby.sh parancsfájl a profil_gyökér/samples/bin/PlantsByWebSphere könyvtárban beállítja a megfelelő osztályútvonal információkat és végrehajtja az Ant összeépítési segédprogramot. Az Ant beolvassa a build.xml fájlokat, amelyek leírják hogyan kell a példát összeépíteni. Az Ant további leírása a Jakarta webhelyen található.

Fontos információk   Az összeépítési folyamat alatt csak a változtatásokat tartalmazó osztályfájlok épülnek újra. A hátralévő osztályfájlok újra lesznek csomagolva az új EAR fájlba.

Az újraépített PlantsByWebSphere.ear fájl átvitele

Használja a Fájlátviteli protokollt (FTP) a bináris EAR fájl átvitelére a z/OS vagy iSeries kiszolgálóra az alábbi útmutatások alapján.

  1. Az újraépített EAR fájlt a <profil_gyökér>/samples/lib/PlantsByWebSphere könyvtárban találhatja.
  2. Nyisson meg egy FTP szekciót a WebSphere Application Server for z/OS vagy iSeries számára a fejlesztési platformról.
  3. Váltson át a <profil_gyökér>/samples/lib/PlantsByWebSphere könyvtárra
    Ha a könyvtár nem létezik, akkor hozza létre.
  4. Ha a PlantsByWebSphere.ear fájl létezik, akkor törölje le, hogy a frissített fájl írható legyen.
    del PlantsByWebSphere.ear
  5. bin
  6. put PlantsByWebSphere.ear
  7. quit

A PlantsByWebSphere.ear fájl eltávolítása és újratelepítése

Alapértelmezésben a Plants by WebSphere példa a profil_gyökér/installedApps/<cella neve> könyvtárba települ, ahol a <cella neve> annak a cellának a neve, ahova az alkalmazás telepítve van. A példa újratelepítésének lépeseit az alábbi leírás tartalmazza:

  1. Állítsa le az alkalmazáskiszolgálót.
  2. Távolítsa el a Plants by WebSphere példa EAR fájlját:
    1. Írja be a következő parancsokat:

      cd <profil_gyökér>\bin
      setupCmdLine

      cd <profil_gyökér>/bin
      . ./setupCmdLine.sh

      z/OS platformokon:
      cd <profil_gyökér>/bin
      . ./setupCmdLine.sh

      iSeries platformokon:
      cd <profil_gyökér>/bin
      . ./setupCmdLine

      ,ahol a <profil_gyökér> a profil telepítési könyvtárát képviseli.
    2. Az alkalmazás eltávolításához írja be a következő parancsot (a profil_gyökér/bin elérési útnak szerepelne kell a PATH változóban):

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      z/OS platformokon:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      iSeries platformokon:
      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 
  3. A Plants By WebSphere példa újratelepítése:
    • Váltson át a profil_gyökér/samples/lib/PlantsByWebSphere könyvtárra.
    • Keresse meg a PlantsByWebSphere.ear fájlt.
    • Írja be a következő parancsot:

      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<csomópont>', '-server', '<kiszolgáló>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      ahol a <csomópont> a csomópont neve, a <kiszolgáló> pedig annak a kiszolgálónak a neve, ahova a példát telepíteni kell.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<csomópont>', '-server', '<kiszolgáló>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      ahol a <csomópont> a csomópont neve, a <kiszolgáló> pedig annak a kiszolgálónak a neve, ahova a példát telepíteni kell.

      z/OS platformokon:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<csomópont>', '-server', '<kiszolgáló>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    

      iSeries platformokon:
      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<csomópont>', '-server', '<kiszolgáló>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      ahol a <csomópont> a csomópont neve, a <kiszolgáló> pedig annak a kiszolgálónak a neve, ahova a példát telepíteni kell.
  4. Indítsa el az alkalmazáskiszolgálót.

 

Az újraépített PlantsByWebsphere.ear fájl telepítésre kerül az alkalmazáskiszolgálón.