Denne siden beskriver driftsmiljøet for FS på Trofast. FS står for Felles Studentsystem, det utvikles av USIT og brukes av alle universiteter og de fleste høgskoler i Norge. De fleste av disse får driftet FS gjennom Trofast.
Trofast-gruppa sitt driftsansvar er terminalservere med FS-klienter (WI) og databaser (DBA). Supporthenvendelser om brukerstøtte skal rettes til fs-brukerstotte
Innhold
1 Servere
FS har bare en type Windows-servere; terminalservere med Citrix. Vi har 7 servere i produksjon (fs-ts11.trofast.uio.no - fs-ts17.trofast.uio.no) og 1 server til test/demo/kursbruk (fs-test2.trofast.uio.no). fs-test2.trofast.uio.no er en fysisk server, men kan med fordel virtualiseres ved anledning.
Merk at testmiljøet er ikke et ekte testmiljø, menet miljø hvor skolene kan teste nye versjoner som vi legger opp. Testmiljøet brukes også til kurs, så hvis det er mange innlogget kan det hende at det er et kurs på gang og da kan man ikke røre det. Det er altså et miljø som må anses for å være i produksjon og kan ikke tas ned uten videre, selv om det er mindre krise enn med prodmiljøet.
FS kan startes på to måter fra Fasportalen; enten som en sømløs applikasjon ("FS direkte" i Fasportalen, "FS" i Citrix) eller som en skrivebordsapplikasjon ("FS skrivebord" i Fasportalen, "FS desktop full" i Citrix). Det samme gjelder for FS på fs-test2 (hhv "FS demo direkte"/"FS demo" og "FS demo skrivebord"/"FS demo desktop full").
Det at Citrix-applikasjonene har forskjellige navn i Citrix og Fasportalen har historiske grunner. Dette bør ikke endres, det kan hende Fasportalen ikke takler det.
I tillegg til Windows-serverne har hver skole en FS-database. Disse databasene kjøres som VPD (Virtual Private Database). Databasene kjører på Trofasts egne databaseservere som driftes av BSD og DBA.
2 Programvarekomponenter
Programvaren på en FS-terminalserver består av en FS-klientinstallasjon for hver skole pluss en del støttekomponenter. FS-klientene kopieres inn og oppdateres hver natt, støttekomponentene installeres under oppsett av serveren. Klienten til hver skole ligger i C:\adb\fs<skoleforkortelse>.
Støttekomponentene for FS er:
- Oracle-databaseklient (32-bits)
- Microsoft Office 2007
- Adobe Reader
- Adobe Flash
- Ghostscript (for PDF-generering)
- Under serverinstallasjonen installeres Ghostscript som normalt, og deretter kjøres en automatisert ved hjelp av AutoIt som setter opp en ny skriver med Ghostscript PDF-driver for alle brukere.
3 Distribusjon
FS-klienter distribueres hver natt til terminalserverne ved hjelp av scriptene under.
- \\usitadmin\Scripts\Dist\FS\dist_fs.cmd
- \\usitadmin\Scripts\Dist\FS\dist_fs_demo.cmd
Hvilke maskiner som filene skal kopieres til er spesifisert i FSProdmaskiner.txt og FSDemomaskiner.txt, som ligger i samme mappe.
Distribueringsjobbene kjører på admin-prod1.trofast.uio.no og heter FS_nightly_dist og FS_demo_nightly_dist. Klientfilene hentes fra \\usitadmin\fs\Klienter\.
4 Versjonsoversikt
Disse sidene viser en matrise over hvilken versjon av hver skoles FS-klient som ligger ute på hver enkelt terminalserver:
- http://admin-prod1.trofast.uio.no/fsoversikt.html
- http://admin-prod1.trofast.uio.no/fsoversikt_demo.html
5 Legge ut ny klientversjon for en skole (må oppdateres av torbenhr)
5.1 Hvordan legge opp ny klient i test?
- RDP til testmaskin (fs-test1 og fs-test2)
- For å kopiere den nye versjonen:
- Bruk \\velociraptor.trofast.uio.no\fileshute til å kopiere over zip-fila til c:\temp.
- Pakk ut filene til c:\adb\fsdist (på anis)
NB! VIKTIG! Sjekk at det ikke ligger fs.ini der. (Fs.ini skal være ulik for hver skole.) VIKTIG!
Før kopiering av klient, sjekk om det er brukere på systemet (tsadmin). Hvis det er mange brukere er det sikkert kurs. Hvis det bare er noen, si fra at du skal legge opp en ny version. Gi de litt tid til å lukke. (5 min)
Source som distes ut ligger på \\USITADMIN\fs\Demoklienter\%skole%demo
Legg nyeste fsklientmappe i katalog \\USITADMIN\fs\kildedemo\, rediger så versjonsvariabel i \\usitadmin\Scripts\Dist\FS\demo\publiser.bat, kjør så scripet publiser.bat, - source-området over vil bli kopiert ut av nattlig task (\\usitadmin\Scripts\Dist\FS\distfs_demo.cmd)
5.2 Hvordan legge opp ny klient i prod?
- Legg versjon i \\USITADMIN\fs\Klienter\fsdist\
- Kjør \\usitadmin\Scripts\Dist\FS\cpfsdistto_skole\bat\%skole%.bat. (Den kopierer filer fra \\USITADMIN\fs\Klienter\fsdist\ til \\USITADMIN\fs\Klienter\fs%skole%\ for så å rename fs.exe og fssystem.exe til fs%skole%.exe og fs%skole%system.exe.)
Nattlig dist fra \\USITADMIN\fs\Klienter\fsdist\ går nattlig kl 0400 som scheduled task på admin-prod1.
5.3 Feilkilder
- Source er nede (hmm er clustret)
- Target er nede (sikres ved sjekk)
- Target har lås på fil (sikres ved boot av tjener)
6 Opprette ny FS-skole (må oppdateres av torbenhr)
Sørg for at OU og superbrukere for skolen er opprettet iht. AD-dok-en (LINK)
6.1 I testfasen
(Dette varsler FS-koordinator om når må gjøres)
- Oppdater tnsnames.ora på \\USITADMIN\GenericDist\Oracle-config\tnsnames.ora til å inkludere demobasen til skolen (se egen doc (LINK) for å finne ut hvordan man finner TNS-oppslagene i UiOs autoritative fil).
- På testserver:
- Opprett en katalog c:\adb\<skolenavn>demo med siste fs-versjon. OBS! Det er viktig å bruke OU-navnet fra AD, ettersom start av FS scriptes med en skole-variabel som settes i forhold til dette. Tidvis heter databasene kortere varianter pga. standarder i Oracle, men på Windows-siden er det AD som må gjelde.
- Skriv om fs.ini til å passe til skolen (bytt alle skolenavn til riktig skole).
- Kopier ny tnsnames.ora til :\Oracle\product\11.2.0\client_1\network\admin\.
- Sjekk at man får tnspinget basen fra host, og hvis ikke be oracle-drift om å åpne tilgang.
- Oppdater FS-kolonnen i oversikten over trofast-partnere (LINK) med at skolen er i demo.
6.2 Når skolen skal over i prod
(Dette varsler FS-koordinator om når må gjøres)
- Oppdater tnsnames.ora på \\USITADMIN\GenericDist\Oracle-config\tnsnames.ora til å inkludere prodbasen til skolen (se egen doc (LINK) for å finne ut hvordan man finner TNS-oppslagene i UiOs autoritative fil).
- På \\USITADMIN\fs\Klienter\:
- Opprett en katalog fs<skole> (UO-navn).
- I katalogen d:\fs\script for sær lokal disting, kopier et eksisterende script og erstatt alle - kopier fs.ini fra en av de andre katalogene og tilpass den ved å erstatte det skolenavnet som finnes der fra før med det nye (alle instanser).
- Oppdater \\USITADMIN\Scripts\Dist\FS\FSProdmaskiner.txt med skolenavn, katalogene vil komme ut til terminalserverene til natten.
- Sjekk om man får tnspinget basen fra prodserverne, og hvis ikke be oracle-drift om å åpne for alle prodserverene i sqlnet.ora til den aktuelle basen.
- Oppdatere FS-kolonnen i oversiken over trofast-partnere (LINK) med at skolen er i prod.
7 Installasjon av nye servere
Serverinstallasjon gjøres ved hjelp av PXE-opplegget på Trofast:
- For å installere en ny terminalserver velger man "Trofast FS-terminalserver med Xenapp 5".
- Til slutt må man utføre punktene som står under "Endringer som ikke er lagt inn her enda:" øverst i applications.xml-fila. Dette er operasjoner som det enten ikke har vært tid til å få inn i den automatiserte installasjonen, eller som man enda ikke har fått til å automatisere.