Plants by WebSphere |
|
Pierwsze kroki |
Poznawanie struktury katalogów |
Odbudowywanie i instalowanie przykładu |
Jedną z większych korzyści płynących z projektowania aplikacji na platformie
J2EE jest przenośność. Wszystkie przykładowe programy z galerii
przykładów są tworzone na stacji roboczej i uruchamiane w systemach z/OS i
iSeries bez konieczności modyfikowania ani jednego wiersza kodu Java. Poprzez budowanie aplikacji J2EE w
systemach Intel lub UNIX programista może wyeliminować problemy z konwersją
pliku ze standardu EBCDIC do standardu ASCII lub ze standardu ASCII do standardu EBCDIC.
Dostępność narzędzi ułatwia programistom pisanie i testowanie kodu
na programistycznej stacji roboczej oraz instalowanie plików Enterprise Archive (EAR)
w systemach z/OS i iSeries.
Każdemu nabywcy serwera aplikacji WebSphere Application Server dla platformy z/OS i iSeries
przysługuje prawo do korzystania z oprogramowania Application
Server Media for Multiplatforms. Jeśli produkt podstawowy (serwer WebSphere Application Server)
oraz przykłady instalowane są na jednej z platform obsługiwanych
przez ten pakiet, w każdej z nich widoczna będzie ta sama galeria. Jedynym
wyjątkiem jest sytuacja, gdy kliknięto opcję nazwa_przykładu > Budowanie za pomocą narzędzia Ant > platforma > Odbudowywanie i instalowanie pliku sample.ear - wtedy podawane
są instrukcje dotyczące odbudowywania pliku EAR na tej platformie. Ponieważ pliki tekstowe w
pliku EAR (XML, xmi, JSP itd.) muszą być
w formacie ASCII, łatwiej jest edytować te pliki na komputerze
ASCII. Dokonując zmian na komputerze ASCII, można następnie wdrażać i instalować
wynikowy plik EAR na platformie z/OS lub iSeries bez potrzeby konwersji ze standardu EBCDIC do standardu
ASCII.
Należy zainstalować serwer WebSphere Application Server na wybranej rozproszonej platformie i wskazać, że zainstalowane mają zostać również przykładowe aplikacje serwera aplikacji.
Należy utworzyć kopię zapasową katalogu <katalog_główny_profilu>/samples przed próbą zmodyfikowania lub ponownego zbudowania przykładów. W tym celu należy utworzyć plik ZIP katalogu samples. Możliwe będzie wtedy odtworzenie katalogu samples do jego stanu pierwotnego poprzez wyodrębnienie plików z pliku ZIP.
Przykłady są zainstalowane w następujących katalogach:
<katalog_główny_profilu>/samples/src/PlantsByWebSphere | Zawiera kod źródłowy dla przykładu Plants by WebSphere. |
<katalog_główny_profilu>/samples/lib/PlantsByWebSphere | Zawiera pliki Web Archive (WAR), pliki Java Archive (JAR) oraz wynikowy plik PlantsByWebSphere.ear przykładu Plants by WebSphere. Ten katalog jest tworzony po odbudowaniu przykładu Plants by WebSphere. |
<katalog_główny_profilu>/samples/javadoc/PlantsByWebSphere | Zawiera dokumentację Javadoc. Ten katalog jest tworzony po odbudowaniu przykładu Plants by WebSphere. |
<katalog_główny_profilu>/samples/bld/PlantsByWebSphere | Zawiera wygenerowane pliki klas. Tych plików klas należy użyć do wygenerowania pliku wynikowego PlantsByWebSphere.ear. Ten katalog jest tworzony po odbudowaniu przykładu Plants by WebSphere. |
Przykład Plants by WebSphere jest instalowany automatycznie wraz z serwerem WebSphere Application Server. Przykładu Plants by WebSphere nie trzeba budować przed użyciem. Następujące instrukcje zawierają kroki odbudowywania przykładu oraz zawierają informacje dodatkowe pomocne przy ich modyfikowaniu.
Wykonywanie skryptu budowania przykładów |
W celu odbudowania przykładu sprawdź, czy katalog katalog_główny_profilu/bin znajduje się w zmiennej środowiskowej PATH. Aby uruchomić skrypt budowania przykładu, który odbuduje przykład, wykonaj następujące kroki:
Przykład zostanie zbudowany.
Skrypty buildplantsby.bat oraz buildplantsby.sh znajdujące się w katalogu katalog_główny_profilu/samples/bin/PlantsByWebSphere ustawiają odpowiednie informacje ścieżki klasy i uruchamiają program narzędziowy budowania Ant. Narzędzie Ant odczytuje pliki build.xml, które opisują sposób budowania przykładu. Dodatkową dokumentację programu Ant można znaleźć w serwisie WWW projektu Jakarta.
W procesie budowania odbudowywane są tylko pliki klas ze zmianami. Pozostałe pliki klas są pakowane ponownie do nowego pliku EAR.
Plik binarny EAR należy przekazać do serwera z/OS lub iSeries przy użyciu protokołu FTP, wykonując poniższe instrukcje.
Domyślnie przykład Plants by WebSphere jest instalowany w katalogu katalog_główny_profilu/installedApps/<nazwa_komórki>,
gdzie <nazwa_komórki> jest nazwą komórki, w której zainstalowano aplikację. Reinstalowanie przykładu polega na wykonaniu następujących kroków:
wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')"
wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')"
wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')"
wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')"
wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear', ['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>', '-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"gdzie <węzeł> to nazwa węzła, a <serwer> to nazwa serwera, na którym ma zostać zainstalowany przykład.
wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear', ['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>', '-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"gdzie <węzeł> to nazwa węzła, a <serwer> to nazwa serwera, na którym ma zostać zainstalowany przykład.
wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear', ['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>', '-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear', ['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>', '-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"gdzie <węzeł> to nazwa węzła, a <serwer> to nazwa serwera, na którym ma zostać zainstalowany przykład.
Odbudowany plik PlantsByWebsphere.ear zostanie wdrożony na serwerze aplikacji.