Print-friendly Version

Funzionalità di base per la creazione dei domini in Sun Java System Application Server

Branko Fiorilo Drakic, luglio 2008

Introduzione

Sun Java System Application Server consente di creare vari domini per utilizzare in modo ottimale un server ed eseguirvi simultaneamente attività di sviluppo, testing e produzione.

Le porte

Per raggiungere questo obiettivo, è necessario prendere in considerazione le porte utilizzate dall'application server. Le porte devono essere esclusive ed essere assegnate ad un unico dominio (si consiglia di utilizzare porte con numeri superiori a 1000).

Sono disponibili due metodi per eseguire questa operazione; forse il più semplice è quello di generare un dominio e quindi di avviarlo prima di generare il secondo, e così via. In questo modo si evitano le sovrapposizioni tra le porte dei domini che devono operare in modo simultaneo.

È sempre necessario specificare una porta amministrativa (obbligatoria) e una porta attiva, possibilmente usando una convenzione, per esempio:

Porta             Dominio 1       Dominio 2         Dominio 3 
Amministrativa    4848            5858              6868 
Attiva            4949            5959              6969 

Prima di usare una porta è necessario verificare che non sia già in uso.

Solaris 10 OS

# netstat -a

Per verificare che la porta non sia utilizzata, controllare ad esempio la porta 7878. Per semplificare la ricerca, utilizzare |grep:

# netstat -a |grep 7878

genesis.7878    10.38.200.56.1912    64555    0 64240     0 ESTABLISHED 
genesis.7878    10.38.200.56.1913    64586    0 64240     0 ESTABLISHED 
      *.7878               *.*          0     0 65536     0 LISTEN 

In questo caso, la porta è già utilizzata e ha due collegamenti attivi, quindi non può essere usata per la creazione di un nuovo dominio.

Microsoft Windows

Nel caso di Windows non è possibile usare |grep quindi la verifica è più complessa.

:> netstat /a 

Sono presenti anche porte supplementari che vengono collegate in modo automatico quando si genera il dominio. Queste porte sono:

Default port 7676 for JMS
Default port 3700 for IIOP
Default port 8181 for HTTP_SSL
Default port 3820 for IIOP_SSL
Default port 3920 for IIOP_MUTUALAUTH
Default port 8686 for JMX_ADMIN 

Opzioni di asadmin per la creazione del dominio

asadmin è lo strumento che consente di amministrare, generare ed eliminare i domini, viene usato dalla riga di comando ed è utilizzato in modo analogo su tutti i sistemi operativi. Qui di seguito è riportata la descrizione delle opzioni più importanti:

