Instruktioner för uppkoppling mot NyA Open

Magnus Björklund 2014-10-09 Sida 1 (16) Instruktioner för uppkoppling mot NyA Open

... 3... 4 Dokumentnummer Version Företag Magnus Björklund 2014-10-09 Sida 2 (16) Innehållsförteckning 1 Inledning... 3 1.1 Syfte 1.2 Versionshistorik... 3 2 4 Systemkrav... 3 Installation av programvaror... 4 3.1 Inledning... 4 3.2 Stunnel 3.2.1 Ladda hem... 4 3.2.2 Installera... 5 3.2.3 Inställningar... 5 3.2.4 Stunnel som en tjänst som körs i bakgrunden... 6 3.3 DB2 Runtime client... 6 3.3.1 Ladda hem... 6 3.3.2 Installera... 7 3.4 Databasdokumentation... 8 3.5 Squirrel SQL... 9 3.5.1 Inledning... 9 3.5.2 Ladda hem... 9 3.5.3 Installera... 9 3.5.4 Inställningar... 10 3.5.4.1 IBM DB2 Net Driver... 11 3.5.4.2 NYA... 14 3.5.4.3 STUDERA... 15 3.5.5 Starta en uppkoppling mot databasen... 16

Magnus Björklund 2014-10-09 Sida 3 (16) 1 Inledning 1.1 Syfte Syfte med detta dokument är att beskriva installation av och inställningar för den programvara som krävs för NyA Open. Inom ramen för NyA Open kan man koppla upp sig till två databaser. Dessa heter nya och studera. Dokumentet vänder sig till användare och systemadministratörer. 1.2 Versionshistorik Versioner Författare Kommentar 0.1 2006-05-22 Rickard Lönneborg Första version 0.2 2006-06-08 Per Hörnblad Mindre justeringar. 0.3 2005-10-12 Per Hörnblad/ Rickard Uppdateringar efter Lönneborg kommentarer 0.4 2006-06-26 Sabine Brännström Uppdatering av länkar för TestB 0.5 2006-07-17 Sabine Brännström Länkar för produktionsmiljö 0.6 2006-12-19 Sabine Brännström Länkar för TestA 0.7 2011-06-21 Mikael Lindmark Uppdaterar till Windows 7. Ändrat sökväg för installationsprogram.

Magnus Björklund 2014-10-09 Sida 4 (16) 2 Systemkrav Dessa instruktioner riktar sig i första hand till användare av Microsoft Windows 7 men fungerar även för Windows XP. Används annat operativsystem krävs andra versioner av programmen. OBS! För att kunna installera all programmen krävs Administratörsrättigheter på datorn. 3 Installation av programvaror 3.1 Inledning För att komma åt NyA Open krävs en SSL-krypterad uppkoppling och DB2-drivrutiner. Förutom detta bör man använda ett databasverktyg. Installationsinstruktioner följer för dessa program; SSL DB2-drivrutiner Databasverktyg Stunnel DB2 Runtime client Lite Squirrel SQL eller MS Access/Excel 3.2 Stunnel Stunnel används för att skapa en krypterad uppkoppling (SSL) mot NyA Open. 3.2.1 Ladda hem Ladda hem installationsprogrammet för stunnel från denna adress: https://www.antagning.se/nyaopen/nyaopen.html (klicka på stunnel-x.x-installer.exe) Välj kör

Magnus Björklund 2014-10-09 Sida 5 (16) 3.2.2 Installera För att kunna installera programmet krävs att man har administratörsrättigheter. Välj I agree, sedan Next > och Install, tills du kommer till denna: Välj Close 3.2.3 Inställningar Dessa inställningar skapar en tunnel på port 10000 till NyA Open-databasen.

Magnus Björklund 2014-10-09 Sida 6 (16) Starta utforskaren och redigera "C:\Program Files (x86)\stunnel\stunnel.conf enligt nedan: Ersätt det som står i filen med följande: ; NyA Open start [db2] accept = 10000 connect = nyaopen.antagning.se:2345 verify = 0 client = yes ; NyA Open end Välj Arkiv, Spara och stäng fönstret. 3.2.4 Stunnel som en tjänst som körs i bakgrunden En service är ett program som är skrivet enkom att ligga och köra i bakgrunden. För att skapa en stunnel tjänst så välj: Start, Alla Program, Stunnel, högerklicka på Service install och välj Kör som administratör (görs bara en gång) För att starta tjänsten: Start, Alla Program, Stunnel, högerklicka på Service start och välj Kör som administratör 3.3 DB2 Runtime client DB2 runtime client krävs för att kommunicera med db2-databasen. 3.3.1 Ladda hem DB2 Runtime client finns att ladda hem här: https://www.antagning.se/nyaopen/nyaopen.html Välj DB2 Run-time Client Windows 32 eller 64 bitar. För att ta reda på vilken version en Windows 7 välj: Start, högerklicka på Dator och välj egenskaper. Se raden Systemtyp. Spara filen som du hämtade på skrivbordet eller ett annat ställe där du kan städa bort den senare. OBS! Ifall du redan har en gammal version som du tänker uppgradera bör du avinstallera den gamla versionen först. Klicka på den nedsparade filen för att påbörja installationen

