Upgrade v3.0.2 naar v4.0.0
Deze versie is nog niet beschikbaar / aan deze versie wordt nog gewerkt
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 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.
- 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.
- 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.
