WebSphere Enterprise Service Bus, Versione 6.2.0 Sistemi operativi: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Utilità di riga comandi WBIPreUpgrade

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.
  • For i5/OS operating system 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.
  • For i5/OS operating system 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

For i5/OS operating system Per eseguire lo script di questo comando, il proprio profilo utente deve avere l'autorizzazione *ALLOBJ.

Sintassi

La sintassi è la seguente:

For i5/OS operating system
WBIPreUpgrade directoryBackup 
                currentProfileDirectory
                [-username IDutente]
                [-password password]
                [-traceString trace_spec [-traceFile file_name ]]
Nota: Se si sta migrando da versione 6.0.2.x a versione 6.2, il parametro -profileName non è supportato.
For Linux operating systemFor UNIX operating system
WBIPreUpgrade.sh directoryBackup 
                currentWebSphereDirectory
                [-profileName nome_profilo]
                [-username IDutente]
                [-password password]
                [-traceString trace_spec [-traceFile file_name ]]
For Windows operating system
WBIPreUpgrade.bat directoryBackup 
                currentWebSphereDirectory
                [-profileName nome_profilo]
                [-username IDutente]
                [-password password]
                [-traceString trace_spec [-traceFile file_name ]]

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.
For i5/OS operating system 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.

For UNIX operating systemFor Linux operating systemFor Windows operating system 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
For UNIX operating systemFor Linux operating systemFor Windows operating system
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.


reference Argomento Riferimento

Termini di utilizzo | Feedback


Icona data/ora Ultimo aggiornamento: 02 Luglio 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/rmig_wbipreupgrade.html
Copyright IBM Corporation 2005, 2010. Tutti i diritti riservati.
Questo centro informazioni utilizza la tecnologia Eclipse. (http://www.eclipse.org).