Upgrade v3.0.2 naar v4.0.0
Upgrade de database schema's middels hieronder beschreven procedures, upgrade daarna de database drivers in de servlet container en daarna de web applicatie(s).
Voor docker scenarios volstaat het upgraden van de database middels dump/restore #2263 en daarna upgrade van de database schema's en het updaten (pull) en herstarten van de latest of upgrade en herstart van de container naar 4.0.0 tag.
Release 4.0.0: https://github.com/B3Partners/brmo/releases/tag/v4.0.0
Volledig wijzigingsoverzicht: https://github.com/B3Partners/brmo/compare/v3.0.2...v4.0.0
In deze versie is de brmo-soap module verwijderd, zie: BRMO-354/#2055.
In deze versie is ondersteuning voor BAG 1 verwijderd, zie: BRMO-123/#2052
In deze versie zijn drie NHR-views toegevoegd, zie: BRMO-352/#2090
Voor deze versie is Java 17 als runtime omgeving noodzakelijk, zie ook Systeemeisen.
Deze versie biedt ondersteuning voor Oracle 23c.
Indien gebruik wordt gemaakt van de boolean velden van BAG en BGT in Oracle databases dient een nieuwe stand te worden geladen om de inhoud van deze kolommen te corrigeren (BRMO-356, BRMO-357).
De database schema's "staging", "rsgb", "bag", "brk" en "rsgbbgt" dienen bijgewerkt te worden met behulp van onderstaande scripts om het database/schema versienummer bij te werken en een aantal aanpassingen door te voeren. Voor "staging" en "rsgb" zijn extra scripts aangegeven om BAG 1 data op te ruimen.
NB Indien er maatwerk views zijn gemaakt of er "oude", niet meer ondersteunde views in de database zitten dan moeten deze mogelijk ook aangepast en/of verwijderd en/of nieuw aangemaakt worden, dit is afhankelijk van de database engine.
Alle genoemde SQL scripts zijn ook beschikbaar in de download zip-file en de docker image.
- oracle: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/upgrade_scripts/3.0.2-4.0.0/oracle/bag.sql
- postgresql: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/upgrade_scripts/3.0.2-4.0.0/postgresql/bag.sql
View vb_util_zk_recht_op_koz wordt aangepast (BRMO-351/#2043)
- oracle: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/upgrade_scripts/3.0.2-4.0.0/oracle/brk.sql
- postgresql: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/upgrade_scripts/3.0.2-4.0.0/postgresql/brk.sql
Om BAG 1 data, brondocumenten, tabellen en views te verwijderen uit de rsgb database dienen de volgende scripts te worden uitgevoerd:
- oracle: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/utility_scripts/oracle/202_delete_bag_brondocumenten.sql
- oracle: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/extra_scripts/oracle/300_drop_bag_tabellen.sql
- postgresql: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/utility_scripts/postgresql/202_delete_bag_brondocumenten.sql
- postgresql: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/extra_scripts/postgresql/300_drop_bag_tabellen.sql
- oracle: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/upgrade_scripts/3.0.2-4.0.0/oracle/rsgb.sql
- postgresql: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/upgrade_scripts/3.0.2-4.0.0/postgresql/rsgb.sql
De volgende materialized views kunnen handmatig verwijderd worden vanwege mogelijke afhankelijkheid:
- mb_kad_onrrnd_zk_adres_bag
- mb_koz_rechth_bag
- mb_avg_koz_rechth_bag
De SQL-statements zijn in de bovenstaande upgrade-scripts uitgecommentarieerd.
Views mb_onroerendezakenmetrechthebbenden en mb_avg_onroerendezakenmetrechthebbenden hebben een tweetal nieuwe kolommen (tijdstipaanbieding_stuk en tijdstipaanbieding_stuk2) gekregen (BRMO-383/#2303) en dienen handmatig te worden bijgewerkt (uitleg/details.
Drop de betreffende materialized views uit het RSGB schema met onderstaande statements
DROP MATERIALIZED VIEW mb_onroerendezakenmetrechthebbenden;
DROP MATERIALIZED VIEW mb_avg_onroerendezakenmetrechthebbenden;Maak daarna de materialized views en commentaar opnieuw aan met de database specifieke code uit db/rsgb/oracle/210_bag2_brk2.0_mat_views.sql#187-591 dan wel db/rsgb/postgresql/210_bag2_brk2.0_mat_views.sql#152-444 (let op er zijn meerdere views in het bestand gedefinieerd).
- oracle: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/upgrade_scripts/3.0.2-4.0.0/oracle/rsgbbgt.sql
- postgresql: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/upgrade_scripts/3.0.2-4.0.0/postgresql/rsgbbgt.sql
Om alle BAG 1 laadprocessen en berichten op te ruimen dient het volgende script te worden uitgeoerd in het schema:
- oracle: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/utility_scripts/oracle/1000_delete_bag_berichten.sql
- postgresql: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/utility_scripts/postgresql/1000_delete_bag_berichten.sql
- oracle: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/upgrade_scripts/3.0.2-4.0.0/oracle/staging.sql
- postgresql: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/upgrade_scripts/3.0.2-4.0.0/postgresql/staging.sql
In de Oracle TopNL schema's zijn de CHAR(1) waarmee boolean waarden werden vastgelegd vervangen door VARCHAR2(5) waar de waarden true en false in passen. (BRMO-363) Derhalve dient bij Oracle databases de TopNL opnieuw geladen te worden, iets wat normaal gezien ieder kwartaal dient te gebeuren om bij te blijven met aanpassingen in de kaarten.
NB het Oracle upgrade script dient door een user met toereikende privileges te worden uitgevoerd, bijvoorbeeld een sys account
- oracle: https://github.com/B3Partners/brmo/blob/v4.0.0/datamodel/upgrade_scripts/3.0.2-4.0.0/oracle/topnl.sql
- postgresql: geen updates
terug naar het upgrades overzicht
Dit werk valt onder een Creative Commons Naamsvermelding-GelijkDelen 2.0 Nederland-licentie.
