Unternehmensanwendungsdateien über die Konsole installieren

Bei der Installation von Java EE-Anwendungsdateien (Java™ Platform, Enterprise Edition) werden assemblierte Unternehmensanwendungs-, Web-, Enterprise-Bean- oder andere installierbare Module in einen als Ziel für diese Dateien konfigurierten Server oder Cluster gestellt. Installierte Dateien, die ordnungsgemäß gestartet und ausgeführt werden, gelten als implementiert.

Vorbereitende Schritte

Vor der Installation von Unternehmensanwendungsdateien sollten Sie sich vergewissern, dass die Installation in einem kompatiblen Implementierungsziel erfolgt. Falls das Implementierungsziel nicht kompatibel ist, wählen Sie ein anderes Ziel aus.

Legen Sie optional fest, ob die Anwendung, die Sie installieren, Bibliotheksdateien verwendet, die auch von anderen implementierten Anwendungen verwendet werden. Sie können eine gemeinsam genutzte Bibliothek für jede dieser gemeinsam genutzten Dateien definieren. Bei der Verwendung einer gemeinsam genutzten Bibliothek verringert sich die Anzahl der Kopien von Bibliotheksdateien auf Ihrer Workstations bzw. Ihrem Server.

Informationen zu diesem Vorgang

Sie können die folgenden Optionen verwenden, wenn Sie neue Unternehmensanwendungsdateien in einer Konfiguration von WebSphere Application Server installieren möchten:

  • Administrationskonsole
  • wsadmin-Scripts
  • Implementierung eines überwachten Verzeichnisses
  • Anwendungseigenschaftendateien
  • Java-MBean-Programme

In diesem Artikel wird beschrieben, wie Sie mit der Administrationskonsole eine Anwendung, eine EJB-Komponente, ein SIP-Archiv (SAR) oder ein Webmodul installieren.

Fehler vermeiden Fehler vermeiden: Nachdem Sie mit der Ausführung der Schritte im Anwendungsinstallationsassistenten begonnen haben, klicken Sie auf Abbrechen, um den Assistenten zu verlassen, falls Sie die Anwendung nicht installieren möchten. Sie sollten nicht einfach eine andere Seite der Administrationskonsole aufrufen. Klicken Sie auf einer Seite für die Anwendungsinstallation zuvor stets auf Abbrechen.gotcha

