Przygotowanie ustawień powiązań instalacji aplikacji

Ta strona umożliwia wybór, czy wyświetlać wszystkie opcje instalacji i czy zmieniać istniejące powiązania dla aplikacji lub modułu podczas instalowania. Użytkownik może wybrać generowanie powiązań domyślnych dla niekompletnych powiązań w aplikacji lub module albo przypisać konkretne powiązania podczas instalacji.

Ta strona jest drugą stroną zawierającą czynności przygotowawcze na potrzeby instalacji aplikacji.

Aby wyświetlić tę stronę Konsoli administracyjnej, należy kliknąć opcję Aplikacje > Nowa aplikacja > Nowa aplikacja korporacyjna, podać ścieżkę aplikacji lub modułu do zainstalowania, a następnie kliknąć przycisk Dalej.

Na stronie konsoli mogą nie zostać wyświetlone wszystkie opcje powiązań wymienione w temacie. Treść instalowanego modułu lub aplikacji określa, które opcje są wyświetlane na stronie konsoli. Opcja Określ powiązania do użycia jest wyświetlana tylko podczas aktualizowania zainstalowanej aplikacji.

Jak chcesz zainstalować aplikację?

Określa, czy mają być pokazywane tylko te opcje, których wymagasz do dostarczenia informacji, czy też wszystkie opcje instalacji.

Tabela 1. Opisy opcji instalacji. Użytkownik może skorzystać z krótkiej ścieżki lub wybrać podgląd wszystkich opcji i parametrów instalacji.
Opcja	Opis
Krótka ścieżka - pytaj tylko wtedy, gdy wymagane są dodatkowe informacje	Wyświetla tylko te opcje, w przypadku których wymagana jest uwaga użytkownika, na podstawie treści aplikacji lub modułu. Krótka ścieżka umożliwia zainstalowanie aplikacji łatwiej, ponieważ nie ma konieczności sprawdzania wszystkich dostępnych opcji instalacyjnych.
Szczegółowa - wyświetl wszystkie opcje i parametry instalacji	Wyświetla wszystkie dostępne opcje instalacji.

Określ powiązania do użycia

Określa, czy scalać powiązania podczas aktualizowania aplikacji, czy też użyć nowych lub istniejących powiązań.

To ustawienie jest wyświetlane w przypadku aktualizowania zainstalowanej aplikacji, a nie w przypadku instalowania nowej aplikacji.

Tabela 2. Opisy opcji powiązania. Użytkownik może skorzystać z powiązań scalonych, nowych oraz istniejących.
Opcja	Opis
Scal nowe i istniejące powiązania	Informacje dotyczące powiązania zawarte w zaktualizowanej aplikacji lub modułach są informacjami preferowanymi w stosunku do odpowiednich informacji pochodzących z zainstalowanej wersji aplikacji. W przypadku braku któregokolwiek elementu powiązania w wersji zaktualizowanej używany jest odpowiedni element z zainstalowanej wersji aplikacji. Jeśli zarówno zainstalowana aplikacja, jak i zaktualizowana aplikacja lub moduł, nie zawierają wartości powiązania, używana jest wartość domyślna. Produkt przypisuje wartość domyślną tylko wtedy, gdy zostanie wybrana opcja Generuj powiązania domyślne.
Użyj nowych powiązań	Używane są informacje dotyczące powiązania zawarte w zaktualizowanej aplikacji lub module. Informacje dotyczące powiązania zawarte w zaktualizowanej wersji aplikacji lub modułu są informacjami preferowanymi w stosunku do odpowiednich informacji pochodzących z zainstalowanej wersji aplikacji. Informacje te zawarte w zainstalowanej wersji aplikacji lub modułu są ignorowane.
Użyj istniejących powiązań	Informacje dotyczące powiązania zawarte w zainstalowanej wersji aplikacji lub modułu są informacjami preferowanymi w stosunku do odpowiednich informacji pochodzących ze zaktualizowanej wersji aplikacji. W przypadku braku któregokolwiek elementu informacji dotyczących powiązania w zainstalowanej wersji aplikacji używany jest element z wersji zaktualizowanej. Oznacza to, że powiązania zawarte w zaktualizowanej wersji aplikacji lub modułu są ignorowane pod warunkiem, że istnieje powiązanie w zainstalowanej wersji aplikacji. W przeciwnym razie honorowane są nowe powiązania i nie są one ignorowane.

