Indledende konfiguration
🇩🇰 Dansk | 🇬🇧 English
Forrige: Installer klienten
Åbn klienten. Du bør blive mødt med et vindue, som ser nogenlunde sådan ud:
Dette er klientens hovedvindue, hvorfra det meste foregår. Den består af en menulinje øverst med menuerne Competition og Help, samt seks paneler: Competition, Divisions, Online, Local, Update Results og Log. Lad dig ikke bekymre af advarslen om Invalid Path i loggen; den tager vi senere. Først og fremmest fokuserer vi på Online-panelet.
Online-panelet indeholder felter og knapper, som relaterer til elementerne på internettet. Feltet Division result server address angiver adressen til webserveren, hvor resultaterne vises. Feltet skulle gerne være fyldt ud på forhånd med et forslag, og hvis du er heldig, fører den foreslåede adresse til en division-result-server. Det kan vi finde ud af med det samme ved at trykke på Test-knappen. Serveren skulle så helst svare med statussen 404 Not Found og fortælle os, at der ikke findes nogen konkurrence med ID 0:
Selvom det teknisk set er en fejlbesked, er det i dette tilfælde et godt tegn: Serveren er online! Godt nok havde den ikke nogen konkurrence med det angivne ID, men det var helt som forventet.
Skulle du derimod modtage status og besked i stil med Request Failed og could not resolve host, var du knap så heldig. Så var der nemlig ikke nogen server på den angivne adresse. Det kan dog løses på flere måder: Hvis du mener, at der bør være en server tilgængelig på den adresse, kan du forsøge at kontakte serveradministratoren. Ellers kan det også være, at du kender nogen, som allerede har en passende server, du kan bruge. Til sidst er der også den mulighed, at du kan være serveradministratoren ved enten at køre serveren på egen hardware eller ved at administrere en maskine i skyen. Opsætning af serveren er noget mere omfattende end at bruge klienten, og det kræver en computer med en fast og offentligt synlig IP-adresse. Kig forbi serverdokumentationen, hvis det er dén vej, du vil gå.
Når du har etableret kontakt til en server, kan du gå videre til Local-panelet.
Det første felt heri angiver klientens "working directory" - arbejdsmappen. Tryk på ...-knappen ved siden af feltet og navigér til den mappe, du vil bruge til dette. Klienten kommer til at skrive midlertidige filer og logfiler her, så vælg en mappe, hvor programmet har skrivetilladelse. Jeg foreslår at oprette en ny mappe specifikt til formålet, så eksisterende filer ikke fejlagtigt overskrives - eksempelvis en mappe på skrivebordet eller ved siden af andre filer til divisionsmatchen.
Det næste felt fortæller klienten, hvor den kan finde en installation af Divisionsmatchberegning. Kontrollér først, at du har den korrekte version af Divisionsmatchberegning installeret, så pointberegningen følger det aktuelle reglement. Tryk derefter på ...-knappen og navigér til Divisionsmatch.exe. Det løser også Invalid Path-problemet, som vi blev advaret om tidligere.
Det sidste felt i Local-panelet indikerer, hvor klienten kan kontakte MeOS' informationsserver. Klienten bruger nemlig informationsserverens API til at hente resultater fra MeOS. Informationsserveren startes i MeOS fra din konkurrences Autofunktioner-fane. Hvis informationsserveren og klienten kører på samme computer, så bør standardindstillingerne virke helt uden firewallkonfiguration. I så fald kan den foreslåede adresse (http://localhost:2009/meos) benyttes. Informationsserveren kan dog køres på enhver computer, der kan tilgås via det lokale netværk eller endda internettet, men det kræver muligvis yderligere netværkskonfiguration.
Log-panelet i højre side af hovedvinduet er klientens primære værktøj til kommunikation om klientens og serverens tilstande og handlinger. Når klienten kommunikerer med eksterne programmer og tjenester eller udfører kritiske, interne opgaver, vil tilbagemeldinger og resultater fremgå i loggen. Derudover kan de også gemmes i logfiler i arbejdsmappen, enten i HTML-format (ligesom i log-panelet), rå tekst eller begge dele. Hvert logpunkt er opbygget af tre bestanddele: tidspunkt, statuslinje og besked.
Tidspunktet viser den lokale tid, da logpunktet blev skrevet. Det følger formatet yyyy-MM-dd HH:mm:ss som foreslået af ISO 8601-standarden.
Statuslinjen indeholder en del mere information. Først og fremmest svarer farven til forskellige typer af logpunkter:
| Farve | Type | Beskrivelse |
|---|---|---|
| Blå | Info | Ikke-kritisk information, fx når en ny version er tilgængelig |
| Grøn | Succes | En handling eller anmodning blev gennemført uden problemer |
| Orange | Advarsel | Noget er ikke helt rigtigt, og du bør nok undersøge det |
| Rød | Fejl | Noget gik galt og forhindrede en handling eller anmodning i at gennemføres |
Teksten på statuslinjen kan deles op i tre segmenter: kilde, handling og resultat. Kilden indikerer softwaren eller tjenesten, som producerede logpunktet, fx Internal (klienten selv), MeOS eller Web Server. Handlingen er en meget kort beskrivelse af, hvad der blev forsøgt udført. Resultatet sætter et par ord på, hvordan handlingen gik.
Logpunktets tredje bestanddel, beskeden, er typisk den største. For fejl og advarsler vil den ofte give en lidt nærmere beskrivelse af problemet. Ellers kan beskeden også indeholde formateret tekst eller data, eller måske et link til downloadsiden for en ny version. Formateret tekst og data vil ofte være pakket ind i HTML, XML eller JSON. De beskeder, som klienten modtager i HTML- og XML-format, er dog i mange tilfælde store og af begrænset kommunikationsværdi, så de udelades fra loggen.
Når klienten kommunikerer med MeOS og server, foregår det via HTTP, som har en række standardiserede tilbagemeldinger. Logpunkter dannet på baggrund af HTTP-tilbagemeldinger vises statuskoden- og teksten som resultat i statuslinjen.
Lad os afrunde logbeskrivelsen med et eksempel. Tidligere afprøvede vi forbindelsen til serveren med Test-knappen, hvilket gav et logpunkt, der så nogenlunde sådan ud:
På den første linje står der 2023-09-27 21:03:18, som naturligvis er tidspunktet.
Den anden linje er statuslinjen, hvor der står Web Server / Test: 404 Not Found. Den kan opdeles i kilde: Web Server, handling: Test og resultat: 404 Not Found. Da vi trykkede på Test-knappen, sendte vi en HTTP-anmodning til serveren. Serverens tilbagemelding dannede grundlag for logpunktet, så kilden er Web Server. Tilbagemeldingen var en reaktion på vores Test-anmodning, så handlingen er Test, og serveren svarede med en af HTTPs standardtilbagemeldinger - i dette tilfælde 404 Not Found.
Den tredje linje er beskeden, som giver en lidt mere detaljeret forklaring pakket ind i JSON-syntax: {"message":"No competition exists with ID 0"}. Serveren begrunder dens 404 Not Found-tilbagemelding: Den anmodede konkurrencer findes simpelthen ikke. I hvert fald ikke endnu...
Næste: Opret din konkurrence