Magnus Björklund 2014-10-09 Sida 7 (16) 3.3.2 Installera Välj Next, I accept the terms, Next, Custom så det ser ut som nedan: Välj Next Välj Install, så att installationen slutförs. Avsluta med Finish.

Magnus Björklund 2014-10-09 Sida 8 (16) 3.4 Databasdokumentation Databasdokumentationen finns tillgänglig på följande adress; https://www.antagning.se/nyaopen/nya/ Tabeller indelade i kategorier finns under Diagram, NyA, NyA Standard. 3.5 Squirrel SQL 3.5.1 Inledning Squirrel SQL är det databasverktyg som rekommenderas för att skriva SQL mot NyA Open, men det kan även fungera med andra verktyg. Detta program kräver Java vilket detta dokument förutsätter redan är installerat i datorn. 3.5.2 Ladda hem Hämta Squirrel SQL från denna adress: https://www.antagning.se/nyaopen/nyaopen.html Välj squirrel-sql-3.2.1-install.jar. Spara filen t.ex. på skrivbordet. 3.5.3 Installera Välj Start och klicka i Tillbehör Högerklicka på Kommandotolken och välj Kör som Administratör. Gå till katalogen där du sparade filen och skriv: "C:\Program Files (x86)\java\jre6\bin\java" -jar squirrel-sql- 3.2.1-install.jar

Magnus Björklund 2014-10-09 Sida 9 (16) Ifall det bara blinkar till, och inget annat händer, kör i kommandotolken echo %path% och verifiera att C:\PROGRA~2\Java\jre6\bin finns med i sökvägen. Välj Next, Next, Nect, OK, Next, Next, Next, och Yes tills installationen är klar och du ser detta fönster

Magnus Björklund 2014-10-09 Sida 10 (16) Välj Done. Nu är Squirrel SQL installerad. 3.5.4 Inställningar Starta Squirrel SQL; Start, Alla Program, SQuirreL SQL Client, SQuirreL SQL Client

Magnus Björklund 2014-10-09 Sida 11 (16) 3.5.4.1 IBM DB2 Net Driver Välj meny Windows, view Drivers. I listan högerklicka på IBM DB2 Net Driver och välj Modify Driver

Magnus Björklund 2014-10-09 Sida 12 (16) Klicka på fliken Extra Class Path och sedan på knappen Add. Markera C:\Program Files\IBM\SQLLIB\java\db2jcc.jar. Klicka på open.

Magnus Björklund 2014-10-09 Sida 13 (16) Klicka på List Drivers och i Class Name välj com.ibm.db2.jcc.db2driver ur listan (kontrollera att det står rätt). Klicka OK. Det ska nu vara en blå bock framför IBM DB2 Net Driver i listan.

Magnus Björklund 2014-10-09 Sida 14 (16) 3.4.5.2 NYA Välj fliken Aliases och sedan i huvudmenyn alternativet Aliases, New Alias Fyll i NYA som namn, välj Driver IBM DB2 Net Driver, skriv jdbc:db2://localhost:10000/nya i URL-fältet samt ange användarnamn och lösenord. Tryck OK

Magnus Björklund 2014-10-09 Sida 15 (16) 3.4.5.3 STUDERA Välj I huvudmenyn alternativet Aliases, New Alias Fyll i NYA som namn, välj Driver IBM DB2 Net Driver, skriv jdbc:db2://localhost:10000/nya i URL-fältet samt ange användarnamn och lösenord. Tryck OK

Magnus Björklund 2014-10-09 Sida 16 (16) 3.5 Starta en uppkoppling mot databasen Dubbelklicka på NYA och välj Connect för att starta en uppkoppling mot databasen. Nu ska du kunna skriva SQL i det fönster du får upp (under fliken SQL):