Capitolo 1. Requisiti di installazione per IBM WebSphere Application Server - Express
Capitolo 2. Installazione di WebSphere Application Server - Express su Windows
Capitolo 3. Installazione di WebSphere Application Server - Express su Linux
Capitolo 4. Installazione di WebSphere Application Server - Express su AIX
Capitolo 5. Installazione di WebSphere Application Server - Express su Solaris
Capitolo 6. Installazione di WebSphere Application Server - Express su HP-UX
Capitolo 7. Plug-in di protezione per il server Web HTTP
Capitolo 8. Installazione dei plug-in di protezione per il server Web HTTP
Questa sesta edizione (Novembre 2003) dellaGuida all'installazione contiene le seguenti informazioni per WebSphere Application Server - Express Versione 5.1:
Per le correzioni seguenti e informazioni di supporto, consultare il sito di supporto per il prodotto all'indirizzo www.ibm.com/software/webservers/appserv/express/support.html.
Ad esempio, per aggiornare dalla versione 5.0 o 5.0.1 o 5.0.2 alla 5.1.
Note su WebSphere Application Server - Express V5.1:
Questa guida è disponibile sia in formato HTML che Acrobat PDF, nella directory principale del CD di installazione e nella directory di installazione del prodotto. Le informazioni contenute nelle due versioni sono identiche. E' possibile aprire il file install.html con qualsiasi browser Web. Per aprire il file install.pdf, è necessario Acrobat Reader, che è possibile scaricare da www.adobe.com/products/acrobat/readstep2.html.
Prima di installare WebSphere Application Server - Express, è necessario installare il seguente hardware:
Risoluzione minima 800 x 600 (si consiglia 1024 x 768)
Risoluzione minima 1024 x 768
Supporto per un adattatore di comunicazioni
Supporto per TCP/IP e un adattatore.
Prima di installare WebSphere Application Server - Express, è necessario installare il seguente software:
Uno dei seguenti sistemi operativi:
Windows(R) 2000 Server o Advanced Server con Service Pack 4 o
successivo, solo componenti del server remoto
Windows(R) 2003 Server Standard Edition, solo componenti del
server remoto
Windows(R) 2000 Professional con Service Pack 4 o successivo,
strumenti di WebSphere Studio e componenti server
Windows XP SP1a Professional per gli strumenti di WebSphere Studio e i
componenti server
Red Hat, Versione 7.2 per gli strumenti di WebSphere Studio, incluso
l'ambiente di test
Red Hat, Versione 8.0 per gli strumenti di WebSphere Studio incluso
l'ambiente di test.
Red Hat, Versione AS (o EL) 2.1 solo per il componente server remoto
SuSE, Versione 7.2, strumenti Studio incluso l'ambiente di
test.
SuSE, Versione 8.1, strumenti Studio incluso l'ambiente di test
United Linux V 1.0 (Suse SLES 8) solo componente server remoto
AIX 5.2 (livello di manutenzione 5200-01) solo componente server
remoto con distribuzione remota da qualsiasi piattaforma studio supportata
Solaris 9 (con Recommended Patch Cluster di Aprile 2003) solo componente
Remote Server
HP 11iv1 (Fix Level Dicembre 2002) solo componente server remoto
Tabella 1. Lingue nazionali supportate dai sistemi operativi Red Hat e SuSE.
|
| Solo Inglese | Inglese più lingue nazionali | SBCS (Single-byte character set) | DBCS (Double-byte character set) (Vedere nota 1) |
|---|---|---|---|---|
| Red Hat 7.2 | SŪ |
|
|
|
| Red Hat 8.0 |
| SŪ | SŪ | SŪ (1) |
| SuSE 7.2 | SŪ |
|
|
|
| SuSE 8.1 |
| SŪ | SŪ |
|
(1) Se si desidera utilizzare i caratteri a doppio byte su Red Hat 8.0, è necessario aggiornare GTK 2.0 a GTK 2.2 o versione successiva. Fare riferimento alla sezione (Facoltativo) Aggiornamento a GTK versione 2.2.2 o successiva.
Avvisi:
Se sul sistema è installato WebSphere Application Server - Express e sono stati installati plug-in di altri fornitori, è necessario recuperare i plug-in corrispondenti per la versione 5.1.1 e reinstallarli.
Questa confezione contiene due serie di CD:
Installazione degli scenari di utilizzo
IMPORTANTE: E' possibile utilizzare DB2 Universal Database Express Edition su computer solo per sviluppare, verificare il funzionamento ed effettuare dimostrazioni dei programmi applicativi. Non è possibile installare i programmi su un server di produzione. Per ulteriori dettagli, consultare la licenza inclusa.
Questa sezione contiene informazioni sull'installazione di WebSphere Application Server - Express su Windows. I componenti principali di WebSphere Application Server - Express sono Application Server, Remote Agent Controller e WebSphere Studio Site Developer (WSSD). Si può scegliere di installare uno o tutti i componenti. Se si desidera gestire Application Server utilizzando WSSD, è necessario installare Remote Agent Controller insieme ad Application Server.E' possibile installare WebSphere Application Server - Express dal CD-ROM o dalle immagini in linea scaricate.
Nota di installazione:
Il programma di installazione può essere eseguito in modalità di console interattiva invece di utilizzare i pannelli della procedura guidata della GUI. La modalità di console è adatta soprattutto alle persone con necessità che richiedono l'accesso facilitato. La modalità "-accessibility" fornisce informazioni udibili supplementari per utenti finali con problemi visivi. Per eseguire il programma in modalità console, immettere questo comando dalla directory di impostazione del CD di installazione di Webphere Application Server - Express:
Seguire le istruzioni per completare l'installazione. Nota: l'opzione "-is:javaconsole" è particolarmente importante. Se questa opzione non è specificata, il programma di installazione viene interrotto. L'opzione "-log @NONE" disattiva il collegamento per eliminare la informazioni di log visualizzate sulla console. In caso di problemi durante l'installazione, eliminare questa opzione in modo da raccogliere informazioni di log.
Importante: Non installare questa versione su una versione precedente. E' possibile eseguire l'installazione in una directory differente ai fini della coesistenza delle due versioni oppure è possibile disinstallare la versione precedente prima di installare la nuova nella stessa directory. Se il programma di installazione rileva una versione precedente del server di applicazioni, sarà possibile migrare la configurazione server al server 5.1. Per ulteriori dettagli, consultare la Guida alla migrazione.
Importante: se si tenta di aprire uno spazio di lavoro della versione 4.0.x da Studio Site Developer IDE della versione 5.1.1, lo spazio di lavoro sarà convertito ad uno spazio di lavoro della versione 5.1.1. Saranno conservati nomi di progetti, file di origine dei progetti e percorsi di compilazione dei progetti Java (percorso classi). Tuttavia, le impostazioni dell'interfaccia utente, le impostazioni di debug e la maggior parte delle preferenze saranno perse. Fare riferimento alla Guida alla migrazione per istruzioni relative alla migrazione sicura dei progetti esistenti alla versione 5.1.1.
A titolo precauzionale, si consiglia di eseguire una copia di backup degli spazi di lavoro della versione 5.x prima di migrare alla versione 5.1.1.
Prima di installare il prodotto, verificare quanto segue:
Per installare WebSphere Application Server - Express dal primo CD di installazione del prodotto, procedere come segue:
Suggerimenti:
Importante: non eseguire l'installazione in una directory il cui nome contiene caratteri double-byte o caratteri speciali quali il simbolo del dollaro. Ciò infatti potrebbe causare effetti indesiderati come problemi relativi al percorso classi nell'ambiente di test di WebSphere.
Esistono diverse parti scaricabili per WebSphere Application Server - Express. Ogni parte è un archivio autoestraibile e tutte le parti sono necessarie.
Prima di installare il prodotto, verificare quanto segue:
Per installare l'immagine in linea di WebSphere Application Server - Express, procedere come segue:
Dopo aver installato WebSphere Application Server - Express il <percorsoinstallazioneExpress> selezionato durante l'installazione, dovrebbe contenere la seguente struttura di directory:
Se una di queste directory contiene un numero molto diverso di file, potrebbe essersi verificato un problema durante l'installazione. Per individuare il problema, esaminare il file expressInstallLog.txt nel <percorsoinstallazioneExpress>\logs.
Se l'installazione è stata completata correttamente, avviare Site Developer da Start >Programmi > IBM WebSphere Application Server - Express 5.1 >Studio Site Developer. Una volta avviato Site Developer, seguire i collegamenti della pagina di benvenuto per caricare ed eseguire uno degli esempi di Express.
IBM Agent Controller viene sempre installato come un servizio Windows e viene avviato automaticamente. IBM Agent Controller fornisce il canale di comunicazione fra Site Developer e Application Server. Verificare in Pannello di controllo > Strumenti di amministrazione > Servizi che IBM Agent Controller sia presente e in esecuzione. In caso di problemi, esaminare il file servicelog.log nella directory <percorsoinstallazioneExpress>\RAC\config.
Se l'installazione non è stata completata correttamente, esaminare il file racInstallLog.txt nella directory <Expressinstallpath>\logs. Se il file racInstallLog.txt non esiste, potrebbe voler dire che sul sistema esiste già un'altra versione di IBM Agent Controller. Disinstallare l'altra versione e ritentare l'installazione.
E' possibile verificare l'esito dell'installazione di Application Server eseguendo il comando Verifica installazione server dall'applicazione introduttiva. Tale applicazione viene avviata al termine dell'installazione oppure è possibile avviarla dal menu Start > Programmi > IBM WebSphere Application Server - Express 5.1 > First Steps.
In alternativa, è possibile verificare il funzionamento di Application Server eseguendo il file <percorsoinstallazioneExpress>\Express\bin\testServer.bat. Questo file batch eseguirà l'avvio e l'arresto di Application Server mediante la sua configurazione predefinita. Il file batch viene usato solo per testare l'installazione del server.
L'esecuzione del file setupwin32.exe inizia con il programma di installazione Java e riporta quindi il controllo al prompt dei comandi. L'esecuzione dell'installazione continua in background. Ci sono diversi modi per verificare l'esito di una installazione non presidiata:
Un modo alternativo per eseguire il programma di installazione prevede l'emissione del comando per eseguire il programma di installazione Java direttamente. Affinché il programma di installazione funzioni correttamente, diversi parametri delle riga comandi sono stati trasferiti nel programma di installazione. Nella directory util del primo CD, è presente un file batch di esempio denominato syncInstall.bat che può essere utilizzato per eseguire l'installazione in modalità sincrona, vale a dire che il controllo non verrà visualizzato sul prompt dei comandi fino a quando l'installazione non sarà completa. E' possibile trasferire i parametri al comando syncInstall.bat come con il file setupwin32.exe. Questo comando batch è particolarmente utile per gli scenari delle installazioni non presidiate.
Il programma di installazione di WebSphere Application Server - Express può essere eseguito in modalità non presidiata, se si desidera unire il prodotto ai propri. Per installare WebSphere Application Server - Express in modalità non presidiata viene usata l'opzione -silent nella riga comandi. Durante l'installazione non presidiata dall'utente, non è possibile vedere i pannelli della procedura guidata una volta eseguito il comando di installazione.
Per eseguire l'installazione in modalità non presidiata con tutti i valori predefiniti, eseguire il comando:
setupwin32.exe -silent
Se si desidera modificare l'ubicazione predefinita per l'installazione di Express (IBM/WebSphere/Express), usare:
setupwin32.exe -silent -P waseBean.installLocation=c:\<yourdirectory>
Si può anche usare un file di risposte per impostare ulteriori opzioni per l'installazione in modalità non presidiata. Per un modello, fare riferimento al file di risposte sul CD di installazione. Per eseguire un'installazione non presidiata con un file di risposte, utilizzare il comando:
setupwin32.exe -silent -options <percorso completo>\responsefile
Nota: WebSphere Application Server - Express non supporta l'installazione non presidiata da un CD quando si seleziona WebSphere Studio Sire Developer. Il motivo è che questa funzione richiede il secondo CD e il programma di installazione non richiede il secondo CD durante l'esecuzione non presidiata. Per installare la funzione WebSphere Studio Site Developer in modalità non presidiata, è possibile copiare il secondo CD sul disco fisso o montare il CD in una seconda unità CD ed utilizzare quindi l'opzione '-media 2=<percorso al secondo CD>' per indicare al programma di installazione dove ricercare il secondo CD.
Express contiene, nella directory \util\responsefile.txt, un file di risposte di esempio. E' possibile utilizzare questo file come un file di risposte di esempio.
Per disinstallare WebSphere Application Server - Express:
Per rimuovere completamente WebSphere Application Server - Express, eliminare le directory rimanenti manualmente.
Durante la disinstallazione di WebSphere Application Server - Express il pannello delle funzioni conterrà diverse funzioni in più rispetto a quelle visualizzate durante l'installazione. Tali funzioni aggiuntive sono mostrate come sottofunzioni di Studio Site Developer. Se si desidera selezionare o deselezionare la funzione Studio Site Developer, assicurarsi che tutte le sottofunzioni vengano selezionate o deselezionate.
IBM Agent Controller fornisce il meccanismo di comunicazione fra Studio Site Developer e Application Server. Agent Controller viene installato come un servizio Windows e viene configurato per essere eseguito nell'account del sistema locale. Usando il pannello Servizi Windows si può modificare la configurazione in modo che IBM Agent Controller venga eseguito da un altro account, se lo si desidera. Poiché Agent Controller viene usato per avviare Application Server, l'account con cui è in esecuzione Agent Controller è anche l'account con cui si esegue Application Server.
Esistono diverse opzioni per rendere sicuro il collegamento tra Studio Site Developer e Agent Controller. L'installazione configura il collegamento per consentire a tutti gli utenti di Studio Site Developer di collegarsi a Agent Controller. Si vorrà modificare il valore predefinito della protezione quando si usa Agent Controller in un ambiente server di produzione.
Si possono usare i file <percorsoinstallazioneExpress>\RAC\bin\RACSecurityOn.bat e RACSecurityOff.bat per abilitare e disabilitare la protezione di base del collegamento. Quando la protezione è abilitata, per collegarsi ad Agent Controller, l'utente di Studio Site Developer dovrà fornire una combinazione nome utente e password valida, cioè un nome utente e password del sistema operativo. Il nome utente e la password verranno inoltrate da Agent Controller al sistema operativo per l'autenticazione. In Windows, le password nome di dominio non verranno autenticate. E' necessario fornire coppie di nome utente e password locali.
Per eseguire l'utilità SetConfig di IBM Agent Controller è necessario che java sia incluso nel percorso di esecuzione.
Se WebSphere Application Server - Express 5.1 è stato installato su un computer in cui esiste già una copia di WebSphere Application Server - Express 5.0, IBM Agent Controller verrà aggiornato alla versione 5.1.1 e verrà configurato un modo da fare riferimento al server 5.1. Se si desidera rimuovere WebSphere Application Server - Express 5.1 e ripristinare l'ambiente 5.0, per ottenere nuovamente la versione 5.0 di IBM Agent Controller, sarà necessario reinstallare il componente Application Server o Studio Site Developer 5.0. Installando una delle due funzioni con versione 5.0, verrà installato anche IBM Agent Controller 5.0.
In questa sezione sono illustrati i problemi noti e le limitazioni relativi all'installazione e disinstallazione di WebSphere Application Server - Express su Windows. Per informazioni sui problemi e sulle limitazioni che influiscono sull'effettivo utilizzo del prodotto, fare riferimento al file readme.
Se si crea un'associazione con un'unità di rete senza specificare il nome di un'unità (ad esempio, \\computername\sharename), è possibile che venga visualizzato il seguente messaggio quando si tenta di installare WebSphere Application Server - Express: The wizard cannot continue because of the following error: could not load wizard specified in /wizard.inf(104). La soluzione consiste nel creare un'associazione locale con l'unità di rete specificando un'unità di rete (ad esempio, x:\sharename).
Non eseguire l'installazione in un'unità Novell NetWare. L'installazione su un'unità Novell NetWare avrà esito negativo.
Prima di avviare l'installazione di WebSphere Application Server - Express, è necessario accedere come amministratore.
A volte, un problema di installazione può far sì che la copia dei file di disinstallazione nella directory _uninst, non venga completata. Come conseguenza, viene visualizzato un messaggio sull'impossibilità di trovare una JVM adatta durante la disinstallazione. In questi casi, sarà necessario eseguire manualmente la disinstallazione, come segue:
Se l'installazione non riesce, è necessario rimuovere tutti i file di WebSphere Application Server - Express installati. Se la directory in cui si desiderava installare WebSphere Application Server - Express è vuota, il processo di installazione ha già rimosso tutti i file installati ed è possibile, se si desidera, eliminare la directory vuota.
Operazioni da effettuare in caso di installazione non riuscita:
Questa sezione contiene informazioni su come installare WebSphere Application Server - Express su Linux. I componenti principali di WebSphere Application Server - Express sono Application Server, Remote Agent Controller e WebSphere Studio Site Developer (WSSD). Si può scegliere di installare uno o tutti i componenti. Se si desidera gestire Application Server utilizzando WSSD, è necessario installare Remote Agent Controller insieme ad Application Server.
E' possibile installare WebSphere Application Server - Express dal CD-ROM o dalle immagini in linea che è possibile scaricare.
Nota di installazione:
Il programma di installazione può essere eseguito in modalità di console interattiva invece di utilizzare i pannelli della procedura guidata della GUI. La modalità di console è adatta soprattutto alle persone con necessità che richiedono l'accesso facilitato. La modalità "-accessibility" fornisce informazioni udibili supplementari per utenti finali con problemi visivi. Per eseguire il programma in modalità console, immettere questo comando dalla directory di impostazione del CD di installazione di Webphere Application Server - Express:
Seguire le istruzioni per completare l'installazione. Nota: l'opzione "-is:javaconsole" è particolarmente importante. Se questa opzione non è specificata, il programma di installazione viene interrotto. L'opzione "-log @NONE" disattiva il collegamento per eliminare le informazioni di log visualizzate sulla console. In caso di problemi durante l'installazione, eliminare questa opzione in modo da raccogliere informazioni di log.
Non installare questa versione su una versione precedente. E' possibile eseguire l'installazione in una directory differente ai fini della coesistenza delle due versioni oppure è possibile disinstallare la versione precedente prima di installare la nuova nella stessa directory. Se il programma di installazione rileva una versione precedente del server di applicazioni, sarà possibile migrare la configurazione server al server 5.1. Per ulteriori dettagli, consultare la Guida alla migrazione.
Per istruzioni sulla migrazione sicura dei progetti esistenti da una versione precedente di Studio Site Developer alla versione 5.1.1, fare riferimento alla Guida alla migrazione.
A titolo precauzionale, si consiglia di eseguire una copia di backup degli spazi di lavoro delle versioni 4.0.x e 5.0 prima di migrare alla versione 5.1.1.
Per installare WebSphere Application Server - Express dal CD del prodotto, attenersi alla seguente procedura:
Esecuzione di 'setupLinux' da una finestra comandi: se la directory di lavoro corrente della finestra comandi è /mnt/cdrom, e si sta eseguendo l'installazione da CD, quando viene richiesto di inserire il secondo CD di installazione, non sarà possibile estrarre il primo CD dall'unità. Questo succede perché la directory di lavoro della finestra comandi sta indicando il CD, quindi l'unità CD risulta essere in uso. Per evitare questo problema, assicurarsi che la directory di lavoro della finestra comandi non sia /mnt/cdrom. Ciò significa che invece di utilizzare il comando ./setupLinux per avviare l'installazione, bisognerà utilizzare il percorso completo del CD: /mnt/cdrom/setupLinux.
Esecuzione di '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary' da una finestra comandi:
E' possibile che vengano riportati errori del tipo 'mqver non trovato' e 'wempsservice non trovato'. E' possibile ignorare questi messaggi di errore.
Esecuzione di Cloudscape su Linux
Per utilizzare Cloudscape su Linux, utilizzare lo script shell EXPcview.sh presente nella directory /opt/IBM/WebSphere/Express51/Express/bin.
Prima di installare il prodotto, verificare quanto segue:
L'immagine del CD Linux di WebSphere Application Server - Express è suddivisa in più parti per ridurre le dimensioni dei download. Ogni parte è un file tar (tape archive) e sono richieste tutte le parti.
Per installare le immagini in linea di WebSphere Application Server - Express, procedere come segue:
Dopo aver installato WebSphere Application Server - Express, nella directory /opt/IBM/WebSphere/Express51, dovrebbe essere stata creata la seguente struttura di directory:
Se una di queste directory contiene un numero molto diverso di file, potrebbe essersi verificato un problema durante l'installazione. Per individuare il problema, fare riferimento al file /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
Controllare prima il file /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt. Nella parte finale del file, verificare lo stato di completamento dell'installazione. Se l'installazione è stata completata correttamente, avviare Site Developer eseguendo wasexpress51 o /opt/IBM/WebSphere/Express51/SiteDeveloper/wasexpress51. Una volta avviato Site Developer, seguire i collegamenti della pagina di benvenuto per caricare ed eseguire uno degli esempi di Express.
Se l'installazione non è stata completata correttamente, scorrere il file expressInstallLog.txt per determinarne il motivo.
Se l'installazione è stata completata correttamente, avviare IBM Agent Controller eseguendo il file /opt/IBMRAC/bin/RAStart.sh. In caso di problemi, esaminare il file /opt/IBMRAC/config/servicelog.log.
Se l'installazione non è stata completata correttamente, scorrere il file racInstallLog.txt per determinarne il motivo.
E' possibile verificare l'esito dell'installazione di Application Server eseguendo il comando Verifica installazione server dall'applicazione introduttiva. Tale applicazione viene avviata al termine dell'installazione oppure è possibile avviarla dal menu Start.
E' anche possibile verificare l'esito dell'installazione di Application Server eseguendo lo script /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh. Questo script eseguirà l'avvio e l'arresto di Application Server usando la sua configurazione predefinita. Questo file script viene usato solo per testare l'installazione del server.
Il programma di installazione di WebSphere Application Server - Express può essere eseguito in modalità non presidiata, se si desidera unire il prodotto ai propri. Per installare WebSphere Application Server - Express in modalità non presidiata viene usata l'opzione -silent nella riga comandi. Durante l'installazione non presidiata dall'utente, non è possibile vedere i pannelli della procedura guidata una volta eseguito il comando di installazione.
Per eseguire l'installazione in modalità non presidiata con tutti i valori predefiniti, eseguire il comando:
./setupLinux -silent
Si può anche usare un file di risposte per impostare ulteriori opzioni per l'installazione in modalità non presidiata. Per un modello, fare riferimento al file di risposte sul CD di installazione. Per eseguire un'installazione non presidiata con un file di risposte, utilizzare il comando:
./setupLinux -silent -options <percorso_completo>/responsefile
Nota: WebSphere Application Server - Express non supporta l'installazione non presidiata da un CD quando si seleziona WebSphere Studio Sire Developer. Il motivo è che questa funzione richiede il secondo CD e il programma di installazione non richiede il secondo CD durante l'esecuzione non presidiata. Per installare la funzione WebSphere Studio Site Developer in modalità non presidiata, è possibile copiare il secondo CD sul disco fisso o montare il CD in una seconda unità CD ed utilizzare quindi l'opzione "-media 2=<percorso al secondo CD>" per indicare al programma di installazione dove ricercare il secondo CD.
Express contiene, nella directory /util/responsefile.txt, un file di risposte di esempio. E' possibile utilizzare questo file come un file di risposte di esempio.
IBM Agent Controller fornisce il meccanismo di comunicazione fra Studio Site Developer e Application Server.
Esistono diverse opzioni per rendere sicuro il collegamento tra Studio Site Developer e Agent Controller. L'installazione configura il collegamento per consentire a tutti gli utenti di Studio Site Developer di collegarsi a Agent Controller. Si vorrà modificare il valore predefinito della protezione quando si usa Agent Controller in un ambiente server di produzione.
E' possibile utilizzare gli script /opt/IBMRAC/bin/RACSecurityOn.sh e RACSecurityOff.sh per abilitare e disabilitare la protezione di base del collegamento. Quando la protezione è abilitata, per collegarsi ad Agent Controller, l'utente di Studio Site Developer dovrà fornire una combinazione nome utente e password valida, cioè un nome utente e password del sistema operativo. Il nome utente e la password verranno inoltrate da Agent Controller al sistema operativo per l'autenticazione.
Se WebSphere Application Server - Express 5.1 è stato installato su un computer in cui esiste già una copia di WebSphere Application Server - Express 5.0, IBM Agent Controller verrà aggiornato alla versione 5.1.1 e verrà configurato un modo da fare riferimento al server 5.1. Se si desidera rimuovere WebSphere Application Server - Express 5.1 e ripristinare l'ambiente 5.0, per ottenere nuovamente la versione 5.0 di IBM Agent Controller, sarà necessario reinstallare il componente Application Server o Studio Site Developer 5.0. Installando una delle due funzioni con versione 5.0, verrà installato anche IBM Agent Controller 5.0.
Avvisi:
Se si desidera utilizzare DBCS (double-byte character set) su Red Hat 8.0, è necessario effettuare le seguenti operazioni per aggiornare GTK alla versione 2.2.2 o successiva. Le istruzioni di seguito riportate si riferiscono a GTK 2.2.2.
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
rpm -q libtiff-devel
Se non è installato, installarlo dal CD di installazione di Red Hat.
/usr/local/lib
./configure make make install /sbin/ldconfig
Per impostazione predefinita, è selezionata l'installazione di GTK 2.0.6. Per verificare che l'applicazione utilizzi GTK 2.2.2, prima di avviare l'applicazione, è necessario eseguire sempre i comandi di esempio di seguito riportati.
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH export PATH=/usr/local/bin/:$PATH /opt/IBM/WebSphereExpress/SiteDeveloper/wasexpress51
Per ulteriori informazioni sull'utilizzo di GTK, visitare il sito Web all'indirizzo developer.gnome.org/doc/API/2.2/gtk/gtk-building.html.
Per disinstallare WebSphere Application Server - Express su Linux, procedere come segue:
./uninstaller
Per rimuovere completamente WebSphere Application Server - Express, eliminare le directory rimanenti manualmente.
In questa sezione sono illustrati i problemi noti e le limitazioni relativi all'installazione e disinstallazione di WebSphere Application Server - Express su Linux. Per informazioni sui problemi e sulle limitazioni che influiscono sull'effettivo utilizzo del prodotto, fare riferimento al file readme.
Se l'installazione non riesce:
A volte, un problema di installazione può causare il mancato completamento dei file di disinstallazione nella directory _uninst. Ciò provoca la visualizzazione di un messaggio che avverte dell'impossibilità di trovare una JVM adatta durante la disinstallazione. Occorre allora eseguire la disinstallazione manualmente, nel modo seguente:
Questa sezione contiene informazioni su come installare WebSphere Application Server - Express su AIX. I componenti principali di WebSphere Application Server - Express che possono essere installati su AIX sono Application Server e Remote Agent Controller. Si può scegliere di installare uno dei due o entrambi i componenti. Se si desidera gestire Application server su AIX utilizzando Studio Site Developer su Windows o Linux, sarà necessario installare Remote Agent Controller insieme ad Application Server. Per gestire Application Server, è anche possibile utilizzare la console di gestione.
E' possibile installare WebSphere Application Server - Express dal CD-ROM o dalle immagini in linea che è possibile scaricare.
Se sul sistema è presente una copia precedente di WebSphere Application Server - Express prima di procedere è necessario disinstallarla.
Esiste un solo CD per prodotto per l'installazione. Per installare WebSphere Application Server - Express dal CD del prodotto, attenersi alla seguente procedura:
Prima di installare il prodotto, verificare quanto segue:
L'immagine del CD per AIX di WebSphere Application Server - Express è suddivisa in più parti per ridurre le dimensioni dei download.
Ogni parte è un file tar (tape archive) e sono richieste tutte le parti. Per installare le immagini elettroniche di WebSphere Application Server - Express, procedere come segue:
Dopo aver installato WebSphere Application Server - Express, nella directory /opt/IBM/WebSphere/Express51, dovrebbe essere stata creata la seguente struttura di directory:
Se una di queste directory contiene un numero molto diverso di file allora potrebbe essersi verificato un problema durante l'installazione. Controllare il file /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
Controllare prima il file /opt/IBM/WebSphere/Express51/logs/expressracInstallLog.txt. Nella parte finale del file, verificare lo stato di completamento dell'installazione. Se l'installazione è terminata correttamente, avviare IBM Agent Controller eseguendo il file /opt/IBMRAC/bin/RAStart.sh. In caso di problemi, fare riferimento al file /opt/IBMRAC/config/servicelog.log.
Se l'installazione non è stata completata correttamente, scorrere il file racInstallLog.txt per determinarne il motivo.
E' possibile verificare l'esito dell'installazione di Application Server eseguendo il comando Verifica installazione server dall'applicazione introduttiva. Tale applicazione viene avviata al termine dell'applicazione. Può essere avviata manualmente eseguendo lo script /opt/IBM/WebSphere/Express51/Express/bin/launchFirstSteps.sh.
E' anche possibile verificare l'esito dell'installazione di Application Server eseguendo lo script /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh. Questo script eseguirà l'avvio e l'arresto di Application Server usando la sua configurazione predefinita. Questo file script viene usato solo per testare l'installazione del server.
Il programma di installazione di WebSphere Application Server Express può essere eseguito in modalità invisibile, se si desidera unire il prodotto ai propri. Per installare WebSphere Application Server - Express in modalità non presidiata viene usata l'opzione da riga comandi -silent. Durante l'installazione non presidiata dall'utente, non è possibile vedere i pannelli della procedura guidata una volta invocato il comando di installazione.
Per eseguire l'installazione in modalità non presidiata con tutti i valori predefiniti, eseguire il comando:
./aix/setupAIX -silent
Si può anche usare un file di risposte per impostare ulteriori opzioni per l'installazione in modalità non presidiata. Per un modello, fare riferimento al file di risposte sul CD di installazione. Per eseguire un'installazione non presidiata con file di risposte, utilizzare il comando:
./aix/setupAIX -silent -options <percorso_completo>/responsefile
Express contiene, nella directory /util/responsefile.text, un file di risposte di esempio. E' possibile utilizzare questo file come un file di risposte di esempio.
IBM Agent Controller fornisce il meccanismo di comunicazione fra Studio Site Developer e Application Server.
Esistono diverse opzioni per rendere sicuro il collegamento tra Studio Site Developer e Agent Controller. L'installazione configura il collegamento per consentire a tutti gli utenti di Studio Site Developer di collegarsi a Agent Controller. Si vorrà modificare il valore predefinito della protezione quando si usa Agent Controller in un ambiente server di produzione.
Si possono usare gli script /opt/IBMRAC/bin/RACSecurityOn.sh e RACSecurityOff.sh per abilitare e disabilitare la protezione di base del collegamento. Quando la protezione è abilitata, l'utente di Studio Site Developer deve fornire una combinazione nome utente e password valida, cioè un nome utente e password di sistema operativo, quando si collega all'Agent Controller. Il nome utente e la password vengono inoltrate dall'Agent Controller al sistema operativo per l'autenticazione.
Per disinstallare WebSphere Application Server - Express su AIX, procedere come segue:
./uninstaller
In questa sezione sono illustrati i problemi noti e le limitazioni relativi all'installazione e disinstallazione di WebSphere Application Server - Express per AIX. Per informazioni sui problemi e sulle limitazioni che influiscono sull'utilizzo del prodotto, consultare il file readme.
Se l'installazione ha esito negativo:
Occasionalmente un problema di installazione può causare il mancato completamento dei file di disinstallazione nella cartella _uninst. Questa condizione provoca la visualizzazione di un messaggio che avverte dell'impossibilità di trovare una JVM adatta durante la disinstallazione. Sarà necessario eseguire manualmente la disinstallazione, come segue:
Se sul sistema è presente una copia precedente di WebSphere Application Server - Express prima di procedere è necessario disinstallarla.
Per installare WebSphere Application Server - Express dal CD del prodotto, attenersi alla seguente procedura:
Nota di installazione:
Eseguendo il comando '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary' da una finestra comandi, è possibile che vengano riportati errori del tipo 'mqver non trovato' e 'wempsservice non trovato'. E' possibile ignorare questi messaggi di errore.
Prima di installare il prodotto, verificare quanto segue:
L'immagine del CD Solaris di WebSphere Application Server - Express è suddivisa in più parti per ridurre le dimensioni dei download. Ogni parte è un file tar (tape archive) e sono richieste tutte le parti.
Per installare le immagini elettroniche di WebSphere Application Server - Express, procedere come segue:
Dopo aver installato WebSphere Application Server - Express, nella directory /opt/IBM/WebSphere/Express51, dovrebbe essere stata creata la seguente struttura di directory:
Se una di queste directory contiene un numero molto diverso di file allora potrebbe essersi verificato un problema durante l'installazione. Fare riferimento al file /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
Il programma di installazione di WebSphere Application Server - Express può essere eseguito in modalità non presidiata, se si desidera unire il prodotto ai propri. Per installare WebSphere Application Server - Express in modalità non presidiata viene usata l'opzione da riga comandi -silent. Durante l'installazione non presidiata dall'utente, non è possibile vedere i pannelli della procedura guidata una volta invocato il comando di installazione.
Per eseguire l'installazione in modalità non presidiata con tutti i valori predefiniti, eseguire il comando:
./solaris/setupSolaris -silent
Si può anche usare un file di risposte per impostare ulteriori opzioni per l'installazione in modalità non presidiata. Per un modello, fare riferimento al file di risposte sul CD di installazione. Per eseguire un'installazione non presidiata con file di risposte utilizzare il comando:
./solaris/setupSolaris -silent -options <percorso_completo>/responsefile
Per disinstallare WebSphere Application Server - Express su Solaris, procedere come segue:
./uninstaller
In questa sezione sono illustrati i problemi noti e le limitazioni relativi all'installazione e disinstallazione di WebSphere Application Server - Express per Solaris. Per informazioni sui problemi e sulle limitazioni che influiscono sull'utilizzo del prodotto, consultare il file readme.
Se l'installazione ha esito negativo:
Occasionalmente un problema di installazione può causare il mancato completamento dei file di disinstallazione nella cartella _uninst. Questa condizione provoca la visualizzazione di un messaggio che avverte dell'impossibilità di trovare una JVM adatta durante la disinstallazione. Sarà necessario eseguire manualmente la disinstallazione, come segue:
Questa sezione contiene informazioni su come installare WebSphere Application Server - Express su HP-UX. Su HP-UX è possibile installare solo il componente Application Server di WebSphere Application Server - Express. Per gestire Application Server su HP-UX, utilizzare la console di gestione.
E' possibile installare WebSphere Application Server - Express dal CD-ROM o dalle immagini in linea che è possibile scaricare.
Se sul sistema è presente una copia precedente di WebSphere Application Server - Express prima di procedere è necessario disinstallarla.
Per installare WebSphere Application Server - Express dal CD del prodotto, attenersi alla seguente procedura:
Nota di installazione:
Eseguendo il comando '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary' da una finestra comandi, è possibile che vengano riportati errori del tipo 'mqver non trovato' e 'wempsservice non trovato'. E' possibile ignorare questi messaggi di errore.
Prima di installare il prodotto, verificare quanto segue:
L'immagine del CD HP/UX di WebSphere Application Server - Express è suddivisa in più parti per ridurre le dimensioni dei download. Ogni parte è un file tar (tape archive) e sono richieste tutte le parti.
Per installare le immagini in linea di WebSphere Application Server - Express, procedere come segue:
Dopo aver installato WebSphere Application Server - Express, nella directory /opt/IBM/WebSphere/Express51, dovrebbe essere stata creata la seguente struttura di directory:
Se una di queste directory contiene un numero molto diverso di file, potrebbe essersi verificato un problema durante l'installazione. Fare riferimento al file /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
E' possibile verificare l'esito dell'installazione di Application Server eseguendo il comando Verifica installazione server dall'applicazione introduttiva. Tale applicazione viene avviata al termine dell'applicazione. Può essere avviata manualmente eseguendo lo script /opt/IBM/WebSphere/Express51/Express/bin/launchFirstSteps.sh.
E' anche possibile verificare l'esito dell'installazione di Application Server eseguendo lo script /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh. Questo script eseguirà l'avvio e l'arresto di Application Server usando la sua configurazione predefinita. Questo file script viene usato solo per testare l'installazione del server.
Il programma di installazione di WebSphere Application Server - Express può essere eseguito in modalità non presidiata, se si desidera unire il prodotto ai propri. Per installare WebSphere Application Server - Express in modalità non presidiata viene usata l'opzione -silent nella riga comandi. Durante l'installazione non presidiata dall'utente, non è possibile vedere i pannelli della procedura guidata una volta eseguito il comando di installazione.
Per eseguire l'installazione in modalità non presidiata con tutti i valori predefiniti, eseguire il comando:
./hpux/setupHPUX -silent
Si può anche usare un file di risposte per impostare ulteriori opzioni per l'installazione in modalità non presidiata. Per un modello, fare riferimento al file di risposte sul CD di installazione. Per eseguire un'installazione non presidiata con un file di risposte, utilizzare il comando:
./hpux/setupHPUX -silent -options <percorso_completo/responsefile
Per disinstallare WebSphere Application Server - Express su HP-UX, procedere come segue:
./uninstaller
In questa sezione sono illustrati i problemi noti e le limitazioni relativi all'installazione e disinstallazione di WebSphere Application Server - Express per HP-UX. Per informazioni sui problemi e sulle limitazioni che influiscono sull'utilizzo del prodotto, consultare il file readme.
Se l'installazione non riesce:
A volte, un problema di installazione può far sì che la copia dei file di disinstallazione nella directory _uninst, non venga completata. Come conseguenza, viene visualizzato un messaggio sull'impossibilità di trovare una JVM adatta durante la disinstallazione. In questi casi, sarà necessario eseguire manualmente la disinstallazione, come segue:
Benvenuti nella funzione plug-in del server Web di WebSphere Application Server - Express.
I plug-in del server Web consentono agli utenti di separare il computer del server Web e il computer del server Express Application in modo da ottenere maggiore protezione e prestazioni migliori. Questa separazione consente inoltre una maggiore flessibilità nell'architettura del sito Web in generale.
Tali plug-in comunicano con WebSphere Application Server - Express attraverso HTTP(S).
L'installazione dei plug-in del server Web comprende tutti i componenti necessari per configurare automaticamente i seguenti server Web sulle piattaforme in cui sono supportati.
| Apache Web Server |
|
| IBM HTTP Web Server |
|
| Microsoft Internet Information System (IIS) |
|
| iPlanet (Sun ONE) Web Server |
|
| Lotus Domino Web Server |
|
| WebSphere Application Server - Express |
Nota #1
|
Note:
| Apache Web Server |
|
| IBM HTTP Web Server |
|
| Microsoft Internet Information System (IIS) |
|
| iPlanet (Sun ONE) Web Server |
|
| Lotus Domino Web Server |
|
| WebSphere Application Server - Express |
Vedere Nota #1
|
Note:
La directory in cui verranno installato i file di plug-in del server e le librerie. Se WebSphere Application Server - Express è già installato, il percorso predefinito sarà <DirInstallazioneExpress>/Plugins.
Nota: la directory di installazione è la cartella in cui verranno installati i file della licenza, i file del prodotto, la JVM e i file di disinstallazione. I file di plug-in del server Web necessari al run-time vengono installati in <DirInstallazione>/../AppServer.
Struttura di directory di esempio:
C:\
- Programmi
-IBM
-WebSphere
- Plugins
- AppServer
In ambiente a singolo tier, dove il server Web viene installato sullo stesso computer di Express Application Server, i plug-in verranno inseriti nella directory <ExpressInstallDir>/AppServer di WebSphere Application Server - Express. In tal modo i plug-in verranno integrati in Express Application Server e la directory predefinita del plugin-cfg.xml rigenerato sarà la stessa directory che viene utilizzata dal server Web. Quindi non sarà necessario copiare manualmente o spostare il file plugin-cfg.xml rigenerato.
Il nome host del computer su cui WebSphere Application Server - Express è in esecuzione. Questa informazione viene raccolta per inserire i valori appropriati nel file di configurazione del plug-in (plugin-cfg.xml). Il valore predefinito è il nome dell'host locale. Se WebSphere Application Server - Express è in esecuzione su un computer diverso, immettere il nome host del server remoto.
Per ciascun plug-in del server Web che si desidera installare, verrà richiesto il percorso del file di configurazione corrispondente. Per continuare con l'installazione, il file deve essere disponibile.
Per informazioni dettagliate, consultare la sezione 4.0 "Modifiche apportate alla configurazione del server Web".
Per informazioni dettagliate, consultare la sezione 4.0 "Modifiche apportate alla configurazione del server Web".
Questa sezione descrive le modifiche apportate ai file di configurazione del server Web durante l'installazione come attività che possono essere completate manualmente. Tali operazioni vengono eseguite automaticamente dal processo di installazione e vengono riportate solo come riferimento.
Le modifiche includono un riferimento alla libreria di plug-in del server Web e un riferimento al percorso del file di configurazione (plugin-cfg.xml).
Operazioni per queste attività
Utilizzare le voci riportate di seguito come modello per la configurazione del file. NOTA: <pluginsInstallRoot> è la directory principale di installazione dei plug-in di WebSphere Application Server - Express.
LoadModule ibm_app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_ibm_app_server_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
Nota: la directory principale di installazione varia in base al sistema operativo. Ad esempio, la directory di installazione in AIX è /opt/IBM/WebSphere/Express51/Plugins/ per la Versione 5.
LoadModule ibm_app_server_http_module <pluginsInstallRoot>\bin\mod_ibm_app_server_http.dll WebSpherePluginConfig <pluginsInstallRoot>\config\cells\plugin-cfg.xml
Utilizzare le voci riportate di seguito come modello per la configurazione del file.
LoadModule was_ap20_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_was_ap20_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/plugins/config/cells/plugin-cfg.xml
Nota: la directory principale di installazione varia in base al sistema operativo. Ad esempio, la directory di installazione in AIX è /opt/IBM/WebSphere/Express51/Plugins/ per la Versione 5.
LoadModule was_ap20_module <pluginsInstallRoot>\bin\mod_was_ap20_http.dll WebSpherePluginConfig <pluginsInstallRoot>\config\cells\plugin-cfg.xml
Nota: se la direttiva di IBM HTTP Server 1.3.26, LoadModule ibm_app_server_http_module, è contenuta nel file httpd.conf di IBM HTTP Server 2.0, non sarà possibile avviare IBM HTTP Server. Per avviare la versione 2 del server, sarà necessario commentare o eliminare la direttiva.
Utilizzare le voci riportate di seguito come modello per la configurazione del file.
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_app_server_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
La maggior parte dei server Web Apache non vengono compilati con supporto EAPI (Extended API). Se all'avvio del server Web con il plug-inmod_app_server_http.so, viene visualizzato un messaggio simile al seguente, utilizzare la versione EAPI del modulo.
[Tue Jul 2 13:20:14 2002] [warn] Loaded DSO /opt/IBM/WebSphere/AppServer/bin/mod_app_server_http.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -D EAPI)
Per utilizzare il modulo EAPI, configurare il file httpd.conf in modo che faccia riferimento a mod_app_server_http_eapi.so invece che a mod_app_server_http.so:
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_app_server_http_eapi.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
Nota: la directory principale di installazione varia in base al sistema operativo. Ad esempio, la directory di installazione in AIX è /opt/IBM/WebSphere/Express51/Plugins/ per la Versione 5.
LoadModule app_server_http_module <pluginsInstallRoot>\bin\mod_app_server_http.dll WebSpherePluginConfig <pluginsInstallRoot>\config\cells\plugin-cfg.xml
La maggior parte dei server Web Apache non vengono compilati con supporto EAPI (Extended API). Se all'avvio del server Web con il plug-inmod_app_server_http.dll, viene visualizzato un messaggio simile al seguente, utilizzare la versione EAPI del modulo.
[Tue Jul 2 13:20:14 2002] [warn] Loaded DSO C:\WebSphere\AppServer\bin\mod_app_server_http.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -D EAPI)
Per utilizzare il modulo EAPI, configurare il file httpd.conf in modo che faccia riferimento a mod_app_server_http_eapi.dll invece che a mod_app_server_http.dll:
LoadModule app_server_http_module <pluginsInstallRoot>\bin\mod_app_server_http_eapi.dll WebSpherePluginConfig <pluginsInstallRoot>\config\cells\plugin-cfg.xml
Per abilitare il plug-in di trasporto HTTP affinché funzioni con Domino Versione 5.05 o 5.06, procedere come segue. La procedura guidata per l'installazione non esegue questa operazione. Eseguire questa procedura manuale.
Nota: se sono già stati specificati dei filtri di file DSAPI (Domino Web Server Application Programming Interface), utilizzare uno spazio per delimitare il file di plug-in di WebSphere Application Server.
Impostare la variabile di ambiente WAS_HOME in modo che indichi la directory principale di installazione di WebSphere Application Server.
Aggiungere la variabile Plugin Config al registro nel percorso HKEY_LOCAL_MACHINE > SOFTWARE > IBM > WebSphere Application Server > 5.1.0.0. Impostare il valore di questa variabile sul percorso del file plugin-cfg.xml, ovvero <pluginsInstallRoot>\config\cells\plugin-cfg.xml.
Dove <pluginsInstallRoot> è la directory principale di installazione dei plug-in di WebSphere Application Server - Express.
02/12/2001 03:05:09 PM JVM: Java virtual machine initialized WebSphere Application Server DSAPI filter loaded 02/12/2001 03:05:10 PM HTTP Web Server started
Utilizzare le voci riportate di seguito come modello per la configurazione del file.
Includere le seguenti direttive nel file obj.conf:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="/opt/IBM/WebSphere/Express51/Plugins/bin/libns41_http.so" Init fn="as_init" bootstrap.properties=" /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml" Service fn="as_handler"
Nota: la directory principale di installazione varia in base al sistema operativo. Ad esempio, la directory di installazione in AIX è /opt/IBM/WebSphere/Express51/Plugins/ per la Versione 5.
Aggiungere una direttiva al file obj.conf dopo "<Object name=default>":
Service fn="as_handler"
Aggiungere due direttive alla fine del file magnus.conf:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="/opt/IBM/WebSphere/Express51/Plugins/bin/libns41_http.so" Init fn="as_init" bootstrap.properties="/opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml"
Nota: la directory principale di installazione varia in base al sistema operativo. Ad esempio, la directory di installazione in AIX è /opt/IBM/WebSphere/Express51/Plugins/ per la Versione 5.
Includere le seguenti direttive nel file obj.conf:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="<pluginsInstallRoot>\bin\libns41_http.dll" Init fn="as_init" bootstrap.properties=" <pluginsInstallRoot>\config\cells\plugin-cfg.xml" Service fn="as_handler"
Aggiungere una direttiva al file obj.conf dopo "<Object name=default>":
Service fn="as_handler"
Aggiungere due direttive alla fine del file magnus.conf:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="<pluginsInstallRoot>\bin\libns41_http.dll" Init fn="as_init" bootstrap.properties=" <pluginsInstallRoot>:\config\cells\plugin-cfg.xml"
Attenersi alla seguente procedura per riprodurre manualmente le operazioni eseguite dalla procedura guidata di installazione per configurare il server Web Internet Service Manager (IIS):
Dove <pluginsInstallRoot> è la directory principale di installazione dei plug-in di WebSphere Application Server - Express.
Dopo aver distribuito le applicazioni in WebSphere Application Server - Express, è necessario rigenerare il file di configurazione del plug-in del server Web, plugin-cfg.xml.
Per rigenerare il file plugin-cfg.xml in base alla configurazione corrente di WebSphere Express Application Server, con WebSphere Application Server - Express versione 5.1.0, utilizzare lo script genPluginCfg.
Dove <ExpressInstallDir> è la directory principale di installazione di WebSphere Application Server - Express
Dove <PluginInstallRoot> è la directory principale di installazione dei plug-in di WebSphere Application Server - Express.
Se dovessero verificarsi le seguenti situazioni, sarà necessario modificare manualmente il file plugin-cfg.xml:
<?xml version="1.0" encoding="ISO-8859-1" ?> <Config> <Log LogLevel="Error" Name="C:\Program Files\IBM\WebSphere\Express51\Plugins\logs\http_plugin.log" /> <VirtualHostGroup Name="default_host"> <VirtualHost Name="*:7080" /> <VirtualHost Name="*:80" /> <VirtualHost Name="*:7443" /> </VirtualHostGroup> <ServerCluster Name="server1_DefaultNode_Cluster"> <Server Name="DefaultNode_server1"> <Transport Hostname="myHostname.raleigh.ibm.com" Port="7080" Protocol="http" /> <Transport Hostname="myHostname.raleigh.ibm.com" Port="7443" Protocol="https"> <Property name="keyring" value=" C:\Program Files\IBM\WebSphere\Express51\Plugins\etc\plugin-key.kdb" /> <Property name="stashfile" value=" C:\Program Files\IBM\WebSphere\Express51\Plugins\etc\plugin-key.sth" /> </Transport> </Server> <PrimaryServers> <Server Name="DefaultNode_server1" /> </PrimaryServers> </ServerCluster> <UriGroup Name="default_host_server1_DefaultNode_Cluster_URIs"> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/UTC/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/CustomHomePageExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/YourCoExpressExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/CustomerServiceExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/DocumentMgmtExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/SurveyExample/*" /> </UriGroup> <Route ServerCluster="server1_DefaultNode_Cluster" UriGroup="default_host_server1_DefaultNode_Cluster_URIs" VirtualHostGroup="default_host" /> </Config>
Quando il server Web è installato su un computer diverso da quello di WebSphere Application Server - Express, il file plugin-cfg.xml generato dovrà essere spostato nella directory <PluginsInstallRoot>/config/cells situata nel computer del server Web. Di conseguenza, i percorsi indicati nel file plugin-cfg.xml dovranno essere modificati manualmente. Utilizzando lo script genPluginCfg ripetutamente, gli aggiornamenti verranno uniti e gli aggiornamenti manuali alle voci di percorso verranno preservati.
Esempio: export SHLIB_PATH=/usr/lib:/lib
Il CD-ROM del prodotto è in formato ISO-9660 con estensione Rockridge. Potrebbe essere necessario comprare il CD-ROM manualmente. Per montare o annullare il montaggio del CD-ROM, è necessario disporre di privilegi root.
Per montare il CD-ROM in HP-UX, procedere come segue:
/usr/sbin/pfs_mountd &
/usr/sbin/pfsd &
<file_unità> <punto_montaggio> <tipo_filesystem> <metodo_conversione
Esempio: /dev/dsk/c0t0d0 /cdrom pfs-rrip ro,suid 0 0
/usr/sbin/pfs_mount/cdrom
/usr/sbin/pfs_umount /cdrom
Esempio: export WAS_HOME=/opt/IBM/WebSphere/Express51/Plugins
WebSphere Application Server - Express, versione 5.1 contiene un'applicazione preinstallata, Snoop, che può essere utilizzata per verificare che il plug-in del server Web sia stato installato e configurato correttamente. Il file di configurazione del plug-in del server Web, plugin-cfg.xml, installato durante l'installazione dei plug-in, è preconfigurato per verificare il funzionamento dell'applicazione Snoop. Tuttavia, è anche possibile rigenerare i plug-in attenendosi alle istruzioni riportate in questa documentazione.
SUGGERIMENTO: dopo aver rigenerato il file di configurazione del plug-in, riavviare il server Web.
Procedura per la verifica del funzionamento del plug-in del server Web
http://nome_server_utente:7080
SUGGERIMENTO: se non risulta possibile avviare il server Web, fare riferimento alla sezione "Suggerimenti per la risoluzione dei problemi" di questa pubblicazione.
NOTA: non specificare il trasporto interno, 7080, di WebSphere Express Application Server. Il plug-in del server Web Server funzionerà come proxy per il server utilizzando il trasporto interno 7080. L'URL seguente prevede che il server Web attenda le comunicazioni sulla porta HTTP 80 predefinita:
http://nome_server_utente
Se il plug-in del server Web è stato installato e configurato correttamente, nel browser verrà visualizzata la pagina Web predefinita di WebSphere Application Server.
Primo suggerimento: una delle ragioni più comuni per cui non è possibile avviare il server Web dopo aver configurato il plug-in, è che il file plugin-cfg.xml contiene informazioni non valide o non corrette e non può essere analizzato dal server Web. Più spesso, il problema è causato da una delle seguenti condizioni:
In caso di problemi con il componente HTTP plug-in, il componente che invia richieste dal server HTTP, ad esempio IBM HTTP Server, Apache, o IIS, a Websphere Application Server - Express, procedere come segue:
Se in tali file non viene individuata la causa del problema, procedere come segue.
Operazioni per l'individuazione di problemi con il plug-in
Il plug-in fornisce una traccia facilmente leggibile che può risultare utile nella individuazione dei problemi. Impostando l'attributo LogLevel nel file config/plugin-cfg.xml su Trace, è possibile seguire l'elaborazione delle richieste e vedere dove si presenta il problema. Generalmente:
E' possibile seguire chiaramente queste operazioni leggendo la traccia di una singola richiesta:
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: --------------------System Information-------------------- [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Bld date: Jul 3 2002, 15:35:09 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Webserver: IIS [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Hostname = SWEETTJ05 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: OS version 4.0, build 1381, 'Service Pack 6' [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: ---------------------------------------------------------------
ws_common: websphereGetStream: Impossibile collegarsi al server app, OS err=%d
Dove %d è un codice di errore specifico del sistema operativo relativo al motivo per cui la chiamata connect() non è riuscita. Il problema può verificarsi per diversi motivi.
La rigenerazione del file plugin-cfg.xml può essere eseguita mediante il browser basato sulla console di amministrazione o utilizzando lo script GenPluginCfg situato in <DirInstallazioneExpress>/AppServer/bin.
Utilizzo: GenPluginCfg [[-option.name optionValue]...]
Opzioni valide:
-config.root configroot_dir
(impostato per valore predefinito sulla variabile di ambiente CONFIG_ROOT)
-cell.name cell
(impostato per valore predefinito sulla variabile di ambiente WAS_CELL)
-node.name node
(impostato per valore predefinito sulla variabile di ambiente WAS_NODE)
-server.name server
(richiesto per la generazione del plugin del singolo server)
-output.file.name nome_file
(impostato per valore predefinito su configroot_dir/plugin-cfg.xml)
-destination.root root
(la directory principale di installazione della configurazione macchina)
-destination.operating.system windows/unix
(il sistema operativo della configurazione macchina)
-debug yes/no
(impostato per valore predefinito su no)
Esempi:
IBM HTTP server
Articoli tecnici e codici di esempio
Aggiornamenti alla documentazione
Per informazioni aggiornate su WebSphere Application Server - Express diverse da quelle incluse nel sistema della guida in linea, fare riferimento ai seguenti siti Web:
Questa sezione descrive come impostare i plug-in di protezione del server Web per WebSphere Application Server - Express. I plug-in di protezione del server Web dovrebbero essere installati dal CD dei plug-in incluso con WebSphere Application Server - Express Versione 5.1.1.
I plug-in di protezione del server Web consentono agli utenti di separare il computer del server Web e il computer del server Express Application in modo da ottenere maggiore protezione e prestazioni migliori. Questa separazione consente inoltre una maggiore flessibilità nell'architettura del sito Web in generale.
Tali plug-in di protezione comunicano con WebSphere Application Server - Express attraverso HTTP(S).
L'installazione dei plug-in del server Web comprende tutti i componenti necessari per configurare automaticamente i seguenti server Web sulle piattaforme in cui sono supportati.
Il plug-in di protezione del server Web deve essere installato sullo stesso computer del server Web HTTP. Assicurarsi che il server Web HTTP sia già installato sul computer prima di installare il plug-in del server Web HTTP.
Per informazioni dettagliate sui seguenti argomenti, fare riferimento al file README sul CD di installazione dei plug-in:
Per installare i plug-in di protezione del server Web HTTP dal CD, procedere come segue:
La directory in cui verranno installato i file di plug-in del server e le librerie. Se WebSphere Application Server - Express è già installato, il percorso predefinito sarà <ExpressInstallDir>/Plugins.
Nota: la directory di installazione è la cartella in cui verranno installati i file della licenza, i file del prodotto, la JVM e i file di disinstallazione. I file di plug-in del server Web necessari al run-time vengono installati in in <InstallDir>/../AppServer.
Struttura di directory di esempio:
C:\ Programmi\IBM\WebSphere\Plugins
C:\Programmi\IBM\WebSphere\Appserver
In ambiente a singolo tier, dove il server Web viene installato sullo stesso computer di Express Application Server, i plug-in verranno inseriti nella directory <ExpressInstallDir>/AppServer di WebSphere Application Server - Express. In tal modo i plug-in verranno integrati in Express Application Server e la directory predefinita del plugin-cfg.xml rigenerato sarà la stessa directory che viene utilizzata dal server Web. Quindi non sarà necessario copiare manualmente o spostare il file plugin-cfg.xml rigenerato.
Il nome host del computer su cui WebSphere Application Server - Express è in esecuzione. Questa informazione viene raccolta per inserire i valori appropriati nel file di configurazione del plug-in (plugin-cfg.xml). Il valore predefinito è il nome dell'host locale. Se WebSphere Application Server - Express è in esecuzione su un computer diverso, immettere il nome host del server remoto.
Per ciascun plug-in del server Web che si desidera installare, verrà richiesto il percorso del file di configurazione corrispondente. Per continuare con l'installazione, il file deve essere disponibile.
Il programma di installazione di WebSphere Application Server - Express Plug-in può essere eseguito in modalità non presidiata, se si desidera unire il prodotto ai propri. Per installare WebSphere Application Server - Express Plug-in in modalità non presidiata, viene usata l'opzione della riga comandi -silent. Durante l'installazione non presidiata dall'utente, non è possibile vedere i pannelli della procedura guidata una volta eseguito il comando di installazione.
Per impostare le opzioni appropriate per l'installazione non presidiata, utilizzare un file di risposte. Per un modello, fare riferimento al file di risposte sul CD di installazione. Per eseguire un'installazione non presidiata con file di risposte utilizzare il comando:
Per Windows:
install.exe -silent -options <percorso_completo>/responsefile
Per Linux e Unix:
linux/setupLinux -silent -options <percorso_completo>/responsefile
Esempi per piattaforme Unix:
WebSphere Application Server - Express, versione 5.1 contiene un'applicazione preinstallata, Snoop, che può essere utilizzata per verificare che il plug-in del server Web sia stato installato e configurato correttamente. Il file di configurazione del plug-in del server Web, plugin-cfg.xml, installato durante l'installazione dei plug-in, è preconfigurato per verificare il funzionamento dell'applicazione Snoop. Tuttavia, è anche possibile rigenerare i plug-in attenendosi alle istruzioni riportate in questa documentazione.
SUGGERIMENTO: dopo aver rigenerato il file di configurazione del plug-in, riavviare il server Web.
Procedura per la verifica del funzionamento del plug-in del server Web
http://nome_server_utente:7080
SUGGERIMENTO: se non risulta possibile avviare il server Web, fare riferimento alla sezione "Suggerimenti per la risoluzione dei problemi" di questa pubblicazione.
NOTA: non specificare il trasporto interno, 7080, di WebSphere Express Application Server. Il plug-in del server Web Server funzionerà come proxy per il server utilizzando il trasporto interno 7080. L'URL seguente prevede che il server Web attenda le comunicazioni sulla porta HTTP 80 predefinita:
http://nome_server_utente
Se il plug-in del server Web è stato installato e configurato correttamente, nel browser verrà visualizzata la pagina Web predefinita di WebSphere Application Server.
Per disinstallare il plug-in di protezione del server Web HTTP di WebSphere Application Server - Express, procedere come segue:
Per disinstallare il plug-in del server Web HTTP per WebSphere Application Server - Express sulle piattaforme Linux e Unix, procedere come segue:
./uninstaller
Per impostazione predefinita, i plug-in CVS (Concurrent Versions System) vengono installati automaticamente con WebSphere Application Server - Express. L'ultima versione del server CVS è disponibile sul sito Web www.cvshome.org. Per utilizzare CVS non è necessario installare un client CVS, ma soltanto un server CVS. Per ulteriori informazioni sull'installazione e l'utilizzo di CVS, consultare la guida in linea team. Inoltre, è disponibile un articolo sul supporto team CVS in WebSphere Application Server - Express sul sito Web www.ibm.com/websphere/developer/library/ techarticles/0108_karasiuk/0108_karasiuk.html
In alternativa a CVS, è possibile utilizzare Rational(R) ClearCase(R) come sistema SCM (software configuration management). Per ulteriori informazioni su Rational ClearCase, fare riferimento a www.ibm.com/software/awdtools/clearcase/
Il server CVS e il client Rational ClearCase non vengono installati automaticamente. E' necessario installarli separatamente da WebSphere Studio.
E' possibile integrare altri repository SCM con WebSphere Application Server - Express mediante adattatori team SCM (noti in Eclipse come provider di team). Per un elenco dei prodotti e degli adattatori SCM forniti dai Business Partner IBM, visitare il sito www-3.ibm.com/software/awdtools/studioappdev/about/ e, nella sezione Further reading, selezionare SCM Adaptor Vendors. Da questo elenco, è possibile accedere a siti Web di fornitori dei prodotti SCM per scaricare gli adattatori SCM desiderati. IBM non fornisce alcuna garanzia né si assume alcuna responsabilità per questi adattatori. Per il supporto o per ulteriori informazioni, rivolgersi direttamente al rivenditore del prodotto SCM.
Nota relativa alle Limitazioni previste per gli Utenti del Governo degli Stati Uniti - l'uso, la duplicazione o la divulgazione sono limitati dal GSA ADP Schedule Contract con la IBM Corp.
Queste informazioni sono state sviluppate per i prodotti e i servizi offerti negli Stati Uniti. E' possibile che negli altri paesi l'IBM non offra i prodotti, i servizi o le funzioni illustrati in questa documentazione. Consultare il rappresentante locale IBM per informazioni sui prodotti e sui servizi attualmente disponibili nel proprio paese. Qualsiasi riferimento relativo a prodotti, programmi o servizi IBM non implica che solo quei prodotti, programmi o servizi IBM possano essere utilizzati. In sostituzione a quelli forniti dall'IBM, possono essere usati prodotti, programmi o servizi funzionalmente equivalenti che non comportino violazione dei diritti di proprietà intellettuale o di altri diritti dell'IBM. E' comunque responsabilità dell'utente valutare e verificare la possibilità di utilizzare altri prodotti, programmi o servizi non IBM.
L'IBM può essere titolare di brevetti o domande di brevetto in corso relativi a quanto trattato nella presente documentazione. La fornitura di tale documentazione non implica la concessione di alcuna licenza su di essi. Chi desiderasse ricevere informazioni relative a licenze può rivolgersi per iscritto a:
IBM Director of Commercial Relations
IBM Europe
Schoenaicher Str.220
D-7030 Boeblingen
Deutschland
Per richieste di licenza relative a informazioni double-byte (DBCS), contattare l'IBM Intellectual Property Department del vostro paese oppure scrivere a:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
L'IBM può utilizzare o divulgare le informazioni ricevute dagli utenti secondo le modalità ritenute appropriate, senza alcun obbligo nei loro confronti.
Il seguente paragrafo non è valido per il Regno Unito o per tutti i paesi le cui leggi nazionali siano in contrasto con le disposizioni in esso contenute: L'INTERNATIONAL BUSINESS MACHINES CORPORATION FORNISCE QUESTA PUBBLICAZIONE NELLO STATO IN CUI SI TROVA SENZA ALCUNA GARANZIA, IMPLICITA O ESPLICITA, IVI INCLUSE EVENTUALI GARANZIE DI COMMERCIABILITˇ ED IDONEITˇ AD UNO SCOPO SPECIFICO. Alcuni stati non consentono la rinuncia a garanzie esplicite o implicite in determinate transazioni, quindi la presente dichiarazione potrebbe non essere a voi applicabile.
Questa pubblicazione potrebbe contenere imprecisioni tecniche o errori tipografici. Le informazioni qui riportate vengono periodicamente modificate e tali modifiche saranno inserite nelle nuove edizioni. L'IBM si riserva il diritto di apportare miglioramenti e/o modifiche al prodotto o al programma descritto nel manuale in qualsiasi momento e senza preavviso.
Coloro che detengono la licenza su questo programma e desiderano avere informazioni su di esso allo scopo di consentire: (i) uno scambio di informazioni tra programmi indipendenti ed altri (compreso questo) e (ii) l'uso reciproco di tali informazioni, dovrebbero rivolgersi a:
Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham,
Ontario, Canada L6G 1C7
Queste informazioni possono essere rese disponibili, secondo condizioni contrattuali appropriate, compreso, in alcuni casi, il pagamento di un addebito.
Il programma su licenza descritto in questa documentazione e tutto il materiale su licenza ad esso relativo vengono forniti dall'IBM nei termini dell'IBM Customer Agreement, dell'IBM International Program License Agreement o di eventuali accordi equivalenti intercorsi tra le parti.
Le informazioni relative a prodotti non IBM sono state acquisite presso i fornitori di tali prodotti, gli annunci da loro pubblicati o altre fonti disponibili pubblicamente. L'IBM non ha verificato tali prodotti, quindi non può confermarne la qualità delle prestazioni, la compatibilità o altre dichiarazioni relative a prodotti non IBM. Eventuali commenti relativi alle prestazioni dei prodotti non IBM devono essere indirizzati ai fornitori di tali prodotti.
Tutti i riferimenti a siti Web non dell'IBM sono forniti unicamente a scopo di consultazione. Il contenuto di questi siti non rientra nella documentazione relativa al prodotto IBM in questione. Pertanto, l'utente si assume eventuali rischi per l'accesso a questi siti Web.
Queste informazioni possono contenere esempi relativi a dati e prospetti utilizzati in operazioni commerciali ordinarie. Perché queste vengano illustrate nel modo più dettagliato possibile, gli esempi possono includere nomi di persona, compagnie, marchi e prodotti. Tutti i nomi contenuti nel manuale sono fittizi e ogni riferimento a nomi e indirizzi reali è puramente casuale.
LICENZA RELATIVA AI DIRITTI D'AUTORE:
Queste informazioni contengono programmi applicativi di esempio in linguaggio di origine che illustrano tecniche di programmazione su diverse piattaforme operative. E' possibile copiare, modificare e distribuire questi esempi di programmi sotto qualsiasi forma senza alcun pagamento alla IBM, allo scopo di sviluppare, utilizzare, commercializzare o distribuire i programmi applicativi in modo conforme alle API (Application Programming Interface) a seconda della piattaforma operativa per cui i programmi sono stati scritti. Tali esempi non sono stati provati in tutte le condizioni di utilizzo. La IBM, quindi, non può garantire o assicurare l'affidabilità, la praticità o il funzionamento di questi programmi. E' possibile copiare, modificare e distribuire questi programmi in qualsiasi forma senza pagamenti a IBM per scopi di sviluppo, utilizzo, marketing o distribuzione di programmi applicativi conformi alle interfaccia IBM di programmazione delle applicazioni.
Qualsiasi copia o parte di questi programmi di esempio o dei lavori derivati, deve necessariamente includere le informazioni sul copyright, come di seguito riportato:
(C) (nome della società) (anno). Parti di questo codice derivano dai Programmi di esempio della IBM Corp. (C) Copyright IBM Corp. 2000, 2003. Tutti i diritti riservati.
Le informazioni relative all'interfaccia di programmazione hanno lo scopo di aiutare gli utenti a creare software applicativo utilizzando questo programma.
Le interfacce di programmazione di uso generale consentono di scrivere software applicativo che si avvalga dei servizi offerti dagli strumenti di questo programma.
Tuttavia, questa pubblicazione può anche contenere informazioni su diagnosi, modifiche e ottimizzazione di prestazioni. Queste informazioni vengono fornite per aiutare gli utenti a eseguire il debug del loro software applicativo.
Avviso: non utilizzare queste informazioni sulle diagnosi, le modifiche e la sintonizzazione come interfaccia di programmazione perché vanno soggette a cambiamenti.
I seguenti termini sono marchi della International Business Machines Corporation negli Stati Uniti e/o in altri paesi:
Java e tutti i marchi e i logo basati su Java sono marchi della Sun Microsystems, Inc. negli Stati Uniti e/o in altri paesi.
ActiveX, Microsoft, Windows, Windows NT e il logo di Windows sono marchi della Microsoft Corporation negli Stati Uniti e/o in altri paesi.
UNIX è un marchio della The Open Group.
Nomi di altre società, prodotti o servizi, che possono essere indicati da un doppio asterisco (**), possono essere marchi di altre società.