Axcient x360Sync PostgreSQL på privat cloud

Fra og med Private Cloud 3.6.20 leveres nye Private Cloud-installationer med PostgreSQL 12 forudinstalleret og PostgreSQL angivet som standard roddatabasetype. Følg nedenstående trin for at opgradere en eksisterende installation.

Den anbefalede proces til opgradering af PostgreSQL på en privat cloud-server involverer at køre version 9.x og 12.x side om side, tage alle tjenester offline, udføre en sikkerhedskopi fra den gamle server, gendanne til den nye server og derefter bringe tjenesterne online igen.

Dette vil resultere i nedetid under migreringsprocessen. Længden af ​​nedetiden afhænger af databasens størrelse. En simpel metode til at estimere nedetiden på forhånd er at udføre databasebackup, mens tjenesterne er online (trin 4 nedenfor). Dobbelt den tid, det tager at oprette backup'en, for at få en grov estimat af, hvor lang tid backup- og gendannelsesprocessen vil tage. Brug ikke den backup til selve migreringen.

Instruktioner

Processen

TRIN 1. Download installationsprogrammet til PostgreSQL 12.22 
Du kan bruge det direkte link fra den officielle webwebsted: https://sbp.enterprisedb.com/getfile.jsp?fileid=1259240 eller en reservemulighed: https://syncedtool.com/shares/file/ZiaTVO1LL93/
I dette dokument anvendes og anbefales PostgreSQL 12, da det er den version, vi i øjeblikket kører i vores produktionsmiljøer. Vi arbejder på at tilføje understøttelse af PostgreSQL 14. Når denne understøttelse introduceres, vil den relevante dokumentation blive opdateret.

TRIN 2. Kør PostgreSQL-installationsprogrammet.

• Alle standardindstillinger er fine.
• Alle komponenter er valgt
• Installationsmappe: C:\Program Files\PostgreSQL\12 Datamappe: C:\Program Files\PostgreSQL\12\data
• Port: 5433 (Vær opmærksom på dette, hvis dette afviger. Disse portoplysninger vil være nødvendige senere)
• Når du bliver bedt om en adgangskode til postgres-brugeren, skal du bruge den adgangskode, der er konfigureret i serverens config.ini i afsnittet [portal]. Hvis der bruges en anden adgangskode, vil serveren ikke kunne oprette forbindelse.

TRIN 3. Stop tjenester: Anchor Server, Anchor Celery, Apache

TRIN 4. Sikkerhedskopier den originale portaldatabase fra den originale server ved hjælp af pgAdmin III

1. Åbn pgAdmin III
2. Du bør se både den oprindelige server og PostgreSQL 12 på serverlisten.
3. Opret forbindelse til den oprindelige server
4. Udvid listen over databaser

Højreklik på "portal"-databasen og vælg "Sikkerhedskopiering...":

1. Filenavn: Vælg en placering til at gemme sikkerhedskopien, og navngiv den "portal.backup"
2. Format: "Brugerdefineret"
3. Kodning: “UTF8”
4. Lad alle andre indstillinger være standardindstillingerne
5. Klik på Backup
   
6. Sikkerhedskopieringsprocessen kan tage et stykke tid afhængigt af databasens størrelse. Den burde slutte med linjen "Process returned exit code 0".
   
7. Når sikkerhedskopieringen er færdig, skal du klikke på Udført og lukke pgAdmin III.

TRIN 5. Gendan portaldatabasen på den nye server ved hjælp af pgAdmin 4

1. Åbn sideadministrator 4
   Du bliver muligvis bedt om at angive en masteradgangskode til pgAdmin 4, første gang du åbner programmet. En adgangskode er ikke påkrævet på dette tidspunkt. Du kan (a) vælge at angive en adgangskode, hvis du foretrækker det, eller (b) klikke på Annuller for at ignorere adgangskodeprompten.
   1. Hvis følgende fejl opstår, når du forsøger at åbne pgAdmin 4, skal du installere en understøttet version til dit operativsystem:
      Procedureindgangspunktet discardvirtualmemory kunne ikke findes i det dynamiske linkbibliotek C:\Program Files\PostgresSQL\12\pgAdmin4\runtime\nw.dll
   2. Hvis du oplevede fejlen som beskrevet ovenfor, skal du downloade pgAdmin 4 v6.21 fra https://www.pgadmin.org/download/pgadmin-4-windows/ Denne download er til Windows Server 2012 og nyere.
   3. Vi anbefaler, at du installerer pgAdmin 4 v6.21 et sted, hvor det er nemt at finde (f.eks. Postgres12-mappen: C:\Program Files\PostgresSQL\12\pgAdmin4)
