Sie können Anwendungseigenschaftendateien verwenden, um
Unternehmensanwendungsdateien auf einem Server
oder Cluster zu installieren und implementierte
Anwendungen oder Module zu aktualisieren oder zu deinstallieren.
Eine Unternehmensanwendungsdatei
muss mit den Spezifikationen von Java™ Platform, Enterprise Edition
(Java EE) übereinstimmen.
Vorbereitende Schritte
Bevor Sie Unternehmensanwendungsdateien
auf einem Anwendungsserver installieren können, müssen Sie die Module entsprechend Ihren Anforderungen assemblieren.
Außerdem muss der Zielanwendungsserver konfiguriert werden.
Stellen Sie im Rahmen der Serverkonfiguration fest, ob Ihre Anwendungsdateien
in Ihren Implementierungszielen installiert werden können.
Starten Sie das Scripting-Tool "wsadmin".
Zum Starten von
"wsadmin" in der Sprache Jython führen Sie im Verzeichnis bin
des Profils des Implementierungsziels den Befehl wsadmin -lang Jython
aus.
Informationen zu diesem Vorgang
Mit einer Anwendungseigenschaftendatei können Sie eine Unternehmensanwendung oder ein Modul installieren, aktualisieren oder deinstallieren.
Führen Sie unter Verwendung von "wsadmin"
Verwaltungsbefehle aus, um eine Anwendung zu implementieren.
Tabelle 1. Aktionen für Anwendungseigenschaftendateien. Sie können Eigenschaften festlegen, durch die Anwendungen installiert, aktualisiert oder deinstalliert werden.Aktion |
Prozedur |
create (installieren) |
- Legen Sie Eigenschaften fest, die die Anwendung und das Implementierungsziel angeben.
- Führen Sie den Befehl applyConfigProperties aus, um die Anwendung zu installieren.
|
modify (aktualisieren) |
- Bearbeiten Sie Anwendungseigenschaften in der Eigenschaftendatei.
Zum Aktualisieren einer Anwendungsdatei legen Sie im Abschnitt für die Eigenschaften ("Properties")
Folgendes fest:
- Update=true
- operationType=add, operationType=update oder operationType=delete
- contentType=file, contentType=moduleFile, contentType=partialapp,
oder contentType=app
- 2. Führen Sie den Befehl
applyConfigProperties aus, um die implementierte Anwendung zu aktualisieren.
|
delete (deinstallieren) |
- Entfernen Sie die Eigenschaften, die das Implementierungsziel angeben, aus der Eigenschaftendatei.
- Führen Sie den Befehl
deleteConfigProperties aus, um die implementierte Anwendung zu deinstallieren.
|
create Property |
Nicht zutreffend |
delete Property |
Nicht zutreffend |
Sie können wahlweise den Dialogmodus mit den Befehlen verwenden:
AdminTask.Befehlsname('-interactive')
Anstatt
eine Anwendungseigenschaftendatei manuell mit wsadmin-Befehlen anzuwenden, können Sie die Eigenschaftendatei
einem überwachten Verzeichnis hinzufügen.
Das Produkt führt die wsadmin-Befehle automatisch aus. Weitere Informationen finden Sie im Abschnitt
"Unternehmensanwendungsdateien durch Hinzufügen von Eigenschaftendateien zu einem überwachten Verzeichnis installieren".
Wenn Sie ein eigenständiges Webanwendungsarchiv (WAR, Web Application Archive) oder
SIP-Archiv (SAR, Session Initiation Protocol Archive) installieren, geben Sie das Kontextstammverzeichnis
der WAR- bzw. SAR-Datei an.
Der Kontextstamm wird mit der definierten Servletzuordnung (aus der WAR-Datei) zum
vollständigen URL kombiniert, den die Benutzer eingeben
müssen, um auf das Servlet zugreifen zu können. Beispiel: Wenn der Stammkontext /gettingstarted
ist und die Servletzuordnung MeineSitzung lautet, ergibt sich daraus der URL
http://host:port/gettingstarted/MeineSitzung.
In diesem Artikel werden die folgenden Prozeduren beschrieben:
Vorgehensweise
- Installieren Sie die Unternehmensanwendung in einem Implementierungsziel.
- Erstellen Sie eine Eigenschaftendatei, die die Anwendung und das Implementierungsziel festlegt.
Öffnen Sie einen Editor, und erstellen Sie eine Eigenschaftendatei wie die folgende, um ein Anwendungskonfigurationsobjekt
zu installieren:
#
# Header
#
ResourceType=Application
ImplementingResourceType=Application
CreateDeleteCommandProperties=true
ResourceId=Deployment=
# Eigenschaften
Name=hello
TargetServer=!{serverName}
TargetNode=!{nodeName}
EarFileLocation=/temp/Hello.ear
#TargetCluster=cluster1
#
EnvironmentVariablesSection
#
#
#Umgebungsvariablen
cellName=myCell04
nodeName=myNode
serverName=myServer
- Führen Sie den Befehl applyConfigProperties aus, um die Anwendung zu installieren.
Wenn Sie den Befehl applyConfigProperties ausführen, wird die Eigenschaftendatei angewendet.
In diesem Beispiel für
Jython erzeugt der optionale Parameter -reportFileName einen Bericht mit dem Namen
report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt '])
- Extrahieren Sie die Eigenschaften für eine implementierte Unternehmensanwendung.
Führen Sie den Befehl extractConfigProperties aus, um die Konfigurationsattribute und -werte
einer implementierten Unternehmensanwendung in eine Eigenschaftendatei zu extrahieren:
AdminTask.extractConfigProperties('[-propertiesFileName myApp.props -configData Deployment=MyApplication]')
Wenn
Sie dieses Jython-Beispiel ausführen, wird eine Datei mit dem Namen
myApp.props erzeugt, in der die Eigenschaften eines Anwendungskonfigurationsobjekts mit dem Namen
MyApplication aufgelistet sind.
Sie können die extrahierte Eigenschaftendatei verwenden, um die Eigenchaften der Anwendung anzuzeigen und zu bearbeiten.
Der Abschnitt "MapModulesToServers" der Eigenschaftendatei gleicht dem folgenden:
#
# SubSection 1.0.2
# MapModulesToServers Section. taskName und row0 dürfen nicht bearbeitet werden. row0 contains column names for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
#
#
#Eigenschaften
#
taskName=MapModulesToServers
row2={"My Web Application" MyWebApplication.war,WEB-INF/web.xml WebSphere:cell=!{cellName},
node=!{nodeName},server=!{serverName}
23 moduletype.web "Web Module"}
row1={"My Enterprise Java Bean" My.jar,META-INF/ejb-jar.xml WebSphere:cell=!{cellName},node=!{nodeName},
server=!{serverName} 20 moduletype.ejb "EJB Module"}
mutables={false false true false false false} #readonly
row0={module uri server ModuleVersion moduletype moduletypeDisplay} # readonly
Standardmäßig erzeugt der Befehl extractConfigProperties
eine Ausgabe, in der alle Spalten, einschließlich verdeckter und nicht verdeckter Spalten,
der Installationstasks und Taskdatenwerte in separaten Zeilen angezeigt werden.
In der Zeile mutables werden die editierbaren Spalten (true) und die nicht editierbaren
Spalten (false) angezeigt.
Um die Ausgabe der Anwendungseigenschaften zu erweitern, fürhen Sie den
AdminTask-Befehl extractConfigProperties mit der Option
SimpleOutputFormat aus. Wenn die Option auf
true gesetzt ist, werden in der Ausgabe nicht verdeckte Spalten der Anwendungseigenschaften in
Spaltenname=Wert-Paaren angezeigt.
Verdeckte Spalten der Anwendungseigenschaften sind nicht in der Ausgabe enthalten. Die erweiterte
Ausgabe erleichtert Ihnen die Suche und Bearbeitung von Anwendungseigenschaftswerten.
Sie können eine editierte Eigenschaftendatei verwenden, um eine Anwendung zu installieren oder zu aktualisieren.
Im folgenden Beispiel wird die Option SimpleOutputFormat mit dem Befehl
extractConfigProperties angegeben:
AdminTask.extractConfigProperties('[-propertiesFileName myApp.props -configData Deployment=MyApplication
-option [[SimpleOutputFormat true]]]')
Mit der Option SimpleOutputFormat gleicht der Abschnitt "MapModulesToServers"
der extrahierten Anwendungseigenschaftendatei dem folgenden:
#
# SubSection 1.0.2
# MapModulesToServers Section. taskName and lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
#
#
#Eigenschaften
#
taskName=MapModulesToServers
row0={ module="My Enterprise Java Bean" #readonly
uri=My.jar,META-INF/ejb-jar.xml #readonly
server=WebSphere:cell=!{cellName},node=!{nodeName},server=!{serverName} }
row1={ module="My Web Application" #readonly
uri=MyWebApplication.war,WEB-INF/web.xml #readonly
server=WebSphere:cell=!{cellName},node=!{nodeName},server=!{serverName} }
- Eine einzelne Datei in einer implementierten Unternehmensanwendung aktualisieren.
- Bearbeiten Sie die Anwendungseigenschaftendatei in der Weise, dass sie die Datei angibt, die hinzugefügt oder geändert werden soll.
Bearbeiten Sie die Eigenschaften eines Anwendungskonfigurationsobjekts.
Geben Sie im Abschnitt für die Eigenschaften ("Properties")
Update=true, einen Operationstyp wie
operationType=add und contentType=file an.
Im folgenden Beispiel wird die Datei
addMe.jsp einer implementierten Anwendung mit dem Namen
hello hinzugefügt:
#
# Header
#
ResourceType=Application
ImplementingResourceType=Application
CreateDeleteCommandProperties=true
ResourceId=Deployment=hello
#
#
# Eigenschaften
#
Name=hello
Update=true
operationType=add
contentType=file
contentURI=test.war/com/ibm/addMe.jsp
contentFile=c:/temp/addMe.jsp
- Führen Sie den Befehl applyConfigProperties aus, um die Anwendung zu aktualisieren.
Wenn Sie den Befehl applyConfigProperties ausführen, wird die Eigenschaftendatei angewendet.
Ein Beispiel finden Sie im
Installationsschritt.
- Eine einzelne Datei aus einer implementierten Unternehmensanwendung entfernen.
- Bearbeiten Sie die Anwendungseigenschaftendatei in der Weise, dass sie die Datei angibt, die entfernt werden soll.
Bearbeiten Sie die Eigenschaften eines Anwendungskonfigurationsobjekts.
Geben Sie im Abschnitt für die Eigenschaften ("Properties") Update=true, operationType=delete und
contentType=file an. Im folgenden Beispiel wird die Datei
addMe.jsp aus einer implementierten Anwendung mit dem Namen
hello entfernt:
#
# Header
#
ResourceType=Application
ImplementingResourceType=Application
CreateDeleteCommandProperties=true
ResourceId=Deployment=hello
#
#
# Eigenschaften
#
Name=hello
Update=true
operationType=delete
contentType=file
contentURI=test.war/com/ibm/addMe.jsp
- Führen Sie den Befehl applyConfigProperties aus, um die Anwendung zu aktualisieren.
Wenn Sie den Befehl applyConfigProperties ausführen, wird die Eigenschaftendatei angewendet.
Ein Beispiel finden Sie im
Installationsschritt.
- Ein einzelnes Modul in einer implementierten Unternehmensanwendung aktualisieren.
- Bearbeiten Sie die Anwendungseigenschaftendatei in der Weise, dass sie das Java-EE-Modul
angibt, das hinzugefügt oder geändert werden soll.
Bearbeiten Sie die Eigenschaften eines Anwendungskonfigurationsobjekts.
Geben Sie im Abschnitt für die Eigenschaften ("Properties")
Update=true, einen Operationstyp wie operationType=add und contentType=moduleFile an.
Im folgenden Beispiel wird die Datei
Increment.jar einer implementierten Anwendung mit dem Namen
hello hinzugefügt:
#
# Header
#
ResourceType=Application
ImplementingResourceType=Application
CreateDeleteCommandProperties=true
ResourceId=Deployment=hello
#
#
# Eigenschaften
#
Name=hello
Update=true
operationType=add
contentType=modulefile
#contextRoot=”/mywebapp” # nur für Webmodul erforderlich
contentURI=Increment.jar
contentFile=c:/apps/app1/Increment.jar
deployEJB=false
- Führen Sie den Befehl applyConfigProperties aus, um die Anwendung zu aktualisieren.
Wenn Sie den Befehl applyConfigProperties ausführen, wird die Eigenschaftendatei angewendet.
Ein Beispiel finden Sie im
Installationsschritt.
- Ein einzelnes Modul aus einer implementierten Unternehmensanwendung entfernen.
- Bearbeiten Sie die Anwendungseigenschaftendatei in der Weise, dass sie das Java-EE-Modul
angibt, das entfernt werden soll.
Bearbeiten Sie die Eigenschaften eines Anwendungskonfigurationsobjekts.
Geben Sie im Abschnitt für die
Eigenschaften ("Properties") Update=true, operationType=delete und
contentType=moduleFile an. Im folgenden Beispiel wird die Datei
test.war aus einer implementierten Anwendung mit dem Namen hello entfernt:
#
# Header
#
ResourceType=Application
ImplementingResourceType=Application
CreateDeleteCommandProperties=true
ResourceId=Deployment=hello
#
#
# Eigenschaften
#
Name=hello
Update=true
operationType=delete
contentType=moduleFile
contentURI=test.war
- Führen Sie den Befehl applyConfigProperties aus, um die Anwendung zu aktualisieren.
Wenn Sie den Befehl applyConfigProperties ausführen, wird die Eigenschaftendatei angewendet.
Ein Beispiel finden Sie im
Installationsschritt.
- Mehrere Dateien einer implementierten Unternehmensanwendung ersetzen, hinzufügen oder löschen.
Diese Option legt fest, dass mehrere Dateien einer installierten Anwendung durch Hochladen einer komprimierten Datei
aktualisiert werden.
Je nach Inhalt der komprimierten Datei kann die einzelne
Verwendung dieser Option Dateien in der installierten Anwendung ersetzen, neue Dateien
zur Anwendung hinzufügen und Dateien aus der Anwendung löschen. Jeder Eintrag in der
komprimierten Datei wird als Einzeldatei behandelt, und der Pfad der Datei vom
Stammverzeichnis wird als relativer Pfad der Datei in der installierten Anwendung
behandelt.
- Wenn Sie eine Datei ersetzen möchten, muss eine Datei
in der komprimierten Datei denselben relativen Pfad haben wie die Datei, die in der
installierten Anwendung aktualisiert werden soll.
- Wenn Sie eine Datei hinzufügen
möchten, muss eine Datei in der komprimierten Datei einen anderen relativen Pfad haben
als die Datei in der installierten Anwendung.
- Der relative Pfad einer Datei in einer installierten Anwendung wird durch Verknüpfung des
relativen Pfads des Moduls (sofern die Datei in einem Modul enthalten ist) und des relativen
Pfads der Datei im Stammverzeichnis des Moduls zusammen. Die Pfad werden durch einen Schrägstrich (/)
voneinander getrennt.
- Wenn Sie eine Datei aus der
installierten Anwendung entfernen möchten, müssen Sie Metadaten in der komprimierten
Datei angeben. Dazu müssen Sie eine Datei verwenden, die für alle Archive
den Namen META-INF/ibm-partialapp-delete.props hat. Die Datei
ibm-partialapp-delete.props muss eine ASCII-Datei sein, die Dateien angibt, die
aus diesem Archiv zu löschen sind. Dabei wird für jeden Eintrag eine Zeile verwendet. Der
Eintrag kann ein Zeichenfolgemuster enthalten, z. B. einen regulären Ausdruck, der
mehrere Dateien angibt. Die Dateipfade für die zu löschenden Dateien müssen relativ zum
Archivpfad angegeben werden, unter dem die Datei
META-INF/ibm-partialapp-delete.props sich befindet.
Weitere Informationen zu der
.props-Datei mit Metadaten, die in komprimierte Dateien eingefügt werden soll,
finden Sie im Abschnitt
"Mehrere Dateien ersetzen, hinzufügen oder löschen" im Artikel "Einstellungen für die Vorbereitung der Anwendungsaktualisierung".
- Bearbeiten Sie die Anwendungseigenschaftendatei in der Weise, dass sie die komprimierte
Datei angibt.
Bearbeiten Sie die Eigenschaften eines Anwendungskonfigurationsobjekts.
Geben Sie im Abschnitt für die
Eigenschaften ("Properties") Update=true, operationType=update und
contentType=partialapp an. Im folgenden Beispiel wird die komprimierte Datei
myAppPartial.zip verwendet, um eine implementierte Anwendung mit
dem Namen hello zu aktualisieren:
#
# Header
#
ResourceType=Application
ImplementingResourceType=Application
CreateDeleteCommandProperties=true
ResourceId=Deployment=hello
#
#
# Eigenschaften
#
Name=hello
Update=true
operationType=update
contentType=partialapp
contentFile= c:/temp/MyApp/myAppPartial.zip
- Führen Sie den Befehl applyConfigProperties aus, um die Anwendung zu aktualisieren.
Wenn Sie den Befehl applyConfigProperties ausführen, wird die Eigenschaftendatei angewendet.
Ein Beispiel finden Sie im
Installationsschritt.
- Die gesamte implementierte Unternehmensanwendung ersetzen.
Diese Option legt fest, dass die bereits auf einem Implementierungsziel installierte Anwendung durch eine
neue (aktualisierte) Unternehmensanwendung
(.ear-Datei) ersetzt werden soll.
- Bearbeiten Sie die Anwendungseigenschaftendatei in der Weise, dass sie die Anwendungsdatei
angibt.
Bearbeiten Sie die Eigenschaften eines Anwendungskonfigurationsobjekts.
Geben Sie im Abschnitt für die
Eigenschaften ("Properties") Update=true, operationType=update und
contentType=app an. Im folgenden Beispiel wird die Datei
newApp1.ear einer implementierten Anwendung mit dem Namen
hello ersetzt. Die Eigenschaft
useDefaultBindings=true weist das Produkt an, Standardbindungen für die Anwendung zu generieren.
#
# Header
#
ResourceType=Application
ImplementingResourceType=Application
CreateDeleteCommandProperties=true
ResourceId=Deployment=hello
#
#
# Eigenschaften
#
Name=hello
Update=true
operationType=update
contentType=app
contentFile=c:/apps/app1/newApp1.ear
useDefaultBindings=true
Beim Aktualisieren der vollständigen Anwendung wird die alte Anwendung deinstalliert und die neue Anwendung installiert.
Wenn Sie die Konfigurationsänderungen speichern und anschließend synchronisieren, werden die Anwendungsdateien
auf dem Knoten dekomprimiert, auf dem die Anwendung ausgeführt wird. Falls die Anwendung während der Aktualisierung
auf dem Knoten aktiv ist, wird die Anwendung gestoppt. Die Anwendungsdateien werden aktualisiert, und anschließend
wird die Anwendung erneut gestartet.
- Führen Sie den Befehl applyConfigProperties aus, um die Anwendung zu aktualisieren.
Wenn Sie den Befehl applyConfigProperties ausführen, wird die Eigenschaftendatei angewendet.
Ein Beispiel finden Sie im
Installationsschritt.
- Eine Anwendung aus einem Implementierungsziel deinstallieren.
Sie können eine Anwendung auf zwei Arten deinstallieren:
- Geben Sie
CreateDeleteCommandProperties=true an, und führen Sie den Befehl
"deleteConfigProperties" aus.
- Bearbeiten Sie die Eigenschaftendatei in der Weise, dass sie zwar die Anwendung angibt, aber nicht mehr das Implementierungsziel.
Geben Sie beispielsweise Eigenschaften wie die folgenden an, um ein Anwendungskonfigurationsobjekt
mit dem Namen
hello zu deinstallieren:
#
# Header
#
ResourceType=Application
ImplementingResourceType=Application
CreateDeleteCommandProperties=true
ResourceId=Deployment=hello
#
#
# Eigenschaften
#
Name=hello
#
- Führen Sie den Befehl deleteConfigProperties aus, um die Anwendung zu deinstallieren.
AdminTask.deleteConfigProperties('[-propertiesFileName myApplication.props -reportFileName report.txt]')
- Geben Sie
DELETE=true an, und führen Sie den Befehl
applyConfigProperties aus.
- Bearbeiten Sie die Eigenschaftendatei in der Weise, dass sie zwar die Anwendung angibt, aber nicht mehr das Implementierungsziel.
Geben Sie beispielsweise Eigenschaften wie die folgenden an, um ein Anwendungskonfigurationsobjekt
mit dem Namen
hello zu deinstallieren:
#
# Header
#
ResourceType=Application
ImplementingResourceType=Application
DELETE=true
ResourceId=Deployment=hello
# Eigenschaften
Name=hello
- Führen Sie den Befehl applyConfigProperties aus.
Ein Beispiel finden Sie im
Installationsschritt.
- Implementierungsoptionen einer implementierten Anwendung bearbeiten.
- Bearbeiten Sie die Anwendungseigenschaftendatei in der Weise, dass sie neue oder geänderte Implementierungsoptionen
angibt.
Geben Sie beispielsweise Eigenschaften wie die folgenden für ein Anwendungskonfigurationsobjekt
mit dem Namen appl an:
#
# Header
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=appl
#
#
# Eigenschaften
#
taskName=AppDeploymentOptions
row1={$(APP_INSTALL_ROOT)/$(CELL)
AppDeploymentOption.Yes
AppDeploymentOption.No
AppDeploymentOption.No
AppDeploymentOption.No
""
off .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755
"WASX.SERV1 [x0617.27]"
AppDeploymentOption.No
AppDeploymentOption.No}
mutables={true true true true true true true true false true true}
row0={installed.ear.destination
distributeApp
useMetaDataFromBinary
createMBeansForResources
reloadEnabled
reloadInterval
validateinstall
filepermission
buildVersion
allowDispatchRemoteInclude
allowServiceRemoteInclude} #readonly
row1 enthält aktuelle Werte für jede Eigenschaft.
Zum Ändern einer Eigenschaft ändern Sie die Werte
in row1.
mutables gibt an, ob eine bestimmte Eigenschaft geändert werden kann.
row0 gibt den Namen der Implementierungseigenschaft an.
- Führen Sie den Befehl applyConfigProperties aus, um die Anwendung zu aktualisieren.
Wenn Sie den Befehl applyConfigProperties ausführen, wird die Eigenschaftendatei angewendet.
Ein Beispiel finden Sie im
Installationsschritt.
- Eine Anwendung erneut implementieren.
- Bearbeiten Sie die Anwendungseigenschaftendatei in der Weise, dass sie die gewünschten Implementierungsoptionen angibt.
Geben Sie beispielsweise Eigenschaften wie die folgenden für ein Anwendungskonfigurationsobjekt
mit dem Namen
myApp an.
- mutables gibt an, ob eine bestimmte Eigenschaft geändert werden kann.
- row0 gibt den Namen der Implementierungseigenschaft an.
- row1 enthält aktuelle Werte für jede Eigenschaft.
Zum Ändern einer Eigenschaft ändern Sie die Werte
in row1.
#
# Header MapModulesToServers
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#
#
# Eigenschaften
#
taskName=MapModulesToServers
mutables={false false true false false false} #readonly
row0={module uri server ModuleVersion moduletype moduletypeDisplay} # readonly
row1={“My Web Module” myWebModule.war,WEB-INF/web.xml WebSphere:cell=!{cellName},node=!{nodeName},
server=!{serverName} 14 moduletype.web "Web Module"}
row2={"My EJB module" MyEjbModule.jar,META-INF/ejb-jar.xml WebSphere:cell=!{cellName},node=!{nodeName},
server=!{serverName} 13 moduletype.ejb "EJB Module"}
#
#
# Header MapRolesToUsers
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
#
#
# Eigenschaften
#
taskName=MapRolesToUsers
row0={role role.everyone role.all.auth.user role.user role.group role.all.auth.realms role.user.access.ids role.group.access.ids} #readonly
mutables={false true true true true true true true} #readonly
row1={administrator AppDeploymentOption.No AppDeploymentOption.No "adminuser" "admingroup"
AppDeploymentOption.No "" ""}
#
# Header BindJndiForEJBNonMessageBinding
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
#
#
#Eigenschaften
#
taskName=BindJndiForEJBNonMessageBinding
row0={EJBModule EJB uri JNDI ModuleVersion localHomeJndi remoteHomeJndi} #readonly
mutables={false false false true false true true} #readonly
row1={"My EJB module" myEjb myEjbModule.jar,META-INF/ejb-jar.xml myEjb 20 "" “"}
#
#
# Header MapEJBRefToEJB
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
#
#
#Eigenschaften
#
taskName=MapEJBRefToEJB
row0={module EJB uri referenceBinding class JNDI ModuleVersion} #readonly
mutables={false false false false false true false} #readonly
row1={"My EJB module" myEJB MyEjbModule.jar,META-INF/ejb-jar.xml myEJB com.ibm.defaultapplication.Increment Increment 23}
#
#
# Header DataSourceFor20EJBModules
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
#
#
#Eigenschaften
#
taskName=DataSourceFor20EJBModules
row0={AppVersion EJBModule uri JNDI resAuth login.config.name auth.props dataSourceProps} #readonly
mutables={false false false true true true true true} #readonly
row1={13 "My EJB module" MyEjbModule.jar,META-INF/ejb-jar.xml MyDataSource cmpBinding.perConnectionFactory "" "" ""}
#
#
# Header DataSourceFor20CMPBeans
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
#
#
# Eigenschaften
#
taskName=DataSourceFor20CMPBeans
row0={AppVersion EJBVersion EJBModule EJB uri JNDI resAuth login.config.name auth.props} #readonly
mutables={false false false false false true true true true} #readonly
row1={13 13 "My EJB module" MyEjb MyEjbModule.jar,META-INF/ejb-jar.xml myDataSource
cmpBinding.perConnectionFactory "" ""}
#
#
# Header MapWebModToVH
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
#
#
# Eigenschaften
#
taskName=MapWebModToVH
row0={webModule uri virtualHost} #readonly
mutables={false false true} #readonly
row1={"My Web Application" MyWebModule.war,WEB-INF/web.xml default_host}
#
#
# Header CtxRootForWebMod
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
#
#
# Eigenschaften
#
taskName=CtxRootForWebMod
row0={webModule uri web.contextroot} #readonly
mutables={false false true} #readonly
row1={"My Web Application" MyWebModule.war,WEB-INF/web.xml /}
#
#
# Header MapSharedLibForMod
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
#
#
# Eigenschaften
#
taskName=MapSharedLibForMod
row0={module uri sharedLibName} #readonly
mutables={false false true} #readonly
row2={"My Web Application" MyWebModule.war,WEB-INF/web.xml ""}
row1={myApp META-INF/application.xml ""}
#
#
# Header JSPReloadForWebMod
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
#
#
# Eigenschaften
#
taskName=JSPReloadForWebMod
row0={webModule uri jspReloadEnabled jspReloadInterval} #readonly
mutables={false false true true} #readonly
row1={"My Web Application" MyWebModule.war,WEB-INF/ibm-web-ext.xmi AppDeploymentOption.Yes 10}
#
#
# Header SharedLibRelationship
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
#
#
# Eigenschaften
#
taskName=SharedLibRelationship
row0={module uri relationship compUnitName matchTarget origRelationship}
#readonly
mutables={false false true true true false} #readonly
row2={"My Web Application" MyWebModule.war,WEB-INF/web.xml "" "" AppDeploymentOption.Yes ""}
row1={myApp META-INF/application.xml "" "" AppDeploymentOption.Yes ""}
#
EnvironmentVariablesSection
#
# Environment Variables
#
cellName=myCell04
applicationName=myApp
nodeName=myNode
serverName=myServer
In diesem Beispiel werden nur häufigsten Task wie
"MapModulesToServer" und "CtxRootForWebMod" angezeigt.
Sie können Eigenschaften für Tasks abrufen, die nicht im Beispiel aufgeführt sind, indem Sie die
Eigenschaften aus einer vorhandenen Anwendung extrahieren und den Inhalt der extrahierten Eigenschaftendatei
entsprechend der Umgebung Ihrer Anwendung ändern.
Unterstützte Konfigurationen: Bei IBM® Erweiterungs- und Bindungsdateien weicht der Name
der XMI- oder XML-Datei ab, je nachdem, ob Sie eine Java EE-Anwendung bzw. ein Java EE-Modul vor oder nach Version 5 verwenden.
Eine IBM Erweiterungs- bzw. Bindungsdatei heißt "ibm-*-ext.xmi" bzw. "ibm-*-bnd.xmi". Das Platzhalterzeichen "*" steht für
den Typ der Erweiterungs- oder Bindungsdatei, z. B. "app", "application", "ejb-jar" oder "web". Es gelten die folgenden Bedingungen:
- Für eine Anwendung oder ein Modul, die bzw. das Java EE vor Version 5 verwendet,
muss die Dateierweiterung ".xmi" sein.
- Für eine Anwendung oder ein Modul, die bzw. das Java EE ab Version 5 verwendet,
muss die Dateierweiterung ".xml" sein. Wenn Dateien mit der Erweiterung ".xmi"
in der Anwendung oder im Modul enthalten sind, werden diese vom Produkt ignoriert.
Ein Modul von Java EE Version 5 oder einer höheren Version kann jedoch in einer Anwendung,
die Dateien einer älteren Java EE-Version als Version 5 enthält, koexistieren.
Die Dateien
ibm-webservices-ext.xmi,
ibm-webservices-bnd.xmi,
ibm-webservicesclient-bnd.xmi,
ibm-webservicesclient-ext.xmi und
ibm-portlet-ext.xmi können die Dateierweiterung ".xmi" weiterhin verwenden.
sptcfg
- Führen Sie den Befehl applyConfigProperties aus, um die Anwendung zu aktualisieren.
Wenn Sie den Befehl applyConfigProperties ausführen, wird die Eigenschaftendatei angewendet.
Ein Beispiel finden Sie im
Installationsschritt.
Ergebnisse
Sie können mit der
Eigenschaftendatei das Anwendungsobjekt und seine Eigenschaften konfigurieren und verwalten.
Nächste Schritte
Speichern Sie die Änderungen in Ihrer Konfiguration.