FTP-guide FTP-guide Import og eksport af Engrosdata 27. marts 2015 XSTJ Projekt Version Dato Forfatter FTP-guide 0.9 2014-11-30 XSTJ Dok. 13/100808-11 Side 1 af 13
Indhold 1. Indledning... 3 1.1 Forord... 3 1.2 Læsevejledning... 3 2. Filoverførsel... 4 2.1 Brugeroplysninger... 4 2.2 IP-adresse oplysninger... 4 2.3 Konfigurering af Firewall... 4 2.4 Download af FTP-klient... 4 2.5 Opsætning af FTP... 5 2.6 Åben et websted... 8 2.7 Mappe med overførsler... 10 2.8 Indsendelse af data... 11 2.9 Hentning af data... 12 2.10 Timeout i FileZilla... 13 Dok. 13/100808-11 Side 2 af 13
FTP-guide 1. Indledning 1.1 Forord Dette dokument indeholder nødvendige informationer til at kunne udveksle Engrosmodel migreringsfiler via FTP. Dokumentet indeholder primært en vejledning til, hvordan FTP bruges som platform til udveksling af migreringsdata. For yderligere informationer om filnavne, folderstrukturer og brugerhåndtering henvises til dokumenterne Migreringsguide og Migreringsformater. Primært henvender dokumentet sig til aktører, der skal migrere pris- og stamdata i mængder, som ikke kan opdateres via markedsportalen. Dette dokument er et af flere som beskriver hele migreringsprocessen, der skal understøtte implementeringen af Engrosmodellen. Følgende dokumenter er pt. planlagt til at understøtte aktøren under migreringen: Migreringsguide (hoveddokument) Migreringsformater FTP-guide Testcases Spørgsmål og svar 1.2 Læsevejledning Generelt er dokumentet relevant for både netvirksomheder og elleverandører der skal indsende eller modtage engrosdata i migreringsfasen. Dokumentet henvender sig til it-kyndige personer, der står for filudvekslingen af migreringsdata op til cut-over, samt for filudvekslingen umiddelbart efter cut-over. Bemærk: Netvirksomheder kan indsende og modtage migreringsfiler. Elleverandører kan kun modtage migreringsfiler. Kapitel 2. indeholder vejledning til brug af FTP til udveksling af data. Tip! Dokumentet anvender denne boks, hvis information ønskes specielt fremhævet. Tippet kan indeholde informationer som er essentielle for den givne kontekst eller som kan gøre det lettere at håndtere migreringsprocessen. Vigtigt! Dokumentet anvender denne boks, hvis et vigtigt udsagn ønskes fremhævet. Denne boks benyttes specielt i situationer, hvor utilsigtede hændelser kan fremprovokere migreringsfejl. Dok. 13/100808-11 Side 3 af 13
2. Filoverførsel Filerne skal overføres via FTP til Migreringssystemet. I de følgende eksempler er processen valgt beskrevet via brug af værktøjet FileZilla. Bemærk, at andre FTP programmer som fx almindelige kommando linje FTP-programmer, samt klient eller browser extension baserede programmer som WinSCP, FireFTP mm. også kan anvendes. 2.1 Brugeroplysninger Alle aktører, der skal indsende eller modtage migreringsfiler, vil modtage brugernavn og password direkte fra Energinet.dk, inden migreringssystemet åbnes for ekstern adgang. Der vil være mulighed for at have mere end et brugernavn pr. organisation. 2.2 IP-adresse oplysninger For at kunne tilgå FTP-serveren skal aktøren have sin udgående IP-adresse registreret på en whitelist (godkendt liste af IP-adresser) der kan ses af migreringssystemet. Det er muligt at have mere end en IP-adresse registreret på whitelisten. Alle legale aktører som har behov for at indsende eller modtage migreringsfiler, vil blive kontaktet inden opstart af migreringen. En eller flere IP-adresser indsendes efterfølgende til Energinet.dk s migreringsteam. 2.3 Konfigurering af Firewall Hvis FTP-serveren tilgås via en firewall, bør nedenstående porte være åbne i denne: TCP: 20, 21, 500, 501, 989, 990 og 2000-2500 2.4 Download af FTP-klient I de følgende eksempler er Firezilla benyttet som FTP klient. FileZilla kan downloades gratis fra http://sourceforge.net/projects/filezilla eller lignende sites. Versionen kan både være Windows 32 eller 64 bit. FTP er en almindelig standard der bruges til filoverførsler, og den findes til alle operativsystemer og dermed også på størsteparten af kendt hardware. Nedenstående skærmbillede vil blive vist ved start af FileZilla. Dok. 13/100808-11 Side 4 af 13
Under værktøjslinjen og Lyntilslut vises meddelelser som fx overførselslog og tilslutningsrelaterede meddelelser. Nedenfor kan filoversigten findes. Den venstre kolonne Lokalt sted viser de lokale filer og mapper. Den højre kolonne Fjernsted viser filer og mapper på den tilsluttede fjernserver. Begge kolonner har en mappestruktur i toppen og en detaljeret liste over den aktuelt valgte mappes indhold i bunden. Der kan nemt navigeres via mappestrukturen og i lister ved at klikke, som i enhver anden stifinder. Nederst i vinduet vises filer i overførselskøen, der er opdelt i Filer i kø, Mislykkede overførsler og Gennemførte overførsler. 2.5 Opsætning af FTP En ny FTP-forbindelse laves via funktionen Websted Manager i FileZilla. For at åbne 'Websted Manager' trykkes på knappen "Åben Websted Manager"- i øverste venstre hjørne. Denne knap skal fremover bruges for at logge på. Dok. 13/100808-11 Side 5 af 13
Dok. 13/100808-11 Side 6 af 13
Ved tryk på "Nyt Websted" skal der angives et navn og nedenstående indstillinger. Navnet på webstedet kunne fx angives som Engrosmigrering Tab Felt Værd Generelt Vært 1) ftp.datahub.dk Generelt Protokol FTP - File Transfer Protocol Generelt Kryptering Forlang eksplicit FTP over TLS Generelt Logontype Normal Generelt Bruger <dit brugernavn> Generelt Kodeord <din adgangskode> Overførsels- indstillinger Overførselstilstand Passiv 1) Hvis der opstår problemer med domain-navnet, kan følgende IP-adresse anvendes: 10.240.17.92. Den angivne adresse er den nuværende. Energinet.dk kan dog ikke stille nogen garanti for, at der ikke foretages ændringer til IP-adressen under migreringsperioden. Dok. 13/100808-11 Side 7 af 13
2.6 Åben et websted Alle sites bliver vist, når der klikkes på pilen i øverste venstre hjørne. Derefter vælges blot det ønskede websted fx Engrosmigrering. Man kan også vælge at trykke på Åben Websted Manager og derfra vælge websted fra den viste webstedsliste. Dok. 13/100808-11 Side 8 af 13
Ved klik på Engrosmigrering oprettes der forbindelse til serveren. Når forbindelsen er etableret vil nedenstående skærmbillede blive vist. Hvis der ligger filer på fjernserveren, vil disse også blive vist. Underfolderen /REPORTS indeholder alle logfiler og filer eksporteret fra migreringen. Bemærk, at der i denne version af FTP-guiden findes en folder med navnet /BACKUP. Denne folder vil ikke være at finde, når datamigreringen åbner for ekstern adgang. Dok. 13/100808-11 Side 9 af 13
2.7 Mappe med overførsler Naviger under Lokalt sted til den mappe på eget system, hvor filerne til upload findes. I dette eksempel er der 4 datafiler som kan overføres til datamigreringen: Dok. 13/100808-11 Side 10 af 13
2.8 Indsendelse af data Datafiler kan indsendes på tre måder: Dobbeltklik på et filnavn for at uploade data (i den venstre rude: Lokalt sted ) Højreklik på filen og vælg Upload (i den venstre rude: Lokalt sted ) Foretag drag & drop (træk fil fra venstre side til højre side) I dette eksempel er filen Electrical_heating_2014103082900001.dat flyttet. Efter maksimalt et minut vil filen forsvinde fra FTP-serveren (Fjernsted). Dette skyldes, at filen nu er overført til selve migreringsløsningen. Fra dette tidspunkt vil migreringsoperatøren kunne se filen og starte import af data. Fortrydes indsendelsen af en datafil kan denne slettes på Fjernsted indenfor maksimalt et minut. Har migreringssystemet først flyttet filen, bør man kontakte migreringssupport for at undgå, at data migreres. Hvis filen ved en fejl bliver lagt i /REPORTS-folderen, vil der intet ske med filen. Det er muligt at slette den igen eller flytte den tilbage til / folderen igen (root-folder). Dok. 13/100808-11 Side 11 af 13
2.9 Hentning af data Datafiler kan hentes på tre måder: Dobbeltklik på et filnavn for at downloade data (i den højre rude: Fjernsted ) Højreklik på filen og vælg Download (i den højre rude: Fjernsted ) Foretag drag & drop (træk fil fra højre side til venstre side) I dette eksempel er filen DeltaLoad_101.dat flyttet. Filen er flyttet fra underfolderen /REPORTS. Prislisten (priselementer Filtype 0) har sin egen underfolder (PRICING), der er placeret i underfolderen /REPORTS. Dok. 13/100808-11 Side 12 af 13
2.10 Timeout i FileZilla Hvis det sker, at FileZilla laver TimeOut i forbindelse med upload af data, kan dette løses ved at ændre på et parameter i FileZilla. Vælg menupunktet Rediger -> Indstillinger : Under det første punkt Forbindelse kan Timeout sættes til den ønskede værdi, eller 0 for at slå timeout fra. Dok. 13/100808-11 Side 13 af 13