Vorgehensweise

  1. Klicken Sie in der Konsolennavigationsstruktur auf Anwendungen > Neue Anwendung > Neue Unternehmensanwendung.
  2. Gehen Sie auf der ersten Seite "Anwendungsinstallation vorbereiten" wie folgt vor:
    1. Geben Sie den vollständigen Pfadnamen der Quellendatei für die Unternehmensanwendung (.ear-Datei bzw. EAR-Datei) an.

      Die EAR-Datei, die Sie installieren, kann sich auf der Clientmaschine (mit dem Web-Browser) oder auf der Servermaschine (mit der der Client verbunden ist) befinden. Wenn Sie eine EAR-Datei auf der Clientmaschine angeben, lädt die Administrationskonsole die EAR-Datei auf die Maschine, auf der die Konsole ausgeführt wird, und fährt dann mit der Installation der Anwendung fort.

      Sie können auch eine eigenständige WAR-, SAR- oder JAR-Datei für die Installation angeben.

      [IBM i]Wenn die EAR-Datei sich auf der Servermaschine befindet und der Server ein Server des Typs IBM® i ist, vergewissern Sie sich, dass das Benutzerprofil QEJBSVR die Berechtigung *R für die EAR-Datei und mindestens die Berechtigung *X für alle Verzeichnisse in dem Pfad mit der EAR-Datei besitzt.

      Fehler vermeiden Fehler vermeiden: Wenn Sie versuchen eine Anwendung aus einem fernen Dateisystem zu installieren und die JVM als Microsoft Windows-Dienst registriert ist, wird in der Administrationskonsole kein zugeordnetes Netzlaufwerk angezeigt. In diesem Szenario wird der Windows-Dienst als neue Anmeldesitzung ausgeführt, deren Sicherheits-ID (SID) von der Benutzersitzung abweicht. Deshalb kann der Dienst das zugeordnete Netzlaufwerk nicht ändern, das vom Anmeldbenutzer eingerichtet wird. Zum Installieren der Anwendung aus einem fernen Dateisystem müssen Sie mit dem Befehl WASService die Registrierung der JVM als Windows-Dienst aufheben. Weitere Informationen finden Sie in der Dokumentation zum Befehl WASService.gotcha
    2. Klicken Sie auf Weiter.
  3. Gehen Sie auf der zweiten Seite Anwendungsinstallation vorbereiten wie folgt vor:
    1. Wählen Sie aus, ob alle Installationsoptionen angezeigt werden sollen.
      Direktaufruf - Nur anfragen, wenn weitere Informationen erforderlich sind
      Zeigt den Schritt für die Modulzuordnung und alle Schritte an, in denen Sie erforderliche Informationen angeben müssen, damit die Anwendung ordnungsgemäß installiert wird.
      Detailliert - Alle Installationsoptionen und -parameter anzeigen
      Zeigt alle Installationsoptionen an.
    2. Geben Sie an, ob Standardbindungen generiert werden sollen.

      Wählen Sie Standardbindungen generieren aus, wenn das Produkt Standardwerte für unvollständige JNDI- und andere Anwendungsbindungen bereitstellen soll. Das Produkt ändert keine vorhandenen Bindungen.

      Sie müssen keine JNDI-Werte für EJB-Bean-Schnittstellen, lokale Home-Schnittstellen, ferne Home-Schnittstellen oder Geschäftsschnittstellen von Modulen der EJB Version 3.x angeben. Das Produkt weist zur Laufzeit Containerstandardwerte zu. Auch für EJB-Referenzen in Modulen der EJB Version 3.x oder Web Version 2.4 oder höher müssen Sie keine JNDI-Werte angeben, weil das Produkt die Ziele zur Laufzeit automatisch auflöst. Selbst wenn Sie Standardbindungen generieren auswählen, generiert das Produkt keine Standardwerte für diese JNDI-Werte, sondern nur für andere Bindungen, wie z. B. virtuelle Hosts.

      Neues Feature Neues Feature:
      Vorkonfigurierte Standardressourcen werden nicht für Java EE-Bindungen verwendet. Wählen Sie die Option Java EE-Standardbindungen verwenden aus, um generierte Bindungen als Java EE-Standardbindungen zu verwenden. newfeat

      Sie können die Standardwerte, die für das Generieren der Standardbindungen verwendet werden, anpassen. Im Artikel Bindungseinstellungen für die Vorbereitung der Anwendungsinstallation werden verfügbare Anpassungen und Beispielbindungen beschrieben.

    3. Klicken Sie auf Weiter. Wenn Sicherheitswarnungen angezeigt werden, klicken Sie auf Weiter. Daraufhin erscheint die Seite Neue Anwendung installieren. Wenn Sie die Option für das Generieren von Standardbindungen ausgewählt haben, können Sie mit dem Schritt Zusammenfassung fortfahren. Der Artikel Beispiel: EAR-Datei mit Standardbindungen installieren enthält Beispielschritte.
  4. Geben Sie bei Bedarf Werte für die Installationsoptionen an.

    Sie können auf die Nummer eines Schritts klicken, um diese Seite direkt aufzurufen, anstatt auf Weiter zu klicken. Der Inhalt der Anwendung bzw. des Moduls, die bzw. das Sie installieren, bestimmt, welche Seiten verfügbar sind.

    Tabelle 1. Beschreibungen der Assistentenseiten. In dieser Tabelle sind die einzelnen Assistentenseiten beschrieben.
    Seite Beschreibung
    Installationsoptionen auswählen Geben Sie auf der Seite Installationsoptionen auswählen Werte für die spezifischen Einstellungen des Produkts an. Wenn Sie keinen Wert angeben, werden die Standardwerte verwendet.
    Servern Module zuordnen Geben Sie auf der Seite Servern Module zuordnen die Implementierungsziele an, in denen Sie die in der Anwendung enthaltenen Module installieren möchten. Module können in einem Implementierungsziel installiert oder auf mehrere Implementierungsziele verteilt werden. Jedes Modul muss einem Zielserver zugeordnet werden.

    In Einzelserverprodukten kann ein Implementierungsziel ein Anwendungsserver oder ein Web-Server sein.

    In Mehrserverprodukten kann ein Implementierungsziel ein Anwendungsserver, ein Cluster von Anwendungsservern oder ein Web-Server sein.

    Optionen für die Kompilierung von JSPs angeben Wenn die Einstellung JSP-Dateien vorkompilieren auf der Seite Installationsoptionen auswählen aktiviert ist und Ihre Anwendung JSP-Dateien (JavaServer Pages) verwendet, können Sie die Optionen für den JSP-Compiler auf der Seite Optionen für die Kompilierung von JSPs angeben.
    JNDI-Namen für Beans angeben Geben Sie auf der Seite JNDI-Namen für Beans angeben einen JNDI-Namen für jede Enterprise-Bean in jedem Modul der EJB Version 2.1 und früher an. Sie müssen für jede in der Anwendung definierte Enterprise-Bean einen JNDI-Namen angeben. Für das EJB-Modul MyBean.jar können Sie beispielsweise MyBean angeben.

    Für Module der EJB Version 3.x können Sie JNDI-Namen, JNDI-Namen für lokale-Home-Schnittstellen, JNDI-Namen für ferne Home-Schnittstellen oder keine JNDI-Namen angeben. Wenn Sie keinen Wert angeben, stellt das Produkt einen Standardwert bereit.

    EJB-Geschäft binden Auf der Seite EJB-Geschäft binden können Sie JNDI-Namen für Geschäftsschnittstellen für Module der EJB Version 3.x angeben. Wenn Sie auf der Seite JNDI-Namen für Beans angeben einen JNDI-Namen für eine Bean angegeben haben, geben Sie auf dieser Seite für dieselbe Bean keinen JNDI-Namen für die Geschäftsschnittstelle an. Wenn Sie den JNDI-Namen für eine Bean nicht angeben, können Sie optional einen JNDI-Namen für eine Geschäftsschnittstelle angeben. Wenn Sie keinen JNDI-Namen für eine Geschäftsschnittstelle angeben, stellt das Produkt einen Containerstandardwert bereit. Für eine Ansicht, die keine Schnittstellenansicht ist, ist der Geschäftsschnittstellenwert eine leere Zeichenfolge ("").
    Standarddatenquellen für Module mit 1.x-Entity-Beans zuordnen Wenn Ihre Anwendung EJB-Module verwendet, die CMP-Beans (Container Managed Persistence, über Container realisierte Transaktionspersistenz) enthält, die auf der Spezifikation EJB 1.x basieren, geben Sie für Standarddatenquellen für Module mit 1.x-Entity-Beans zuordnen einen JNDI-Namen für die Standarddatenquelle der EJB-Module an. Die Standarddatenquelle für die EJB-Module ist optional, wenn Datenquellen für einzelne CMP-Beans angegeben werden.
    Beans EJB-Referenzen zuordnen Wenn Ihre Anwendung EJB-Referenzen definiert, können Sie auf der Seite Beans EJB-Referenzen zuordnen JNDI-Namen für Enterprise-Beans angeben, die die in den EJB-Referenzen angegebenen logischen Namen darstellen.

    Wenn die EJB-Referenz aus einem Modul der EJB Version 3.x bzw. Web Version 2.4 oder höher stammt, ist der JNDI-Name optional. Für frühere Module muss jede in der Anwendung definierte EJB-Referenz an eine EJB-Datei gebunden sein.

    Wenn die Einstellung Automatische Auflösung von EJB-Referenzen zulassen aktiviert ist, ist der JNDI-Name für alle Module optional. Das Produkt stellt einen Containerstandardwert bereit oder löst die EJB-Referenzen für unvollständige Bindungen automatisch auf.

    Ressourcen Ressourcenreferenzen zuordnen Wenn Ihre Anwendung Ressourcenreferenzen definiert, geben Sie für Ressourcen Ressourcenreferenzen zuordnen JNDI-Namen für die Ressourcen an, die die in den Ressourcenreferenzen definierten logischen Namen darstellen. Optional können Sie für die Ressource den Namen einer Anmeldekonfiguration und Authentifizierungseigenschaften angeben. Klicken Sie nach dem Angeben der Authentifizierungseigenschaften auf OK, um die Werte zu speichern und zur Zuordnung zurückzukehren. Sie können optional erweiterte Datenquelleneigenschaften angeben, um eine Datenquelle zu aktivieren, die heterogenes Pooling verwendet, um eine Verbindung zu einer DB2-Datenbank herzustellen. Sie müssen jede in der Anwendung definierte Ressourcenreferenz an eine in Ihrer Konfiguration von WebSphere Application Server definierte Ressource binden, bevor Sie auf der Seite Zusammenfassung auf Fertigstellen klicken.
    Webmodulen virtuelle Hosts zuordnen Wenn Ihre Anwendung Webmodule verwendet, wählen Sie in der Liste unter Webmodulen virtuelle Hosts zuordnen einen virtuellen Host aus, der einem in der Anwendung definierten Webmodul zugeordnet werden soll. Im URL, der für den Zugriff auf Artefakte wie Servlets und JSP-Dateien des Webmoduls verwendet wird, enthält die in der Definition des virtuellen Hosts angegebene Portnummer. Jedes Webmodul muss einem virtuellen Host zugeordnet sein. Sind nicht alle erforderlichen virtuellen Hosts angegeben, wird ein Validierungsfehler angezeigt, sobald Sie auf der Seite "Zusammenfassung" auf Fertigstellen klicken.
    Sicherheitsrollen Benutzern oder Gruppen zuordnen Wenn im Implementierungsdeskriptor der Anwendung Sicherheitsrollen definiert sind, geben Sie für Sicherheitsrollen Benutzern oder Gruppen zuordnen Benutzer und Gruppen an, die den einzelnen Sicherheitsrollen zugeordnet werden. Markieren Sie den Eintrag Rolle, wenn Sie alle Rollen auswählen möchten, oder wählen Sie einzelne Rollen aus. Für jede Rolle können Sie angeben, ob vordefinierte Benutzer wie Jeder oder Alle authentifizierten Benutzer zugeordnet werden sollen. Gehen Sie wie folgt vor, um bestimmte Benutzer oder Gruppen aus der Benutzerregistry anzugeben:
    1. Wählen Sie eine Rolle aus und klicken Sie auf Benutzer suchen oder Gruppen suchen.
    2. Geben Sie auf der daraufhin erscheinenden Seite "Benutzer oder Gruppen suchen" Suchkriterien ein, nach denen eine Liste von Benutzern oder Gruppen aus der Benutzerregistry extrahiert werden soll.
    3. Wählen Sie aus den angezeigten Ergebnissen einzelne Benutzer oder Gruppen aus.
    4. Klicken Sie auf OK, um die ausgewählten Benutzer oder Gruppen der Rolle zuzuordnen, die auf der Seite Sicherheitsrollen Benutzern oder Gruppen zuordnen ausgewählt wurde.
    RunAs-Rollen zu Benutzern zuordnen Wenn im Implementierungsdeskriptor der Anwendung RunAs-Rollen definiert sind, geben Sie für RunAs-Rollen zu Benutzern zuordnen den RunAs-Benutzernamen und das Kennwort für jede RunAs-Rolle an. RunAs-Rollen werden von Enterprise-Beans verwendet, die bei der Interaktion mit einer anderen Enterprise-Bean unter einer bestimmten Rolle ausgeführt werden müssen. Markieren Sie den Eintrag Rolle, wenn Sie alle Rollen auswählen möchten, oder wählen Sie einzelne Rollen aus. Geben Sie nach Auswahl einer Rolle den Benutzernamen und das Kennwort ein. Bestätigen Sie das Kennwort, und klicken Sie auf Anwenden.
    Sicherstellen, dass alle ungeschützten 1.x-Methoden den richtigen Zugriffsschutz haben Wenn Ihre Anwendung EJB-1.x-CMP-Beans ohne definierte Methodenberechtigungen für EJB-Methoden enthält, geben Sie unter Sicherstellen, dass alle ungeschützten 1.x-Methoden die richtige Zugriffsschutzebene verwenden an, ob die Methoden ungeschützt bleiben sollen oder jeder Zugriff verweigert werden soll.
    Listener für MDBs binden Wenn Ihre Anwendung MDBs enthält, geben Sie für Listener für MDBs binden den Namen eines Listener-Ports oder für jede MDB den JNDI-Namen einer Aktivierungsspezifikation an.
    Standarddatenquellen für Module mit 2.x-Entity-Beans zuordnen Wenn Ihre Anwendung EJB-Module verwendet, die CMP-Beans enthalten, die auf der Spezifikation EJB 2.x basieren, geben Sie für Standarddatenquellen für Module mit 2.x-Entity-Beans zuordnen einen JNDI-Namen für die Standarddatenquelle und den Typ der Ressourcenberechtigung an, die für die Standarddatenquelle der EJB-Module verwendet werden soll. Optional können Sie für die Datenquelle den Namen einer Anmeldekonfiguration und Authentifizierungseigenschaften angeben. Klicken Sie nach dem Erstellen der Authentifizierungseigenschaften auf OK, um die Werte zu speichern und zur Zuordnung zurückzukehren. Sie können optional erweiterte Datenquelleneigenschaften angeben, um eine Datenquelle zu aktivieren, die heterogenes Pooling verwendet, um eine Verbindung zu einer DB2-Datenbank herzustellen. Die Standarddatenquelle für EJB-Module ist optional, wenn Datenquellen für die einzelnen CMP-Beans angegeben werden.
    Datenquellen für alle 2.x-CMP-Beans zuordnen Wenn Ihre Anwendung CMP-Beans enthält, die auf der EJB-Spezifikation 2.x basieren, geben Sie auf der Seite Datenquellen für alle 2.x-CMP-Beans zuordnen für jede der 2.x-CMP-Beans einen JNDI-Namen und den Typ der zu verwendenden Ressourcenberechtigung für diese Datenquellen an.

    Optional können Sie für die Datenquelle den Namen einer Anmeldekonfiguration und Authentifizierungseigenschaften angeben. Klicken Sie nach dem Erstellen der Authentifizierungseigenschaften auf OK, um die Werte zu speichern und zur Zuordnung zurückzukehren. Das Datenquellenattribut für einzelne CMP-Beans ist optional, wenn für das EJB-Modul, das CMP-Beans enthält, eine Standarddatenquelle angegeben wurde. Falls weder eine Standarddatenquelle für das EJB-Modul noch eine Datenquelle für einzelne CMP-Beans angegeben wurde, wird ein Validierungsfehler angezeigt, sobald Sie auf Fertigstellen klicken. Die Installation wird abgebrochen.

    Sicherstellen, dass alle ungeschützten 2.x-Methoden den richtigen Zugriffsschutz haben Wenn Ihre Anwendung EJB-2.x-CMP-Beans enthält und in den Implementierungsdeskriptoren keine Methodenberechtigungen für EJB-Methoden definiert sind, geben Sie unter Sicherstellen, dass alle ungeschützten 2.x-Methoden die richtige Zugriffsschutzebene verwenden an, ob Sie den ungeschützten Methoden einer bestimmten Rolle zuordnen, die Methoden zur Ausschlussliste hinzufügen oder sie als abgewählt markieren möchten. Zur Ausschlussliste hinzugefügte Methoden werden als nicht aufrufbar markiert. Für Methoden, die als abgewählt markiert sind, wird vor dem Aufruf keine Berechtigungsprüfung durchgeführt.
    Optionen für die EJB-Implementierung angeben Wenn auf der Seite Installationsoptionen auswählen die Einstellung Enterprise-Beans implementieren aktiviert ist, können Sie auf der Seite Optionen für die EJB-Implementierung angeben Optionen für das EJB-Implementierungstool angeben. Auf dieser Seite können Sie für die Ausführung des EJB-Implementierungstool einen zusätzlichen Klassenpfad sowie zusätzliche RMIC-Optionen, Datenbanktypen und Namen von Datenbankschemata angeben.

    Sie können auf dieser Seite Optionen für das EJB-Implementierungstool angeben, wenn Sie eine Anwendung installieren oder aktualisieren, die EJB-Module enthält. Das EJB-Implementierungstool wird während der Installation von Modulen der EJB Version 1.x oder 2.x ausgeführt. Das EJB-Implementierungstool wird während der Installation von Modulen der EJB Version 3.x nicht ausgeführt.

    Gemeinsam genutzte Bibliotheken zuordnen Geben Sie auf den Seiten Referenzen auf gemeinsam genutzte Bibliotheken und Zuordnung gemeinsam genutzter Bibliotheken die gemeinsam genutzten Bibliotheksdateien für Ihre Anwendung bzw. Ihre Webmodule an. Es muss eine definierte gemeinsam genutzte Bibliothek vorhanden sein, damit die Anwendung oder das Modul der Bibliotheksdatei zugeordnet werden kann.
    Gemeinsam genutzte Bibliotheksbeziehungen zuordnen Geben Sie auf der Seite Gemeinsam genutzte Bibliotheksbeziehungen zuordnen Beziehungskennungen und Kompositionseinheitennamen für gemeinsam genutzte Bibliotheken an, auf die Module in Ihrer Unternehmensanwendung verweisen.

    Wenn Sie Ihre Unternehmensanwendung installieren, erstellt das Produkt eine Kompositionseinheit für jede gemeinsam genutzte Bibliotheksbeziehung in der Geschäftsanwendung, die Sie für Name der Geschäftsanwendung auf der Seite Installationsoptionen auswählen angegeben haben.

    Optionen für das erneute Laden der JSP für Webmodule angeben Wenn Ihre Anwendung Webmodule verwendet, konfigurieren Sie für Optionen für das erneute Laden der JSP für Webmodule angeben das erneute Laden der Klassen von JSP-Dateien.
    Kontextstammverzeichnisse für Webmodule zuordnen Wenn Ihre Anwendung Webmodule verwendet, die im XML-Implementierungsdeskriptor der Anwendung definiert sind, geben Sie für Kontextstammverzeichnisse für Webmodule zuordnen ein Kontextstammverzeichnis für jedes Webmodul in der Anwendung an.

    Das Produkt schließt keine Webmodule aus Annotationen auf dieser Seite ein.

    Initialisierungsparameter für Servlets Wenn Ihre Anwendung Webmodule verwenden, die die Spezifikation Servlet 2.5 unterstützen, definieren oder überschreiben Sie für Initialisierungsparameter für Servlets Anfangsparameter, die an die Methode "init" der Servletfilter für Webmodule übergeben werden.

    Auf dieser Seite werden Servlets aus dem XML-Implementierungsdeskriptor des Moduls angezeigt. Implementierungsinformationen für Servlets aus Annotationen sind auf dieser Seite nicht verfügbar.

    Umgebungseinträge für EJB-Module zuordnen Wenn Ihre Anwendung Webmodule verwendet, konfigurieren Sie für Umgebungseinträge für EJB-Module zuordnen die Umgebungseinträge der EJB-Module, z. B. Entity-Beans, Session-Beans oder Message-driven-Beans.
    Umgebungseinträge für Clientmodule zuordnen Wenn Sie Anwendungsclientmodule implementieren konfigurieren Sie für Umgebungseinträge für Clientmodule zuordnen die Umgebungseinträge der Clientmodule, die als JAR-Dateien implementiert sind. Zum Anzeigen der Seite Umgebungseinträge für Clientmodule zuordnen wählen Sie die Option Clientmodule implementieren auf der Seite Installationsoptionen auswählen aus.
    Umgebungseinträge für Webmodule zuordnen Wenn Ihre Anwendung Webmodule verwendet, die die Spezifikation Servlet 2.5 unterstützen, konfigurieren Sie für Umgebungseinträge für Webmodule zuordnen die Umgebungseinträge der Webmodule, z. B. Servlets und JSP-Dateien.
    Umgebungseinträge für die Anwendungsebene zuordnen Wenn Ihre Anwendung einen oder mehrere Umgebungseinträge für definiert, konfigurieren Sie für Umgebungseinträge für Clientmodule zuordnen die Umgebungseinträge der Anwendungen, die als EAR-Dateien implementiert sind.
    Referenzen auf Ressourcenumgebungseinträge zu Ressourcen zuordnen Falls Ihre Anwendung Ressourcenumgebungsreferenzen enthält, geben Sie für Referenzen auf Ressourcenumgebungseinträge zu Ressourcen zuordnen JNDI-Namen der Ressourcen an, die den in den Ressourcenumgebungsreferenzen definierten logischen Namen zugeordnet werden sollen. Wurde nicht jeder Ressourcenumgebungsreferenz eine Ressource zugeordnet, wird ein Validierungsfehler angezeigt, sobald Sie auf Fertigstellen klicken.
    Richtige Verwendung der System-ID Wenn Ihre Anwendung RunAs-Identität als Systemidentität definiert, können Sie den Wert für Richtige Verwendung der System-ID optional in RunAs-Rolle ändern und für die ausgewählten RunAs-Rolle einen Benutzernamen und ein Kennwort angeben. Die Auswahl der System-ID impliziert, dass der Aufruf von der Sicherheitsserver-ID von WebSphere Application Server ausgeführt wird. Diese ID sollte mit Bedacht verwendet werden, da sie mehr Berechtigungen hat.
    Korrekte Isolationsstufen für alle Ressourcenreferenzen Falls Ihre Anwendung Ressourcenreferenzen enthält, die Ressourcen zugeordnet sind, deren Back-End-Verarbeitung in einer Oracle-Datenbank stattfindet, können Sie unter Korrekte Isolationsstufen für alle Ressourcenreferenzen die Isolationsstufe angeben, die für solche Ressourcen verwendet werden soll, sofern sie von der Anwendung genutzt werden. Oracle-Datenbanken unterstützen nur die Isolationsstufen "Festgeschriebene Daten lesen" und "Serialisierbar".
    JASPI-Provider zuordnen Wenn Ihre Anwendung Webmodule enthält, können Sie auf der Seite JASPI-Provider zuordnen Werte angeben, um die JASPI-Einstellungen aus der globalen oder Domänensicherheitskonfiguration zu überschreiben. Standardmäßig übernimmt eine Anwendung die JASPI-Einstellungen, die in der globalen oder Domänensicherheitskonfiguration von WebSphere Application Server definiert sind, und die Webmodule übernehmen die Anwendungseinstellung.
    Nachrichtenzielreferenzen an verwaltete Objekte binden Wenn Ihre Anwendung MDBs verwendet, geben Sie für Nachrichtenzielreferenzen an verwaltete Objekte binden den JNDI-Namen des verwalteten J2C-Objekts an, um die Nachrichtenzielreferenz an die MDBs zu binden.

    Wenn die Nachrichtenzielreferenz aus einem Modul der EJB Version 3.0 oder höher stammt, ist der JNDI-Name optional, und die Laufzeitumgebung stellt einen Containerstandardwert bereit.

    Achtung: Wenn mehrere Nachrichtenzielreferenzen mit demselben Nachrichtenziel verknüpft sind, wird nur ein JNDI-Name erfasst. Wenn eine Nachrichtenzielreferenz mit demselben Nachrichtenziel verknüpft ist wie eine MDB und der JNDI-Name des Ziels bereits erfasst wurde, wird der JNDI-Name für die Nachrichtenzielreferenz nicht erfasst.
    JNDI-Namen für JCA-Objekte angeben Wenn Ihre Anwendung eine integrierte Datei .rar enthält, geben Sie für JNDI-Namen für JCA-Objekte den Namen und den JNDI-Namen jeder JCA-Verbindungsfactory, jedes verwalteten Objekts und jeder Aktivierungsspezifikation an.
    J2C-Aktivierungsspezifikationen an JNDI-Namen des Ziels binden Wenn Ihre Anwendung eine integrierte Datei mit der Erweiterung .rar enthält, ihre Eigenschaft "activationSpec" den Wert Destination und den Typ javax.jms.Destination hat, geben Sie für J2C-Aktivierungsspezifikationen an JNDI-Namen des Ziels binden den JNDI-Namen jeder gebundenen Aktivierung an.
    Aktuelle Back-End-ID auswählen Wenn Ihre Anwendung EJB-Module enthält, für die mit einem Assembliertool Implementierungscode für mehrere Back-End-Datenbanken generiert wurde, geben Sie für Aktuelle Back-End-ID auswählen die Back-End-ID der Back-End-Datenbank an, die bei der Ausführung des EJB-Moduls verwendet werden soll.

    Weitere Informationen zu Back-End-Datenbanken finden Sie in den Artikeln zum EJB-Implementierungstool.

    Dieser Schritt wird nicht angezeigt, wenn die Einstellung Enterprise-Beans implementieren auf der Seite Installationsoptionen auswählen aktiviert ist und wenn eine andere Datenbankeinstellung als Ohne auf der Seite Optionen für die EJB-Implementierung angeben ausgewählt ist.

    Metadaten für Module Wenn Ihre Anwendung Module der EJB Version 3.x oder Web Version 2.5 enthält, können Sie Implementierungsdeskriptoren für ein oder mehrere dieser Module sperren. Wenn Sie das Attribut metadata-complete auf true setzen und Implementierungsdeskriptoren sperren, schreibt das Produkt den vollständigen Implementierungsdeskriptor, einschließlich der Implementierungsinformationen aus Annotationen, im XML-Format.
    Optionen für die Web-Service-Implementierung angeben Wenn die Einstellung Web-Services implementieren in der Anzeige Installationsoptionen auswählen aktiviert ist und Ihre Anwendung Web-Services verwendet, können Sie auf der Seite Optionen für die Implementierung von Web-Services angeben für den Befehl wsdeploy angeben. Weitere Informationen zu dieser Seite finden Sie in den Beschreibungen der Optionen wsdeploy -cp und -jardir.
    Eigenschaften für ferne Anforderungsverteilung konfigurieren Wenn Sie Remote Request Dispatcher (RRD) verwenden, müssen Sie diesen zuerst konfigurieren. Remote Request Dispatcher (RRD) ist eine Plug-in-Erweiterung für den Web-Container, die Anwendungsframeworks, Servlets und JSP-Dateien (JavaServer Pages) ermöglicht, für die derzeit aktive Ressourcen-JVM externen Inhalt in die Antwort einzufügen, die an den Client gesendet wird. Informationen zur Konfiguration dieser Eigenschaften über die Administrationskonsole finden Sie in den Beschreibungen der Einstellungen der Remote-Dispatcher-Eigenschaften.
    Build-ID des Moduls anzeigen Wenn die Datei MANIFEST.MF eines Moduls in einer Unternehmensanwendung eine Build-ID enthält, wird auf dieser Seite die Build-ID des Moduls angezeigt.
  5. Prüfen Sie auf der Seite Zusammenfassung die Zelle, den Knoten und den Server, auf dem die Anwendungsmodule installiert werden:
    1. Wählen Sie Hier klicken neben der Option Zelle/Knoten/Server aus.
    2. Überprüfen Sie die Einstellungen.
    3. Kehren Sie zur Seite Zusammenfassung zurück.
    4. Klicken Sie auf Fertigstellen.

