Comando mqsimigratecomponents

Piattaforme supportate

  • Windows
  • sistemi Linux e UNIX
  • z/OS

Scopo

Il comando mqsimigratecomponents sposta un componente da una versione installata in precedenza (solo Versione 2.1 o Versione 5) del prodotto ad un'altra. Questo comando deve essere eseguito dall'ultima versione del prodotto installata, indipendentemente se è l'origine o la destinazione.
Nota:
  1. Per la Versione 2.1 del prodotto, CSD02 Versione 2.1 (2.1.0.3) costituisce il rilascio minimo del prodotto supportato. (Consultare Migrazione ed aggiornamento per maggiori informazioni.)
  2. Per la Versione 5 del prodotto, la Versione 5.0.0.4 costituisce il rilascio minimo del prodotto supportato.

Deve essere installata la Versione 6.0 del prodotto con il codice del componente richiesto, ovvero, il componente broker è installato se necessario, e così via.

Prima di avviare la migrazione, arrestare eventuali sessioni di debug in Centro di controllo. Non è possibile eseguire la migrazione di flussi di messaggi di cui si sta eseguendo il debug.

E possibile richiamare il comando con varie opzioni per eseguire una delle seguenti azioni:
  • Verificare un componente, senza effettuare eventuali modifiche, per assicurare che i componenti siano adatti per la migrazione richiesta (-c).
  • Spostare un componente su una versione diversa, completamente o in parte -s e -t).
  • Annullare una fase di migrazione non riuscita (-u).
  • Verificare che uno spostamento abbia avuto esito positivo (-v).

Il comando mqsimigratecomponents aggiorna il registro e il file system, le definizioni WebSphere MQ e le definizioni database. Se l'utente che immette il comando non dispone dell'autorizzazione per eseguire tutta la procedura, il comando può essere eseguito una parte alla volta. Differenti utenti possono eseguire la parte per cui sono autorizzati al fine di ottenere il risultato generale. Ciò viene denominato come migrazione a più passi e viene eseguito utilizzando i parametri -1, -2 e -3.

Se si sta utilizzando il comando mqsimigratecomponents con un database Sybase, è necessario modificare il database eseguendo le seguenti azioni:
  1. Collegarsi a ISQL utilizzando l'account dell'amministratore di sistema.
  2. Immettere le seguenti serie di comandi:
    1> use master
    2> go
    1> sp_dboption "BROKER1","ddl in tran",TRUE
    2> go
    Opzione di database 'ddl in tran' attivata per il database 'BROKER1'.
    Eseguire il comando CHECKPOINT nel database che è stato modificato.
    (stato di restituzione = 0)
    1> use BROKER1
    2> go
    1> checkpoint
    2> go
    dove BROKER1 è il nome del database del broker Sybase.

Sintassi

Parametri

-c
(Facoltativo) Effettuare una verifica pre-migrazione di un componente specificato per assicurare quanto segue:
  • La versione del broker rilevata in automatico corrisponde a qualsiasi versione specificata sulla riga comandi
  • Non sono presenti gruppi di esecuzione a 64 bit, se si esegue la migrazione dalla Versione 6.0 ad un rilascio precedente
  • Le tabelle di database che devono essere copiate da un rilascio precedente non contengono righe che violano i requisiti di indice della Versione 6.0.
Se un broker che si sta migrando condivide uno schema database con un altro broker, viene emesso il messaggio di avvertenza BIP8678 e il controllo ha esito negativo. In questo caso, tutti i broker che condividono uno schema database devono essere migrati insieme.
  1. Arrestare tutti i broker che condividono lo schema database.
  2. Migrare il primo broker. In questo modo verranno migrate le tabelle database per tutti i broker, oltre che il file system e il registro e le definizioni WebSphere MQ solo per tale broker; ad esempio:
    mqsimigratecomponents FIRSTBROKER -t 6.0.0.1 
  3. Migrare il file system e il registro e parti WebSphere MQ di ogni altro broker; la parte del database è già stata migrata. Utilizzare i parametri -1 e -2 a tale scopo, in uno o in due passaggi:
    • In un passaggio:
      mqsimigratecomponents BROKERB -1 -2
    • In due passaggi:
      mqsimigratecomponents BROKERB -1
      mqsimigratecomponents BROKERB -2

