Bindungseinstellungen für die Vorbereitung der Anwendungsinstallation

Verwenden Sie diese Seite, um auszuwählen, ob während der Installation alle Installationsoptionen angezeigt und die vorhandenen Bindungen für Ihre Anwendung bzw. Ihr Modul geändert werden sollen. Sie können Standardbindungen für alle unvollständigen Bindungen in der Anwendung bzw. im Modul generieren oder während der Installation bestimmte Bindungen zuordnen.

Diese Seite ist die zweite rste Seite "Anwendungsinstallation vorbereiten".

Klicken Sie zum Anzeigen dieser Seite der Administrationskonsole auf Anwendungen > Neue Anwendung > Neue Unternehmensanwendung , geben Sie den Pfad der Anwendung bzw. des Moduls an, die bzw. das Sie installieren möchten, und klicken Sie anschließend auf Weiter.

Auf der Konsolseite werden möglicherweise nicht alle Bindungsoptionen angezeigt, die in diesem Artikel aufgelistet sind. Der Inhalt der Anwendung bzw. des Moduls, die bzw. das Sie installieren, bestimmt, welche Optionen auf der Konsolseite angezeigt werden. Die Option Zu verwendende Bindungen angeben wird nur angezeigt, wenn Sie eine installierte Anwendung aktualisieren.

Wie soll die Anwendung installiert werden?

Gibt an, ob nur die Installationsoptionen, bei denen Informationen angegeben werden müssen, oder alle Installationsoptionen angezeigt werden sollen.

Option Beschreibung
Direktaufruf - Nur anfragen, wenn weitere Informationen erforderlich sind Zeigt je nach Inhalt Ihrer Anwendung bzw. Ihres Moduls nur die Optionen an, die Ihrer Aufmerksamkeit bedürfen. Verwenden Sie den Direktaufruf, um Ihre Anwendung einfacher installieren zu können, weil nicht alle verfügbaren Installationsoptionen geprüft werden müssen.
Detailliert - Alle Installationsoptionen und -parameter anzeigen Zeigt alle verfügbaren Installationsoptionen an.
Zu verwendende Bindungen angeben

Gibt an, ob Bindungen zusammengeführt werden sollen, wenn Sie Anwendungen aktualisieren, oder ob neue oder vorhandene Bindungen verwendet werden sollen.

Diese Einstellung wird nur angezeigt, wenn Sie eine installierte Anwendung aktualisieren, aber nicht, wenn Sie eine neue Anwendung installieren.

Option Beschreibung
Neue und vorhandene Bindungen mischen Behält die vorhandenen Bindungswerte der installierten Anwendung bei und fügt neue Bindungswerte für unvollständige Bindungen in die aktualisierte Anwendung ein. Verwenden Sie die Option für Zusammenführen, wenn die aktualisierte Anwendung Bindungswerte enthält, die von den Werten abweichen, die für die installierte Anwendung angegeben sind. Das Produkt ordnet die Bindungswerte in der folgenden Reihenfolge zu:
  1. Vorhandene Bindungswerte in der installierten Anwendung verwenden.
  2. Wenn die installierte Anwendung keinen Bindungswert hat, den neuen Bindungswert verwenden.
  3. Wenn die installierte Anwendung und die aktualisierte Anwendung keinen Bindungswert haben, den Standardwert verwenden. Das Produkt ordnet nur dann einen Standardwert zu, wenn Sie Standardbindungen generieren auswählen.
Neue Bindungen verwenden Verwendet Bindungswerte in der aktualisierten Anwendung. Verwendet keine vorhandenen Bindungswerte in der installierten Anwendung.
Vorhandene Bindungen verwenden Verwendet vorhandene Bindungswerte in der installierten Anwendung. Verwendet keine Bindungswerte in der aktualisierten Anwendung.
Standardbindungen generieren

Gibt an, ob Standardbindungen und -zuordnungen generiert werden sollen. Zum Anzeigen dieser Einstellung klicken Sie auf Auswahl für die Generierung von Standardbindungen und -zuordnungen. Wenn Sie Standardbindungen generieren auswählen, vervollständigt das Produkt alle unvollständigen Bindungen in der Anwendung mit Standardwerten. Das Produkt ändert keine vorhandenen Bindungen.

