Utilizzare il comando WBIPreUpgrade per WebSphere ESB per salvare la configurazione di una versione precedentemente installata di WebSphere ESB in una directory di backup specifica per la migrazione.
Dettagli
Il comando WBIPreUpgrade salva i file selezionati dalle directory
root_installazione eroot_profilo nella directory di backup specificata. Il valore predefinito per root_profilo è profiles/nome_profilo. I file copiati si troveranno in varie sottodirectory, tutti copiati da WBIPreUpgrade
nella directory di backup specificata. Inoltre, viene creata una sottodirectory logs, che contiene nuovi file di log che corrispondono all'istanza
corrente dell'esecuzione del comando WBIPreUpgrade.
In base alla versione da cui si sta migrando, il comando
WBIPreUpgrade
esegue il backup dei profili esistenti in
WebSphere Enterprise Service Bus, tutti insieme
o uno alla volta.
- Se si migra versione 6.0.2.x,
il comando WBIPreUpgrade esegue il backup dei profili esistenti
in WebSphere Enterprise Service Bus, tutti
contemporaneamente.
- Se si migra versione 6.1.x,
il comando WBIPreUpgrade esegue il backup dei profili esistenti uno
alla volta, e solo quei profili che utilizzano il parametro
-profileName.
Restrizioni
- Se
si migra da versione 6.1.x,
il comando WBIPreUpgrade eredita le seguenti limitazioni
dai programmi di utilità backupConfig di WebSphere Application Server Network Deployment, Versione 6.1:
- Per impostazione predefinita, tutti i server sul nodo vengono arrestati
prima che il backup viene effettuato, in modo tale che le informazioni
parzialmente sincronizzate non vengono salvate.
- Occorre avere l'autorizzazione root per eseguire la migrazione.
- In un ambiente UNIX® o Linux®, il comando backupConfig non salva le informazioni di autorizzazione o di proprietà del file.
- Quando si ripristina un file, il comando restoreConfig utilizza
la umask corrente e l'ID utente effettivo per impostare l'autorizzazione e la proprietà.
- Occorre arrestare il gestore distribuzione di origine prima di avviare la migrazione. Se non si arresta il gestore distribuzione di origine, il comando WBIPreUpgrade
lo arresta automaticamente.
Se si sta eseguendo la migrazione su una piattaforma i5/OS, il nome del profilo di destinazione deve corrispondere al nome del profilo di origine da migrare.
Se si sta eseguendo la migrazione su una piattaforma i5/OS, backUpConfig non salva alcuna autorizzazione privata sui file e nelle directory che possono essere state configurate nel profilo di origine. Quindi, è necessario prendere nota di tali autorizzazioni private che possono esistere nei file e nelle directory della struttura ad albero config del profilo di origine, quindi ripristinare tali autorizzazioni private manualmente nel profilo di destinazione dopo l'esecuzione del comando WBIPostUpgrade e la migrazione del profilo.
Ubicazione
Il file del comando si trova, e dovrebbe essere eseguito, nella directory install_dir/bin.
Autorizzazione
Per eseguire lo script di questo comando,
il proprio profilo utente deve avere l'autorizzazione *ALLOBJ.
Parametri
I parametri sono i seguenti:
- backupDirectory
- Si tratta di un parametro richiesto, che dev'essere il primo parametro specificato dall'utente. Il valore backupDirectory specifica il nome della directory dove lo script di comando memorizza la configurazione salvata e i log creati durante WBIPreUpgrade e WBIPostUpgrade.
È anche la directory da cui il comando WBIPostUpgrade legge la configurazione.
Se la directory non esiste, verrà creata dallo script del comando WBIPreUpgrade.
- currentWebSphereDirectory
- Si tratta di un parametro richiesto, che dev'essere il secondo parametro specificato dall'utente. Può essere un'edizione qualsiasi di WebSphere ESB per il quale la migrazione è supportata.

