Public Uppgjord: Alexandra Trpkoska, Nicklas Johansson Godkänd: Christina Hellmark 21 oktober 2003 Dok. nr. O001199 Rev. 1.0
Sidnr 1(13)
Snod FAQ
1 2 3 4 4.1 4.2 4.2.1 4.2.2 4.2.3 4.3 4.4 4.5 4.6
REVISIONSHISTORIK INLEDNING KORTFATTAD BESKRIVNING AV SNOD FRÅGOR & SVAR Generella frågor Frågor om installation Allmänt om installation Installation på NT Installation på Unix Frågor om konfiguration Frågor om Snod-tjänster Frågor om utveckling Driftrelaterade frågor
2 3 4 5 5 8 8 9 9 9 11 11 12
Teleca AU-System AB
Årstaängsvägen 19 B Box 47612 117 94 Stockholm Sverige Tel 08-726 75 00 Fax 08-19 33 22 www.teleca.se Styrelsens Säte Stockholm VAT SE556254 0673 01
Uppgjord: Alexandra Trpkoska Godkänd: Christina Hellmark Nicklas, Nicklas Johansson
21 oktober 2003 Dok. nr. O001199
Public Rev. 1.0
Sidnr 2(13)
1
Revisionshistorik
Version 0.1 0.2 Datum 2003-10-21 2004-01-29 Ändrad av Alexandra Trpkoska Alexandra Trpkoska Kommentar Skapat första utkast Ändrat kap 4.1(frågan om OS stöd), 4.2.1 (frågan om XP och Snod) samt 4.5 (frågan om svarstider) efter möte med kund. 0.3 0.4 0.5 2004-02-13 2004-05-26 2004-10-14 Alexandra Trpkoska Alexandra Trpkoska Olof Lindberg Lagt till svaret på fråga 4.1 Nytt dokument skapat Uppdaterat med nya URLer samt rättat småfel. 1.0 2004-10-19 Olof Lindberg Granskad och godkänd.
Uppgjord: Alexandra Trpkoska Godkänd: Christina Hellmark Nicklas, Nicklas Johansson
21 oktober 2003 Dok. nr. O001199
Public Rev. 1.0
Sidnr 3(13)
2
Inledning
Syftet med dokumentet är att få en förståelse för hur Snod fungerar och kunna få svar på de vanligaste frågorna kring Snod.
Uppgjord: Alexandra Trpkoska Godkänd: Christina Hellmark Nicklas, Nicklas Johansson
21 oktober 2003 Dok. nr. O001199
Public Rev. 1.0
Sidnr 4(13)
3
Kortfattad beskrivning av Snod
Snod har till uppgift att transportera data på ett säkert sätt (krypterat). Kortfattat kan man beskriva ett anrop på följande vis: En användare ger ett program information, som används för att anropa en Snodtjänst. Programmet använder sig av funktioner i sn25.dll för att kommunicera med Snod-servern. Sn25.dll kommunicerar med Snod-servern och skickar angivna parametrar. Snod-servern verifierar användarens namn och lösenord. Snod-servern kontrollerar sedan om användaren har rättighet till angiven tjänst. Snod-servern kan hantera tjänsten på två olika sätt, antingen hanterar Snodservern själv tjänsten och levererar ett svar, eller så skickas anropet vidare till en annan Snod-server som i sin tur hanterar anropet och levererar ett svar Svaret från Snod-servern kan programmet sedan presentera för användaren. Om ett fel uppstår hos klient eller server, har svaret ”alltid” ett Snodformat som innehåller felkod, intern felkod, svarslängd (bytes) och svaret (text) som programmet hanterar och sedan kan presentera för användaren.
Uppgjord: Alexandra Trpkoska Godkänd: Christina Hellmark Nicklas, Nicklas Johansson
21 oktober 2003 Dok. nr. O001199
Public Rev. 1.0
Sidnr 5(13)
4
4.1
Frågor & Svar
Generella frågor
Q: När behövs en Snod-server och när räcker det med en Snod-klient? A: Som oftast behöver man endast en Snod-klient, som sedan används för att kommunicera med en Snod-server. En Snod-server kan vara lämplig att sätta upp om man t ex vill utveckla en egen Snod-tjänst eller administrera sina lokala Snodanvändare. Då alla Snod-servrar i slutändan kommunicerar med servrarna som står hos Tieto Enator, kan en Snod-server lokalt resultera i marginellt längre svarstider. Q: Vi vill installera en Snod-server hos oss, vad ska vi göra? A: Följ beskrivningen nedan steg för steg. Kontakta SLL:s Snodförvaltning, se kontaktuppgifter på http://www.sll.se/snod Utav dem får du: Godkännande att installera en Snod-server Hjälp med att initiera kontakt för att hämta hem installationsprogram Hjälp med att få reda på vart du ska vända dig för att få användar-id, lösenord och annan information beroende på vilka tjänster som ska nyttjas. Meddela sedan SLL:s Snodförvaltning följande serveruppgifter: Ägare/organisation Fysisk placering av servern Namn på kontaktperson Telefonnummer E-postadress Operativsystem och version
Uppgjord: Alexandra Trpkoska Godkänd: Christina Hellmark Nicklas, Nicklas Johansson
21 oktober 2003 Dok. nr. O001199
Public Rev. 1.0
Sidnr 6(13)
DNS-namn Serverns användningsområde
Steg för steg när du vill ha en Snod-klient: DLL-erna för de olika Snod-klienterna finns tillgängliga på http://www.ls.sll.se/L_snod/125039.cs Där finns också en hel del dokumentation om Snod-servern och klientapplikationerna. Kontakta kontaktpersonen för den Snod-server som klienten ska gå emot för att få hjälp med de inställningar som behöver göras. http://www.ls.sll.se/docs/L_snod/snoddas/Kontaktpersoner_utan_DNS.doc Om behov finns för mer avancerad klientanvändarhjälp, utbildning och/eller installationshjälp av klienter, kan denna köpas av Snod-kunniga konsulter från exempelvis Bring, Teleca AU-System och Tieto Enator.
Q: På vilka operativsystem kan Snod köras? A: Idag finns support för följande operativsystem: SunOS 5.7, HP-UX 10.20, AIX 4.2, WindowsNT 4. Kontakta Snod-förvaltningen på SLL om du undrar om och/eller när stöd för ditt operativsystem kommer att införas. Q: Vad ingår i Snod? A: Server: Snod 2.5 Server Snod 2.5 Proxy Snod 2.5 Admin
Uppgjord: Alexandra Trpkoska Godkänd: Christina Hellmark Nicklas, Nicklas Johansson
21 oktober 2003 Dok. nr. O001199
Public Rev. 1.0
Sidnr 7(13)
Klienter: Klient Ediput.exe Beskrivning Applikation för att hämta filer från en Snodserver Ediget.exe Applikation för att skicka filer till en Snodserver Sft25.exe Applikation för att skicka/hämta filer från/till en Snod-server Snod25.exe Applikation för vanliga transaktioner med svar i textformat SnActiveX ActiveX-objekt för t.ex. VB-applikationer eller webb
Q: Vilka tjänster kan man köra med Snod? A: Det finns en mängd olika tjänster konfigurerade på olika Snodservrar. Man kan dela upp dessa tjänster i fyra (4) kategorier. 1. Anrop för information där man får ett svar i textformat t.ex. PKNOD. 2. Tjänster som tillåter användare att skicka filer till Snod-servern. t.ex. ARV. 3. Tjänster som tillåter användare att hämta filer från en Snod-server. t.ex. ARVGET. 4. Tjänster som utför ett arbete på Snod-servern. Alla dessa typer av anrop ger också oftast ett svar tillbaka i textformat.
Uppgjord: Alexandra Trpkoska Godkänd: Christina Hellmark Nicklas, Nicklas Johansson
21 oktober 2003 Dok. nr. O001199
Public Rev. 1.0
Sidnr 8(13)
Q: Vilken klientapplikation ska jag använda? A: Valet av klientapplikation beror främst på vilken typ av tjänst man vill använda. Klientapplikation Ediput.exe Ediget.exe Sft25.exe Beskrivning Kan skicka filer till en Snod-server Kan hämta filer från en Snod-server Kan skicka eller hämta filer från en Snodserver Snod25.exe Anropar tjänster som endast returnerar ett svar i textformat
Q: Vad är det för skillnad mellan de olika Snodklienterna? A: Skillnaden mellan Snodklienterna är användningsområdet. Se frågan ovan för klient respektive användningsområde.
4.2
4.2.1
Frågor om installation
Allmänt om installation
Q: Vart kan jag läsa om Snod-server respektive Snod-klienter? A: All dokumentation så som server-arkitektur, beskrivning av moduler,installationsanvisningar mm hittas på http://www.sll.se/snod Q: Vi har uppgraderat till Windows XP och nu fungerar inte vår klient. Vad kan det bero på? A: Snod-server är inte utvecklad eller testad för Windows XP. För Snod-klienterna finns däremot två alternativ man kan pröva. Istället för att ange DNS namnet när man anropar servern, ange IPnumret vid anrop till servern.
Uppgjord: Alexandra Trpkoska Godkänd: Christina Hellmark Nicklas, Nicklas Johansson
21 oktober 2003 Dok. nr. O001199
Public Rev. 1.0
Sidnr 9(13)
-
Uppdatera Snod-klienten med följande filer: Sn25.dll (2.5.5.4), libeay32.dll (openssl-0.9.3a) och ssleay32.dll (openssl-0.9.3a). Du hittar filerna på http://www.sll.se/docs/L_snod/download/sn252.5.5.4_openssl-093a.zip
Om problemet kvarstår, kontakta i första hand din driftansvarig.
4.2.2
Installation på NT
Se dokumentation : Snod 2.5 Installation ODBC http://www.sll.se/L_snod/106597.cs?dirid=106600&diridtop= Installation Snod 2.5 Server http://www.ls.sll.se/L_snod/106590.cs?dirid=106592&diridtop=
4.2.3
Installation på Unix
Se dokumentation : Installation av Snod 2.5 Server på Unix. http://www.sll.se/L_snod/106593.cs?dirid=106596&diridtop=
4.3
Frågor om konfiguration
Q: Hur ska jag konfigurera min databas? A: Se dokumentation MySql användaradministration http://www.ls.sll.se/L_snod/106602.cs?dirid=106641&diridtop= Snod 2.5 Admin Installation och manual http://www.ls.sll.se/docs/L_snod/verktyg/Snod%202_5%20Admin.doc Admin för Unix http://www.ls.sll.se/docs/L_snod/verktyg/Snod%202_5%20Admin_Unix.pdf Om din databas är annan än MySql, rekommenderas att läsa dokumentation för aktuell databas.
Uppgjord: Alexandra Trpkoska Godkänd: Christina Hellmark Nicklas, Nicklas Johansson
21 oktober 2003 Dok. nr. O001199
Public Rev. 1.0
Sidnr 10(13)
Q: Hur ska jag konfigurera min Snod-server? A: Se dokumentation : Snod 2.5 Admin Installation och manual. http://www.ls.sll.se/docs/L_snod/verktyg/Snod%202_5%20Admin.doc Konfiguration av SNOD 2.5 Server i konfigurationsfilen httpd.conf http://cvsext.ausys.se/snod/doc/server/konfig/konfig_server.htm Q: Vi ska konfigurera vår Snod-server för backup, finns det några bra tips/förhållningsregler? A: Se dokumentation: http://www.ls.sll.se/docs/L_snod/verktyg/Snod%202_5%20Admin_Unix.pdf Se avsnitt Beskrivning av Backup / Restore. OBS! Beskrivningen av backup/restore är skriven för Snod-administratörer av Unixservrar. Q: Jag behöver hjälp med att konfigurera MySQL. Finns det någon dokumentation som beskriver hur man ska göra? A: Se dokumentation: MySql användaradministration http://www.ls.sll.se/L_snod/113345.cs Snod 2.5 Admin Installation och manual http://www.ls.sll.se/docs/L_snod/verktyg/Snod%202_5%20Admin.doc Admin för Unix http://www.ls.sll.se/docs/L_snod/verktyg/Snod 2_5 Admin_Unix.pdf
Uppgjord: Alexandra Trpkoska Godkänd: Christina Hellmark Nicklas, Nicklas Johansson
21 oktober 2003 Dok. nr. O001199
Public Rev. 1.0
Sidnr 11(13)
4.4
Frågor om Snod-tjänster
Q: Jag vill börja köra PKNOD. Hur gör jag? A: Kontakta Eva-Britt Larsson på Landstingskontoret. e-post: eva-britt.larsson@sll.se Telefon: 08-737 25 00 Q: Vad är det för skillnad mellan PU och PKNOD? A: PU står för PersonUppgiftssystemet och är en stordator som driftas av Tieto Enator. PKNOD är en Snod-tjänst som kommunicerar med PU för att hämta till personuppgifter. Q: Hur ska jag sätta upp mina tjänster? A: Se svaren under konfiguration.
4.5
Frågor om utveckling
Q: Vi har i uppdrag att utveckla en applikation som ska integreras och/eller kommunicera med en Snod-server. Var kan vi hitta API:er eller annan systemdokumentation av nytta? A: Vi rekommenderar att följande följande dokument läses igenom: Snod 2.5 Server arkitektur http://www.ls.sll.se/L_snod/100799.cs?dirid=100809&diridtop= Snod 2.5 Moduler http://www.ls.sll.se/L_snod/100811.cs?dirid=100813&diridtop= Skapa Snod modul med WindowsNT/95/98 till en Snod server http://www.ls.sll.se/L_snod/125027.cs Snod 2.5 API Beskrivning http://www.ls.sll.se/L_snod/125247.cs
Uppgjord: Alexandra Trpkoska Godkänd: Christina Hellmark Nicklas, Nicklas Johansson
21 oktober 2003 Dok. nr. O001199
Public Rev. 1.0
Sidnr 12(13)
Snod 2.5 Client API http://www.ls.sll.se/L_snod/125242.cs
Snod SnActiveX 2.5 http://www.ls.sll.se/L_snod/124987.cs
4.6
Driftrelaterade frågor
Q: När vi kör Snod får vi ett felmeddelande, vad betyder det? A: Felkoder och felmeddelanden för Snod hittar du i dokumentet "Felkoder Snod2.5". http://www.ls.sll.se/L_snod/113311.cs Ta gärna hjälp av din driftansvarig. Vanliga fel kan vara : -33 Behörighet saknas. Användare finns inte upplagd eller felaktigt lösenord. -7007 Kan inte komma åt servern. Kan bero på internt/externt nätverksproblem eller att servern inte är igång. Q: Vi har problem med PU-uppslag för personnummer ÅÅÅÅMMDDXXXX. Vi får bara ett "tomt" svar tillbaka. Vad är det för fel? Hur ska vi tolka svaret? A: Svaret tillbaka är en tom sträng i ett s k PKNOD-format. Tecken 5 t o m tecken 8 är svaret från stordatorn. För att se vad de olika felkoderna från Snod-servern betyder gå till http://www.ls.sll.se/L_snod/113311.cs Exempel : I detta exempel kan man utläsa felkod 0020 (tecken 5 t o m 8) som betyder: Fel format på personnummer. -----------------------------------------------------------0 0 704
Uppgjord: Alexandra Trpkoska Godkänd: Christina Hellmark Nicklas, Nicklas Johansson
21 oktober 2003 Dok. nr. O001199
Public Rev. 1.0
Sidnr 13(13)
07040020 -----------------------------------------------------------För att få veta mer om svaret som returneras, eller för mer information kring PU, kontakta Tieto Enator. Tfn: 020-99 66 00 E-postadress: dos@tietoenator.com