Nach der Auswahl von Standardbindungen generieren können Sie direkt mit dem Schritt "Zusammenfassung" fortfahren und die Anwendung installieren, wenn keiner der Schritte mit einem roten Stern (*) markiert ist. Ein roter Stern gibt an, dass der entsprechende Schritt unvollständige Daten hat und einen gültigen Wert benötigt. Prüfen Sie in der Anzeige "Zusammenfassung" die Zelle, den Knoten und den Server, auf dem die Anwendung installiert ist.

Hinweis zur Umstellung: Sie müssen keine JNDI-Werte (Java Naming and Directory Interface) für die EJB-Bean-Schnittstelle, die lokale Home-Schnittstelle, die ferne Home-Schnittstelle oder die Geschäftsschnittstelle der EJB-Module der Version 3.0 angeben. Das Produkt ordnet zur Laufzeit Containerstandardwerte zu. Für EJB-Referenzen in einem EJB-Modul der Version 3.0, Webmodul der Version 2.4 oder Webmodul der Version 2.5 müssen Sie ebenfalls keine JNDI-Werte angeben, weil das Produkt die Zeile zur Laufzeit automatisch auflöst. Selbst wenn Sie Standardbindungen generieren auswählen, generiert das Produkt keine Standardwerte für diese JNDI-Werte. Das Produkt generiert nur Standardwerte für andere Bindungen, wie z. B. den virtuellen Host. trns

Wenn Sie Standardbindungen generieren auswählen, generiert das Produkt Standardbindungen wie folgt:

  • EJB-JNDI-Namen werden im Format Präfix/EJB-Name generiert. Das Standardpräfix ist ejb, es kann jedoch überschrieben werden. Der EJB-Name entspricht der Angabe im Tag <ejb-name> des Implementierungsdeskriptors bzw. in der entsprechenden Annotation für EJB-Module der Version 3.0. Das Produkt generiert keine Standardwerte für Enterprise-Beans in einem EJB-Modul der Version 3.0, weil die Laufzeitumgebung Containerstandardwerte bereitstellt.
  • EJB-Referenzen werden gebunden, wenn ein Element <ejb-link> gefunden wird. Wird eine eindeutige Bean mit einer übereinstimmenden Home- oder lokalen Home-Schnittstelle als referenzierte Bean ermittelt, wird die Referenz automatisch aufgelöst. Das Produkt generiert keine Standardwerte für EJB-Referenzen in einem EJB-Modul der Version 3.0, Webmodul der Version 2.4 oder Webmodul der Version 2.5, weil die Laufzeitumgebung Containerstandardwerte bereitstellt oder die Zielreferenzen automatisch auflöst.
  • Ressourcenreferenzbindungen werden aus dem Tag <res-ref-name> bzw. der entsprechenden Annotation für Java-EE-Module (Java Platform, Enterprise Edition) abgeleitet. Diese Aktion setzt voraus, dass der java:comp/env-Name dem globalen JNDI-Namen der Ressource entspricht.
  • Verbindungs-Factory-Bindungen für JAR-Dateien der EJB Version 2.0 und EJB 2.1 werden auf der Basis des JNDI-Namens und der bereitgestellten Berechtigungsoptionen generiert. Diese Aktion führt dazu, dass Standardverbindungs-Factory-Einstellungen für jede JAR-Datei eines EJB-Moduls der Version 2.0 und EJB-Moduls der Version 2.1 in der zu installierenden Anwendung erstellt werden. Es werden keine Bindungen von Verbindungs-Factorys auf Bean-Ebene generiert.
  • Datenquellenbindungen für JAR-Dateien von EJB-Modulen der Version 1.1 werden auf der Basis des JNDI-Namens, des Benutzernamens und des Kennworts der Datenquelle generiert. Diese Aktion führt dazu, dass Standarddatenquelleneinstellungen für jede JAR-Datei erstellt werden. Es werden keine Bindungen von Datenquellen auf Bean-Ebene generiert.
  • Für nachrichtengesteuerte Beans der EJB-Version 2.0 oder höher, die als JCA-1.5-kompatible (Java EE Connector Architecture) Ressourcen implementiert wurden, werden die JNDI-Namen für activationSpec-Instanzen im Format eis/Name_der_MDB-EJB generiert. Referenzen auf Nachrichten-Destinations werden gebunden, wenn ein Tag <message-destination-link> gefunden wird. Anschließend wird der JNDI-Name auf ejs/message-destination-linkName gesetzt. Andernfalls wird der JNDI-Name auf eis/message-destination-refName gesetzt.
  • Für nachrichtengesteuerte Beans der EJB-Version 2.0 oder höher, die für Listener-Ports implementiert wurden, werden die Listener-Ports aus dem Tag <ejb-name> der nachrichtengesteuerten Bean abgeleitet, und anschließend wird die Zeichenfolge Port angefügt.
  • Für Dateien mit der Erweiterung .war wird der virtuelle Host mit default_host definiert, sofern keine andere Angabe vorhanden ist.

Das Standardverfahren ist für die meisten Anwendungen oder zumindest für die meisten Bindungen in den meisten Anwendungen ausreichend. Wenn Fehler auftreten, führen Sie die folgenden Aktionen aus:

  • Kontrollieren Sie die globalen JNDI-Namen einer oder mehrerer EJB-Dateien.
  • Kontrollieren Sie die Datenquellenbindungen für CMP-Beans (Container-Managed Persistence, über Container realisierte Transaktionspersistenz). Das bedeutet, Sie haben mehrere Datenquellen und benötigen mehrere globale Datenquellen.
  • Ordnen Sie den JNDI-Namen der globalen Ressource Ressourcenreferenzen zu, die vom java:comp/env-Namen abweichen.

In diesen Fällen können Sie das Verhalten mit einem XML-Dokument ändern. Dies ist eine angepasste Strategie. Verwenden Sie die Einstellung Bindungsdatei angeben, um beispielsweise eine angepasste Strategie anzugeben und die Einstellungsbeschreibung in dieser Hilfedatei anzuzeigen.

Vorhandene Bindungen überschreiben

Gibt an, ob generierte Bindungen vorhandene Bindungen überschreiben.

Standardmäßig werden keine vorhandenen Bindungen überschrieben. Wählen Sie Vorhandene Bindungen überschreiben aus, wenn generierte Bindungen vorhandene Bindungen ersetzen sollen.

Die Option Vorhandene Bindungen überschreiben gleicht der Scripting-Option -defaultbinding.force.

Spezifische Bindungsdatei

Gibt eine Bindungsdatei an, die die Standardbindung überschreibt.

Die Option Spezifische Bindungsdatei gleicht der Scripting-Option -defaultbinding.strategy.file.

Ändern Sie das Verhalten der Standardbindung mit Hilfe eines XML-Dokuments. Dies ist eine angepasste Strategie. Angepasste Strategien erweitern die Standardstrategie, so dass Sie nur die Bereiche, in denen die Standardstrategie unzureichend ist, anpassen müssen. Sie müssen also nur beschreiben, wie die nach der Standardstrategie generierten Bindungen geändert werden sollen. Es ist nicht erforderlich, die Bindungen für die gesamte Anwendung zu definieren.

Verwenden Sie die folgenden Beispiele, um verschiedene Aspekte des Generators für Standardbindungen zu überschreiben:

EJB-JNDI-Namen kontrollieren

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>helloEjb.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
         <ejb-name>HelloEjb</ejb-name>
         <jndi-name>com/acme/ejb/HelloHome</jndi-name>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>
Hinweis: Stellen Sie sicher, dass die Einstellung für <ejb-name> mit dem ejb-name-Eintrag im Implementierungsdeskriptor der EJB-JAR-Datei entspricht. Im Folgenden ist die Einstellung <ejb-name>HelloEjb</ejb-name>.

Verbindungs-Factory-Bindung für eine EJB-JAR-Datei festlegen

<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>yourEjb20.jar</jar-name>
      <connection-factory>
        <jndi-name>eis/jdbc/YourData_CMP</jndi-name>
        <res-auth>Container</res-auth>
      </connection-factory>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

Verbindungs-Factory-Bindung für eine EJB-Datei festlegen

