Prima di creare il pool, distribuire il modulo connettore (Resource Adapter) associato al pool. I valori specificati per il nuovo pool dipendono dal modulo connettore distribuito.
Espandere il nodo Risorse nell'albero di navigazione.
Espandere il nodo Connettori.
Nel nodo Connettori selezionare il nodo Connection pool connettore.
Viene visualizzata la pagina Connection pool connettore.
Nella pagina Connection pool connettore fare clic su Nuovo.
Viene visualizzata la pagina Nuovo connection pool connettore (passo 1 di 2).
Nel campo Nome pool digitare un nome univoco per il pool.
Specificare questo nome durante la creazione di una risorsa connettore.
Nell'elenco a discesa Resource Adapter selezionare una voce dalla lista dei Resource Adapter (moduli connettori) distribuiti.
Nell'elenco a discesa Definizione connessione selezionare la definizione di connessione per il connection pool del connettore.
Le scelte disponibili nella lista dipendono dal Resource Adapter selezionato. La definizione della connessione identifica un elemento connection-definition
del Resource Adapter nel file ra.xml
.
Fare clic su Successivo.
Viene visualizzata la pagina Nuovo connection pool connettore (passo 2 di 2).
Selezionare la casella di controllo Abilitato dell'opzione Ping per eseguire il ping del connection pool durante il processo di creazione o riconfigurazione al fine di identificare e segnalare valori non corretti per i relativi attributi.
Questa opzione è disabilitata per impostazione predefinita.
Nel campo Descrizione digitare una descrizione del connection pool.
Nel campo Dimensione pool iniziale e minima specificare il numero minimo di connessioni per il pool.
Il valore predefinito è 8.
Nel campo Dimensione massima pool specificare il numero massimo di connessioni per il pool.
Il valore predefinito è 32.
Nel campo Quantità di ridimensionamento pool specificare il numero di connessioni da rimuovere allo scadere del timeout di inattività del pool.
Il valore predefinito è 2.
Nel campo Timeout inattività specificare il numero massimo di secondi durante i quali una connessione può rimanere inattiva nel pool.
Il valore predefinito è 300.
Nel campo Tempo massimo di attesa specificare il tempo di attesa per la richiesta di connessione di un'applicazione prima che si verifichi il timeout della connessione.
Il valore predefinito è 60000.
Selezionare la casella di controllo Obbligatorio dell'opzione Convalida della connessione per abilitare la convalida della connessione.
Se la casella di controllo Obbligatorio è selezionata, le connessioni vengono convalidate prima di essere fornite all'applicazione. Se la convalida di una risorsa non riesce, la risorsa viene eliminata e viene creata e restituita una nuova risorsa. Questa opzione è disabilitata per impostazione predefinita.
Selezionare la casella di controllo In caso di qualsiasi errore: Chiudi tutte le connessioni in modo che GlassFish Server chiuda e ristabilisca tutte le connessioni nel pool in caso di errore di una sola connessione.
Se non si seleziona la casella di controllo, le singole connessioni vengono ristabilite solo quando vengono utilizzate. Questa opzione è disabilitata per impostazione predefinita.
Nell'elenco a discesa Supporto transazioni selezionare il tipo di supporto di transazione per il connection pool.
Il supporto transazioni scelto sovrascrive l'attributo di supporto delle transazioni nel Resource Adapter associato a questo connection pool compatibilmente con gli elementi inferiori. In altre parole, può supportare un livello di transazione inferiore o uguale a quello specificato nel Resource Adapter, ma non un livello superiore.
Nell'elenco a discesa sono disponibili le opzioni riportate di seguito.
NoTransaction: indica che il Resource Adapter non supporta le transazioni locali o JTA del Resource Manager e non implementa le interfacce XAResource o LocalTransaction.
LocalTransaction: indica che il Resource Adapter supporta le transazioni locali mediante l'implementazione dell'interfaccia LocalTransaction.
Le transazioni locali sono gestite all'interno di un Resource Manager e non coinvolgono alcun Transaction Manager esterno.
XATransaction: indica che il Resource Adapter supporta le transazioni locali e JTA del Resource Manager mediante l'implementazione delle interfacce LocalTransaction e XAResource.
Le transazioni XA sono controllate e coordinate da un Transaction Manager esterno a un Resource Manager.
Nella sezione Proprietà aggiuntive specificare le proprietà aggiuntive per il connection pool del connettore.
Le proprietà disponibili dipendono dal Resource Adapter per il connection pool del connettore.
Per aggiungere una proprietà, fare clic sul pulsante Aggiungi proprietà. Nella riga vuota visualizzata, digitare il nome della proprietà nel campo Nome e il valore della proprietà nel campo Valore.
Se si specifica un nome ma non un valore per una proprietà, la proprietà viene rimossa dalla tabella al termine della creazione del connection pool. Se non si desidera impostare il valore di una proprietà in questa fase, conservando tuttavia la proprietà nella tabella in modo da impostarne il valore in un secondo momento, digitare un set di parentesi vuote nel campo Valore:
()
Fare clic su OK.