Cosa è cambiato in IBM MQ 9.4.0

Titolarità della licenza, installazione e migrazione

Modifica dell'opzione nonprod entitlement del comando setmqinst

Da IBM MQ 9.4.0, l'opzione nonprod del parametro -l del comando setmqinst imposta la titolarità su IBM MQ (Non-Production) o IBM MQ Advanced (Non-Production), a seconda che l'installazione sia IBM MQ Advanced o meno.

Per ulteriori informazioni sul comando setmqinst, vedere setmqinst (set IBM MQ installation).

Modifiche alle funzionalità fornite con il server mqweb

Il server mqweb è un server WebSphere® Liberty utilizzato per supportare IBM MQ Console e REST API.

Da IBM MQ 9.4.0, le funzioni WebSphere Liberty fornite con il server mqweb si riducono a quelle necessarie per eseguire, proteggere e monitorare i server IBM MQ Console e REST API. Ciò riduce significativamente la dimensione dei file di installazione per il server mqweb.

Considerazioni sulla migrazione relative alla IBM MQ Bridge to Salesforce rimozione

IBM MQ Bridge to Salesforce viene rimosso dal prodotto all'indirizzo IBM MQ 9.4.0. La connettività Salesforce può essere raggiunta con IBM App Connect Enterprise. I nodi Salesforce Input e Salesforce Request possono essere utilizzati per interagire con applicazioni Salesforce . Per ulteriori informazioni, consultare Utilizzo Salesforce con IBM App Connect Enterprise.

Solo su Linux® for x86-64 , se si sta eseguendo la migrazione da un'installazione in cui è presente IBM MQ Bridge to Salesforce , è necessario rimuoverlo prima di eseguire l'aggiornamento a IBM MQ 9.4.0 o successivo.

IBM Aspera® faspio Gateway versione aggiornata

IBM MQ Advanced for Multiplatforms 9.4.0, IBM MQ Advanced 9.4.0, IBM MQ Advanced for z/OS® Value Unit Edition 9.4.0 e IBM MQ Advanced for z/OS 9.4.0 aggiornano la versione di IBM Aspera faspio Gateway a 1.3.4.

IBM Aspera faspio Gateway 1.3.4 apporta diverse modifiche dalle versioni precedenti:

• Se si sta eseguendo la migrazione daIBM Aspera faspio Gateway 1.2, è ora necessario un file di licenza per eseguire il gateway in modalità server. Vedere Note di rilascio: IBM Aspera faspio Gateway 1.3 per i dettagli. Questo file di licenza viene fornito con IBM MQ; consultare Definizione di una connessione Aspera gateway su piattaforme Linux o Windows.
• Se si sta eseguendo la migrazione da IBM Aspera fasp.io Gateway 1.1 , oltre alla modifica del file di licenza già descritta, esiste anche una struttura di directory modificata e TLS è abilitato per impostazione predefinita. Vedere Note di rilascio: IBM Aspera faspio Gateway 1.2 per i dettagli. Per ulteriori informazioni, vedere Definizione di una connessione e Aspera gateway e su piattaforme Linux o Windows .

Modifica del nome da Long Term Support (LTS) a Support Cycle 2 (SC2) per IBM MQ nei contenitori

Dal canale IBM MQ Operator v3.2, Long Term Support ( LTS ) viene rinominato in Support Cycle 2 ( SC2 ). Questo perché l'unico percorso LTS disponibile per IBM MQ nei container è il supporto di due anni nell'ambito del diritto di IBM Cloud Pak® for Integration e IBM Cloud Pak for Integration ha adottato il termine SC2.

Ecco il quadro completo della titolarità:

• Con la titolarità IBM MQ , IBM MQ Operator può distribuire solo immagini IBM MQ Continuous Delivery (CD).
• Con la titolarità IBM Cloud Pak for Integration , IBM MQ Operator può distribuire immagini CD o SC2 (formerly LTS) .

Sicurezza

Modifiche all'attributo Security Policy della stanza Service del file qm.ini

Da IBM MQ 9.4.0, le modifiche vengono apportate all'attributo SecurityPolicy della stanza Service del file qm.ini quando il gestore code è configurato per accettare i token di autenticazione. Per consentire l'uso di utenti non noti al gestore di code per l'autenticazione e l'autorizzazione, il gestore di code viene messo in modalità UserExternal quando la stanza AuthToken viene aggiunta al file qm.ini. Ciò non si verifica automaticamente se l'attributo SecurityPolicy della stanza Service del file qm.ini è già impostato su group. Se si desidera utilizzare i token di autenticazione, cambiare l'impostazione da gruppo a UserExternal e riavviare il gestore di code.

