Migrazione di un gestore code ad una versione successiva su Windows

Su piattaforme Windows , seguire queste istruzioni per migrare un gestore code da una versione precedente a una versione successiva di IBM® MQ.

Prima di iniziare

Se è stato installato il codice del programma di supporto iniziale sul server, è necessario eliminare tutti i gestori code creati con l'installazione. Disinstallare il codice prima di procedere con l'installazione del codice del livello di produzione.

Creare un piano di migrazione; Vedere Pianificazione della migrazioneIBMMQ a una versione successiva su Windows .
Esaminare i requisiti di sistema IBM MQ per la versione più recente, incluse le informazioni sulle versioni di Windows supportate da IBM MQ . Vedere Requisiti di sistema perIBM MQ .
Eseguire il back up del sistema prima di installare una versione successiva di IBM MQ su una versione precedente. Una volta avviato un gestore code, non sarà possibile ripristinare la versione precedente. Se è necessario ripristinare il sistema, non è possibile ripristinare alcun lavoro, come le modifiche ai messaggi e agli oggetti, eseguite dalla versione più recente di IBM MQ. Per ulteriori informazioni sul backup del sistema, consultare Backup e ripristino dei dati del gestore code IBM MQ.
Esaminare tutti gli altri SupportPacs installati per la loro applicabilità alla versione più recente.
Se l'esecuzione avviene su un server con più installazioni IBM MQ , è necessario identificare l'installazione. Assicurarsi che i comandi immessi vengano eseguiti rispetto all'installazione corretta; consultare setmqenv.

Informazioni su questa attività

Per eseguire un comando, il sistema operativo deve trovare il comando in una installazione IBM MQ . Per alcuni comandi, è necessario eseguire il comando dall'installazione associata al gestore code corretto. IBM MQ non passa i comandi all'installazione corretta. Per altri comandi, come setmqinst, è possibile eseguire il comando da qualsiasi installazione su cui è installata la versione più recente del prodotto.

Se è installata una versione precedente del prodotto, il comando eseguito è il comando per tale versione, a meno che il percorso di ricerca non venga sovrascritto da un'impostazione locale. È possibile sovrascrivere il percorso di ricerca eseguendo setmqenv. È necessario impostare il percorso corretto per eseguire un comando. Se è stata impostata un'installazione primaria, il comando eseguito è la copia nell'installazione primaria, a meno che non si sovrascriva la selezione con un percorso di ricerca locale.

Procedura

Accedere come utente in group mqm.
Arrestare tutte le applicazioni utilizzando l'installazione di IBM MQ

Se si utilizza il componente Managed File Transfer (MFT), assicurarsi che tutti gli agent MFT abbiano terminato tutti i trasferimenti file in cui erano impegnati. Non devono essere presenti trasferimenti incompleti associati agli agent e al relativo SYSTEM.FTE.STATE FTE.STATE non devono contenere messaggi.
Terminare tutte le attività dei gestori code associati all'installazione di IBM MQ
1. Eseguire il comando dspmq per elencare lo stato di tutti i gestori code sul sistema.
  Eseguire uno dei seguenti comandi dall'installazione che si sta aggiornando:
```
dspmq -o installation -o status
dspmq -a
```
  dspmq -o installation -o status visualizza il nome installazione e lo stato dei gestori code associati a tutte le installazioni di IBM MQ.
  
  dspmq -a visualizza lo stato dei gestori code attivi associati all'installazione da cui viene eseguito il comando.
