Axcient x360Sync PostgreSQL su cloud privato

A partire da Private Cloud 3.6.20, le nuove installazioni di Private Cloud includono PostgreSQL 12 preinstallato e PostgreSQL impostato come tipo di database radice predefinito. Per aggiornare un'installazione esistente, seguire i passaggi seguenti.

Il processo consigliato per l'aggiornamento di PostgreSQL su un server Private Cloud prevede l'esecuzione parallela delle versioni 9.x e 12.x, la disconnessione di tutti i servizi, l'esecuzione di un backup dal vecchio server, il ripristino sul nuovo server e il ripristino dei servizi online.

Ciò comporterà tempi di inattività durante il processo di migrazione. La durata di tali tempi dipenderà dalle dimensioni del database. Un metodo semplice per stimare in anticipo i tempi di inattività è eseguire il backup del database mentre i servizi sono online (passaggio 4 di seguito). Raddoppiate il tempo necessario per creare il backup per avere un'idea approssimativa della durata del processo di backup e ripristino. Non utilizzate tale backup per la migrazione effettiva.

Istruzioni

Il processo

PASSAGGIO 1. Scarica il programma di installazione di PostgreSQL 12.22 
Puoi usare il link diretto dal sito ufficiale websito: https://sbp.enterprisedb.com/getfile.jsp?fileid=1259240 o un'opzione di riserva: https://syncedtool.com/shares/file/ZiaTVO1LL93/
Ai fini del presente documento, si utilizza e si consiglia PostgreSQL 12, in quanto è la versione attualmente utilizzata nei nostri ambienti di produzione. Stiamo lavorando per aggiungere il supporto per PostgreSQL 14. Quando questo supporto verrà introdotto, la documentazione pertinente verrà aggiornata.

PASSAGGIO 2. Eseguire il programma di installazione di PostgreSQL.

• Tutte le opzioni predefinite vanno bene.
• Tutti i componenti selezionati
• Directory di installazione: C:\Programmi Files\PostgreSQL\12 Directory dati: C:\Programma Files\PostgreSQL\12\dati
• Porta: 5433 (prendere nota nel caso in cui sia diversa. Queste informazioni sulla porta saranno necessarie in seguito)
• Quando viene richiesta una password per l'utente postgres, utilizzare la password configurata nel file config.ini del server, nella sezione [portal]. Se si utilizza una password diversa, il server non riuscirà a connettersi.

PASSAGGIO 3. Arrestare i servizi: Anchor Server, Anchor Celery, Apache

PASSAGGIO 4. Eseguire il backup del database del portale originale dal server originale utilizzando pgAdmin III

1. Apri pgAdmin III
2. Nell'elenco dei server dovresti vedere sia il server originale che PostgreSQL 12.
3. Connettiti al server originale
4. Espandi l'elenco dei database

Fare clic con il tasto destro del mouse sul database "portale" e selezionare "Backup...":

1. Filenome: scegli una posizione in cui salvare il backup e chiamalo "portal.backup"
2. Formato: “Personalizzato”
3. Codifica: “UTF8”
4. Lascia tutte le altre opzioni come predefinite
5. Fai clic su Backup
   
6. Il processo di backup potrebbe richiedere del tempo, a seconda delle dimensioni del database. Dovrebbe concludersi con la riga "Process returned exit code 0".
   
7. Al termine del backup, fare clic su Fine e chiudere pgAdmin III.

PASSAGGIO 5. Ripristinare il database del portale sul nuovo server utilizzando pgAdmin 4

1. Apri pgAdmin 4
   Al primo avvio di pgAdmin 4, potrebbe essere richiesto di impostare una password principale. In questa fase, non è richiesta alcuna password. È possibile (a) scegliere di impostare una password, se si preferisce, oppure (b) fare clic su "Annulla" per ignorare la richiesta di inserimento della password.
   1. Se si verifica il seguente errore quando si tenta di aprire pgAdmin 4, sarà necessario installare una versione supportata per il sistema operativo in uso:
      Il punto di ingresso della procedura discardvirtualmemory non è stato individuato nella libreria a collegamento dinamico C:\Program Files\PostgresSQL\12\pgAdmin4\runtime\nw.dll
   2. Se hai riscontrato l'errore descritto sopra, scarica pgAdmin 4 v6.21 da https://www.pgadmin.org/download/pgadmin-4-windows/ Questo download è per Windows Server 2012 e versioni successive.
   3. Ti consigliamo di installare pgAdmin 4 v6.21 in un posto facile da trovare (ad esempio nella directory Postgres12: C:\Programmi Files\PostgresSQL\12\pgAdmin4 )