Per ulteriori informazioni, vedere SecurityPolicy e AuthToken stanza del file qm.ini.

Modifica della proprietà SSLCIPH per i canali AMQP

A partire da IBM MQ 9.4.0, i canali AMQP supportano QUALSIASI* generico CipherSpecs.

Per ulteriori informazioni, vedere Configurazione dei client AMQP con TLS e Abilitazione di CipherSpecs.

MQIPT richiede closeClassLoader Java security manager il permesso di usare le uscite

Da IBM MQ 9.4.0, se IBM MQ Internet Pass-Thru (MQIPT) è configurato per utilizzare un'uscita di certificato o un'uscita di sicurezza ed è anche configurato per utilizzare Java security manager, è necessaria un'autorizzazione aggiuntiva nel file dei criteri Java security manager. Modificare il file dei criteri MQIPT Java security manager per concedere un java.lang.RuntimePermission con un obiettivo di autorizzazione closeClassLoader.

Per ulteriori informazioni sull'uso di MQIPT con Java security manager, vedere Java security manager in MQIPT.

Il canale AMQP non supporta più i keystore CMS

Da IBM MQ 9.4.0, il canale AMQP non supporta più i keystore CMS. Se il gestore di code è attualmente configurato con un keystore CMS (cioè un keystore .kdb) e si utilizza un canale SSL/TLS per AMQP, il canale non si avvia. Per utilizzare i canali SSL AMQP, è necessario convertire il keystore CMS in un keystore PKCS12.

Per ulteriori informazioni su come eseguire questa conversione, vedere Supporto SSL/TLS in Protezione dei client AMQP.

Rimozione del supporto per lo scambio di chiavi RSA quando si opera in modalità FIPS

Da IBM MQ 9.4.0, IBM Java 8 JRE rimuove il supporto per lo scambio di chiavi RSA quando si opera in modalità FIPS . Questa rimozione si applica a quanto segue CipherSuites:

• TLS_RSA_WITH_AES_256_GCM_SHA384
• TLS_RSA_WITH_AES_256_CBC_SHA256
• TLS_RSA_WITH_AES_256_CBC_SHA
• TLS_RSA_WITH_AES_128_GCM_SHA256
• TLS_RSA_WITH_AES_128_CBC_SHA256
• TLS_RSA_WITH_AES_128_CBC_SHA
• TLS_RSA_WITH_3DES_EDE_CBC_SHA

Per continuare a utilizzare la modalità FIPS , i seguenti componenti di IBM MQ devono essere modificati per utilizzare un CipherSuite ancora supportato:

• server AMQP
• Managed File Transfer (MFT)
• IBM MQ Console
• IBM MQ Explorer
• IBM MQ REST API
• Servizio MQ Telemetry

Per ulteriori informazioni, consultare TLS CipherSpecs e CipherSuites in IBM MQ classes for Java.

Modifiche ai comandi di gestione dei certificati MQIPT

Da IBM MQ 9.4.0, i seguenti comandi per gestire i certificati nei keystore MQIPT vengono rimossi:

• mqiptKeycmd
• mqiptKeyman

È possibile utilizzare un nuovo comando, mqiptKeytool, invece di questi comandi per gestire i certificati nei keystore MQIPT .

Il comando mqiptKeytool esegue il programma di utilità di gestione certificati Java keytool . I parametri che devono essere specificati quando viene eseguito il comando mqiptKeytool sono differenti dai parametri che devono essere specificati quando il comando mqiptKeyman viene eseguito nelle versioni precedenti di MQIPT.

Per ulteriori informazioni relative al comando mqiptKeytool , consultare mqiptKeytool (gestione certificati). Per ulteriori informazioni sulla gestione dei keystore MQIPT , consultare Gestione dei keystore MQIPT.

Modifiche ai comandi di gestione dei certificati IBM MQ

Da IBM MQ 9.4.0, i seguenti comandi per gestire i certificati nei repository delle chiavi utilizzati da IBM MQ vengono rimossi:

• runmqckm
• strmqikm

Il comando runmqakm , o il nuovo comando runmqktool , può essere utilizzato invece per gestire i repository delle chiavi e i certificati.

Il comando runmqktool esegue il programma di utilità di gestione certificati Java keytool . I parametri che devono essere specificati quando viene eseguito il comando runmqktool sono differenti dai parametri che devono essere specificati quando il comando runmqckm viene eseguito nelle versioni precedenti di IBM MQ.

