Utilizzare questa pagina per installare un'applicazione (file EAR) o un modulo (file JAR o WAR).
Per visualizzare questa pagina della console di gestione, fare clic su Applicazioni > Installa nuova applicazione.
Seguire le istruzioni presenti su questa pagina per installare un'applicazione o un modulo. E' necessario completare almeno la prima fase; per quanto riguarda le fasi successive, è possibile completarle solo in parte a seconda se si sta installando un'applicazione, un modulo EJB o un modulo Web.
Utilizzare Percorso locale se il browser e i file dell'applicazione si trovano sulla stessa macchina (a prescindere dalla posizione del server).
Utilizzare Percorso server se il file dell'applicazione risiede su un qualsiasi nodo nel contesto cella corrente. E' possibile eseguire le ricerche sull'intero file system di un nodo, se l'agente nodo o il gestore distribuzione è in esecuzione sul nodo prescelto. Durante la ricerca, vengono visualizzati soltanto i file .ear, .jar o .war.
Durante l'installazione dell'applicazione, i file corrispondenti sono di solito caricati da una macchina client, contenente il browser, alla macchina server, contenente la console di gestione, dove vengono distribuiti. In questi casi, viene utilizzato il browser Web, che esegue la console di gestione, per selezionare i moduli EAR, WAR o JAR ed eseguire il caricamento sulla macchina server.
In alcuni casi, tuttavia, i file dell'applicazione risiederanno sul file system di un qualsiasi nodo in una cella. Per consentire al server delle applicazioni di installare questi file, utilizzare l'opzione Percorso server.
Questa opzione può essere utilizzata anche per specificare un file dell'applicazione che già risiede sulla macchina su cui è in esecuzione il server delle applicazioni. Ad esempio, il valore di questo campo su Windows NT deve essere C:\WebSphere\AppServer\installableApps\test.ear. Se si sta installando un modulo WAR autonomo, è necessario specificare la root contesto.
Questo campo viene utilizzato solo per installare un file WAR autonomo. La root contesto è associata alla mappa servlet definita (dal file WAR) per creare l'URL completo, utilizzato dagli utenti per accedere al servlet. Ad esempio, se la root contesto è /gettingstarted e la mappatura servlet è MySession, l'URL sarà http://host:port/gettingstarted/MySession.
Selezionando questa opzione è possibile passare direttamente alla procedura di riepilogo e installare l'applicazione, se non ci sono procedure contrassegnate da un asterisco rosso (*). Un asterisco rosso denota che la procedura non è stata completata e che richiede un valore valido. Sul pannello Riepilogo, verificare la cella, il nodo e il server su cui è installata l'applicazione.
I collegamenti vengono creati nel modo seguente:
La strategia predefinita funziona correttamente per la maggior parte delle applicazioni o almeno per la maggior parte dei collegamenti in un gran numero di applicazioni. Tuttavia, non può funzionare nei seguenti casi:
In questi casi, è possibile modificare la funzionalità di un documento XML (una strategia di personalizzazione). Utilizzare il campo File di collegamenti specifici per specificare una strategia di personalizzazione e consultare la guida relativa al campo per gli esempi.
Se questa casella di controllo è selezionata, i collegamenti esistenti verranno sovrascritti da quelli generati.
Se il pulsante di opzione Collegamenti predefiniti per CMP 1.1 di EJB è selezionato, specificare il nome JNDI dell'origine dati predefinita da utilizzare con i bean CMP 1.1. Inoltre, è necessario specificare l'ID utente e la password dell'origine dati predefinita specificata.
Se il pulsante di opzione Collegamenti predefiniti delle produzioni connessioni è selezionato, specificare il nome JNDI dell'origine dati predefinita da utilizzare con i collegamenti. Inoltre, specificare un'autorizzazione di risorsa.
Modificare la funzionalità del collegamento predefinito con un documento XML (strategia di personalizzazione aka). Le strategie di personalizzazione estendono la strategia predefinita per rendere possibile la personalizzazione solo di quelle aree dove la strategia predefinita è insufficiente. Cioè, è necessario soltanto descrivere il modo in cui si desidera modificare i collegamenti generati dalla strategia predefinita; non è indispensabile definire i collegamenti dell'intera applicazione.
Seguono alcuni brevi esempi sul modo di sovrascrivere i vari aspetti del generatore dei collegamenti:
Controllo di un nome JNDI EJB
<?xml version="1.0" ?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
<module-bindings>
<ejb-jar-binding>
<jar-name>helloEjb.jar</jar-name>
<!-- il nome deve corrispondere al nome del modulo nel file .ear -->
<ejb-bindings>
<ejb-binding>
<ejb-name>HelloEjb</ejb-name>
<!-- ciò deve corrispondere alla voce <ejb-name> nel DD del file jar EJB -->
<jndi-name>com/acme/ejb/HelloHome</jndi-name>
</ejb-binding>
</ejb-bindings>
</ejb-jar-binding>
</module-bindings>
</dfltbndngs>
Impostazione del collegamento della produzione connessioni per un file 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>
Impostazione del collegamento della produzione connessioni per un file 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>
<!-- ciò corrisponde alla tag ejb-name nel 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>
Sovrascrittura di un collegamento riferimento risorse da un file JAR EJB, WAR o JAR del client J2EE
Di seguito, viene illustrato un codice di esempio per sovrascrivere un collegamento riferimento risorse da un file WAR. Utilizzare un codice simile per sovrascrivere un collegamento riferimento risorse da un file JAR EJB o da un file JAR del client 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>
<!-- quello che segue deve corrispondere a resource-ref nel 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>
Sovrascrivere le porte listener JMS 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>