Technische release notes 2016 release - Algemeen
tg1. |
De versie op het splash screen van Corsa, MyCorsa en MyCorsa NxT toont deze release 2016. Deze Lange Termijn (LT) release wordt maximaal drie jaar door BCT ondersteund. |
||||||||||||||||||||||||||||||||||||
tg2. |
Deze release bevat databasewijzigingen ten opzichte van de Corsa 2015-1 release en eerder. De wijzigingen gelden voor de Corsa database en de Audit database. Voor ETL zijn er geen databasewijzigingen.
Informatie over het aantal tabellen en indexen van de diverse databases voor deze release:
Met 'voorheen' wordt de Corsa 2015-1 release bedoeld.
Let op: er gelden aanvullende voorwaarden bij een upgrade naar de Corsa 2016 release met betrekking tot database gerelateerde zaken. Zie de release notes hieronder. |
||||||||||||||||||||||||||||||||||||
tg3. |
Met de Corsa 2016 release is de overgang van OpenEdge 10.2B (32-bit) naar Progress OpenEdge 11.6 Service Pack 1 (32-bit) doorgevoerd.
Het betreft een technologische upgrade van het onderliggende platform van Corsa. BCT gaat op deze manier mee in de nieuwe ontwikkelingen van Progress OpenEdge en is derhalve voorbereid op de toekomst.
Voor de installatie van de OpenEdge 11 database, AppServer en WebSpeed dient de desbetreffende installatiehandleiding gebruikt te worden. Er zijn nl. t.o.v. OpenEdge 10 enkele zaken gewijzigd tijdens de installatie en configuratie. |
||||||||||||||||||||||||||||||||||||
tg4. |
Het is noodzakelijk om vóórafgaand aan de Corsa 2016 database upgrade een pre-conversie programma uit te voeren op de bestaande Corsa database. Dit programma controleert op corrupte records in de database en verwijdert deze indien gevonden. Voor de drie ondersteunde databaseplatformen geldt: •Progress: het pre-conversie programma wordt automatisch uitgevoerd tijdens de automatische database upgrade. •Oracle & Microsoft SQL Server: het pre-conversie programma moet handmatig worden uitgevoerd in een bestaande (werkende) Corsa omgeving voordat de database upgrade plaatsvindt.
Het pre-conversie programma wordt op twee manieren uitgeleverd: Variant 1: Het programma is opgenomen in de PL-bestanden van de UCR van juni 2016 (UCR 06 - 2016) en later voor de 2013-4, 2014, 2014-2 en 2015-1 release. Variant 2: Het programma wordt los uitgeleverd (pre_conv_hand_p10.r) zodat het programma handmatig uitgevoerd kan worden als de PL-bestanden van UCR 05 - 2016 (of later) niet geplaatst zijn.
Variant 1: Instructie uitvoeren pre-conversie programma: •Log in met de 'system' gebruiker in Corsa •Ga naar 'Systeem' | 'Installatie' | 'Programma's' •Vink de optie 'Gedefinieerde programma's' uit •Type de volgende regel in: std/upgrade/preconv/pre_conv_hand_p10.r •Klik op 'OK' •Klik op 'Yes' of 'Ja' bij de vraag 'Start pre-conversion?' •Na afloop wordt een dialoog getoond met de tekst 'Pre-conversion has finished'. Klik op 'OK'.
Variant 2: Instructie uitvoeren pre-conversie programma: •Log in met de 'system' gebruiker in Corsa •Ga naar 'Systeem' | 'Installatie' | 'Programma's' •Vink de optie 'Gedefinieerde programma's' uit •Browse naar de locatie waar het pre-conversie programma geplaatst is en selecteer 'pre_conv_hand_p10.r' en klik op 'Open' •Klik op 'OK' •Klik op 'Yes' of 'Ja' bij de vraag 'Start pre-conversion?' •Na afloop wordt een dialoog getoond met de tekst 'Pre-conversion has finished'. Klik op 'OK'.
In het logbestand bct_upgrade.log (standaard terug te vinden in %TEMP% van de gebruiker die de Corsa sessie heeft gestart) is de totale tijdsduur van het pre-conversie programma terug te vinden:
================================================================================ End update PRE-CONVERT Elapsed time : 00:02:23 ================================================================================
Na het uitvoeren van het pre-conversie programma dienen geen mutaties in de database meer plaats te vinden totdat de Corsa 2016 release is geïnstalleerd en in gebruik is genomen.
Enkele opmerkingen: •Het pre-conversie programma is voor alle ondersteunde databaseplatformen gelijk. •Het pre-conversie programma kan gebruikt worden voor alle op Progress OpenEdge 10 gebaseerde Corsa release. •Het pre-conversie programma kan uitgevoerd worden terwijl er gebruikers actief zijn Corsa, MyCorsa en/of MyCorsa NxT. Het is echter raadzaam om het programma uit te voeren als er geen gebruikers actief zijn, zodat de kans op nieuwe corrupte records zeer klein is. •Het pre-conversie programma kan meerdere malen uitgevoerd worden. •De doorlooptijd van het pre-conversie programma is afhankelijk van het totaal aantal records van alle tabellen. |
||||||||||||||||||||||||||||||||||||
tg5. |
Voor het Progress OpenEdge databaseplatform dient een aanvullende actie te worden uitgevoerd bij een Corsa upgrade, namelijk het converteren van de databasestructuur naar OpenEdge 11. Deze conversie kan worden uitgevoerd door het 'db_convert_to_oe11_<dbnaam>.cmd' script uit te voeren dat is terug te vinden in de 'bct\data\db_files' map van de nieuwe directorystructuur (zie tg6).
Het script voert de volgende acties uit: •Er wordt een 'repair' en een 'truncate' van de bestaande database uitgevoerd tegen Progress OpenEdge 10 door middel van de meegeleverde Progress OpenEdge 10 tools •De database wordt geconverteerd naar het OpenEdge 11 formaat. |
||||||||||||||||||||||||||||||||||||
tg6. |
De standaard directorystructuur die door BCT gebruikt wordt is aangepast. De belangrijkste aanpassingen betreffen: •De verwijzingen naar de productie- (prod) en testomgeving (test) zijn uit de benamingen en de inhoud van de bestanden verwijderd. •Er zijn geen aparte bestanden meer voor de productie- en testomgeving. •In de client- en serversoftware mappen zijn de versienummers en de cijfers uit de namen van de mappen verwijderd. •In diverse .cmd bestanden is de DLC Enviroment Variable toegevoegd i.v.m. OpenEdge 11 compatibiliteit. •Gewijzigde registerbestanden (.reg bestanden) t.b.v. het maken van de ODBC verbinding met de Corsa database in het geval van een Microsoft SQL Server databaseplatform.
Gezien de wijzigingen moet bij een installatie van de Corsa 2016 release ook de nieuwe directorystructuur gebruikt worden. Het is raadzaam om een backup te maken van de oude directorystructuur bij een upgrade. |
||||||||||||||||||||||||||||||||||||
tg7. |
Indien de Corsa 2016 release wordt gebruikt dan dienen ook de minimale versies van de volgende componenten geïnstalleerd of bijgewerkt te worden (indien van toepassing): •Corsa 7.2 Web Service versie 7.2.161.1 / 062 •Corsa 7.2 StUF-BG 2.04 Web Service versie 2.04.1604 / 030 •Corsa 7.2 BBC Schaubroeck Web Service versie 7.20.161.1 •Corsa/TaskService versie 7.20.1603.1 •Corsa/Enterprise Search (zie ook tg8) oBCT BerichtenCentrale (BCE) MSI 2.0.2 oCorsa/Enterprise Search deployment voor de BCT BerichtenCentrale (BCE) 2.0.9 oCorsa/Solr MSI 2.0.3 •SharePoint on Corsa versie 2.0.12 •ABBYY FineReader Engine versie 11.1.1601 •MyCorsa NxT Office Add-in versie 2.0.4
Deze componenten zijn backwards compatibel met oudere releases. Zie voor meer informatie de installatiehandleidingen en/of het Corsa 7.2 Availability Document. |
||||||||||||||||||||||||||||||||||||
tg8. |
Voor Corsa/Enterprise Search dienen de volgende minimale versies gebruikt te worden: •BCT BerichtenCentrale (BCE) MSI 2.0.2 of hoger •Corsa/Enterprise Search deployment voor de BCT BerichtenCentrale (BCE) 2.0.9 of hoger •Corsa/Solr MSI 2.0.3 of hoger
Bij een upgrade naar de Corsa 2016 release dient een zogenaamde herindexering plaats te vinden. Zie de installatiehandleiding van Corsa/Enterprise Search voor meer informatie.
De zogenoemde groepeerfunctionaliteit voor Corsa/Enterprise Search is vervallen om voor grote hoeveelheden gegevens de performance/schaalbaarheid te verbeteren. Er wordt nu minder gerelateerde informatie (van cases en dossiers) bij een poststuk geïndexeerd. Hiervoor is eenmalig herindexering nodig.
Door het vervallen van de groepeerfunctionaliteit zal de grootte van de Solr index in meer of mindere mate afnemen. Dit is afhankelijk van de hoeveelheid en type vulling. |
||||||||||||||||||||||||||||||||||||
tg8. |
De Corsa 2016 release is de laatste release waarbij MyCorsa uitgeleverd wordt. Corsa releases nieuwer dan de Corsa 2016 release zullen geen MyCorsa meer bevatten. Het advies is om over te stappen naar MyCorsa NxT. |
||||||||||||||||||||||||||||||||||||
tg10. |
Browserondersteuning m.i.v. de Corsa 2016 release
•Ondersteuning Apple iPad voor MyCorsa NxT •Ondersteuning Microsoft Edge browser voor MyCorsa NxT
Let op! De ondersteuning voor Internet Explorer 9 is vervallen. MyCorsa NxT toont de volgende melding indien toch Internet Explorer 9 wordt gebruikt:
Zie het document 'BCT Browserondersteuning' voor meer informatie. |
||||||||||||||||||||||||||||||||||||
tg11. |
Vrijgave van de ondersteuning voor Windows 10 voor Corsa en MyCorsa NxT. MyCorsa wordt niet ondersteund op Windows 10. |
||||||||||||||||||||||||||||||||||||
tg12. |
Vrijgave van de ondersteuning voor Microsoft Office 2016 (32-bit) voor Corsa, MyCorsa en MyCorsa NxT. Microsoft Office 2016 (32-bit) wordt vooralsnog niet ondersteund als ondersteunende applicatie ten behoeve van Neevia Document Converter Pro. Bij het gebruik van Microsoft Office 2016 op de clients, wordt vooralsnog uitsluitend Microsoft Office 2013 (32-bit) als ondersteunende applicatie voor Neevia Document Converter Pro ondersteund. |
||||||||||||||||||||||||||||||||||||
tg13. |
Het aanmaken van de schema holder ten behoeve van de communicatie tussen Progress OpenEdge en een Oracle of Microsoft SQL Server database, is gewijzigd. In het verleden werd er een schema holder aangemaakt die het 1252 formaat had en daarna geconverteerd naar UTF-8. Vanaf de 2016 release wordt de schema holder direct aangemaakt in het UTF-8 formaat. Gebruik voor het aanmaken van de schema holders de scripts uit de standaard directorystructuur. |
||||||||||||||||||||||||||||||||||||
tg14. |
Vrijgave van de ondersteuning voor Windows 10 voor Corsa/ADR 4.5. Hiervoor moet minimaal versie 4.5.1602.2 gebruikt worden. |
||||||||||||||||||||||||||||||||||||
tg15. |
Met de overgang naar Progress OpenEdge 11.6 is er tevens een nieuwe ODBC driver geïntroduceerd ten behoeve van de communicatie van Progress OpenEdge naar Microsoft SQL Server. In het verleden werd de standaard 'SQL Server' driver gebruikt, met de Corsa 2016 release is dit de 'OpenEdge 11.6 Wire Protocol Driver for MS SQL Server'.
Deze driver wordt standaard door de Corsa Connector MSI geïnstalleerd in de '<installatiemap>\appl\ODBC' map geïnstalleerd. Tevens zijn hiervoor de aangeleverde registerbestanden aangepast: •odbc_corsa_32-bit_os.reg: aanmaken datasource voor 32-bit besturingssystemen •odbc_corsa_64-bit_os.reg: aanmaken datasource voor 64-bit besturingssystemen
Deze .reg bestanden zijn terug te vinden in de standaard directorystructuur die door BCT aangeleverd wordt (om precies te zijn in '<installatiemap>\bct\clientsoftware\config\misc\odbc'.
Werkwijze bij het aanmaken van een ODBC datasource op basis van de nieuwe driver: •Open het .reg bestand overeenkomstig het gebruikte besturingssysteem •Pas de relevante velden aan (zie de installatiehandleiding van de Progress OpenEdge AppServer/WebSpeed en de Corsa Connector MSI voor meer informatie) •Verwijder de oude 'SQL Server' ODBC datasource •Lees het .reg bestand in door er bijvoorbeeld op te dubbelklikken.
De Corsa Connector MSI detecteert of de driver al geïnstalleerd is en zal deze niet nogmaals installeren als dit het geval is. Dit betekent onder andere dat de driver niet door de Corsa Connector MSI geïnstalleerd wordt op machines waarop Progress OpenEdge 11 - DataServer for Microsoft SQL Server geïnstalleerd is. In dit geval is de driver al door de Progress OpenEdge setup geïnstalleerd. Bij het aanmaken van de ODBC datasource dient dan ook de locatie van de driver in de OpenEdge installatiemap opgegeven te worden in plaats van de installatiemap van de Corsa Connector MSI. |
||||||||||||||||||||||||||||||||||||
tg16. |
Er zijn vanuit BCT aanpassingen doorgevoerd zodat de Corsa 2016 release FIPS compliant is. Diverse randcomponenten waren al FIPS compliant gemaakt in recente versies. Om volledige FIPS compliancy te garanderen, dient men gebruik te maken van de versies van de randcomponenten zoals deze in tg7 benoemd zijn. |
||||||||||||||||||||||||||||||||||||
tg17. |
Zoals in tg7 is aangegeven, dient er bij de Corsa 2016 release gebruik te worden gemaakt van een minimale MyCorsa NxT Office Add-in versie. De genoemde add-in versie is gecompileerd tegen het Microsoft .NET Framework 4.0 Full Package. Overige wijzigingen in de add-in betreffen onder andere: •Microsoft Office 2016 (32-bit) ondersteuning •FIPS compliancy
De add-in setup vereist het Microsoft .NET Framework 4.0 Full Package en de setup probeert deze vereiste te installeren op Windows 7, Windows 2008/R2 indien er wordt gedetecteerd dat dit niet aanwezig is. Bij recentere besturingssystemen is het .NET 4.0 framework in het besturingssysteem inbegrepen (via zogenaamde 'Features'), waardoor deze niet via de setup te installeren is. Er kan een reguliere update worden uitgevoerd om de nieuwe add-in te installeren, net zoals in het verleden ook het geval was (de add-in hoeft dus niet eerst verwijderd te worden alvorens de nieuwe versie te installeren). |
||||||||||||||||||||||||||||||||||||
tg18. |
M.i.v. de Corsa 2016 release dient het 'startup type' van de Windows services van de diverse Corsa componenten op 'manual' gezet te worden (i.p.v. 'automatic'). Voor het starten en stoppen van de services dienen respectievelijk de scripts 'start_processes.cmd' en 'stop_processes.cmd' uit de standaard directorystructuur gebruikt te worden.
Ook de 'auto start' van de OpenEdge database en/of AppServer en WebSpeed brokers dient uitgezet te worden in de OpenEdge Explorer.
De stop/start scripts hanteren de juiste volgorde in het stoppen en starten van processen. Zo wordt bijvoorbeeld voorkomen dat bepaalde processen al beginnen met het verwerken van data terwijl onderliggende componenten die hiervoor nodig zijn nog niet zijn gestart. De scripts voorkomen daarbij foutmeldingen en waarschuwingen in logbestanden. Daarnaast zorgen de scripts voor opschoning van ongebruikte processen/bestanden en rotatie van logbestanden.
Het gaat op het moment van schrijven om de volgende Windows services: •BCT BCE •CorsaCMIS •BCT Apache2 •BCT AS •BCT TaskService •BCT CaptureService •CorsaSolr •CORSATaskService •Tomcat6 •Tomcat7 •DSservice •IDT PDF Service •DCStart •AdminService11.6(32-bit) (tevens uitschakelen van de 'auto start' van de componenten database, AppServer en WebSpeed)
Het is zaak om op elke Corsa server een geplande taak aan te maken zodat de processen peridiodiek worden gestopt en gestart. Daarnaast dient deze geplande taak er ook voor te zorgen dat bij het opstarten van de server de 'start_processes.cmd' wordt uitgevoerd. |