--user (nome dell'utente)

--adminport (porta amministrativa) (DAS)

--domaindir (nome della directory dove viene generato il dominio, utile per creare il dominio in una posizione differente da quella predefinita)

--instanceport (porta utilizzata per l'istanza)

--checkports=true (utile per verificare se le porte sono già in uso)

Sono presenti altre opzioni ma quelle qui descritte garantiscono la creazione corretta del dominio.

Esempio

Si supponga di voler generare due domini per l'ambiente di prova, uno per gli sviluppatori (denominato sviluppo) e un altro per il personale incaricato delle prove (denominato qualità). Per usare tutte le opzioni, vengono usate directory differenti per ottenere un controllo più appropriato. Vengono inoltre usati utenti e password differenti per il DAS di ogni dominio.

Nell'impostazione predefinita Application Server viene installato in:

/opt/SUNWappsserv (per Solaris)

c:\Sun\Application \ (per Windows)

Creazione di "sviluppo" e "qualità"

bash-3.00# /opt/SUNWappserver/bin/asadmin create-domain --domaindir \
/sbvirt/ --user sviluppo --instanceport 1234 --adminport 1235 \
--checkports=true sviluppo 
Please enter the admin password> 
Please enter the admin password again> 
Please enter the master password [Enter to accept the default]:> 
Please enter the master password again [Enter to accept the default]:> 
Using port 1235 for Admin. 
Using port 1234 for HTTP Instance. 
Default port 7676 for JMS is in use. Using 34310 
Default port 3700 for IIOP is in use. Using 34311 
Default port 8181 for HTTP_SSL is in use. Using 34312 
Default port 3820 for IIOP_SSL is in use. Using 34313 
Default port 3920 for IIOP_MUTUALAUTH is in use. Using 34314 
Default port 8686 for JMX_ADMIN is in use. Using 34315 
Domain being created with profile:enterprise, as specified by 
variable AS_ADMIN_PROFILE in configuration file. 
Security Store uses: NSS 

Per proseguire, avviare il dominio con il seguente comando:

bash-3.00# /opt/SUNWappserver/bin/asadmin start-domain --domaindir \
/sbvirt/ --user sviluppo sviluppo

È necessario includere l'utente e la directory poiché non si utilizzano le impostazioni predefinite. Nell'output vengono visualizzate varie informazioni utili, ad esempio se si dimentica una determinata porta di Application Server (è possibile verificare queste informazioni anche nel file domain.xml nella directory config di Application Server).

Starting Domain sviluppo, please wait.
Log redirected to /sbvirt//sviluppo/logs/server.log.
Please enter the admin password>
Redirecting output to /sbvirt/sviluppo/logs/server.log 
Domain sviluppo started. 
Domain [sviluppo] is running [Sun Java System Application Server 9.1 
(build b58g-fcs)] with its configuration and logs at: [/sbvirt/]. 
Admin Console is available at [https://localhost:1235]. 
Use the same port [1235] for "asadmin" commands. 
User web applications are available at these URLs: 
[http://localhost:1234 https://localhost:34312 ]. 
Following web-contexts are available: 
[/web1  /__wstx-services ]. 
Standard JMX Clients (like JConsole) can connect to JMXServiceURL: 
[service:jmx:rmi:///jndi/rmi://genesis.cadebsa.com:34315/jmxrmi] for 
domain management purposes. 
Domain listens on at least following ports for connections: 
[1234 34312 1235 34311 34313 34314 34315 ]. 
Domain supports application server clusters and other standalone instances. 

Ora viene creato il secondo dominio, in questo caso qualità. L'unica differenza è data dalla password e dal nome del dominio.

bash-3.00# /opt/SUNWappserver/bin/asadmin create-domain --domaindir \
/sbvirt/ --user qualita --instanceport 1222 --adminport 1220 \
--checkports=true qualita 
Please enter the admin password> 
Please enter the admin password again> 
Please enter the master password [Enter to accept the default]:> 
Please enter the master password again [Enter to accept the default]:> 
Using port 1220 for Admin. 
Using port 1222 for HTTP Instance. 
Default port 7676 for JMS is in use. Using 34474 
Default port 3700 for IIOP is in use. Using 34475 
Default port 8181 for HTTP_SSL is in use. Using 34476 
Default port 3820 for IIOP_SSL is in use. Using 34477 
Default port 3920 for IIOP_MUTUALAUTH is in use. Using 34478 
Default port 8686 for JMX_ADMIN is in use. Using 34479 
Domain being created with profile:enterprise, as specified by 
variable AS_ADMIN_PROFILE in configuration file. 
Security Store uses: NSS 

Come procedere se un dominio generato presenta conflitti con un altro dominio o applicazione?

Le cause possono essere diverse. Un dominio era inattivo, è stata installata una nuova applicazione, sono presenti problemi con alcune porte del dominio. Se l'application server non può essere avviato, è possibile modificare manualmente le porte per evitare di dover creare di nuovo il dominio. È possibile correggere la situazione modificando il file domain.xml e cambiando la voce che produce l'errore. Ad esempio, per Solaris:

vi /sbvirt/sviluppo/config/domain.xml 

In ambiente Windows, eseguire:

edit c:\dominios\sviluppo\config\domain.xml

Si noti che è presente una porta di quelle citate, la porta 1234. Se questa è la porta che produce il problema (come indicato da Application Server), è sufficiente sostituirla con un'altra (usando il metodo netstat descritto in precedenza). Una volta effettuata la modifica, il dominio può essere usato senza perdere l'applicazione in uso precedentemente.

Unless otherwise licensed, code in all technical manuals herein (including articles, FAQs, samples) is provided under this License.