| 9 | | De virtual machine heet OpenAC3 en is te benaderen in de [https://portal.azure.com/ 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 RDP (Bureaublad op afstand) verbinding opgezet worden, of doe dat gewoon met de applicatie op je computer door te verbinden met computer {{{51.124.172.104}}}, gebruiker {{{OpenACBeheerder}}}. |
| 10 | | De server heeft Windows Server 2012 R2 als besturingssysteem. |
| | 9 | De virtual machine heet `OpenAC3` en is te benaderen in de [https://portal.azure.com/ 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`. |
| | 10 | 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. |
| | 11 | |
| | 12 | == Azure Database == |
| | 13 | 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. |
| | 14 | === ODBC en Azure === |
| | 15 | 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. |
| 17 | | - [https://nodejs.org/en/download/ Node.js] - installeer de afhankelijkheden ook, dan kan de software gebouwd worden. Node.js installeert dan: |
| 18 | | - |
| | 22 | - [https://nodejs.org/en/download/ 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: |
| | 23 | - 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. |
| | 24 | - Visual Studio Build Tools - wordt ook gebruikt om de C# code te bouwen |
| | 25 | - [https://dotnet.microsoft.com/download/dotnet-core/3.1 .NET Core SDK 3.1] - nodig voor de applicatie |
| 27 | | 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: ********}}}. |
| | 35 | 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: ********`. |
| | 36 | Notepad++ onthoudt welke bestanden open waren toen het afgesloten werd, je kan daar meestal gelijk de configuratie bestanden van OpenAC3 zien. |
| | 37 | |
| | 38 | 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\. |
| | 39 | |
| | 40 | == OpenAC2 Configuratie == |
| | 41 | 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 |
| | 42 | 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! |
| | 43 | Configuratie bestanden van OpenAC2 staan in `C:\Users\OpenACBeheerder\AppData\Roaming\OpenAC\`. |
| | 44 | Met het script reset-password van OpenAC2 kunnen medewerkers (en admin) een ander wachtwoord krijgen. |
| | 45 | |
| | 46 | |
