SYSTEMDOKUMENTATION KA-system Version 1.0

Sidan: 1 (17) SYSTEMDOKUMENTATION KA-system Version 1.0

Sidan: 2 (17) Innehåll 1 REVISIONSINFORMATION... 4 2 OM DETTA DOKUMENT... 5 3 SYSTEMÖVERSIKT... 6 3.1 Kort beskrivning av KA-systemet... 7 3.2 Kort beskrivning av modulerna... 7 3.2.1 Studentportal... 7 3.2.2 Personlig information... 7 3.2.3 Kursutbud... 7 3.2.4 Kursval... 7 3.2.5 Studentregistrering... 7 3.2.6 MTS, Människa Teknik Samhälle...7 3.2.7 Kurshemsidor... 7 3.3 Förvaltningsorganisation... 7 3.3.1 Systemägare... 8 3.3.2 Applikationsansvarig... 8 3.3.3 Modulansvariga i linjen... 8 3.3.4 Driftsleverantör... 8 3.3.5 Driftsansvarig... 8 4 UTVECKLINGSMILJÖ... 9 4.1 Oracle... 9 4.2 Zope... 9 5 DRIFTSMILJÖ... 10 5.1 Oracle... 10 5.2 Zope... 10 6 INSTALLATION... 11 6.1 Oracle... 11 6.1.1 Skapa tablespaces... 11 6.1.2 Skapa användaren LADOK... 11 6.1.3 Skapa KA-användarna... 11 6.2 Zope... 11 6.2.1 Installera använda produkter... 11 6.2.2 Installera KA... 11 6.3 Uppladdning av filer... 12 7 FLYTTNING... 13 7.1 Spara Oracle-data... 13 7.2 Zope... 13 7.3 Ominstallation... 13 8 START OCH STOPP... 14 9 BEHÖRIGHET... 15

Sidan: 3 (17) 10 FAQ... 16 10.1 Varför kommer jag (student) inte in i KA?... 16 10.2 Varför kommer jag (personal) inte in i KA?... 16 11 REFERENSER... 17

Sidan: 4 (17) 1 Revisionsinformation Utarbetat av Datum Utgåva Ändringar 01-12-19 0.1 Första utgåvan

Sidan: 5 (17) 2 Om detta dokument Denna systemdokumentation syftar till att ge en översikt över KA-systemet ge en översikt över hårdvara och mjukvara som behövs för att köra KA-systemet ge instruktioner för installation av KA-systemet. Information om KA-systemets funktioner och hur det används beskrivs i Användardokumentationen, vilken dels finns som hjälptexter i systemet, samt sammanfattad i referens 2. Information om utvecklingsmiljön och dokumentation om varje modul finns i Utvecklingshandboken, referens 3.

Sidan: 6 (17) 3 Systemöversikt Anonym användare Personal Teknologer Systemadministratör Endast se Se och, efter inloggning, röra KA-systemet version 1.0 Studentregistrering Kursutbud Studentportal Personlig information Kursval MTS Kurshemsidor Gemensamma funktioner Oracle Databas Underlag till uppdatering av Ladok Replikering från Ladok Ladok

Sidan: 7 (17) 3.1 Kort beskrivning av KA-systemet Systemet skall erbjuda en samlad ingång för studenternas studieinformation. För att uppnå detta finns en portal studenten kan logga in till, och därefter få tillgång till.. Den information som behövs hämtas dels från LADOK, dels från en egen databas som förses med information genom de administrationsgränssnitt som ingår i KA-systemet. 3.2 Kort beskrivning av modulerna 3.2.1 Studentportal Samlingsplats på nätet för Chalmers studieinformation samt KA-systemets moduler och funktionalitet. Här finns inloggningen till alla funktioner i KA. Portalens innehåll administreras med olika bilder. Det är t ex möjligt att förändra boxarnas innehåll och placering, lägga till HTML-sidor och länka till dessa, mm. 3.2.2 Personlig information Studenten kan se information om sina studieresultat på Chalmers. 3.2.3 Kursutbud Inmatning och presentation av kursinformation enligt European Credit Transfer System, ECTS, på nätet. (Informationen som tidigare publicerats i kurskatalog och kursplaner.) Informationen hålls på tre nivåer: arbetsmaterial gällande arkiverat 3.2.4 Kursval Studieadministratören kan skapa kursvalstillfällen, och lägga in information och kurser för dessa. Studenten gör sedan sitt kursval i systemet. 3.2.5 Studentregistrering Studenten kan göra sin terminsregistrering över nätet, och även ändra vilka kurser som skall registreras. Studievägledaren har möjlighet att godkänna eller avslå studenters tillval. 3.2.6 MTS, Människa Teknik Samhälle MTS-ansvariga har möjlighet att till största delen själva administrera de data som behövs för MTS-anmälan. Studenten kan se information om MTS-seminarierna samt göra val över nätet. 3.2.7 Kurshemsidor Samlingsplats för information och material relaterat kurstillfället. Studenterna kan göra anmälan till moment, indela sig i grupper samt ladda upp inlämningar.förvaltningsorganisation

