Valores de Preparación para la instalación de la aplicación

Utilice esta página para instalar una aplicación (archivo EAR) o un módulo (archivo JAR o WAR).

Para ver esta página de la consola administrativa, pulse Aplicaciones > Instalación de una nueva aplicación.

Siga los pasos que aparecen en esta página para instalar una aplicación o módulo. Debe realizar, como mínimo, el primer paso. Dependiendo de si está instalando una aplicación, un módulo EJB o un módulo Web, deberá completar algunos o todos los demás pasos.

Vía de acceso
Especifica la vía de acceso plenamente cualificada del archivo .ear, .jar o .war de la aplicación de empresa.

Utilice la Vía de acceso local si los archivos de la aplicación y el navegador están en la misma máquina (tanto si el servidor se encuentra o no también en esa máquina)

Utilice Vía de acceso del servidor si los archivos de la aplicación residen en uno de los nodos del contexto de célula actual. Puede examinar todo el sistema de archivos de un nodo si el agente de nodo o gestor de despliegue se está ejecutando en ese nodo seleccionado. Sólo se muestran los archivos .ear, .jar, o .war durante el examen.

Durante la instalación de la aplicación, los archivos de aplicación suelen bajarse normalmente desde la máquina cliente que ejecuta el servidor a la máquina servidor que ejecuta la consola administrativa, donde se despliegan. En tales casos, el navegador Web que ejecuta la consola administrativa se utiliza para seleccionar módulos EAR, WAR o JAR para subirlos a la máquina servidor.

No obstante, en algunos casos los archivos de la aplicación residen en el sistema de archivos de cualquiera de los nodos de una célula. Para que el servidor de aplicaciones instale estos archivos, utilice la opción Vía de acceso del servidor.

También puede utilizar esta opción para especificar un archivo de la aplicación que ya resida en la máquina que esté ejecutando el servidor de aplicaciones. Por ejemplo, el valor de campo en Windows NT podría ser C:\WebSphere\AppServer\installableApps\test.ear. Si está instalando un módulo WAR autónomo, también debe especificar el directorio raíz de contexto.

Directorio raíz de contexto
Especifica el directorio raíz de contexto de la aplicación Web (WAR).

Este campo sólo se utiliza para instalar un archivo autónomo WAR. El directorio raíz de contexto se combina con la correlación de servlet definida (del archivo WAR) para componer el URL completo que los usuarios escriben para acceder al servlet. Por ejemplo, si el directorio raíz de contexto es /gettingstarted y la correlación de servlet es MySession, el URL sería http://host:port/gettingstarted/MySession.

Generar enlaces por omisión
Especifica si se deben generar enlaces por omisión. Si coloca una marca de selección en el recuadro de selección, todos los enlaces incompletos de la aplicación se rellenan con los valores por omisión. Los enlaces existentes no sufrirán ninguna modificación.

Al elegir esta opción, puede ir directamente al paso Resumen e instalar la aplicación si ninguno de estos 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 el panel Resumen, verifique la célula, el nodo y el servidor donde se desea instalar la aplicación.

Los enlaces se generan de la siguiente manera:

La estrategia por omisión 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, no funciona si:

En estos casos, puede alterar el comportamiento con un documento XML (una estrategia personalizada). Utilice el campo Archivo de enlaces específicos para especificar una estrategia personalizada y ver la ayuda del campo para obtener ejemplos.

Prefijos
Especifica prefijos para utilizarlos con nombres JNDI generados.
Alterar temporalmente
Especifica si se deben alterar temporalmente los enlaces existentes.

Si este recuadro de selección está seleccionado, los enlaces generados alteran temporalmente los enlaces existentes.

Enlaces CMP de EJB 1.1
Especifica el nombre JNDI de origen de datos por omisión.

Si el botón de selección Enlaces por omisión para CMP de EJB 1.1 está seleccionado, especifique el nombre JNDI para el origen de datos por omisión que se va a utilizar con los beans CMP 1.1. También debe especificar el ID de usuario y la contraseña para este origen de datos por omisión.

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

Si el botón de selección Enlaces de fábrica de conexiones por omisión está seleccionado, especifique el nombre JNDI para el origen de datos por omisión que se va a utilizar con los enlaces. También debe especificar la autorización de recursos.

Sistema principal virtual
Especifica el sistema principal virtual de los módulos WAR.
Archivo de enlaces específicos
Especifica el archivo de enlaces que altera temporalmente el enlace por omisión.

Modifique el comportamiento del enlace por omisión con un documento XML (también conocido como estrategia personalizada). Las estrategias personalizadas amplían la estrategia por omisión de forma que sólo necesita personalizar aquellas áreas donde la estrategia por omisión es insuficiente. Es decir, sólo necesita describir cómo desea modificar los enlaces generados por la estrategia por omisión. No es necesario que defina enlaces para toda la aplicación.

A continuación, aparecen algunos ejemplos breves de cómo alterar temporalmente varios aspectos del generador de enlaces por omisión:

Controlar 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>
<!-- este nombre debe coincidir con el nombre de módulo en el archivo .ear -->
      <ejb-bindings>
        <ejb-binding>
         <ejb-name>HelloEjb</ejb-name>
<!-- este valor debe coincidir con la entrada <ejb-name> en el DD jar de EJB -->
         <jndi-name>com/acme/ejb/HelloHome</jndi-name>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

Establecer el enlace de fábrica de conexiones de un archivo JAR de 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>

Establecer el enlace de fábrica de conexiones de 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>
<!-- este valor debe coincidir con el distintivo de ejb-name en el DD -->
          <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>

Alterar temporalmente un enlace de referencia de recursos desde un archivo JAR de cliente J2EE, JAR de EJB o WAR

A continuación, aparece código de ejemplo para alterar temporalmente un enlace de referencia de recursos de un archivo WAR. Utilice código parecido para alterar temporalmente un enlace de referencia de recursos de un archivo JAR de EJB o JAR de cliente J2EE.

<?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>
          <!-- el siguiente valor debe coincidir con el valor de resource-ref en el DD -->
          <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>

Alterar temporalmente puertos de receptor JMS de MDB

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

Información relacionada

Botones de la consola de administración