Può essere eseguito il controllo della migrazione di un componente in esecuzione. Ciò non influisce sul componente, ad eccezione di un lieve peggioramento delle prestazioni. Tenere presente che sui sistemi UNIX, la migrazione del file odbc.ini deve essere eseguita (ovvero, deve essere creato un file odbc.ini di nuovo formato con la stessa serie di origini di dati di quello precedente) prima che possa essere eseguito il controllo, poiché i comandi di controllo devono essere in grado di accedere al database del broker.

Il comando di controllo ha esito positivo o negativo e stampa un messaggio relativo all'esito della migrazione, ma durante tale processo non viene eseguita alcuna modifica.

-v
(Facoltativo) Effettuare una verifica post-migrazione di un componente specificato per assicurare quanto segue:
  • Per la versione specificata, esistono le code e le tabelle di database corrette.
  • Il registro è del formato corretto per la versione specificata.
-q
(Facoltativo) Stampa meno messaggi di stato durante l'operazione.
-1
(Facoltativo) Esegue solo il lavoro di registro e file system.
  • Durante la migrazione a Versione 6.0, utilizzare il parametro -1 prima dei parametri -2 o -3.
  • Durante la migrazione a una versione precedente, utilizzare il parametro -2 o -3 prima del parametro -1.
-2
(Facoltativo) Esegue solo il lavoro WebSphere MQ.
-3
(Facoltativo) Esegue solo il lavoro del database.
-u
(Facoltativo) Annulla un passo di migrazione non andato a buon fine; è anche necessario specificare almeno uno dei seguenti: -1, -2 o -3. Utilizzare questa opzione solo quando la migrazione non ha avuto esito positivo ed anche quando il ripristino automatico non è andato a buon fine (si è verificato, ad esempio, un errore durante la migrazione suddivisa).
-sVersione Origine
(Facoltativo) La versione precedente del componente.
  • Se non specificato, questo valore viene rilevato in automatico.
  • Durante l'esecuzione di una migrazione a più fasi a Versione 6.0, il parametro -s è obbligatorio dopo avere eseguito il comando mqsimigratecomponents con il parametro -1. Tale procedura viene descritta nell'esempio di migrazione a più fasi.
  • Fare riferimento a Scopo per le limitazioni ai numeri di versione del prodotto che sono supportate.
-tVersione Destinazione
(Facoltativo) La versione di destinazione del componente.
  • Se non specificato, viene assunta la versione corrente.
  • Durante l'esecuzione di una migrazione a più fasi da Versione 6.0 a una versione precedente, il parametro -t è obbligatorio. Tale procedura viene descritta nell'esempio di migrazione a più fasi.
  • Fare riferimento a Scopo per le limitazioni ai numeri di versione del prodotto che sono supportate.
Nome Componente
(Obbligatorio) Il nome del componente da migrare.

Autorizzazione

Quando si esegue una migrazione che prevede un unico passo, l'ID utente utilizzato per richiamare questo comando deve poter:
  • Scrivere sul registro e sul file system del prodotto
  • Modificare i database associati al componente
  • Modificare le definizioni della coda
Relativamente alla migrazione che prevede più passi, l'ID utente utilizzato per richiamare questo comando deve sempre poter leggere dal registro del prodotto e disporre anche dell'autorizzazione specifica affinché ciascun passo abbia esito positivo:
  • -1 richiede la capacità di scrivere sul registro e sul file system del prodotto
  • -2 richiede la capacità di modificare le definizioni della coda
  • -3 richiede la capacità di modificare i database associati al componente

Risposte

Inizio modificaQuesto comando può produrre un gran numero di risposte possibili, a seconda dei risultati delle varie operazioni. Tenere presente che questo comando differisce dagli altri in quanto produce messaggi; ovvero questi vengono visualizzati quando necessario anziché essere prodotti in un batch alla fine del programma. Durante la migrazione di tabelle database, z/OS produce più output del sistema distribuito.Fine modifica