Per ulteriori informazioni sui comandi di gestione dei certificati e del repository delle chiavi IBM MQ , consultare i comandi runmqakm e runmqktool su AIX®, Linux, and Windows.

Managed File Transfer supporto per i cifrari sicuri ampliato

Da IBM MQ 9.4.0, Managed File Transfer ha aumentato il numero di cifrature sicure supportate dal prodotto.

Inoltre, i valori predefiniti per cipherList e gli attributi specifici del server SFTP sono stati modificati dalla release IBM MQ 9.4.0 . È probabile che venga visualizzato il messaggio BFGBR0127E dopo la migrazione a IBM MQ 9.4.0.

Consultare Formato file delle proprietà del bridge di protocollo per i dettagli delle aggiunte alle cifrature e la Nota importante su come risolvere l'errore BFGBR0127E .

MQIPT rifiuta le connessioni HTTP per impostazione predefinita

Da IBM MQ 9.4.0, gli instradamenti MQIPT accettano solo le connessioni che utilizzano il protocollo IBM MQ per impostazione predefinita. Se MQIPT è usato per accettare connessioni HTTP da un'altra istanza di MQIPT, usare la nuova proprietà AllowedProtocols per configurare la rotta in modo che accetti connessioni HTTP prima di migrare a MQIPT in IBM MQ 9.4.0.

Per ulteriori informazioni, consultare AllowedProtocols.

Amministrazione

Modificato il codice di ritorno per endmqm

Se è stato immesso un comando endmqm per un gestore code in fase di avvio, è stato restituito il codice generico 71 'errore imprevisto'. Da IBM MQ 9.4.0, un tentativo di terminare un gestore code che si sta avviando ora restituisce il codice 4 ' Il gestore code è in fase di avvio '.

Per ulteriori informazioni, vedere endmqm (end queue manager).

Modifica dei permessi predefiniti dello strumento Runmqdlq

Da IBM MQ 9.4.0, le autorizzazioni predefinite di runmqdlq sono state modificate per rimuovere il bit setuid. Quando si esegue runmqdlq, lo strumento viene eseguito nel contesto dell'utente che richiama il comando. Questa modifica porta runmqdlq in linea con altri strumenti che supportano la funzione di connessione client.

Per ulteriori informazioni su runmqdlq, vedere runmqdlq (run dead-letter queue handler).

Modifiche al comando RECOVER CFSTRUCT

Da IBM MQ 9.4.0, l'elaborazione RECOVER CFSTRUCT è stata modificata per utilizzare lo storage a 64 bit invece dello storage a 31 bit. Se si intende eseguire il comando per strutture che contengono più di qualche milione di messaggi, è necessario aumentare il parametro MEMLIMIT nel JCL del gestore di code pertinente di 500MB.

Per ulteriori informazioni, vedere Configurazione dello storage del gestore di code.

Modifiche all'output del comando MFT fteDisplayVersion

Prima di IBM MQ 9.4.0, l'output del comando fteDisplayVersion includeva componenti che Managed File Transfer non utilizzava. Da IBM MQ 9.4.0, questi componenti non sono più inclusi nell'output.

Per ulteriori informazioni, vedere fteDisplayVersion (visualizzazione della versione installata di MFT).

Modifiche alle voci del registro delle connessioni per le connessioni a MQIPT percorsi di server TLS che si chiudono senza inviare dati

Da IBM MQ 9.4.0, le connessioni agli instradamenti IBM MQ Internet Pass-Thru (MQIPT) che si chiudono prima dell'invio dei dati non vengono registrate come errori. Questa modifica influisce sugli instradamenti definiti con SSLServer=true e SSLPlainConnections=false.

Nelle versioni precedenti di MQIPT, le connessioni a questi instradamenti che si chiudono senza inviare dati causano la scrittura di una voce nel log di connessione con un codice di completamento ERROR e un messaggio di errore SSLHandshakeException . Da IBM MQ 9.4.0, le stesse connessioni causano la scrittura di una voce nodata nel log di connessione, con codice di completamento OK . Questa modifica rende le voci del log di connessione per le connessioni che si chiudono prima che i dati vengano inviati congruenti per tutti i tipi di instradamenti MQIPT .

Modifiche al modo in cui la funzione CSQ1LOGP EXTRACT gestisce i messaggi con proprietà di messaggio

Da IBM MQ 9.4.0, la funzione EXTRACT CSQ1LOGP viene modificata in modo che un messaggio con proprietà del messaggio abbia le proprietà convertite in MQRFH2 nel record di output.

Attenzione:

• Il programma di utilità non produce più record MQPUTPRP.
• La funzione CSQ1LOGP EXTRACT richiede thlqual.SCSQAUTH per essere inclusa in STEPLIB.

Consultare Il programma di utilità di stampa del log (CSQ1LOGP) per ulteriori informazioni e Service facilities codes (X'F1') per le modifiche ai codici prodotti.

Modifiche a zHyperWrite

A partire da IBM MQ 9.4.0, il comportamento di zHyperWrite è cambiato, in modo che quando è impostato ZHYWRITE(YES), le scritture di registro attive tentano di usare zHyperWrite indipendentemente dal fatto che i set di dati di registro siano abilitati per zHyperWrite. In precedenza le scritture di registro attive tentavano di usare zHyperWrite solo se i set di dati di registro erano abilitati per zHyperWrite.

Per ulteriori informazioni, vedere Utilizzo di zHyperWrite con IBM MQ registri attivi.

RHEL 7 non è più supportato per RDQM

Da IBM MQ 9.4.0, RDQM su RHEL 7 non è più supportato.

È necessario passare a RHEL 8 o RHEL 9 quando si migra la configurazione di RDQM, vedere Migrazione dei gestori di code di dati replicati.

Modifica dell'avvio del servizio AMQP

Da IBM MQ 9.4.0, il funzionamento predefinito dell'impostazione dell'attributo CONTROL per l'avvio del servizio AMQP è cambiato. Quando si crea e si avvia un nuovo gestore code, il servizio AMQP non si avvia automaticamente come parte del processo di avvio del gestore code.

Per ulteriori informazioni, vedere AMQP Service non si avvia automaticamente all'avvio del gestore code.

Sviluppo di applicazioni

Modifiche ai nomi dei file JAR di Bouncy Castle

Da IBM MQ 9.4.0, i nomi dei file JAR Bouncy Castle forniti con il prodotto sono cambiati. Ad esempio, bcprov-jdk15to18.jar è stato modificato in bcprov-jdk18on.jar.

Per ulteriori informazioni, vedere IBM MQ classes for JMS/Jakarta Messaging file JAR rilocabili e IBM MQ classes for Java file JAR rilocabili.

com.ibm.mq.cfg.useIBMCipherMappings non è più necessario per configurare le mappature

Da IBM MQ 9.4.0, una cifratura può essere definita come nome CipherSpec o CipherSuite e viene quindi gestita correttamente da IBM MQ.

La Java Proprietà di sistema com.ibm.mq.cfg.useIBMCipherMappings, precedentemente utilizzata per configurare un'applicazione per utilizzare l'associazione IBM Java o Oracle Java CipherSuite , non è più necessaria per controllare quali associazioni vengono utilizzate e vengono rimosse dal prodotto.

Miglioramento del messaggio di errore per i fallimenti dell'uscita di sicurezza quando un client .NET si connette a IBM MQ

Un programma di uscita di sicurezza viene utilizzato per verificare che il partner all'altra estremità di un canale sia autentico. Questa operazione è nota anche come autenticazione. Per indicare che un canale deve utilizzare un'uscita di sicurezza, è possibile specificare il nome dell'uscita nel campo SCYEXIT della definizione del canale.

Da IBM MQ 9.4.0, un messaggio di diagnostica nuovo e migliorato viene lanciato dall'applicazione client IBM MQ classes for .NET o IBM MQ classes for XMS .NET gestita. Se non è stato possibile caricare correttamente l'uscita di sicurezza utilizzata dall'applicazione, il vecchio messaggio di errore2195 MQRC_UNEXPECTED_ERRORè sostituito dal nuovo messaggio di errore2406 MQRC_CLIENT_EXIT_LOAD_ERROR.

Per ulteriori informazioni sulle uscite di sicurezza, consultare Programmi di uscita di sicurezza del canale.

Utilizzo del runtime IBMJavaSemeru scaricabile separatamente per le IBM MQ applicazioni client

Da IBM MQ 9.4.0, si dovrebbe usare un IBM Semeru Runtime scaricabile separatamente per le applicazioni client di IBM MQ , invece di usare il runtime di Java confezionato con IBM MQ.

IBM MQ supporta il runtime IBM Semeru Runtime attraverso l'abilitazione del prodotto IBM MQ quando viene utilizzato per l'esecuzione delle applicazioni IBM MQ Java e JMS . Si prevede che il runtime Java , fornito con il prodotto IBM MQ , venga aggiornato più spesso, il che potrebbe comportare modifiche alle applicazioni che dipendono da esso.

Rimozione di IBM MQ .NET Standard librerie client

Le librerie client IBM MQ .NET create utilizzando .NET Standard 2.0, obsolete in IBM MQ 9.3.1, sono state rimosse dal prodotto da IBM MQ 9.4.0. Ciò significa che non sarà più possibile visualizzare la cartella netstandard2.0 e le librerie in essa contenute, ossia amqmdnetstd.dll e amqmxmsstd.dll, nelle seguenti ubicazioni:

• MQ_INSTALLATION_PATH\bin\netstandard2.0
• MQ_INSTALLATION_PATH\lib64\netstandard2.0

Di seguito sono riportati due scenari che potrebbero verificarsi dopo la rimozione delle librerie netstandard2.0 :

• Se si sta utilizzando un'applicazione IBM MQ classes for .NET Framework o IBM MQ classes for XMS .NET Framework creata utilizzando le librerie netstandard2.0 come amqmdnetstd.dll, è necessario ricreare l'applicazione con le librerie Microsoft.NET Framework 4.7.2 come amqmdnet.dll, affinché l'applicazione venga eseguita correttamente. Se non si rigenera l'applicazione, è possibile ottenere un System.IO.Unexceptionable ineccepibile:

  Eccezione rilevata: System.IO.FileLoadException: impossibile caricare il file o l'assembly 'amqmdnetstd, Version=9.3.5.0, Culture=neutral, PublicKeyToken=23d6cb914eeaac0e' o una delle sue dipendenze. La definizione del manifest dell'assieme non corrisponde al riferimento dell'assieme. (Eccezione da HRESULT: 0x80131040)
  Nome file: 'amqmdnetstd, Version=9.3.5.0, Culture=neutral, PublicKeyToken=23d6cb914eeaac0e'
     A SimplePut.SimplePut.PutMessages()
     A SimplePut.SimplePut.Main(String[] argomenti) in C:\SampleCode\Program.cs:riga 132
  
  

• Se si sta utilizzando un'applicazione .NET 6 creata utilizzando le librerie netstandard2.0 , è sufficiente sostituire tali librerie con le stesse librerie .NET 6 nella cartella bin della directory di runtime dell'applicazione. Non è richiesta alcuna rigenerazione.
  Nota: la libreria .NET 6 di sostituzione deve essere sempre dello stesso livello o di un livello superiore della libreria netstandard2.0 sostituita.

Per ulteriori informazioni, consultare Installing IBM MQ classes for .NET e Installing IBM MQ classes for XMS .NET.

Modifiche al modo in cui vengono costruiti i programmi di esempio C con funzionalità di autenticazione

I programmi di esempio C che consentono agli utenti di connettersi a un gestore code con le credenziali sono stati modificati in modo che l'autenticazione sia abilitata solo quando è definito un nuovo indicatore di compilazione, SAMPLE_AUTH_ENABLED. I client che creano i file di esempio di origine forniti dovranno definire questo indicatore di compilazione se desiderano utilizzare l'autenticazione.

Per ulteriori informazioni su come costruire gli esempi con e senza autenticazione, vedere Preparazione ed esecuzione dei programmi di esempio.

Rimozione del supporto delle librerie a 31 bit per IBM MQ per Linux on IBM Z®

Da IBM MQ 9.4.0, il supporto delle librerie a 31 bit per IBM MQ per Linux on IBM Z viene rimosso a causa della rimozione del supporto da parte di alcuni dei sistemi operativi supportati. Le applicazioni a 31 bit devono essere ricompilate a 64 bit.

Container

Modifica delle variabili d'ambiente per l'immagine del contenitore IBM MQ Advanced for Developers

Vengono aggiunte tre nuove variabili di ambiente:

• MQ_LOGGING_CONSOLE_SOURCE
• MQ_LOGGING_CONSOLE_FORMAT (che sostituisce LOG_FORMAT)
• MQ_LOGGING_CONSOLE_EXCLUDE_ID

Per ulteriori informazioni, vedi IBM MQ Advanced for Developers.

Per l'utilizzo nei contenitori, un certificato deve avere un Subject Distinguished Name univoco

I certificati del gestore code con lo stesso DN (Distinguished Name) del certificato dell'emittente (CA) non sono supportati per l'utilizzo con i contenitori IBM MQ . Il prodotto ora controlla questa condizione e ne impedisce l'esecuzione.