2. Utilizzare il comando MQSC DISPLAY LSSTATUS per elencare lo stato dei listener associati a un gestore code, come mostrato nel seguente esempio:
```
echo "DISPLAY LSSTATUS(*) STATUS" | runmqsc QmgrName
```
3. Eseguire il comando endmqm per arrestare ogni gestore code in esecuzione associato a questa installazione.
  
  Il comando endmqm informa un'applicazione che il gestore code a cui è connesso è in fase di arresto; consultare Arresto di un gestore code.
  
  Per continuare la manutenzione, le applicazioni devono rispondere a un comando endmqm disconnettendosi dal gestore code e rilasciando le librerie IBM MQ che hanno caricato. In caso contrario, è necessario trovare un altro modo per forzare le applicazioni a rilasciare le risorse IBM MQ , ad esempio arrestando le applicazioni.
  
  È inoltre necessario arrestare le applicazioni che utilizzano le librerie client che fanno parte dell'installazione. Le applicazioni client potrebbero essere connesse a un gestore code differente, eseguendo un'installazione differente di IBM MQ. L'applicazione non viene informata dei gestori code nell'installazione corrente in fase di chiusura.
  
  Tutte le applicazioni che continuano a disporre di librerie condivise IBM MQ dall'installazione caricate non consentono di applicare la manutenzione IBM MQ . Un'applicazione potrebbe disconnettersi da un gestore code o essere disconnessa in modo forzato, ma mantenere caricata una libreria condivisa IBM MQ .
  
  Nota: Applicazione degli aggiornamenti del livello di manutenzione ai gestori code a più istanze su Windows descrive come applicare la manutenzione a un gestore code a più istanze. Un gestore code a più istanze può continuare l'esecuzione su un server, mentre la manutenzione viene applicata a un altro server.
4. Arrestare tutti i listener associati ai gestori code, utilizzando il comando:
```
endmqlsr -m QMgrName
```
Eseguire il back up del gestore code
Eseguire le copie di tutte le directory dei dati e dei file di log del gestore code, incluse tutte le sottodirectory, e anche del file qm.ini e delle voci di registro. Per ulteriori informazioni, consultare Backup e ripristino dei dati del gestore code IBM MQ.
Arrestare il servizio IBM MQ e uscire dall'applicazione dell'icona Servizio.
Facoltativo: se si sta eseguendo una migrazione a una singola fase, disinstallare facoltativamente la versione corrente del prodotto.
Tieni presente che esegui questo passaggio solo se stai effettuando una migrazione a fase singola; Vedere Migrazione su Windows: fase unica .
Installare la versione successiva di IBM MQ.
Su Windows, è possibile eseguire questa operazione utilizzando il Launchpad di installazione o il comando msiexec . Per ulteriori informazioni, consultare:
- Modifica dell'installazione del server utilizzando il Launchpad di installazione
- Modifica silenziosa dell'installazione di un server utilizzando msiexec
Immetti nuovamente le informazioni su dominio, ID utente e password

Quando l'installazione della versione più recente viene completata, Prepare IBM MQ Wizard viene avviato automaticamente.

Dove UAC è abilitato: se si riesegue Prepare IBM MQ Wizard, assicurarsi che la procedura guidata venga eseguita con privilegi di amministratore, altrimenti la procedura guidata potrebbe non riuscire.
Avviare il gestore code.
```
strmqm QmgrName
```
Quando si avvia per la prima volta un gestore code dopo la migrazione:
- I nuovi attributi per gli oggetti esistenti vengono impostati sui valori predefiniti.
- Vengono creati tutti i nuovi oggetti predefiniti.
- I dati del gestore code vengono migrati.
Importante: non utilizzare l'opzione -c per avviare il gestore code, a meno che non si desideri esplicitamente reimpostare o ricreare gli oggetti di sistema predefiniti.

È necessario avviare IBM MQ prima di avviare i listener.

Cosa fare successivamente

Completare le attività nel piano di migrazione, come la verifica del nuovo livello di codice e la distribuzione di nuove funzioni come il riavvio automatico delle connessioni client.

Se si utilizza la pubblicazione / sottoscrizione, è necessario migrare il broker di pubblicazione / sottoscrizione.

Se il gestore code è un membro di un cluster di gestori code, migrare gli altri membri del cluster.

Importante: è necessario migrare lo stato del broker di pubblicazione / sottoscrizione prima di migrare il sistema IBM MQ a IBM MQ 8.0 o versioni successive, poiché la migrazione di pubblicazione / sottoscrizione del broker non è supportata in IBM MQ 8.0o versioni successive.