Sidan: 8 (17) 3.3.1 Systemägare Ing-Britt Svensson, Utbildningsavdelningen. 3.3.2 Applikationsansvarig Gunn Wallius, Utbildningsavdelningen. 3.3.3 Modulansvariga i linjen Modul Ansvarig Avdelning Studentportal Pia Lundberg Utb Personlig information Stellan Englén Ladok Kursutbud Patrik Hellman Utb Kursval Johan Bankel M Studentregistrering Ingrid Sjöberg Utb MTS Lena Axelsson MTS Kurshemsidor Göran Stigler M 3.3.4 Driftsleverantör Görgen Olofsson, ITA. 3.3.5 Driftsansvarig Dario Lopez-Kästen, ITA.

Sidan: 9 (17) 4 Utvecklingsmiljö KA-systemet är byggt med applikationsservern Zope och databashanteraren Oracle. De programspråk som används är DTML, HTML och Javascript för presentation Python för script och större funktioner PL/SQL för script och funktioner som är tätt kopplade till databasen All data, inklusive texter och html-sidor som användarna skapar, lagras i Oracle-tabeller, och all programkod lagras i Zopes databas. 4.1 Oracle Utvecklingen har skett mot version 8.1.7. Inga specialfunktioner används, varför applikationen sannolikt fungerar mot version 8.1.6 eller högre. 4.2 Zope Utvecklingen har skett i Zope version 2.4.3, under Python 2.1. I nedanstående tabell listas de produkter och tillägg till Zope som används. Produkt Version Beskrivning Kommentar DCOracle2 Koppling till Oracle exuserfolder 0.9.0 Behörighetskontroll Patchad av Dario Formulator 1.0.1 Indatakontroll på fältnivå Patchad av Jens LocalFS Koppling till serverns filsystem Stripogram Tar bort otillåtna HTML-taggar ReplaceSupport 0.4.0 Sök och ersätt i Zope-objekt Ej nödvändig för drift TransparentFolders 0.3.2 Virtuella foldrar Ej nödvändig för drift

Sidan: 10 (17) 5 Driftsmiljö 5.1 Oracle Databasdelen av KA kan installeras på vilken maskin som helst som har Oracle 8.1.7 installerad, och har tillräckliga prestanda. Databasen måste vara åtkomlig från den maskin där Zopedelen av systemet installeras, och databasen måste komma åt LADOK-data. Ett maskinförslag är en Sun?????? Mhz processor??? MB internminne?? GB diskutrymme 5.2 Zope Zopedelen av KA installeras på vilken Zope-server som helst som har Zope, version 2.4.3, installerad. Utöver Zope måste maskinen komma åt den Oracle-databas, där KAs data ligger. Zope bör installeras på en kraftfull LINUX-maskin. Ett maskinförslag är en Intelbaserad PC 1,5 Ghz processor 512 MB internminne 1 GB diskutrymme I filsystemet på denna maskin sparas inlämningar av arbeten. Datamängderna kommer med tiden att bli stora, 50 100 GB, varför tillgänglighet till disk måste finnas.

Sidan: 11 (17) 6 Installation Alla filer som refereras i detta kapitel finns på CDn. 6.1 Oracle Nedanstående förutsätter att en lämplig Oracle-instans finns att installera i. 6.1.1 Skapa tablespaces I de script som skapar Oracle-användare nedan, sätts deras default tablespace, och det är också de namn som finns i importfilerna. Skapa därför följande tablespaces på lämpligt ställe: KA_TS KA_CHP_TS KA_CI_TS KA-systemet håller inga stora mängder data, så en initial storlek på 100 MB per tablespace borde räcka ett tag. Dock kan en frekvent användning av diskussionsforum göra att större utrymme krävs. 6.1.2 Skapa användaren LADOK Användaren LADOK är KA-systemets koppling till LADOK-data. Användaren har inga egna tabeller, utan tillhandahåller data via vyer mot lämplig den LADOK-replikering som satts i databaslänken LADOK.ITA.CHALMERS.SE Kör scriptet create_ladok_user.sql som användare SYSTEM. Importera hela filen ladok_user.dmp som användare SYSTEM. 6.1.3 Skapa KA-användarna KA-systemets data är uppdelat på flera scheman efter de moduler som finns i systemet. Kör scriptet create_ka_users.sql som användare SYSTEM. Importera hela filen (inklusive data) ka_users.dmp som användare SYSTEM. 6.2 Zope Nedanstående förutsätter att installationen av Zope har gjorts enligt instruktionerna i referens 1. 6.2.1 Installera använda produkter Packa upp SharedProducts.tar i /usr/local/zope/sharedproducts. 6.2.2 Installera KA Packa upp ka.tar i /usr/local/zope/home. Lägg in KA i /usr/local/zope/etc/instances. Raden bör se ut som följer: ka Zope-2.4.XX NNNN nomon nodebug rw där XX pekar ut den distribution som skall köras, och NNNN ersätts med den port som skall användas.