Ergebnisse

Es werden mehrere Nachrichten angezeigt, die Ihnen anzeigen, ob die Installation der Anwendungsdatei ordnungsgemäß verläuft.

Wenn die Einstellung Eingabe validieren (Aus/Warnung/Fehler) auf der Seite Installationsoptionen auswählen auf Warnung eingestellt ist, können standardmäßig mehrere Validierungswarnungen angezeigt werden. Wenn die Einstellung den Wert Fehler hat, können die Validierungswarnungen zu Fehlern führen.

Wenn Sie eine Ausnahme des Typs "OutOfMemory" empfangen und die Quellenanwendungsdatei nicht installiert wird, ist der Systemspeicher möglicherweise unzureichend oder die Anwendung enthält zu viele Module, um auf dem Server installiert werden zu können. Prüfen Sie in diesem Fall die Datei SystemOut.log oder SystemErr.log und die FFDC-Protokolldateien (First-Failure Data Capture, Erfassung von Fehlerdaten beim ersten Auftreten) der Maschinen, die an dem Fehler beteiligt sind, um festzustellen, bei welchen Java-Prozessen auf welchem System der Fehler aufgetreten ist. Versuchen Sie, auf dem System, auf dem die Ausnahme ausgelöst wurde, den Wert für die maximale Java-Heapspeichergröße um 256 MB zu erhöhen. Weitere Informationen finden Sie in der Dokumentation zur Optimierung von IBM Virtual Machine for Java. Nachdem Sie die maximale Java-Heapspeichergrößeangepasst haben, versuchen Sie erneut, die Anwendungsdatei zu installieren. Je nach Speichermenge, die für die Installation dieser Anwendung erforderlich ist, muss die maximale Größe des Heapspeichers möglicherweise mehrere Male erhöht werden. Wenn Sie die maximal unterstützte Größe des Heapspeichers für Ihre JVM erreichen und das Problem weiterhin besteht, versuchen Sie, Ihre Anwendung mit weniger Modulen erneut zu packen.