Esempi

Nell'esempio seguente viene verificata la migrazione di BROKER1 da Versione 2.1 a Versione 6.0:

Inizio modifica
mqsimigratecomponents –c BROKER1
BIP8849I: Broker 'BROKER1' (Versione 2.1) con gestore code 'brkqm1' e origine dati 'brkdb1'
specificato per la migrazione.
BIP8791I: Avviato controllo delle righe duplicate.
BIP8794I: La tabella BRMINFO non contiene righe duplicate.
BIP8794I: La tabella BRMRTDDEPINFO non contiene righe duplicate.
BIP8794I: La tabella BROKERRESOURCES non contiene righe duplicate.
BIP8794I: La tabella BRMRTDINFO non contiene righe duplicate.
BIP8794I: La tabella BRMWFDINFO non contiene righe duplicate.
BIP8792I: Controllo delle righe duplicate superato.
BIP8791I: Avviato controllo delle righe duplicate.
BIP8800W: Nessuna sintassi dell'argomento non valida rilevata nella tabella BSUBSCRIPTIONS.
BIP8800W: Nessuna sintassi dell'argomento non valida rilevata nella tabella BPUBLISHERS.
BIP8800W: Nessuna sintassi dell'argomento non valida rilevata nella tabella BRETAINEDPUBS.
BIP8797I: Controllo della sintassi dell'argomento riuscito
BIP8680I: Controllo pre-migrazione riuscito.
BIP8071I: Comando completato con esito positivo.
Fine modifica

Nell'esempio seguente viene eseguita la migrazione automatica di BROKER1 dalla Versione 2.1 alla Versione 6.0:

