wiki:Documentatie/Ontwikkelaar/Systeembeheer/OpenAC3Testserver

Version 3 (modified by peter, 5 years ago) (diff)

--

TOC(heading=Systeembeheer, sectionindex, compact, depth=3, allactive, Documentatie/Ontwikkelaar/Systeembeheer/)? TOC(heading=Ontwikkelaar, sectionindex, compact, depth=2, allactive, Documentatie/Ontwikkelaar/)? TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)?

OpenAC3 Testserver

De server ten behoeve van het testen van de master branch van OpenAC3 is een Azure Virtual Machine. Voor gebruikers van OpenAC3 die de applicatie testen is een dagelijkse experimentele build van OpenAC3 te benaderen via ​https://openac3test.fenac.nl/.

Azure Virtual Machine

De virtual machine heet OpenAC3 en is te benaderen in de ​Azure portal onder de "standaardmap", als je daar toegang toe hebt gekregen. De resource groep waar de VM bij hoort met alle bijhorende Azure onderdelen heet OpenAC3_group. Vanuit Azure kan een bestand voor een RDP (Bureaublad op afstand) verbinding gedownload worden, of doe dat gewoon met de applicatie op je computer door te verbinden met computer 51.124.172.104, gebruiker OpenACBeheerder. De server heeft Windows Server 2012 R2 als besturingssysteem, er is maar 1 gebruiker. Wanneer je met RDP op de server ingelogd bent dan heb je een aantal tools beschikbaar vastgezet op de taakbalk: Google Chrome, Notepad++, Opdrachtprompt, Git Bash, OpenAC2, Firefox en Services. In het menu start zie je ook nog MSSQL Studio, ODBC bronbeheer, en meer.

Azure Database

In de resource groep is SQL Server openacdb in gebruik. Er kunnen databases aangemaakt worden vanuit de Azure portal of met SQL Server Management Studio. OpenAC3 maakt zelf geen database aan, daarom kopieer je een OpenAC2 database of je gebruikt OpenAC2 met een ODBC koppeling om de database in te richten bij de eerste start.

ODBC en Azure

Je kan de database van de testserver op afstand gebruiken met OpenAC2. Configureer met het programma "ODBC-gegevensbronbeheer (32-bits)" een SQL Server koppeling met het "ODBC Driver XX for SQL Server" stuurprogramma. De server is te vinden op openacdb.database.windows.net en je logt in met SQL Server authenticatie, gebruiker Fenac. Aan te raden is de standaard database te veranderen naar de database waarvoor de koppeling opgezet wordt. Zet eventueel de taal van de berichten naar Nederlands. Op de testserver is voor alle databases in Azure een ODBC koppeling gedefinieerd. Koppeling "Azure" gebruikt database OpenAC3DB met adaptatie ac_nederland, koppeling "Azure AC Hoensbroek" gebruikt database ac_hoensbroek met adaptatie ac_hoensbroek en koppeling "testdata" gebruikt database testdata met adaptatie ac_hoensbroek, van die laatste zijn medewerkers geanonimiseerd.

Applicaties

Om OpenAC3 te kunnen draaien zijn een aantal applicaties op de server geïnstalleerd.

Essentieel zijn:

  • ​Git - om de code op te halen en bij te werken
  • ​Node.js - installeer de afhankelijkheden voor het compileren van C/C++ modules ook (o.a. Chocolatey), daar kan de OpenAC3 software ook mee gebouwd worden. Node.js installeert dan:
    • Python3 - deze heb je na installatie niet echt meer nodig omdat er ook OpenAC2 met python2 op de server staat. Sterker nog, het staat in de weg dus ik heb het uitgeschakeld.
    • Visual Studio Build Tools - wordt ook gebruikt om de C# code te bouwen
  • ​.NET Core SDK 3.1 - nodig voor de applicatie

Best belangrijk

Handig maar niet essentieel zijn:

OpenAC3 Configuratie

De configuratie bestanden van OpenAC3 staan in C:\ProgramData\OpenACWeb\. In appsettings.json is de database koppeling met Azure ingeregeld. Verschillende instellingen hebben fictieve waarden, zoals AGB code 12345678 die we aan Fenac toekennen. Waarden die er wel toe doen zijn Agb > AgbLocaties > Bestandsmap: C:\OpenACData\Documents en HTTPS > CertificateFile: C:\ProgramData\OpenACWeb\letsencrypt.pfx en HTTPS > CertificatePassword: ********. Notepad++ onthoudt welke bestanden open waren toen het afgesloten werd, je kan daar meestal gelijk de configuratie bestanden van OpenAC3 zien.

Let ook even op het bestand C:\ProgramData?\OpenACWeb\letsencrypt.pfx, dat is het https certificaat van ​https://openac3test.fenac.nl/ dat door de service gebruikt wordt en geconfigureerd staat in appsettings.json onder HTTPS. Dit bestand wordt elke maandag ververst met batch bestand C:\Users\OpenACBeheerder\Documents\letsencrypt.bat. Er is een geplande taak voor certbot om de basis certificaat bestanden bij te werken, maar die is uitgeschakeld en vervangen door de taak die het pfx bestand aanmaakt. Let op, daar staat een wachtwoord in. De certificaat bestanden van certbot staan in C:\Certbot\.

OpenAC2 Configuratie

Configuratie van OpenAC2 is zo dat de applicatie met de starterkit in C:\OpenAC2\ geïnstalleerd is, en het werkt met ODBC koppelingen naar de Azure databases die zijn ingericht. Er De versie is ingesteld op development. Je kan OpenAC2 dus gewoon draaien op de testserver. In de adaptaties is ac_nederland wat aangepast om er een algemeen AC van te maken met database koppeling "Azure". Die veranderingen zijn niet gecommit omdat ac_nederland aangemaakt is voor iets anders! Configuratie bestanden van OpenAC2 staan in C:\Users\OpenACBeheerder\AppData\Roaming\OpenAC\. Met het script reset-password van OpenAC2 kunnen medewerkers (en admin) een ander wachtwoord krijgen.