[z/OS]Wenn Sie den Assistenten für Anwendungsinstallation im Browser Internet Explorer verwenden, kann die Anwendungsinstallation fehlschlagen. Der Browser Internet Explorer sendet nicht alle verschlüsselten Daten, die der Server erwartet. Verwenden Sie zum Installieren der Anwendung den Assistenten für Anwendungsinstallation im Browser Firefox 1.5 oder höher, oder verwenden Sie das Tool wsadmin.

[z/OS]Auf z/OS-Betriebssystemen werden Anwendungsdateien, die größer sind als 10 MB, möglicherweise nicht installiert. Wenn die angepasste Eigenschaft protocol_http_large_data_inbound_buffer des Anwendungsservers auf 0 (die Standardeinstellung) gesetzt wird, können Anwendungsdateien, die größer sind als 10 MB nicht installiert werden. Setzen Sie protocol_http_large_data_inbound_buffer auf einen Wert, der größer ist als die Größe der Anwendungsdatei. Wenn die EAR-Datei, die Sie installieren möchten, beispielsweise eine Größe von 15 MB hat, setzen Sie protocol_http_large_data_inbound_buffer auf 20 MB:
  1. Klicken Sie auf Server > Servertypen > WebSphere-Anwendungsserver > Servername > Serverinfrastruktur > Verwaltung > Angepasste Eigenschaften.
  2. Setzen Sie die angepasste Eigenschaft protocol_http_large_data_inbound_buffer des Anwendungsservers auf 20000000.
  3. Stoppen Sie den Anwendungsserver und starten Sie ihn dann erneut.
  4. Versuchen Sie erneut, die EAR-Datei zu installieren.

