Valores de Preparación para el enlace de instalación de aplicación

Utilice esta página para seleccionar si se debe ver todas las opciones de instalación y para cambiar los enlaces existentes para la aplicación o módulo durante la instalación. Puede elegir generar enlaces predeterminados para cualquier enlace incompleto de la aplicación o del módulo o para asignar enlaces específicos durante la instalación.

Esta página es la segunda página de Preparación para instalar una aplicación.

Para ver esta página de consola administrativa, pulse Aplicaciones > Nueva aplicación > Nueva aplicación de empresa, especifique la vía de acceso para la aplicación o el módulo a instalar y, a continuación, pulse Siguiente.

La página de la consola podría no visualizar todas las opciones de enlace listadas en este tema. El contenido de la aplicación o del módulo que está instalando determina qué opciones se visualizan en la página de la consola. Asimismo, la opción Especificar los enlaces a utilizar sólo se muestra cuando se actualiza una aplicación instalada.

¿Cómo desea instalar la aplicación?

Especifica si se han de mostrar únicamente las opciones de instalación que requieren que proporcione información o mostrar todas las opciones de instalación.

Tabla 1. Descripciones opciones de instalación. Puede seleccionar una vía de acceso rápida o seleccionar ver todas las opciones y parámetros de instalación.
Opción	Descripción
Vía de acceso rápida: solicitar sólo cuando se necesite información adicional	Solamente visualiza aquellas opciones que requieran su atención, basándose en el contenido de la aplicación o módulo. Utilice la vía de acceso rápida para instalar la aplicación de forma más fácil, puesto que no deberá examinar todas las opciones de instalación disponibles.
Detallada: mostrar todas las opciones y todos los parámetros de instalación	Muestra todas las opciones de instalación disponibles.

Especificar los enlaces a utilizar

Especifica si se deben fusionar los enlaces cuando actualice aplicaciones o si se deben utilizar enlaces nuevos o existentes.

Este valor sólo se muestra cuando actualice una aplicación instalada y no cuando instale una aplicación nueva.

Tabla 2. Descripciones de opciones de enlace. Puede utilizar enlaces fusionados, nuevos o existentes.
Opción	Descripción
Fusionar enlaces nuevos y existentes	La información de enlace de la aplicación o módulos actualizados es preferible a la información de enlace correspondiente de la versión instalada. Si falta un elemento del enlace en la versión actualizada, se utiliza el elemento correspondiente de la versión instalada. Si la aplicación o módulo actualizado y el instalado no tiene un valor de enlace, se utiliza el valor predeterminado. El producto asigna un valor predeterminado únicamente si selecciona la opción Generar enlaces predeterminados.
Utilizar enlaces nuevos	Se utiliza la información de enlace en la aplicación o el módulo actualizado. Se prefiere la información de enlace de la versión actualizada de la aplicación o el módulo a la información de enlace correspondiente de la versión instalada. La información de enlaces de la versión instalada de la aplicación o módulo se ignora.
Utilizar enlaces existentes	Se prefiere la información de enlaces de la versión instalada de la aplicación o el módulo a la información de enlaces correspondiente de la versión actualizada. Si en la versión instalada no existe un elemento de la información de enlace, se utiliza el elemento de la versión actualizada. Es decir, los enlaces de la versión actualizada de la aplicación o el módulo se omiten si existe un enlace en la versión instalada. De lo contrario, los nuevos enlaces se aceptan y no se omiten.

Generar enlaces predeterminados

Especifica si se deben generar enlaces y correlaciones por omisión. Para ver este valor, expanda Elija generar enlaces y correlaciones predeterminados. Si selecciona Generar enlaces predeterminados, el producto completará todos los enlaces incompletos de la aplicación con valores predeterminados. El producto no cambia los enlaces existentes.