Generuj powiązania domyślne

Określa, czy mają być generowane domyślne powiązania i odwzorowania. Aby wyświetlić to ustawienie, należy rozwinąć sekcję Wybierz, aby generowane były domyślne powiązania i odwzorowania. Jeśli zostanie wybrana opcja Generuj powiązania domyślne, produkt uzupełni wszystkie niekompletne powiązania w aplikacji za pomocą wartości domyślnych. Produkt nie zmieni istniejących powiązań.

Po wybraniu opcji Generuj powiązania domyślne można przejść bezpośrednio do kroku Podsumowanie i zainstalować aplikację, jeśli żaden z kroków nie jest oznaczony symbolem gwiazdki (*) w kolorze czerwonym. Czerwona gwiazdka informuje o tym, że dane w tym kroku są niekompletne i wymagają podania poprawnej wartości. Na stronie Podsumowanie należy sprawdzić komórkę, węzeł i serwer, na którym jest instalowana aplikacja.

Przejście: nie trzeba podawać wartości JNDI (Java Naming and Directory Interface) dla komponentu EJB, lokalnego interfejsu podstawowego, zdalnego interfejsu podstawowego ani interfejsów biznesowych modułów komponentów EJB 3.0 lub nowszych. Produkt przypisuje kontenerowi wartości domyślne w czasie wykonywania. Podobnie w przypadku dowolnego odwołania EJB w module komponentu EJB 3.0, EJB 3.1, Web 2.4 lub Web 2.5 nie ma konieczności określania wartości JNDI, ponieważ produkt rozstrzyga miejsca docelowe automatycznie w czasie wykonywania. Nawet jeśli zostanie wybrana opcja Generuj powiązania domyślne, produkt nie wygeneruje domyślnych wartości dla tych wartości JNDI, ale wygeneruje domyślne wartości dla innych powiązań, na przykład dla wirtualnego hosta.

Jeśli zostanie wybrana opcja Generuj powiązania domyślne produkt wygeneruje następujące powiązania:

Nazwy JNDI komponentu EJB są generowane w postaci przedrostek/nazwa_EJB. Domyślnym przedrostkiem jest ejb, można go jednak zmienić. Parametr nazwa_EJB jest określony w znaczniku <ejb-name> deskryptorów wdrażania lub w odpowiadającej mu adnotacji dla modułów komponentów EJB 3.0 lub nowszych. Produkt nie generuje domyślnych wartości komponentów EJB w modułach komponentów EJB 3.0 lub nowszych, ponieważ środowisko wykonawcze udostępnia wartości domyślne kontenera.
Odwołania komponentów EJB zostaną powiązane, jeśli znaleziony zostanie parametr <ejb-link>. W przeciwnym razie, jeśli unikalny komponent EJB zostanie odnaleziony wraz z odpowiadającym mu interfejsem głównym (lub lokalnym interfejsem głównym) jako komponent EJB stanowiący odwołanie, rozstrzygniecie odwołania nastąpi automatycznie. Produkt nie generuje domyślnych wartości dla odwołania komponentu EJB w module komponentu EJB 3.0, EJB 3.1, Web 2.4 lub Web 2.5, ponieważ środowisko wykonawcze udostępnia wartości domyślnego kontenera lub automatycznie rozstrzyga odwołania do miejsca docelowego.
Powiązania odwołania do zasobów są określane na podstawie znacznika <res-ref-name> lub odpowiadającej mu adnotacji dla modułów Java Platform, Enterprise Edition (Java EE) 5 lub 6. W tym działaniu zakłada się, że nazwa java:comp/env jest tą samą nazwą co nazwa JNDI zasobu globalnego.
Powiązania fabryki połączeń dla plików JAR EJB 2.0 i EJB 2.1 są generowane na podstawie udostępnionej nazwy JNDI i informacji uwierzytelniających. Wynikiem tego działania są domyślne ustawienia fabryki połączeń dla każdego pliku JAR komponentu EJB 2.0 i EJB 2.1 w instalowanej aplikacji. Powiązania fabryki połączeń na poziomie komponentów EJB nie są generowane.
Powiązania źródła danych dla plików JAR komponentów EJB w wersji 1.1 są generowane w oparciu o opcje nazwy JNDI, nazwy użytkownika źródła danych i hasła. To działanie skutkuje domyślnymi ustawieniami źródła danych dla każdego pliku JAR. Powiązania źródeł danych na poziomie komponentów EJB nie są generowane.
W przypadku komponentów EJB 2.0 lub późniejszych sterowanych komunikatami komponentów Bean wdrożonych jako zasoby zgodne z architekturą JCA (Java EE Connector Architecture) w wersji 1.5 nazwy JNDI odpowiadające instancjom activationSpec są generowane w postaci eis/nazwa_MDB_ejb. Powiązania odwołań docelowego miejsca komunikatu są przypisywane, jeśli parametr <message-destination-link> zostanie odnaleziony, a następnie nazwa JNDI jest przypisywana do parametru ejs/odsyłacz_do_miejsca_docelowego_komunikatuName. W przeciwnym razie nazwa JNDI jest ustawiana na eis/odwołanie_miejsca_docelowego_komunikatuName.
W przypadku komponentów EJB 2.0 lub nowszych sterowanych komunikatami komponentów bean wdrożonych względem portów nasłuchiwania porty nasłuchiwania są określane na podstawie znacznika <ejb-name> sterowanego komunikatami komponentu Bean z dodanym łańcuchem Port.
W przypadku plików .war wirtualny host jest ustawiony jako host domyślny (default_host), chyba że określono inaczej.