Il valore
currentWebSphereDirectory specifica il nome della directory root del profilo per l'installazione di
WebSphere ESB esistente. In
i5/OS, il formato di questo percorso di directory è il seguente:
user_data_root/profiles/profile_name,
dove
profile_name è il nome del profilo e
user_data_root è la directory dei dati utente predefinita per
WebSphere ESB (
/QIBM/UserData/WebSphere/ESB). I profili e le sottodirectory profileRegistry vengono creati in questa directory quando si installa il prodotto.
Nota: La piattaforma i5/OS è
supportata solo se si sta migrando da versione 6.1.x a versione 6.2.


Il valore currentWebSphereDirectory specifica il nome della directory root di installazione per l'installazione di WebSphere ESB esistente.
Le seguenti directory sono le predefinite per
WebSphere ESB versione 6.1.x.
Un percorso
diverso, non predefinito, potrebbe essere stato utilizzato per la propria installazione.
- Se, per la precedente installazione, WebSphere Application Server e WebSphere ESB sono stati installati durante lo stesso processo di installazione: /QIBM/UserData/WebSphere/ProcServer/profiles/profile_name.
- Se, per la precedente installazione, WebSphere Application Server era già installato e WebSphere ESB era installato sopra: /QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/profile_name.
- -password
- Questo è un parametro facoltativo che è necessario se la
la sicurezza amministrativa è stata configurata nella versione precedente di WebSphere ESB. Il
valore password specifica la password per il nome utente
amministrativo dell'installazione di WebSphere ESB corrente (prima della migrazione).
- -profileName


Nota: Questo parametro non è supportato sulla piattaforma i5/OS.
Se viene utilizzato, viene emessa un'eccezione parametro non valido.
Questo è un parametro facoltativo per la migrazione da profili specifici. Il valore nome_profilo specifica il nome del profilo creato
nella versione precedente di WebSphere ESB,
da cui lo script migra la propria configurazione. Se il parametro -profileName non viene specificato verrà utilizzato il profilo predefinito. Se non viene trovato il profilo predefinito, il sistema segnalerà un errore.
Nota: Per assicurarsi che sia stato migrato il profilo
corretto, specificare il nome del profilo utilizzando questo parametro
e non fare affidamento su quello predefinito.
- -traceFile
Nota: Questo parametro viene ignorato per la migrazione da WebSphere ESB versione 6.1.x a versione 6.2.
Questo parametro è facoltativo. Il valore file_name specifica il nome del file di output per le informazioni di traccia. Importante: Se l'utente specifica questo parametro, deve specificare anche il parametro -traceString. Se si specifica il parametro
-traceFile ma non si specifica il parametro -traceString,
il comando utilizza la profondità di traccia predefinita e memorizza il file di traccia
nella ubicazione specificata.
- -traceString
Nota: Questo parametro viene ignorato per la migrazione da WebSphere ESB versione 6.1.x a versione 6.2.
Questo parametro è facoltativo. Il valore trace_spec specifica le informazioni di traccia che l'utente desidera raccogliere. Per raccogliere tutte le informazioni di traccia, specificare "*=all=enabled" (fra virgolette).
Importante: Se l'utente specifica questo parametro, deve specificare anche il parametro -traceFile.
Se si specifica il parametro -traceString ma non si specifica il parametro -traceFile, il comando crea un file di traccia per impostazione predefinita, posizionandolo nella directory backupDirectory/logs.
- -username
- Questo è un parametro facoltativo che è necessario se la
la sicurezza amministrativa è stata configurata nella versione precedente di WebSphere ESB. Il
valore IDutente specifica il nome utente amministrativo
dell'installazione di WebSphere ESB corrente (prima della migrazione).
Registrazione
Il comando WBIPreUpgrade visualizza lo stato sullo schermo, durante l'esecuzione. Inoltre, salva una serie più estesa
delle informazioni di registrazione nel file WBIPreUpgrade.timestamp.log scritto nella directory backupDirectory/logs, dove backupDirectory è il valore specificato per il parametro backupDirectory. È possibile visualizzare il file WBIPreUpgrade.nomeProfilo.dataora.log con un editor di testo.