Sidan: 12 (17) 6.3 Uppladdning av filer Som en del av KA-systemet finns funktioner för att spara och hämta filer, t ex undervisningsmaterial och inlämningar. Dessa sparas i Zopeserverns filsystem. Datamängden kommer, om inlämning av arbeten sker via Kurhemsidorna, att bli stor. Hur stor är svårt att förutse, men 100 MB per kurs kan vara ett riktmärke, vilket ger 100 GB om 1000 kurser tar emot inlämningar på detta sätt. Om installationen skett enligt ovan är startpunkten för fillagringen /usr/local/zope/home/ka/var/lfs. Startpunkten kan ändras i Zopes utvecklingsgränssnitt, vilket bör göras innan systemet tas i bruk. Görs det senare måste de filer som finns i katalogen flyttas med!

Sidan: 13 (17) 7 Flyttning 7.1 Spara Oracle-data Skapa två dumpfiler som användaren SYSTEM. en som innehåller användaren LADOK, och en som innehåller användarna KA, KA_CHP, KA:CI, KA_CS, KA_MTS och KA_SR. 7.2 Zope Gör en tar-fil av ka-biblioteket vilket normalt ligger under /usr/local/zope/home. 7.3 Ominstallation Följ installationsanvisningarna i föregående kapitel, men använd de filer som just skapats.

Sidan: 14 (17) 8 Start och stopp KA startas och stoppas m h a kommandona zope_start respektive zope_stopp som finns i /usr/local/zope/bin. För att få rätt parametrar till startkommandot är det lämpligt att lista /usr/local/zope/etc/instances och kopiera KA-raden därifrån. KA kan också startas om inifrån. I Root-foldern finns Control_panel i vilken knappar för omstart och nedtagning finns.

Sidan: 15 (17) 9 Behörighet Behörighet till KA-systemet hanteras dels genom ett inloggningsförfarande som kontrollerar att användaren har ett DCE/Y500-konto, och dels i varje program som kontrollerar att användaren har den roll som krävs för just den funktionen. För att vara behörig måste konto och personnummer finnas inlagt i tabellen ka.acc_pnr, och rollerna i tabellen ka.acc_roles. Dessa kan uppdateras i formulär i KA-systemet. Då det gäller studenter behöver de bara finnas i ka.acc_pnr, rollerna sätts automatiskt utifrån LADOK-data. Grovt sett finns det tre behörighetsnivåer i KA administratör, som beroende på typ, tillhandahåller olika data, och kan hjälpa studenterna genom att de kan se studentens data, student, som får se sin egen data, och utföra vissa funktioner, samt ej inloggad, som endast får se viss data. I vissa moduler kontrolleras behörighet även på objektnivå, t ex att en studievägledare är behörig att godkänna kurser för studenter på ett visst program.

Sidan: 16 (17) 10 FAQ 10.1 Varför kommer jag (student) inte in i KA? Rätt konto? Rätt lösenord? Är användarnamn och personnummer är kopplade i tabell ka.acc_pnr? Detta kan kontrolleras och uppdateras i formulär Studentkonton under Organisation. 10.2 Varför kommer jag (personal) inte in i KA? Rätt konto? Rätt lösenord? Är upplagd i KAs organisationstabeller? Har fått rätt behörighet? Detta kan kontrolleras och uppdateras i formulär Personal under Organisation. 10.3 Nästa fråga

Sidan: 17 (17) 11 Referenser Ref. Dokumentnamn och dokumentbeteckning Utgåvenr Dokumentdatum 1 Installationsanvisningar för Zope på Chalmers Finns ej ännu 2 Användardokumentation KA P1.0 01-12-19 3 Utvecklingshandbok KA P1.0 01-12-19