Domyślna strategia wystarcza dla większości aplikacji lub przynajmniej dla większości powiązań w większości aplikacji. Jeśli jednak wystąpią błędy, należy wykonać następujące działania:

Sterować globalnymi nazwami JNDI jednego lub wielu plików EJB.
Sterować powiązaniami źródła danych dla komponentów bean typu CMP (container-managed persistence - trwałość zarządzana przez kontener). czyli posiadasz wiele źródeł danych i potrzebujesz więcej niż jednego globalnego źródła danych.
Odwzorować odwołania zasobów na nazwy JNDI zasobów globalnych różne od nazwy java:comp/env.

W takich przypadkach można zmienić zachowanie z użyciem dokumentu XML, co jest strategią niestandardową. Ustawienie Konkretny plik powiązań umożliwia określenie niestandardowej strategii i na przykład przejrzenie opisu ustawienia w tym pliku pomocy.

Nadpisz istniejące powiązania

Określa, czy powiązania generowane mają zastąpić istniejące.

Ustawieniem domyślnym jest brak nadpisywania istniejących powiązań. Wybranie opcji Nadpisz istniejące powiązania powoduje, że wygenerowane powiązania będą zastępowały istniejące.

Ustawienie Nadpisz istniejące powiązania jest podobne do opcji skryptu -defaultbinding.force.

Używanie domyślnych powiązań Java EE

Określa, czy wygenerowane powiązania mają używać opcji wstępnie skonfigurowanych zasobów domyślnych dla powiązań Java Platform, Enterprise Edition (Java EE).

Domyślnie wstępnie skonfigurowane zasoby domyślne dla powiązań Java EE nie są używane. Aby wygenerowane powiązania były domyślnymi powiązaniami Java EE, należy wybrać opcję Użyj powiązań domyślnych Java EE.

Opcja Użyj powiązań domyślnych Java EE jest podobna do opcji skryptu -defaultbinding.ee.defaults.

Konkretny plik powiązań

Określa plik powiązań nadpisujący powiązanie domyślne.

Opcja Konkretny plik powiązań jest podobna do opcji skryptu -defaultbinding.strategy.file.

Zachowanie powiązania domyślnego można zmienić z użyciem dokumentu XML, który jest strategią niestandardową. Strategie niestandardowe rozszerzają strategię domyślną - wystarczy dostosować tylko te obszary, w których strategia domyślna jest niewystarczająca. Tym samym wystarczy opisać sposób zmiany powiązań generowanych przez strategię domyślną. Nie musisz więc definiować powiązań dla całej aplikacji.