2. Opret forbindelse til den nye server, der som standard hedder “PostgreSQL 12”
   
3. Opret den nye portaldatabase
   1. Højreklik på serveren, og vælg Opret > Database…
   2. Indtast "portal" som databasenavn
   3. Lad alle andre indstillinger være standardindstillingerne
   4. Klik på Gem
      
4. Gendan portaldatabasen til den nye server
   1. Højreklik på den nye "portal"-database og vælg "Gendan...":
   2. Format: "Brugerdefineret eller tar"
   3. Filenavn: Vælg portal.backup file du gemte tidligere
   4. Lad alle andre indstillinger være standardindstillingerne
   5. Klik på Gendan
      
5. Gendannelsesprocessen kan tage et stykke tid afhængigt af databasens størrelse.
   Den vil afsluttes med meddelelsen "Processen mislykkedes".
   
6. Bekræft, at gendannelsen er fuldført som forventet:
   1. Klik View Processer
   2. Klik på dokumentikonet i rækken Gendan
   3. Du burde se en fejl i gendannelsesloggen: pg_restore: error: could not execute query: ERROR schema “public” already exists
   4. Rul ned til slutningen af ​​loggen. Du vil se: pg_restore: warning: errors ignored on restore: 1
      

TRIN 6. Opdater serverkonfigurationen

1. Åbn \Anchor Server\conf\config.ini i en teksteditor
2. Skift "port"-posten i afsnittet "[portal]" til 5433 (eller den portværdi, du valgte under PostgreSQL-installationen)

[portal]

• vært = lokal vært
• database = portal
• port = 5433

Spare
TRIN 7. Opdater web config

1. Åbn \Ankerserver\web\config.py i en teksteditor
2. Tilføj følgende linje efter PORTAL_DB_NAME-linjen (ændre portnummeret, hvis et andet blev brugt under PostgreSQL-installationen)

PORTAL_DB_PORT = “5433”
Hvis config.py allerede har en værdi for PORTAL_DB_PORT, skal du opdatere den i stedet.

Spare

• TRIN 8. Stop postgresql-9.x-tjenesten
• TRIN 9. I postgresql-9.x serviceegenskaber skal du ændre "Starttype" til "Manuel"
• TRIN 10. Genstart tjenester: Anchor Server, Anchor Celery, Apache
• TRIN 11. Bekræft at applikationen fungerer som forventet

Noget gik galt…

Hvis sikkerhedskopieringen/gendannelsen ikke fuldføres som forventet, eller tjenesterne ikke genstarter eller fungerer som forventet, skal du vende tilbage til den oprindelige databaseserver:

1. Sørg for, at postgresql-9.x-tjenesterne kører
2. Fortryd konfigurationsændringerne
3. Genstart tjenester

Hvis tjenester blev bragt online igen, og brugerne oprettede nye organisationer, konti, rodsystemer osv., vil disse ændringer gå tabt, hvis man vender tilbage til den oprindelige database. Data i rodsystemer, der eksisterede før migreringen, ville ikke blive påvirket. Risikoen kan afbødes ved at deaktivere offentlig adgang til tjenester, før de bragtes online igen, verificere funktionaliteten og derefter tillade offentlig adgang. For eksempelampf.eks. ved at bruge en firewall eller ændre server- og Apache-konfigurationen til kun at lytte lokalt. Denne proces kan variere afhængigt af miljøet og ligger uden for dette dokuments omfang.

Ophavsret ©2025 Axcient Alle rettigheder forbeholdes.

Dokumenter/ressourcer

Axcient x360Sync PostgreSQL på privat cloud [pdfBrugermanual Privat cloud 3.6.20, x360Sync PostgreSQL på privat cloud, x360Sync, PostgreSQL på privat cloud, Privat cloud, Cloud

Referencer

• Brugermanual