Inizio modifica
mqsimigratecomponents BROKER1
BIP8849I: Broker 'BROKER1' (Versione 2.1) con gestore code 'BROKER1' e origine dati 'BROKERDB'
specificato per la migrazione.
BIP8755I: Valore 'QueueManagerName' copiato nella nuovo posizione
BIP8755I: Valore 'DataSourceName' copiato nella nuovo posizione
BIP8755I: Valore 'DataSourceUserId' copiato nella nuovo posizione
BIP8755I: Valore 'DataSourcePassword' copiato nella nuovo posizione
BIP8755I: Valore 'LilPath' copiato nella nuovo posizione
BIP8755I: Valore 'ConfigurationTimeout' copiato nella nuovo posizione
BIP8755I: Valore 'ConfigurationDelayTimeout' copiato nella nuovo posizione
BIP8755I: Valore 'MigrationNeeded' copiato nella nuovo posizione
BIP8755I: Valore 'MQTrustedQueueManager' copiato nella nuovo posizione
BIP8755I: Valore 'UserNameServerQueueManagerName' copiato nella nuovo posizione
BIP8755I: Valore 'BrokerUUID' copiato nella nuovo posizione
BIP8755I: Valore 'AdminAgentPID' copiato nella nuovo posizione
BIP8763I: Valore 'QueueManagerName' eliminato dalla precedente posizione
BIP8763I: Valore 'DataSourceName' eliminato dalla precedente posizione
BIP8763I: Valore 'DataSourceUserId' eliminato dalla precedente posizione
BIP8763I: Valore 'DataSourcePassword' eliminato dalla precedente posizione
BIP8763I: Valore 'LilPath' eliminato dalla precedente posizione
BIP8763I: Valore 'ConfigurationTimeout' eliminato dalla precedente posizione
BIP8763I: Valore 'ConfigurationDelayTimeout' eliminato dalla precedente posizione
BIP8763I: Valore 'MigrationNeeded' eliminato dalla precedente posizione
BIP8763I: Valore 'MQTrustedQueueManager' eliminato dalla precedente posizione
BIP8763I: Valore 'UserNameServerQueueManagerName' eliminato dalla precedente posizione
BIP8763I: Valore 'BrokerUUID' eliminato dalla precedente posizione
BIP8763I: Valore 'AdminAgentPID' eliminato dalla precedente posizione
BIP8768I: Migrazione di registro terminata per il componente ‘BROKER1’.
BIP8654I: Spostamento di artefatti del filesystem da '' a 'C:\Documents and Settings\AllUsers\Application Data\IBM\MQSI'
BIP8670I: Migrazione del database avviata
BIP8663I: Creazione di nuove tabelle provvisorie
BIP8664I: Migrazione da tabelle esistenti a nuove tabelle provvisorie
BIP8665I: Eliminazione di tabelle esistenti
BIP8666I: Creazione di nuove tabelle
BIP8667I: Copia di tutte le righe da nuove tabelle provvisorie a nuove tabelle
BIP8668I: Eliminazione di nuove tabelle temporanee
BIP8669I: Migrazione del database eseguita correttamente
BIP8785I: Avvio della migrazione coda WebSphere MQ per il componente 'BROKER1'.
Il comando setmqaut è stato completato con esito positivo.
BIP8786I: Creata coda WebSphere MQ per 'SYSTEM.BROKER.AGGR.REQUEST'
Il comando setmqaut è stato completato con esito positivo.
BIP8786I: Creata coda WebSphere MQ per 'SYSTEM.BROKER.AGGR.CONTROL'
Il comando setmqaut è stato completato con esito positivo.
BIP8786I: Creata coda WebSphere MQ per 'SYSTEM.BROKER.AGGR.REPLY'
Il comando setmqaut è stato completato con esito positivo.
BIP8786I: Creata coda WebSphere MQ per 'SYSTEM.BROKER.AGGR.TIMEOUT'
Il comando setmqaut è stato completato con esito positivo.
BIP8786I: Creata coda WebSphere MQ per 'SYSTEM.BROKER.AGGR.UNKNOWN'
Il comando setmqaut è stato completato con esito positivo.
BIP8786I: Creata coda WebSphere MQ per 'SYSTEM.BROKER.TIMEOUT.QUEUE'
Il comando setmqaut è stato completato con esito positivo.
BIP8786I: Creata coda WebSphere MQ per 'SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE'
Il comando setmqaut è stato completato con esito positivo.
BIP8786I: Creata coda WebSphere MQ per 'SYSTEM.BROKER.WS.INPUT'
Il comando setmqaut è stato completato con esito positivo.
BIP8786I: Creata coda WebSphere MQ per 'SYSTEM.BROKER.WS.REPLY'
Il comando setmqaut è stato completato con esito positivo.
BIP8786I: Creata coda WebSphere MQ per 'SYSTEM.BROKER.WS.ACK'
Il comando setmqaut è stato completato con esito positivo.
BIP8786I: Creata coda WebSphere MQ per 'SYSTEM.BROKER.IPC.QUEUE'
BIP8787I: Eliminata coda WebSphere MQ 'SYSTEM.BROKER.ADMIN.QUEUE'
BIP8787I: Eliminata coda WebSphere MQ 'SYSTEM.BROKER.EXECUTIONGROUP.QUEUE'
BIP8787I: Eliminata coda WebSphere MQ 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY'
BIP8787I: Eliminata coda WebSphere MQ 'SYSTEM.BROKER.IPC.QUEUE'
BIP8789I: Terminata migrazione della coda WebSphere MQ per il componente 'BROKER1'.
BIP8071I: Comando completato con esito positivo.
Fine modifica

Il seguente esempio illustra una migrazione a più fasi da Versione 2.1 a Versione 6.0:

mqsimigratecomponents BROKER -1
mqsimigratecomponents BROKER -s 2.1.0.8 -2
mqsimigratecomponents BROKER -s 2.1.0.8 -3

Il seguente esempio illustra una migrazione a più fasi da Versione 6.0 a Versione 2.1:

mqsimigratecomponents BROKER -t 2.1.0.8 -2
mqsimigratecomponents BROKER -t 2.1.0.8 -3
mqsimigratecomponents BROKER -t 2.1.0.8 -1
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
an26150_