Utilizzare questa procedura per disinstallare IBM WebSphere ESB e la
copia di WebSphere Application Server Network
Deployment sottostante con la GUI (graphical user interface) della procedura guidata di disinstallazione.
Informazioni preliminari
Prima di disinstallare
WebSphere ESB utilizzando
questa procedura, essere certi di:
- Voler disinstallare WebSphere ESB in modo interattivo.
- Sapere se si desidera disinstallare il prodotto WebSphere Application Server Network Deployment sottostante
durante la disinstallazione di WebSphere ESB.
- Se si sceglie di disinstallare il prodotto WebSphere Application Server Network Deployment sottostante,
il programma di disinstallazione rimuove anche tutti i profili, incluse tutte le applicazioni ed i dati di
configurazione di ogni profilo.
- Se si sceglie di non disinstallare il prodotto WebSphere Application Server Network Deployment sottostante,
tutti i profili WebSphere ESB che sono stati
creati o ampliati verranno riportati ai profili WebSphere Application Server Network Deployment
se nessun altro prodotto ha ampliato i profili dopo WebSphere ESB.
- Eseguire il backup delle cartelle config, installableApps e
installedApps di ogni profilo, se necessario.
Eseguire il backup di tutte le applicazioni non conservate in un'altra ubicazione.
- Rimuovere l'applicazione enterprise della messaggistica di eventi,
il database di eventi e la configurazione per l'applicazione
Common Event Infrastructure, in questo ordine. Per informazioni relative alla rimozione di queste applicazioni
e del database, consultare Rimozione della configurazione Common Event Infrastructure
- Disinstallare il prodotto come utente root su un sistema Linux o UNIX oppure come un membro
del gruppo di amministratori su un sistema Windows.
Limitazione: la procedura guidata di disinstallazione non esegue disinstallazioni parziali, personalizzate
o incrementali.
Limitazione:
Su piattaforme Windows: le piattaforme Windows dispongono di una lunghezza massima
per i percorsi di file che corrisponde a 256 caratteri. Se un percorso di file per una directory di profilo è
troppo lungo, la procedura guidata di disinstallazione non può rimuovere la directory.
Il percorso di file può essere troppo lungo a causa di un nome di directory
profile_root lungo, di un nome di
cella lungo, di nomi di server del processo lunghi o di altri nomi lunghi utilizzati come nomi di cartelle di file
nelle directory all'interno del profilo. Sebbene le piattaforme Windows consentano la creazione di
percorsi di file lunghi, i sistemi operativi non consentono la cancellazione di percorsi
di file lunghi, anche durante il tentativo di una cancellazione manuale. Per abilitare la disinstallazione
nel caso si dovesse verificare questo problema, ridenominare le directory e le directory secondarie
per i file rimasti utilizzando nomi che possiedono un numero inferiore di caratteri.
Quindi eliminare le directory manualmente.
Perché e quando eseguire questa attività
Il programma di disinstallazione viene creato durante l'installazione del prodotto.
Viene personalizzato per ciascuna installazione del prodotto, con routine e ubicazioni del disco specifiche per la
rimozione delle funzioni installate.
Calcolo del tempo richiesto per la
disinstallazione: il tempo richiesto per la disinstallazione varia in base alla velocità di elaborazione della
macchina. Come indicazione approssimativa, la disinstallazione di WebSphere ESB, WebSphere Application Server Network
Deployment e di un profilo richiede circa 20 minuti.
Per disinstallare WebSphere ESB, effettuare i seguenti
passi.
Passi per questa attività
- Accedere come utente root su un sistema Linux o UNIX o come un utente del
gruppo di amministratori su un sistema Windows.
- Se si sta disinstallando il prodotto WebSphere Application Server Network
Deployment sottostante, eseguire il programma di disinstallazione per i plugin del server web
per WebSphere Application Server.
Se il sistema include un server web configurato per l'esecuzione con WebSphere Application Server Network
Deployment, disinstallare i plugin per rimuovere la configurazione dal server
web. Per questo prodotto, consultare la procedura di disinstallazione nell'information center di WebSphere Application Server Network
Deployment, all'indirizzo http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp.
- Se è installato un gestore distribuzione, arrestare il processo del gestore
distribuzione dmgr con il comando stopManager.
Arrestare tutti i
processi
dmgr in esecuzione sulla macchina. Ad esempio, inoltrare uno dei seguenti
comandi, in base alla piattaforma (dove
profile_root rappresenta la directory di
installazione del profilo del gestore distribuzione):
su piattaforme Linux e UNIX: profile_root/bin/stopManager.sh
-user user_ID -password password
Su piattaforme Windows: profile_root\bin\stopManager.bat
-user user_ID -password password
- Arrestare il processo nodeagent con il comando stopNode.
Se si dispone di nodi associati ad un gestore distribuzione sul sistema, arrestare il processo
nodeagent che potrebbe essere in esecuzione su ogni macchina con un nodo
associato. Ad esempio, inoltrare uno dei seguenti comandi per arrestare il processo nodeagent, in base alla
piattaforma (dove
profile_root rappresenta la directory di installazione del nodo
associato):
Su piattaforme Linux e UNIX: profile_root/bin/stopNode.sh
Su piattaforme Windows: profile_root\bin\stopNode.bat
- Arrestare ciascun server in esecuzione con il comando stopServer.
Arrestare tutti i processi del server in tutti i profili sulla macchina. Ad esempio, inoltrare uno dei
seguenti comandi per arrestare il server
server1 nel profilo, in base alla
piattaforma. In questo esempio,
profile_root rappresenta l'ubicazione di installazione
del profilo:
Su piattaforme Linux e UNIX: profile_root/bin/stopServer.sh
server1
Su piattaforme Windows: profile_root\bin\stopServer.bat
server1
- Opzionale: eseguire il backup dei file di log e dei file di configurazione per un
riferimento successivo, se necessario.
Il programma di disinstallazione non rimuove i file di
log nella directory install_root. Se si sceglie di disinstallare il
prodotto WebSphere Application Server Network Deployment sottostante, il
programma di disinstallazione rimuove tutti i profili e tutti i dati presenti nei profili.
Eseguire il backup
delle cartelle config e logs di ciascun profilo per un riferimento
successivo, se necessario. Non è possibile riutilizzare i profili, pertanto non è necessario eseguire
il backup di un intero profilo.
- Inoltrare il comando uninstall da una riga comandi.
La procedura guidata di disinstallazione si avvia e viene visualizzato il pannello di
Benvenuto.
- Nel pannello di Benvenuto, selezionare se disinstallare il prodotto WebSphere Application Server Network
Deployment sottostante, durante la disinstallazione di WebSphere ESB.
Quindi fare clic su Avanti. Viene visualizzato uno dei quattro pannelli:
- Se tutti i server sono in esecuzione sul sistema, un pannello di attenzione avvisa l'utente di chiudere i server e riavviare la
disinstallazione. Annullare la disinstallazione ed arrestare i server in
esecuzione.
- Se nessun server è in esecuzione, se non si è scelto di disinstallare il
prodotto WebSphere Application Server Network
Deployment sottostante e se il programma di disinstallazione determina che i profili possono essere riportati
correttamente ai profili WebSphere Application Server, viene
visualizzato il pannello relativo al riepilogo di disinstallazione. Proseguire con il passo 10.
- Se nessun server è in esecuzione, se non si è scelto di disinstallare il
prodotto WebSphere Application Server Network
Deployment sottostante e se il programma di disinstallazione determina che non può essere annullato
correttamente l'ampliamento dei profili, viene visualizzato un pannello di attenzione che informa l'utente che i
profili WebSphere ESB non saranno
utilizzabili. Proseguire con il passo 9.
- Se nessun server è in esecuzione, se si è scelto di disinstallare il prodotto WebSphere Application Server Network
Deployment sottostante, viene visualizzato un pannello di attenzione che informa l'utente che i
profili WebSphere ESB saranno
eliminati. Proseguire con il passo 9.
- Dal pannello di attenzione, selezionare se si desidera continuare
la disinstallazione. Fare clic su Avanti per continuare la disinstallazione o
su Indietro se si desidera riconsiderare la disinstallazione del prodotto.
Questa procedura di esempio presume che si desidera continuare la disinstallazione. Viene visualizzato il pannello relativo al riepilogo di disinstallazione.
- Esaminare il riepilogo del prodotto e delle funzioni che si stanno
disinstallando.
Fare clic su Avanti per continuare la disinstallazione del
prodotto o selezionare Indietro se si desidera riconsiderare la disinstallazione del
prodotto. Questa procedura di esempio presume che si desidera continuare la disinstallazione.
Ha inizio la disinstallazione del prodotto.
Se si esegue una selezione per disinstallare il prodotto WebSphere Application Server Network
Deployment sottostante, il programma di disinstallazione effettua le seguenti attività nel seguente
ordine:- Annulla l'ampliamento degli ultimi profili ampliati da WebSphere ESB.
- Disinstalla WebSphere ESB.
- Disinstalla WebSphere Application Server Network Deployment,
che elimina i profili.
Viene visualizzato il pannello relativo alla disinstallazione completata.
- Fare clic su Fine per chiudere la procedura guidata di disinstallazione.
- Rimuovere tutte le voci di configurazione nel nodo gestito, che descrivono un gestore distribuzione
eliminato.
Una topologia comune consiste nell'installare i file principali
del prodotto su più macchine. Una macchina possiede il gestore distribuzione ed altre macchine i
nodi gestiti creati dai profili personalizzati.
Se si elimina un'installazione in cui è stato creato un profilo personalizzato ed è stato associato un nodo all'interno di
una cella del gestore distribuzione in un'altra installazione, è necessario rimuovere la
configurazione dal gestore distribuzione.
L'istruzione ufficiale di supporto per un
problema relativo ad una configurazione di un nodo nel nodo gestito di utilizzare il
comando backupConfig dopo l'installazione iniziale.
Utilizzare nuovamente il comando se si effettuano modifiche importanti alla configurazione che è necessario
salvare. Con un backup valido della configurazione, è sempre possibile utilizzare il
comando restoreConfig per ritornare ad uno stato precedentemente esistente all'interno della
configurazione.
E' possibile utilizzare anche uno dei seguenti comandi sulla macchina, con il
nodo gestito, per rimuovere il nodo quando il gestore distribuzione non è in
esecuzione. In questo esempio
profile_root rappresenta la directory di installazione
del profilo del nodo gestito:
Su piattaforme Linux e UNIX: profile_root/bin
removeNode.sh -force
Su piattaforme Windows: profile_root\bin
removeNode.bat -force
Se si ripulisce manualmente la configurazione sul nodo gestito, è possibile tentare la seguente
procedura non supportata:
- Ridenominare la directory cell_name per il nodo con il nome di origine se il nome attuale
non è il nome di origine.
Andare ad una delle seguenti
directory e ridenominare la directory
cell_name con il nome di
origine. In questo esempio
profile_root rappresenta la directory di installazione
del profilo del nodo:
Su piattaforme Linux e UNIX: profile_root/config/cells/
Su piattaforme Windows: profile_root\config\cells\
- Eliminare la directory dmgr_node_name, se esiste.
Andare ad una delle seguenti directory per individuare la directory
dmgr_node_name che è necessario
eliminare. In questo esempio
profile_root rappresenta la directory di installazione
del profilo del nodo:
Su piattaforme Linux e UNIX: profile_root/config/cells/original_cell_name/nodes
Su piattaforme Windows: profile_root\config\cells\original_cell_name\nodes
- Modificare il file setupCmdLine.sh su un sistema operativo Linux o
UNIX oppure il file setupCmdLine.bat su un sistema
Windows e sostituire il nome della cella con il nome di origine della cella.
Il
file si trova in una delle seguenti directory, in base alla piattaforma. In questo esempio
profile_root rappresenta la directory di installazione
del profilo del nodo:
Su piattaforme Linux e UNIX: profile_root/bin
Su piattaforme Windows: profile_root\bin
Sostituire il valore della variabile
WAS_CELL con il nome di origine della
cella.
- Rimuovere tutte le voci di configurazione nel gestore distribuzione che descrivono un nodo gestito
eliminato.
Aprire la console di gestione del gestore distribuzione e fare
clic su Amministrazione di sistema > Nodi.
Selezionare la casella di spunta accanto al nodo che si desidera eliminare e poi selezionare Rimuovi
nodo.
L'istruzione ufficiale di supporto per un
problema relativo ad una configurazione di un nodo nel gestore distribuzione è di utilizzare il
comando backupConfig dopo l'installazione iniziale.
Utilizzare nuovamente il comando se si effettuano modifiche importanti alla configurazione che è necessario
salvare. Con un backup valido della configurazione, è sempre possibile utilizzare il
comando restoreConfig per ritornare ad uno stato precedentemente esistente all'interno della
configurazione.
Se si ripulisce manualmente la configurazione, è possibile tentare la seguente
procedura non supportata:
- All'interno della directory nodes del gestore distribuzione, rimuovere
la directory di configurazione per il nodo eliminato.
Andare ad una delle seguenti directory per individuare il file
deleted_node_name.
In questo esempio
profile_root rappresenta la directory di installazione
del profilo del gestore distribuzione:
Su piattaforme Linux e UNIX: profile_root/config/cells/cell_name/nodes
Su piattaforme Windows: profile_root\config\cells\cell_name\nodes
- All'interno della directory buses del gestore distribuzione, rimuovere
la directory di configurazione per il nodo eliminato.
Andare ad una delle seguenti directory per individuare il file
deleted_node_name.
In questo esempio
profile_root rappresenta la directory di installazione
del profilo del gestore distribuzione:
Su piattaforme Linux e UNIX: profile_root/config/cells/cell_name/buses
Su piattaforme Windows: profile_root\config\cells\cell_name\buses
- Modificare il file coregroup.xml in ogni directory secondaria della
directory coregroups del gestore distribuzione. Individuare gli elementi di
tipo coreGroupServers. Rimuovere tutti gli elementi coreGroupServers che fanno riferimento al nodo
eliminato.
Andare ad una delle seguenti directory per individuare
il file. In questo esempio
profile_root rappresenta la directory di installazione
del profilo del gestore distribuzione:
Su piattaforme Linux e UNIX: profile_root/config/cells/cell_name/coregroups/deleted_node_name
Su piattaforme Windows: profile_root\config\cells\cell_name\coregroups\deleted_node_name
- Modificare il file nodegroup.xml in ogni directory secondaria della
directory nodegroups del gestore distribuzione. Individuare gli elementi di
tipo members. Rimuovere tali elementi quando hanno un riferimento al nodo
eliminato.
Andare ad una delle seguenti directory per individuare
il file. In questo esempio
profile_root rappresenta la directory di installazione
del profilo del gestore distribuzione:
Su piattaforme Linux e UNIX: profile_root/config/cells/cell_name/coregroups/deleted_node_name
Su piattaforme Windows: profile_root\config\cells\cell_name\coregroups\deleted_node_name
Risultato
Questa procedura disinstalla WebSphere ESB e
se selezionato anche WebSphere Application Server Network
Deployment. Dopo aver eseguito la procedura guidata di disinstallazione, la struttura di directory conterrà
poche directory rimaste, inclusa la directory logs.
Il file
uninstlog.txt registra il
file system o altri errori non comuni. Individuare l'indicatore di corretta esecuzione INSTCONFSUCCESS nel
log:
Uninstall, com.ibm.ws.install.ni.ismp.actions.
ISMPLogSuccessMessageAction, msg1,
INSTCONFSUCCESS
Operazioni successive
Se si desidera installare nuovamente il prodotto nella stessa directory root di installazione,
è necessario effettuare una delle seguenti operazioni, in base all'esito
della disinstallazione:
- Se la disinstallazione ha avuto un esito positivo, è necessario rimuovere manualmente la directory install_root.
Importante: per evitare problemi di installazione, è necessario disinstallare WebSphere ESB ed il prodotto
WebSphere Application Server Network
Deployment sottostante se si pianifica di installare nuovamente WebSphere ESB nella
stessa directory. Quindi la directory install_root, che è necessario rimuovere
manualmente, deve essere vuota.
- Se la disinstallazione non ha avuto un esito positivo, è necessario disinstallare manualmente i restanti artefatti
del prodotto. Per ulteriori informazioni, consultare Preparazione per la reinstallazione dopo una disinstallazione non riuscita. Se non si pianifica di eseguire una reinstallazione,
non è necessario eseguire questa attività.
Per ulteriori informazioni sui comandi descritti in questo argomento, consultare l'information
center di WebSphere Application Server Network Deployment, versione 6.0,
all'indirizzo http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp.