Aggiornamento di versione

GovPay viene costantemente aggiornato per la risoluzione di problemi o l’implementazione di nuove funzionalità, pertanto può risultare necessario effettuare l’installazione di una nuova versione nella propria piattaforma.

GovPay segue il versionamento semantico, pertanto si presentano solitamente due casistiche:

  • Aggiornamento di una patch version

  • Aggiornamento di una minor version

Non tratteremo il caso di aggiornamento di una major version poichè attualmente non previste.

Aggiornamento di una patch version

Nel caso di aggiornamento di una patch version, ad esempio per aggiornare la versione 3.1.1 alla 3.1.3, è sufficiente sostituire l’archivio EAR dispiegato nell’Application Server.

Si consiglia di effettuare l’aggiornamento dell’EAR con l’Application Server spento.

Aggiornamento di una minor version

Nel caso di aggiornamento di una minor version oltre a sostituire l’EAR può essere necessario:

  • Applicare una o più patch al database

  • Aggiungere i file di Spring security alla directory di lavoro la configurazione usata lo prevede

Ad esempio, nel caso di aggiornamento dalla versione 3.4.1 alla versione 3.6.0 è necessario

  • Applicare le patch 3.5.sql e 3.6.sql

  • Copiare il file di configurazione api-jppapdp-applicationContext-security.xml nella directory di lavoro

Si consiglia di effettuare le operazioni di aggiornamento con l’Application Server spento e di eseguire un backup del DB prima di applicare le patch.

Aggiornamento da versioni precedenti la 3.5

Il nuovo client HTTP utilizzato da GovPay ignora la configurazione del keystore e trustore della JVM. Risulta quindi necessario verificare che i parametri per l’autenticazione SSL, ove prevista, siano specificati tramite Cruscotto di Backoffice nella configurazione delle Applicazioni e degli Intermediari.

Aggiornamento da versioni precedenti la 3.7

La distribuzione standard di GovPay prevede il seguente stack applicativo seguente:

  • Java 11

  • Wildfly 26