Public Sidnr
Uppgjord: Alexandra Trpkoska,
Nicklas Johansson 21 oktober 2003 Rev. 1.0 1(13)
Godkänd: Christina Hellmark Dok. nr. O001199
Snod FAQ
1 REVISIONSHISTORIK 2
2 INLEDNING 3
3 KORTFATTAD BESKRIVNING AV SNOD 4
4 FRÅGOR & SVAR 5
4.1 Generella frågor 5
4.2 Frågor om installation 8
4.2.1 Allmänt om installation 8
4.2.2 Installation på NT 9
4.2.3 Installation på Unix 9
4.3 Frågor om konfiguration 9
4.4 Frågor om Snod-tjänster 11
4.5 Frågor om utveckling 11
4.6 Driftrelaterade frågor 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
Public Sidnr
Uppgjord: Alexandra Trpkoska 21 oktober 2003 Rev. 1.0 2(13)
Godkänd: Christina Hellmark
Nicklas, Nicklas Johansson Dok. nr. O001199
1 Revisionshistorik
Version Datum Ändrad av Kommentar
0.1 2003-10-21 Alexandra Trpkoska Skapat första utkast
0.2 2004-01-29 Alexandra Trpkoska Ä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 2004-02-13 Alexandra Trpkoska Lagt till svaret på fråga 4.1
0.4 2004-05-26 Alexandra Trpkoska Nytt dokument skapat
0.5 2004-10-14 Olof Lindberg Uppdaterat med nya
URLer samt rättat småfel.
1.0 2004-10-19 Olof Lindberg Granskad och godkänd.
Public Sidnr
Uppgjord: Alexandra Trpkoska 21 oktober 2003 Rev. 1.0 3(13)
Godkänd: Christina Hellmark
Nicklas, Nicklas Johansson Dok. nr. O001199
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.
Public Sidnr
Uppgjord: Alexandra Trpkoska 21 oktober 2003 Rev. 1.0 4(13)
Godkänd: Christina Hellmark
Nicklas, Nicklas Johansson Dok. nr. O001199
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 Snod-
servern 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.
Public Sidnr
Uppgjord: Alexandra Trpkoska 21 oktober 2003 Rev. 1.0 5(13)
Godkänd: Christina Hellmark
Nicklas, Nicklas Johansson Dok. nr. O001199
4 Frågor & Svar
4.1 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 Snod-
anvä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
Public Sidnr
Uppgjord: Alexandra Trpkoska 21 oktober 2003 Rev. 1.0 6(13)
Godkänd: Christina Hellmark
Nicklas, Nicklas Johansson Dok. nr. O001199
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
Public Sidnr
Uppgjord: Alexandra Trpkoska 21 oktober 2003 Rev. 1.0 7(13)
Godkänd: Christina Hellmark
Nicklas, Nicklas Johansson Dok. nr. O001199
Klienter:
Klient Beskrivning
Ediput.exe Applikation för att hämta filer från en Snod-
server
Ediget.exe Applikation för att skicka filer till en Snod-
server
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.
Public Sidnr
Uppgjord: Alexandra Trpkoska 21 oktober 2003 Rev. 1.0 8(13)
Godkänd: Christina Hellmark
Nicklas, Nicklas Johansson Dok. nr. O001199
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 Beskrivning
Ediput.exe Kan skicka filer till en Snod-server
Ediget.exe Kan hämta filer från en Snod-server
Sft25.exe Kan skicka eller hämta filer från en Snod-
server
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 Frågor om installation
4.2.1 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 IP-
numret vid anrop till servern.
Public Sidnr
Uppgjord: Alexandra Trpkoska 21 oktober 2003 Rev. 1.0 9(13)
Godkänd: Christina Hellmark
Nicklas, Nicklas Johansson Dok. nr. O001199
- 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/sn25-
2.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.
Public Sidnr
Uppgjord: Alexandra Trpkoska 21 oktober 2003 Rev. 1.0 10(13)
Godkänd: Christina Hellmark
Nicklas, Nicklas Johansson Dok. nr. O001199
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 Unix-
servrar.
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
Public Sidnr
Uppgjord: Alexandra Trpkoska 21 oktober 2003 Rev. 1.0 11(13)
Godkänd: Christina Hellmark
Nicklas, Nicklas Johansson Dok. nr. O001199
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
Public Sidnr
Uppgjord: Alexandra Trpkoska 21 oktober 2003 Rev. 1.0 12(13)
Godkänd: Christina Hellmark
Nicklas, Nicklas Johansson Dok. nr. O001199
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
Public Sidnr
Uppgjord: Alexandra Trpkoska 21 oktober 2003 Rev. 1.0 13(13)
Godkänd: Christina Hellmark
Nicklas, Nicklas Johansson Dok. nr. O001199
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