Después de seleccionar Generar enlaces predeterminados, puede avanzar directamente al paso Resumen e instalar la aplicación si ninguno de los pasos aparece acompañado de un asterisco (*) rojo. Un asterisco rojo indica que el paso presenta datos incompletos y es necesario un valor válido. En la página Resumen, verifique la célula, el nodo y el servidor en el que se instala la aplicación.

Transición: No es necesario especificar valores de JNDI (Java Naming and Directory Interface) para interfaces de empresa, inicio remoto, inicio local o bean EJB de módulos de EJB 3.0 o posteriores. El producto asigna valores de contenedor predeterminados durante la ejecución. De forma parecida, para cualquier referencia de EJB de un módulo EJB 3.0, EJB 3.1, Web 2.4 o Web 2.5, no es necesario que especifique valores JNDI porque el producto resuelve los destinos automáticamente durante la ejecución. Aunque seleccione Generar enlaces predeterminados, el producto no genera valores predeterminados para esos valores JNDI, pero genera valores predeterminados para otros enlaces como, por ejemplo, host virtual.

Si selecciona Generar enlaces predeterminados, el producto genera enlaces como se indica a continuación:

Los nombres EJB (Enterprise bean) JNDI se generan con el formatoprefijo/nombre-ejb. El prefijo por omisión es ejb, pero se puede alterar temporalmente. El valor nombre-ejb es el que se especifica en el distintivo <ejb-name> de los descriptores de despliegue o en su correspondiente anotación para los módulos EJB 3.0 o posteriores. El producto no genera valores predeterminados para enterprise beans de un módulo EJB 3.0 o posterior porque el tiempo de ejecución proporciona valores de contenedor predeterminados.
Las referencias EJB se enlazan si se encuentra un <ejb-link>. De lo contrario, si se encuentra un enterprise bean exclusivo que coincida con una interfaz de factoría (o factoría local) como bean referenciado, la referencia se resuelve automáticamente. El producto no genera valores predeterminados para las referencias EJB de un módulo EJB 3.0, EJB 3.1, Web 2.4 o Web 2.5 puesto que el tiempo de ejecución proporciona valores de contenedor predeterminados o resuelve automáticamente las referencias de destino.
Los enlaces de referencia de recursos se derivan del distintivo <res-ref-name> o de su correspondiente anotación para módulos Java Platform, Enterprise Edition (Java EE) 5 o 6. En esta acción se asume que el nombre java:comp/env es el mismo que el nombre JNDI global del recurso.
Los enlaces de fábrica de conexiones para archivos JAR EJB 2.0 y EJB 2.1 se generan a partir del nombre JNDI y de la información de autorización que se proporcionan. Esta acción se traduce en valores de fábrica de conexiones predeterminada para cada archivo JAR EJB 2.0 y EJB 2.1 de la aplicación que se va a instalar. No se genera ningún enlace de fábrica de conexiones a nivel de bean.
Los enlaces de origen de datos para los archivos JAR EJB 1.1 se generan basándose en las opciones de nombre JNDI, de nombre de usuario de origen de datos y de contraseña. Esta acción se traduce en valores de origen de datos predeterminado para cada archivo JAR. No se generará ningún enlace de origen de datos a nivel de bean.
Para los beans controlados por mensajes EJB 2.0 o posterior desplegados como recursos compatibles con JCA (Java EE Connector Architecture) 1.5, los nombres JNDI correspondientes a las instancias de activationSpec se generan con el formato eis/nombre-ejb_MDB. Las referencias de destinos de mensajes se enlazan si se encuentra un <enlace-destino-mensaje>, entonces el nombre JNDI se establece en ejs/enlace-destino-nombreNombre. De lo contrario, el nombre JNDI se establece en eis/ref-destino-mensajeNombre.
Para los beans controlados por mensaje EJB 2.0 o posterior desplegados en puertos de escucha, los puertos de escucha se derivan del distintivo <ejb-name> del bean controlado por mensaje con la serie Port añadida.
Para los archivos .war, el host se establece como default_host, a menos que se especifique lo contrario.