Poniższe przykłady umożliwiają nadpisanie różnych aspektów generatora domyślnych powiązań:

Sterowanie nazwą JNDI komponentu EJB

<?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>

Do zapamiętania: należy upewnić się, że ustawienie <ejb-name> odpowiada pozycji ejb-name w deskryptorze wdrażania JAR komponentu EJB. W tym przypadku to ustawienie to <ejb-name>WitajEjb</ejb-name>.

Ustawianie powiązania fabryki połączeń dla pliku JAR komponentu EJB

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

Ustawianie powiązania fabryki połączeń dla pliku komponentu EJB

<?xml version="1.0">
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>PlikEjb20.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
          <ejb-name>PlikCmp20</ejb-name>
          <connection-factory>
           <jndi-name>eis/jdbc/Dane_CMP</jndi-name>
           <res-auth>DlaFabrykiPolaczen</res-auth>
          </connection-factory>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
 </module-bindings>
</dfltbndngs>

Ograniczenie: należy upewnić się, że ustawienie <ejb-name> odpowiada znacznikowi ejb-name w deskryptorze wdrażania. W tym przypadku to ustawienie to <ejb-name>PlikCmp20</ejb-name>.

Ustawianie nazwy JNDI docelowego odwołania komunikatu dla określonego komponentu EJB

W tym przykładzie pokazano wyodrębnianie elementów XML w pliku strategii niestandardowej dla ustawienia odwołań miejsca docelowego komunikatu dla określonego komponentu EJB.

<?xml version="1.0">
 <!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
 <dfltbndngs>
  <module-bindings>
   <ejb-jar-binding>
    <jar-name>PlikEjb21.jar</jar-name>
    <ejb-bindings>
     <ejb-binding>
      <ejb-name>Sesja21</ejb-name>
      <message-destination-ref-bindings>
       <message-destination-ref-binding>
        <message-destination-ref-name>jdbc/ZrodloDanych</message-destination-ref-name>
        <jndi-name>eis/niektoreAO</jndi-name>
       </message-destination-ref-binding>
      </message-destination-ref-bindings>
     </ejb-binding>
    </ejb-bindings>
   </ejb-jar-binding>
  </module-bindings>
 </dfltbndngs>

Ograniczenie: należy upewnić się, że ustawienie <ejb-name> odpowiada znacznikowi ejb-name w deskryptorze wdrażania. W tym przypadku to ustawienie to <ejb-name>Sesja21</ejb-name>. Upewnij się również, że ustawienie <message-destination-ref-name> odpowiada znacznikowi message-destination-ref-name w deskryptorze wdrażania. W tym przypadku to ustawienie to <message-destination-ref-name>jdbc/ZrodloDanych</message-destination-ref-name>.

Nadpisywanie powiązania odwołania zasobu z pliku WAR, EJB JAR lub pliku JAR klienta Java EE

W tym przykładzie pokazano kod nadpisywania powiązania odwołania zasobu z poziomu pliku WAR. Podobnego kodu można użyć przy nadpisywaniu powiązania odniesienia zasobu w pliku JAR komponentu EJB lub klienta Java EE.

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <war-binding>
      <jar-name>witaj.war</jar-name>
      <resource-ref-bindings>
        <resource-ref-binding>
          <resource-ref-name>jdbc/ZrodloDanych</resource-ref-name>
          <jndi-name>war/override/zrodloDanych</jndi-name>
        </resource-ref-binding>
      </resource-ref-bindings>
    </war-binding>
  </module-bindings>
</dfltbndngs>

Ograniczenie: należy upewnić się, że ustawienie <resource-ref-name> odpowiada znacznikowi resource-ref w deskryptorze wdrażania. W poprzednim przykładzie ustawienie to <resource-ref-name>jdbc/ZrodloDanych</resource-ref-name>.

Nadpisywanie nazwy JNDI dla komponentu bean sterowanego komunikatami wdrażanego jako zasób zgodny ze specyfikacją JCA 1.5