<?xml version="1.0">
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>yourEjb20.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
          <ejb-name>YourCmp20</ejb-name>
          <connection-factory>
           <jndi-name>eis/jdbc/YourData_CMP</jndi-name>
           <res-auth>PerConnFact</res-auth>
          </connection-factory>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
 </module-bindings>
</dfltbndngs>
Einschränkung: Stellen Sie sicher, dass die Einstellung für <ejb-name> mit dem ejb-name-Tag im Implementierungsdeskriptor entspricht. Im Folgenden ist die Einstellung <ejb-name>YourCmp20</ejb-name>.

JNDI-Namen für die Referenz auf die Nachrichten-Destination für eine bestimmte Enterprise-Bean festlegen

Dieses Beispiel zeigt einen XML-Auszugt aus einer angepassten Strategiedatei für die Festlegung von "message-destination-refs"-Elementen für eine bestimmte Enterprise-Bean.

<?xml version="1.0">
 <!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
 <dfltbndngs>
  <module-bindings>
   <ejb-jar-binding>
    <jar-name>yourEjb21.jar</jar-name>
    <ejb-bindings>
     <ejb-binding>
      <ejb-name>YourSession21</ejb-name> 
      <message-destination-ref-bindings>
       <message-destination-ref-binding>
        <message-destination-ref-name>jdbc/MyDataSrc</message-destination-ref-name>
        <jndi-name>eis/somAO</jndi-name>
       </message-destination-ref-binding>
      </message-destination-ref-bindings>
     </ejb-binding>
    </ejb-bindings>
   </ejb-jar-binding>
  </module-bindings>
 </dfltbndngs>
Einschränkung: Stellen Sie sicher, dass die Einstellung für <ejb-name> mit dem ejb-name-Tag im Implementierungsdeskriptor entspricht. Im Folgenden ist die Einstellung <ejb-name>YourSession21</ejb-name>. Stellen Sie sicher, dass die Einstellung für <message-destination-ref-name> mit dem message-destination-ref-name-Tag im Implementierungsdeskriptor entspricht. Im Folgenden ist die Einstellung <message-destination-ref-name>jdbc/MyDataSrc</message-destination-ref-name>.

Ressourcenreferenzbindung aus einer WAR-, EJB-JAR- oder Java-EE-Client-JAR-Datei überschreiben

Dieses Beispiel zeigt den Code für das Überschreiben einer Ressourcenreferenzbindung aus einer WAR-Datei. Sie können einen ähnlichen Code verwenden, um die Ressourcenreferenzbindung aus einer EJB-JAR-Datei oder der JAR-Datei eines Java-EE-Clients zu überschreiben.

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <war-binding>
      <jar-name>hello.war</jar-name>
      <resource-ref-bindings>
        <resource-ref-binding>
          <resource-ref-name>jdbc/MyDataSrc</resource-ref-name>
          <jndi-name>war/override/dataSource</jndi-name>
        </resource-ref-binding>
      </resource-ref-bindings>
    </war-binding>
  </module-bindings>
</dfltbndngs>
Einschränkung: Stellen Sie sicher, dass die Einstellung für <resource-ref-name> mit dem resource-ref-Tag im Implementierungsdeskriptor entspricht. Im vorherigen Beispiel ist die Einstellung <resource-ref-name>jdbc/MyDataSrc</resource-ref-name>.

JNDI-Namen für eine als JCA-1.5-kompatible Ressource implementierte MDB überschreiben

Dieses Beispiel zeigt einen XML-Auszug aus einer angepassten Strategiedatei, mit dem der JNDI-Name der JMS-Aktivierungsspezifikation für eine nachrichtengesteuerte Bean der EJB-Version 2.0 oder höher überschrieben werden kann, die als JCA-1.5-konforme Ressource implementiert ist.

<?xml version="1.0"?>
 <!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
  <dfltbndngs>
  <module-bindings>
   <ejb-jar-binding>
     <jar-name>YourEjbJar.jar</jar-name>
     <ejb-bindings>
      <ejb-binding>
        <ejb-name>YourMDB</ejb-name>
        <activationspec-jndi-name>activationSpecJNDI</activationspec-jndi-name>
      </ejb-binding>
     </ejb-bindings>
   </ejb-jar-binding>
  </module-bindings>
 </dfltbndngs>