2. Connettiti al nuovo server, denominato "PostgreSQL 12" per impostazione predefinita
   
3. Crea il nuovo database del portale
   1. Fare clic con il pulsante destro del mouse sul server e selezionare Crea > Database…
   2. Inserisci "portale" come nome del database
   3. Lascia tutte le altre opzioni come predefinite
   4. Fare clic su Salva
      
4. Ripristinare il database del portale sul nuovo server
   1. Fare clic con il tasto destro del mouse sul nuovo database "portale" e selezionare "Ripristina...":
   2. Formato: "Personalizzato o tar"
   3. Filenome: seleziona il portale.backup file hai salvato prima
   4. Lascia tutte le altre opzioni come predefinite
   5. Fare clic su Ripristina
      
5. Il processo di ripristino potrebbe richiedere del tempo, a seconda delle dimensioni del database.
   Si concluderà con il messaggio "Processo fallito".
   
6. Conferma che il ripristino è stato completato come previsto:
   1. Clic View Processi
   2. Fare clic sull'icona del documento nella riga Ripristina
   3. Dovresti vedere un errore nel registro di ripristino: pg_restore: errore: impossibile eseguire la query: ERRORE lo schema "public" esiste già
   4. Scorri fino alla fine del registro. Vedrai: pg_restore: avviso: errori ignorati durante il ripristino: 1
      

PASSAGGIO 6. Aggiornare la configurazione del server

1. Aprire \Anchor Server\conf\config.ini in un editor di testo
2. Modificare la voce “porta” nella sezione “[portale]” in 5433 (o il valore della porta scelto durante l’installazione di PostgreSQL)

[portale]

• host = localhost
• database = portale
• porta = 5433

Salva
PASSAGGIO 7. Aggiornare il web configurazione

1. Apri \Anchor Server\web\config.py in un editor di testo
2. Aggiungere la seguente riga dopo la riga PORTAL_DB_NAME (modificare il numero di porta se ne è stato utilizzato uno diverso durante l'installazione di PostgreSQL)

PORTAL_DB_PORT = “5433”
Se config.py ha già un valore per PORTAL_DB_PORT, aggiornalo invece

Salva

• PASSAGGIO 8. Arrestare il servizio postgresql-9.x
• PASSAGGIO 9. Nelle proprietà del servizio postgresql-9.x modificare "Tipo di avvio" in "Manuale"
• PASSAGGIO 10. Riavviare i servizi: Anchor Server, Anchor Celery, Apache
• PASSAGGIO 11. Verificare che l'applicazione funzioni come previsto

Qualcosa è andato storto...

Se il backup/ripristino non viene completato come previsto o i servizi non si riavviano o non funzionano come previsto, ripristinare il server del database originale:

1. Assicurarsi che i servizi postgresql-9.x siano in esecuzione
2. Annulla le modifiche alla configurazione
3. Riavviare i servizi

Se i servizi venissero ripristinati e gli utenti creassero nuove organizzazioni, account, root, ecc., il ripristino del database originale comporterà la perdita di tali modifiche. I dati nelle root esistenti prima della migrazione non rimarrebbero interessati. Il rischio può essere mitigato disabilitando l'accesso pubblico ai servizi prima di ripristinarli, verificandone la funzionalità e quindi consentendo l'accesso pubblico. Ad esempioample, utilizzando un firewall o modificando la configurazione del server e di Apache in modo che ascoltino solo localmente. Tale processo può variare a seconda dell'ambiente e non rientra nell'ambito di questo documento.

Copyright ©2025 Axcient Tutti i diritti riservati.

Documenti / Risorse

Axcient x360Sync PostgreSQL su cloud privato [pdf] Manuale d'uso Private Cloud 3.6.20, x360Sync PostgreSQL su Private Cloud, x360Sync, PostgreSQL su Private Cloud, Private Cloud, Cloud

Riferimenti

• Manuale d'uso