W tym przykładzie przedstawiono wyodrębnianie kodu XML w pliku strategii niestandardowej w celu przesłonięcia nazwy JNDI specyfikacji aktywowania activationSpec usługi Java Message Service (JMS) dla sterowanego komunikatami komponentu EJB w wersji 2.0 lub nowszego jako zasobu zgodnego z architekturą JCA w wersji 1.5 lub nowszej.

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

Nadpisywanie nazwy portu nasłuchiwania usługi JMS dla sterowanego komunikatami komponentu bean EJB w wersji 2.0, 2.1 lub 3.0

W tym przykładzie pokazano fragment kodu XML w pliku strategii niestandardowej nadpisujący nazwę portu nasłuchiwania JMS dla sterowanego komunikatami komponentu EJB w wersji 2.0 lub nowszej wdrażanego względem portu nasłuchiwania.

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

Nadpisywanie powiązania komponentu EJB w pliku JAR komponentu EJB, pliku WAR lub pliku EJB

W tym przykładzie przedstawiono przykładowy kod nadpisywania powiązania odwołania komponentu EJB w pliku JAR EJB. Podobnego kodu można użyć do nadpisania powiązania odwołania komponentu EJB w pliku WAR lub EJB.

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>PlikEjbJar.jar</jar-name>
      <ejb-ref-bindings>
        <ejb-ref-binding>
          <ejb-ref-name>PlikEjb</ejb-ref-name>
          <jndi-name>PlikEjb/JNDI</jndi-name>
        </ejb-ref-binding>
      </ejb-ref-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

Określ unikalny przedrostek dla komponentów bean

Określa łańcuch stosowany przez produkt na początku generowanych nazw JNDI komponentów EJB. Przedrostek musi być unikalny w ramach komórki lub węzła.

Domyślnie unikalny przedrostek dla komponentów bean nie jest określany.

Parametr Określaj unikalny przedrostek dla komponentów bean jest podobny do opcji wykonywania skryptów -defaultbinding.ejbjndi.prefix.

Domyślne powiązania dla komponentów EJB typu CMP w wersji 1.1

Określa domyślną nazwę JNDI domyślnego źródła danych i innych powiązań dla zarządzanych przez kontener komponentów bean (CMP) w wersji 1.1.

Domyślne powiązania nie są używane na potrzeby komponentów bean EJB typu CMP w wersji 1.1.

Jeśli zostanie wybrana opcja Domyślne powiązania dla komponentów EJB typu CMP w wersji 1.1, należy określić nazwę JNDI dla domyślnego źródła danych do użycia z komponentami bean typu CMP w wersji 1.1. Należy również podać nazwę użytkownika i hasło dla tego domyślnego źródła danych.

Ustawienie Domyślne powiązania dla komponentów EJB typu CMP w wersji 1.1 jest podobne do opcji skryptu -defaultbinding.datasource.jndi.

Domyślne powiązania fabryki połączeń

Określa nazwę JNDI domyślnej fabryki połączeń.

Domyślnie powiązania domyślnej fabryki połączeń nie są używane. Wybranie ustawienia Domyślne powiązania fabryki połączeń pozwala określić powiązania dla fabryk połączeń.

Jeśli zostanie wybrana opcja Domyślne powiązania fabryki połączeń, należy określić nazwę JNDI dla domyślnej fabryki połączeń do użycia. Również należy określić, czy uwierzytelnianie zasobu ma być przeprowadzane dla aplikacji czy dla całego kontenera.

Parametr Domyślne powiązania fabryki połączeń jest podobny w działaniu do opcji skryptu -defaultbinding.cf.jndi.

Użyj domyślnej nazwy hosta wirtualnego dla modułów WWW i SIP

Umożliwia określenie wirtualnego hosta modułu WWW (pliku WAR) lub modułu SIP (pliku SAR).

Domyślnie nazwa domyślna hosta wirtualnego dla modułów WWW lub SIP nie jest używana. W przypadku wybrania opcji Użyj domyślnej nazwy hosta wirtualnego dla modułów WWW i SIP należy określić domyślną nazwę hosta.

Parametr Użyj domyślnej nazwy hosta wirtualnego dla modułów WWW i SIP jest podobny w działaniu do opcji skryptu -defaultbinding.virtual.host.

Nazwa pliku: urun_rapp_instw_gendefbind.html