Nächste Schritte

Gehen Sie nach der Installation der Anwendungsdatei wie folgt vor:

  1. Speichern Sie die Änderungen in Ihrer Konfiguration.

    Klicken Sie beispielsweise unter den Nachrichten zur Anwendungsinstallation auf den Link Speichern.

    Die Anwendung wird in der Administrationskonfiguration registriert und die Anwendungsdateien werden in das Zielverzeichnis kopiert, das ein von Ihnen angegebenes Verzeichnis oder das Standardverzeichnis Stammverzeichnis_des_Anwendungsservers/installedApps/Zellenname ist.

    Für Einzelserverprodukte werden die Anwendungsdateien beim Speichern der Änderungen in das Zielverzeichnis kopiert.

    Bei Mehrserverprodukten werden Dateien auf ferne Knoten kopiert, wenn die Konfiguration auf dem Deployment Manager mit der Konfiguration auf einzelnen Knoten synchronisiert wird.

    Wenn Sie unter den Nachrichten zur Anwendungsinstallation auf den Link Speichern geklickt haben, erscheint erneut die Seite "Anwendungsinstallation vorbereiten". Klicken Sie auf Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen, um die Seite zu verlassen und zu prüfen, ob Ihre Anwendung in der Liste installierter Anwendungen aufgeführt wird.

  2. Starten Sie die Anwendung.
  3. Testen Sie die Anwendung. Geben Sie z. B. in einem Web-Browser den URL der implementierten Anwendung an, und testen Sie die Leistung der Anwendung. Bearbeiten Sie bei Bedarf die Anwendungskonfiguration.

Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_instwiz
Dateiname:trun_app_instwiz.html