Rational Developer for System z, Version 7.6

Deployment-Services

SCLM Developer Toolkit stellt mehrere Deployment-Features bereit. Sie können Enterprise-Archivdateien (EAR) in einem beliebigen WebSphere Application Server (WAS) implementieren. Zusätzlich kann jede vom SCLM Developer Toolkit erstellte oder gesteuerte Komponente mit einem anpassbaren Deployment-Script geändert verändert werden. Es stehen Beispiel-Scripts für das Kopieren einer EAR-Datei auf einen fernen Host mit den Befehlen SCP (secure copy) und SFTP (secure FTP) zur Verfügung.

Wenn Sie ein Deployment-Script starten möchten, klicken Sie mit der rechten Maustaste auf das Projekt, und wählen Sie Team > Deployment für Enterprise-Anwendung aus. Die folgenden Abschnitte enthalten Informationen zur Erstellung und Ausführung von Deployment-Scripts sowie zur Anpassung des Deployments und Beispiele für Deployment-Scripts.

Vorhandenes Deployment-Script ausführen

Falls Sie bereits ein Deployment-Script haben, das Sie ohne Änderungen ausführen möchten, wählen Sie das Optionsfeld Vorhandenes Deployment-Script ausführen aus.

Sie müssen den Membernamen, die Gruppe und den Typ des Scripts angeben. Sie können aber auch auf die Schaltfläche Durchsuchen klicken und den Standardanzeigen des Developer Toolkit für die Member-Suche durchgehen, um die Werte automatisch eintragen zu lassen.

Wenn Sie das Script ausgewählt und Namen, Gruppe und Typ des Scripts eingegeben haben, klicken Sie zum Fortfahren auf OK. Das Developer Toolkit nimmt jetzt Kontakt zum Host auf und ruft das ausgewählte Deployment-Script auf.

Deployment-Script erstellen

Wenn Sie ein neues Script erstellen oder neue Parameter an ein altes Script übergeben möchten, wählen Sie das Optionsfeld Deployment-Script erstellen aus. Unter dem Optionsfeld wird daraufhin ein Editierfeld aktiviert. Hier können Sie die XML für Ihr Deployment-Script eingeben.

SCLM durchsuchen
Falls Sie ein bereits in SCLM vorhandenes Script modifizieren möchten, klicken Sie auf diese Schaltfläche.
Lokal durchsuchen
Klicken Sie auf diese Schaltfläche, wenn Sie ein auf Ihrer Workstation gespeichertes Script modifizieren oder verwenden möchten. Falls Sie kein vorbereitetes Script haben, geben Sie das Script im Editierfeld ein.
Deploy-Skeleton
Diese Option stellt die Basis für ein WAS-Deployment-Script bereit. Sie müssen das Skeleton modifizieren. Geben Sie die Details des Ziel-WAS-Servers und der EAR-Datei ein.
Fernes Deploy-Skeleton
Diese Option stellt ein WAS-Deployment-Script für das Deployment einer EAR auf einem fernen WAS-Server bereit.
Sicheres Deploy-Skeleton
Diese Option stellt die Basis für ein SCP- oder SFTP-Deployment-Script bereit. Für die Umschaltung von SCP auf SFTP müssen Sie den Wert der Eigenschaft SCLM_ANTXML von BWBSCOPY in BWBSFTP ändern.
SCLM-Member einschließen
Wenn Sie ein Member von SCLM in das z/OS UNIX® System Services-Dateisystem kopieren möchten, klicken Sie auf diese Schaltfläche, um die bekannte Anzeige für Member-Filter und Member-Auswahl aufzurufen. Wählen Sie in dieser Anzeige das gewünschte Member aus.

Das folgende Beispiel-Script demonstriert die Aufnahme von SCLM-Membern:

<ANTXML>
<property longname="cipherWAR.ear" shortname="CI000003" group="RELEASE" 
type="J2EEEAR" dest="/u/username/"/>
</ANTXML>

Die Parameter haben folgende Bedeutung:

longname
Der lange Name des zu kopierenden SCLM-Members
shortname
Der kurze Name des zu kopierenden SCLM-Members
group
Die erste Gruppe, die nach dem zu kopierenden Member durchsucht wird. Danach setzt SCLM die Suche in der Hierarchie ausgehend von der angegebenen Gruppe fort.
type
Der Typ des zu kopierenden SCLM-Members
dest
Die Verzeichnisposition im z/OS UNIX System Services-Dateisystem, an die die Datei kopiert werden soll. Alternativ dazu können Sie mit diesem Feature auswählen, welches erstellte Objekt (z. B. J2EEEAR) über SCP oder SFTP implementiert werden soll. Geben Sie in diesem Fall denselben Wert für die Position des eingeschlossenen Members im z/OS UNIX System Services-Dateisystem und die Eingabeposition der EAR-Datei an. Vergleichen Sie dazu das folgende Beispiel:
<ANTXML>
<! -- weitere Script-Eigenschaften -->
<! -- Eingabe-EAR-Datei -->
<property name="LOCAL_FILE_PATH" value="/u/username/cipherWAR.ear"/>
<!-- Include-Member -->
<property longname="cipherWAR.ear" shortname="CI000003" group="RELEASE" 
type="J2EEEAR" dest="/u/username/"/>
</ANTXML>

Wenn Sie mit dem Inhalt Ihres Scripts zufrieden sind, ordnen Sie dem Script einen Namen und eine Sprache zu, und klicken Sie auf OK. Damit wird der Deployment-Prozess gestartet. Sie können dieses Build-Script später aufrufen, indem Sie Vorhandenes Deployment-Script ausführen auswählen.

Deployment-Anpassung

Für das Deployment werden im Kern zwei Scripts benötigt. Das erste Script ist ein Eigenschaftsscript. Dieses Script wird von Ihnen modifiziert. Es enthält einfach eine Liste von Parametern für Ihre Deployment-Operation. Das zweite Script ist das Aktions-Script mit den erforderlichen Schritten der Deployment-Operation.

Wenn Sie ein Deployment einleiten, geben Sie den Inhalt des Eigenschaftsscripts an. Eines der enthaltenen Eigenschaften ist die Eigenschaft SCLM_ANTXML mit dem Membernamen des entsprechenden Aktions-Scripts. Das Developer Toolkit verwendet Ihr Eigenschaftsscript als Schablone für das Aktions-Script und ruft dann das resultierende Aktions-Script mit ANT auf.

Das WAS-Deployment ist ein Sonderfall, bei dem die Eigenschaft SCLM_ANTXML auf ein JACL-Aktions-Script zeigt.

Nachfolgend sind die mit dem Developer Toolkit bereitgestellten Beispiel-Scripts aufgelistet.

BWBDEPLA
WAS-EAR-Deployment
BWBSCOPY
Secure-Copy-Deployment (Ein Buildobjekt wird mit SCP von einem Host auf einen anderen kopiert.)
BWBSFTP
Secure-FTP-Deployment (Ein Buildobjekt wird mit SFTP von einem Host auf einen anderen kopiert.)
BWBRDEPL
Fernes WAS-EAR-Deployment

Beispiel-Deployment-Scripts

Die folgenden Abschnitte enthalten Beispiel-Scripts, die für das Deployment in einem lokalen WAS unter z/OS ein JACL-Script verwenden:

Nutzungsbedingungen | Feedback

Dieses Information Center basiert auf Eclipse-Technologie. (http://www.eclipse.org)