La estrategia predeterminado es suficiente para la mayoría de las aplicaciones o, por lo menos, para la mayoría de los enlaces de casi todas las aplicaciones. Sin embargo, si tiene errores, realice las siguientes acciones:

Controle los nombres JNDI globales de uno o varios archivos EJB.
Controle los enlaces de origen de datos de los beans de persistencia gestionada por contenedor (CMP). Es decir, dispone de varios orígenes de datos y necesita más de un origen de datos global.
Correlacione las referencias de recursos con nombres JNDI de recursos globales que sean diferentes del nombre java:comp/env.

En estos casos, puede modificar el comportamiento con un documento XML, que es una estrategia personalizada. Utilice el valor de Archivo de enlaces específicos para especificar una estrategia personalizada y ver la descripción del valor en este archivo de ayuda para obtener ejemplos.

Alterar temporalmente enlaces existentes

Especifica si se deben sustituir los enlaces existentes por enlaces generados.

El valor predeterminado es no alterar temporalmente los enlaces existentes. Seleccione Alterar temporalmente enlaces existentes para que los enlaces generados sustituyan los enlaces existentes.

Alterar temporalmente enlaces existentes es similar a la opción de scripting -defaultbinding.force.

Utilizar enlaces predeterminados Java EE

Especifica si los enlaces generados deben utilizar la opción de recursos predeterminados preconfigurada para enlaces Java Platform, Enterprise Edition (Java EE).

El valor predeterminado es no utilizar recursos predeterminados preconfigurados para enlaces Java EE. Seleccione Utilizar enlaces predeterminados Java EE para que los enlaces generados sean Java EE predeterminados.

Utilizar enlaces predeterminados Java EE es similar a la opción de script -defaultbinding.ee.defaults.

Archivo de enlaces específicos

Especifica el archivo de enlaces que altera temporalmente el enlace predeterminado.

Archivo de enlaces específicos es similar a la opción de scripting -defaultbinding.strategy.file.

Modifique el comportamiento del enlace predeterminado con un documento XML, que es una estrategia personalizada. Las estrategias personalizadas amplían la estrategia predeterminada de forma que sólo necesita personalizar aquellas áreas donde la estrategia predeterminada es insuficiente. De este modo sólo necesita describir cómo desea modificar los enlaces generados por la estrategia predeterminada. No es necesario que defina enlaces para toda la aplicación.

Utilice los siguientes ejemplos para alterar temporalmente varios aspectos del generador de enlaces predeterminados:

Control de un nombre JNDI de 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>

Recuerde: Asegúrese de que el valor para <ejb-name> coincide con la entrada ejb-name en el descriptor de despliegue JAR EJB . En el ejemplo el valor es <ejb-name>HelloEjb</ejb-name>.

Definición del enlace de la fábrica de conexiones para un archivo JAR EJB

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

Definición del enlace de la fábrica de conexiones para un archivo EJB

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

Restricción: Asegúrese de que el valor para <ejb-name> coincide con la etiqueta ejb-name en el descriptor de despliegue. En el ejemplo el valor es <ejb-name>YourCmp20</ejb-name>.

Definición del JNDI de referencia de destino de mensaje para un enterprise bean específico

Este ejemplo muestra un extracto XML de un archivo de estrategia personalizada para establecer message-destination-refs para un enterprise bean específico.

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

Restricción: Asegúrese de que el valor para <ejb-name> coincide con la etiqueta ejb-name en el descriptor de despliegue. En el ejemplo el valor es <ejb-name>YourSession21</ejb-name>. Además, asegúrese de que el valor para <message-destination-ref-name> coincide con el distintivo message-destination-ref-name en el descriptor de despliegue. En el ejemplo el valor es <message-destination-ref-name>jdbc/MyDataSrc</message-destination-ref-name>.

Alteración de un enlace de referencia de recurso de un archivo WAR, JAR EJB o un archivo JAR de cliente Java EE