Namen des JMS-Listener-Port für eine EJB-2.0, EJB-2.1- oder EJB-3.0-MDB überschreiben

Dieses Beispiel zeigt einen XML-Auszug aus einer angepassten Strategiedatei, mit dem der JMS-Listener-Portname für eine nachrichtengesteuerte Bean der EJB-Version 2.0 oder höher überschrieben wird, der für einen Listener-Port implementiert wurde.

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>YourEjbJar.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
          <ejb-name>YourMDB</ejb-name>
          <listener-port>yourMdbListPort</listener-port>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

EJB-Referenzbindung aus einer EJB-JAR-, WAR- oder EJB-Datei überschreiben

Dieses Beispiel zeigt Code, mit dem eine EJB-Referenzbindung aus einer EJB-JAR-Datei überschrieben wird. Sie können ähnlichen Code verwenden, um eine EJB-Referenzbindung in einer WAR-Datei oder einer EJB-Datei zu überschreiben.

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>YourEjbJar.jar</jar-name>
      <ejb-ref-bindings>
        <ejb-ref-binding>
          <ejb-ref-name>YourEjb</ejb-ref-name>
          <jndi-name>YourEjb/JNDI</jndi-name>
        </ejb-ref-binding>
      </ejb-ref-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>
Eindeutiges Präfix für Beans angeben

Gibt eine Zeichenfolge an, die das Produkt auf den Anfang generierter JNDI-Namen von Enterprise-Beans anwendet. Das Präfix muss innerhalb der Zelle bzw. auf dem Knoten eindeutig sein.

Standardmäßig wird kein eindeutiges Präfix für Beans angegeben.

Sie Option Eindeutiges Präfix für Beans angeben gleicht der Scripting-Option -defaultbinding.ejbjndi.prefix.

Standardbindungen für CMP-Beans der EJB-Version 1.1

Gibt den JNDI-Namen der Standarddatenquelle und andere Bindungen für CMP-Beans der Version 1.1 an.

Standardmäßig werden keine Standardbindungen für CMP-Beans der EJB-Version 1.1 verwendet.

Wenn Sie Standardbindungen für CMP-Beans der EJB-Version 1.1 auswählen, geben Sie den JNDI-Namen für die Standarddatenquelle an, die für die CMP-Beans der Version 1.1 verwendet werden soll. Geben Sie auch den Benutzernamen und das Kennwort für diese Standarddatenquelle an.

Die Option Standardbindungen für CMP-Beans der EJB-Version 1.1 gleicht der Scripting-Option -defaultbinding.datasource.jndi.

Bindungen der Standardverbindungs-Factory

Gibt den JNDI-Namen für die Standardverbindungs-Factory an.

Standardmäßig werden keine Bindungen für die Standardverbindungs-Factory verwendet. Wählen Sie Bindungen der Standardverbindungs-Factory aus, um Bindungen für Verbindungs-Factorys anzugeben.

Wenn Sie Bindungen der Standardverbindungs-Factory auswählen, geben Sie den JNDI-Namen für die zu verwendende Standardverbindungs-Factory an. Geben Sie auch an, ob die Ressourcenberechtigung für die Anwendung oder containerweit gelten soll.

Die Option Bindungen der Standardverbindungs-Factory gleicht der Scripting-Option -defaultbinding.cf.jndi.

Virtuellen Standardhost für Web- bzw. SIP-Module verwenden

Gibt den virtuellen Host für das Webmodul ((WAR-Datei) bzw. SIP-Modul (SAR-Datei) an.

Standardmäßig wird kein virtueller Standardhostname für Web- oder SIP-Module verwendet. Wenn Sie Virtuellen Standardhost für Web- bzw. SIP-Module verwenden: auswählen, geben Sie einen Standardhostnamen an.

Die Option Virtuellen Standardhost für Web- bzw. SIP-Module verwenden gleicht der Scripting-Option -defaultbinding.virtual.host.




Mit (online) gekennzeichnete Links setzen einen Internet-Zugang voraus.

Zugehörige Konzepte
Zugehörige Tasks
Zugehörige Informationen
Einstellungen für die Vorbereitung der Anwendungsinstallation


Dateiname: urun_rapp_instw_gendefbind.html