Absentie Presentie Server Migratie
Auteur Versie Datum Status
A. Boerkamp V1.2 11-08-2010 Voor Intern / Extern gebruik
Pincash International, 3066GS Rotterdam, Anthonetta Kuijlstraat 43-45, 010-2868000
1
Inhoudsopgave Inhoudsopgave ............................................................................................................. 2 1. Inleiding..................................................................................................................... 3 2. APM systeem architectuur ....................................................................................... 4 3. Voorbereiding ........................................................................................................... 5 4. Installatie SQL Server ............................................................................................... 5 4.1 Database kopiëren ............................................................................................ 5 5. Web-Server setup ..................................................................................................... 6 5.1 IIS installeren en configureren................................................................................. 6 5.2 ODBC koppelingen maken...................................................................................... 6 5.3 Webserver licenties installeren................................................................................ 9 5.4 Webserver verbinding testen..................................................................................10 6. APM-Client setup .................................................................................................... 11
Pincash International, 3066GS Rotterdam, Anthonetta Kuijlstraat 43-45, 010-2868000
2
1. Inleiding Dit document beschrijft welke stappen te ondernemen bij de migratie van APM/TLM applicatieserver en/of SQL server naar een andere server, bijv. bij een upgrade van hardware of operating system. Als er ook sprake is van een koppeling met een leerling administratiesysteem, dan dient u contact op te nemen met Pincash. De server installatie voor Absentie Presentie Manager (APM) als TeLaat Manager (TLM) zijn gelijk. In het vervolg zullen we alleen de afkorting APM gebruiken. Dit document gaat uit van enige kennis wat betreft systeembeheer en SQL server database. Men moet in staat zijn zelf Windows, SQL Server en Internet Information Services te installeren. Bovendien moet men DSN kunnen aanmaken en met de SQL Server Manager databases kunnen detach'en en attach'en. Er wordt in dit document vanuit gegaan dat de nieuwe server op een andere machine geïnstalleerd wordt en dat APM door kan blijven draaien terwijl de nieuwe machine gereed gemaakt wordt. Als dit niet het geval is en de nieuwe installatie moet op dezelfde machine plaatsvinden, dan moet de backup als eerste gemaakt worden. In hoofstuk 2 wordt ter introductie kort uiteengezet hoe de systeemarchitectuur in elkaar steekt. In de hoofdstukken hierna worden de werkzaamheden beschreven voor de migratie naar een nieuwe server.
Pincash International, 3066GS Rotterdam, Anthonetta Kuijlstraat 43-45, 010-2868000
3
2. APM systeem architectuur WebService (IIS)
Client
ODBC
Schools.mdb (Access)
Client-Pc
Web-Server
SQLService (MSDE, SQL server)
PRS (SQL)
SQL-Server
Figuur 1.1 Systeem architectuur APM.
Zoals te zien in Fig 1. kan de totale APM structuur over drie fysieke omgevingen worden verdeeld. Deze verdeling is locatie onafhankelijk, wat inhoudt dat het ook mogelijk is om de gehele structuur op een PC te installeren. De SQL-server draait de SQL-service die de toegang tot de SQL database beheert. Deze SQL database bevat alle schoolgegevens, wat betekent dat o.a. alle leerling, docenten, scanner data, enz. hierin wordt opgeslagen. Communicatie tussen de APM-client en de schoolgegevens wordt afgehandeld door de Web-server/applicatieserver. In bijna alle gevallen draait hier de IIS (Internet Information Service) web-service, behorende bij Windows 2000/2003/XP. ASP (Active Server Pages) verzorgen op de webserver de uitwisseling van data, waarbij gebruikt wordt gemaakt van een tweetal ODBC-koppelingen. Naast de koppeling met de SQL-database, is er een koppeling met een Access-database waarin zich programma-afhankelijke data bevinden. Deze gegevens bestaan o.a. uit de SQL-databasenaam, encryptie-sleutel, enz. Op de client staat APM geïnstalleerd. Gegevens worden uitgewisseld met de Web-server via een beveiligde verbinding welke versleuteld is met de in schools.mdb (zie Fig 1.) te vinden sleutel.
Pincash International, 3066GS Rotterdam, Anthonetta Kuijlstraat 43-45, 010-2868000
4
3. Voorbereiding Voordat u met de daadwerkelijke overstap begint, doet u het volgende. 1. Maak een backup van de SQL-server database "PRSNaamVanSchool". Deze bestanden kunnen niet zonder meer gekopieerd worden, omdat ze in gebruik zijn door SQL Server. Met de 'Enterprise Manager' of 'SQL Server Management Studio' kan een backup gemaakt worden van de databases. Als u gebruikt maak van de MSDE of de Express versie van SQLServer, kunt u ook met behulp van de command-tool 'Osql' een backup maken (zie "http://support.microsoft.com/kb/325003" hoe dit te doen). 2. Pincash voorziet u van een download website waarop de benodigde server installatie componenten staan. 3. Op de oude server moet de directory 'C:\Presentie Manager\Webservice' gekopieerd worden naar de nieuwe server. Als deze directory niet bestaat, dan is deze te vinden door te kijken waarnaar de virtual directory 'inetpm' naar verwijst in de Internet Information Services (IIS). 4. Bovendien moet het bestand 'C:\Presentie Manager\schools.mdb' gekopieerd worden naar de nieuwe server. 5. Als u de pasfoto's ook op de oude server heeft staan, moet u ook deze directory naar de nieuwe server kopiëren.
4. Installatie SQL Server Installeer de gewenste versie van SQL Server (2000, 2005 of 2008) op de nieuwe machine. Zorg dat mixed authentication mode is toegestaan (SQL Server en Windows authentication). Als er geen SQL Server licentie beschikbaar is, dan kan gebruik gemaakt worden van de (gratis) SQL Server 2005 Express. De installatie is te vinden op de Microsoft website of op de download website. (Installeer ook de SQL Server Management Studio Express om SQL Server eenvoudiger te kunnen beheren). Maak een nieuwe login aan: Naam: pmonline Password: 1979101648175 Zet 'Enforce password policy' uit!
4.1
Database kopiëren
De beste manier om de APM databases over te zetten is de eerder gemaakte backup terug te zetten op de nieuwe server (restore). 1. Kopieer het backup bestand van de database die u eerder gemaakt heeft (zie hoofdstuk 3) naar de nieuwe server in een (tijdelijke) directory. 2. Open de 'Enterprise Manager' of 'SQL Server Management Studio' op de nieuwe server en doe een 'restore' van de backup van de oude server. 3. Repareer de koppeling tussen database server login en database user door de volgende query te draaien in de PRS database: "sp_change_users_login 'Auto_Fix', pmonline" Pincash International, 3066GS Rotterdam, Anthonetta Kuijlstraat 43-45, 010-2868000
5
5. Web-Server setup 5.1 IIS installeren en configureren 1. Installeer, indien nodig, IIS vanaf de Windows Installatie-CD door het toevoegen van de IIS (Internet Information Services) component. (Plaats de Windows installatie-CD in de server en kies voor het toevoegen van Windows componenten). 2. Creëer een map “Presentie Manager” op de webserver (indien webserver en databaseserver dezelfde computer is, is de map al aanwezig). Kopieer de inhoud van de deze map van de 'oude' server naar de zojuist gecreëerde map. 3. Ga via het Control Panel naar Administrative tools om IIS manager op te starten. Voeg nu een virtuele directory toe aan de Default Web site met de onderstaande specificaties.
Virtual directory wizard field name
Waarde
Alias Directory Allow the following
inetpm “C:\Presentie manager\Webservice” Read + Run scripts
Tabel 5.1 IIS virtual directory specificaties.
5. Als IIS 6 (Windows 2003) gebruikt wordt, moet in de IIS Manager, Webservice extensions de optie 'Allow for Active Server Pages' aangeklikt worden, zodat het runnen van ASP bestanden toegestaan wordt. In Windows Server 2003 64-bits versie moet IIS 6 in 32-bits modus draaien. Hiertoe moet ket volgende gedaan worden: 1. Open a command prompt and navigate to the "%systemdrive%\Inetpub\AdminScripts" directory. 2. Typ het volgende commando gevolgd door [Enter]: cscript.exe adsutil.vbs set W3SVC/AppPools/Enable32BitAppOnWin64 1
In Windows 2008 met IIS7 moet op de volgende punten gelet worden. 1. Zorg dat ASP geïnstalleerd is, dit is niet standaard. 2. Voeg een Application toe i.p.v. een virtual directory. 3. Geef de gebruiker IIS_IUSR Read/Write rechten in de Webservice directory. 4. Ga in IIS naar de Default Application pool, dan naar Advanced Settings en zet 'Enable 32 bit applications' = true en 'Load user profile' = false. Ga naar de Inetpm settings, dan naar ASP en zet 'Enable parent paths' = true.
5.2 ODBC koppelingen maken Op de Webserver moeten een tweetal ODBC koppelingen gemaakt worden. De eerste koppeling behelst een verbinding met een Access database, waarin o.a. de encriptionkeys staan. Een tweede koppeling bestaat uit de verbinding met de SQL-server. 1. Ga via Control Panel naar Administrative Tools om Data Manager (ODBC) op te starten. (In de 64bits versie van Windows 2003 moet de 32 bits ODBC data manager opgestart worden. Deze bevindt zich in c:windows\syswow64\odbcad32.exe)
Pincash International, 3066GS Rotterdam, Anthonetta Kuijlstraat 43-45, 010-2868000
6
2. Voeg onder system-DNS de schools.mdb database toe als datasource met de onderstaande specificaties (zie ook figuur 3.1). ODBC MS Access setup field name
Waarde
Driver Data source name Select Database
Microsoft Access driver (*.mdb) schools “..\Presentie manager\schools.mdb”
Tabel 5.2 ODBC specificaties behorende bij het toevoegen van schools.mdb.
Figuur 5.1 ODBC koppeling met MS Access “Schools.mdb” database.
3. Voeg onder system-DNS de SQL-Server toe als datasource met de onderstaande specificaties (zie ook figuur 5.2 t/m 5.5). ODBC MS SQL Server setup field name
Waarde
Driver Name Server
SQL Server PRSNaamVanSchool DNS naam SQL-server (of ip). Typ "(local)" als de web-service en SQL-service op dezelfde fysieke machine draaien. Als niet de default instancename gebruikt wordt, vul hier dan de volledige instancename in. With SQL server authentication ……. pmonline 1979101648175 Selecteer PRS-database (PRSNaamVanSchool) English (belangrijk)
Authenticity of the Login ID? Username Password Change default database to: Change the language of the SQL Server system messages to:
Tabel 5.3 ODBC specificaties behorende bij het toevoegen van de SQLServer instellingen.
Pincash International, 3066GS Rotterdam, Anthonetta Kuijlstraat 43-45, 010-2868000
7
Figuur 5.2 ODBC koppeling met SQLServer database.
Figuur 5.3 ODBC koppeling met SQLServer database.
Pincash International, 3066GS Rotterdam, Anthonetta Kuijlstraat 43-45, 010-2868000
8
Figuur 5.4 ODBC koppeling met SQLServer database.
Figuur 5.5 ODBC koppeling met SQLServer database.
5.3 Webserver licenties installeren 1. Kopieer de map “PRS” van de download website naar de C: root van de webserver (moet C: root zijn, en niet de root van een andere drive!).
Pincash International, 3066GS Rotterdam, Anthonetta Kuijlstraat 43-45, 010-2868000
9
2. Run inetPMLicenseServer.msi en inetPRSEncDec.msi van de APM-Installatie CD, welke te vinden zijn op de map “..\Licensing Server Setup” en “..\EncryptorDecryptor Setup”. Opmerkingen: - Uninstall van inetPMLicenseServer kan problemen opleveren, raadzaam om dit niet te doen. - inetPMLicenseServer geeft een foutmelding tijdens installatie, nl. dat msado15.dll niet geregistreerd kan worden. Deze fout kan genegeerd worden.
5.4 Webserver verbinding testen Om de Web-server en SQL-server installatie te testen kan nu de Internet Explorer op de Web-server worden geopend met het volgende adres: http://localhost/inetpm/challenge.asp. Het resultaat moet een string van karakters beginnend met OK zijn.
Pincash International, 3066GS Rotterdam, Anthonetta Kuijlstraat 43-45, 010-2868000
10
6. APM-Client setup Het enige dat op de clients aangepast moet worden is de naam of IP-nummer van de server. In het loginschermpje van de APM client applicatie bevindt zich een knop 'Instellingen'. Klik hierop en het instellingen scherm verschijnt met hierin de verbindingsgegevens met de server. In de vakken "Server URL:" en "Help directory:" moet de naam of IP-nummer van de oude server vervangen worden door die van de nieuwe server.
Pincash International, 3066GS Rotterdam, Anthonetta Kuijlstraat 43-45, 010-2868000
11