Este ejemplo muestra código que permite alterar temporalmente un enlace de referencia de recurso de un archivo WAR. Utilice código parecido para alterar temporalmente un enlace de referencia de recurso de un archivo JAR EJB (enterprise bean) o un archivo JAR de cliente Java EE.

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

Restricción: Asegúrese de que el valor para <resource-ref-name> coincide con la etiqueta resource-ref en el descriptor de despliegue. En el ejemplo anterior, el valor es <resource-ref-name>jdbc/MyDataSrc</resource-ref-name>.

Alteración del nombre JNDI para un bean controlado por mensaje desplegado como un recurso compatible con JCA 1.5

Este ejemplo muestra un extracto XML de un archivo de estrategia personalizada para la alteración temporal del nombre JNDI activationSpe JMS (Java Message Service) de un bean controlado por mensajes EJB 2.0 o posterior desplegado como un recurso compatible con JCA 1.5.

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

Alteración del nombre de puerto de escucha JMS para un bean controlado por mensaje EJB 2.0, 2.1 o 3.0

Este ejemplo muestra un extracto XML de un archivo de estrategia personalizado para alterar temporalmente el nombre del puerto de escucha JMS de un bean controlado por mensajes EJB 2.0 o posterior desplegado en un puerto de escucha.

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

Alteración de un enlace de referencia de EJB de un archivo EJB JAR, WAR o un archivo EJB

Este ejemplo muestra código para alterar temporalmente un enlace de referencia EJB desde un archivo JAR de EJB. Utilice código parecido para alterar temporalmente un enlace de referencia de EJB desde un archivo WAR o un archivo EJB.

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

Especificar un prefijo exclusivo para beans

Especifica una serie que el producto aplica al comienzo de los nombres JNDI de enterprise beans generados. El prefijo debe ser exclusivo en la célula o nodo.

El valor predeterminado es no especificar un prefijo exclusivo para los beans.

Especificar prefijo exclusivo para beans es similar a la opción de scripting -defaultbinding.ejbjndi.prefix.

enlaces predeterminados para beans CMP EJB 1.1

Especifica el nombre JNDI de origen de datos por omisión y otros enlaces para beans CMP (persistencia gestionada por contenedor) 1.1.

El valor predeterminado es no utilizar enlaces predeterminados para beans CMP EJB 1.1.

Si selecciona enlaces predeterminados para beans CMP EJB 1.1., especifique el nombre JNDI para el origen de datos predeterminado que se va a utilizar con los beans CMP 1.1. También debe especificar el nombre de usuario y contraseña de este origen de datos predeterminado.

enlaces predeterminados para beans CMP EJB 1.1. es similar a la opción de scripting -defaultbinding.datasource.jndi.

Enlaces de fábrica de conexiones predeterminada

Especifica el nombre JNDI de fábrica de conexiones por omisión.

El valor predeterminado es no utilizar enlaces de fábrica de conexiones predeterminada. Seleccione Enlaces de la fábrica de conexiones predeterminada para especificar los enlaces para las fábricas de conexiones.

Si selecciona Enlaces de la fábrica de conexiones predeterminada, especifique el nombre JNDI de la fábrica de conexiones predeterminada que se va a utilizar. Especifique también si la autorización del recurso es a nivel de aplicación o de contenedor.

Enlaces de la fábrica de conexiones predeterminada es similar a la opción de scripting -defaultbinding.cf.jndi.

Utilizar el nombre de host virtual predeterminado para los módulos web y SIP

Especifica el host virtual para el módulo web (archivo WAR) o el módulo SIP (Session Initiation Protocol) (archivo SAR).

El valor predeterminado es No utilizar el nombre de host virtual predeterminado para módulos web o SIP. Si selecciona Utilizar nombre de host virtual predeterminado para módulos web y SIP, especifique un nombre de host predeterminado.

Utilizar nombre host virtual predeterminado para módulos Web y SIP es similar a la opción de scripting -defaultbinding.virtual.host.

Nombre de archivo: urun_rapp_instw_gendefbind.html