1. First time setup


(Zie bijlagen voor de tekening van het script)


Voor het makkelijk aanpassen van bestanden en het bekijken van logs raad ik aan om de container en p-ap15 te mounten in je file explorer, dit doe je als volgt:

  • Run het volgende command in powershell: winget install -e --id "SSHFS-Win.SSHFS-Win".
  • Voeg een netwerk locatie toe in file explorer
  • P-AP15: \\sshfs\[email protected]
  • Bestmix container: \\sshfs\[email protected]!2022


Hiernaast raad ik ook aan om visual studio code te installeren voor het bekijken en aanpassen van de bestanden.


2. Bekende problemen.


  • Als het artikel (ingredient) niet in bestmix staat krijg je een error met het importeren
  • Als BestMix de grondstoffen van een partij heeft gebruikt archiveerd hij de partij, waneer het script oude partijen importeert en deze staat gearchiveerd krijg je een error van de API.


3. Logs bekijken.


Bij het openen van de netwerk locatie van de container zie je gelijk de log bestanden, dit kunnen er 2 zijn de Infolog en de Errorlog (Als de error log er niet is zijn er ook geen errors geweest).


3.1 Infolog


In de infolog zie je 2 verschillende berichten:

  • INFO
    • Eerst staat aangegeven of het over tarwe of rogge gaat, daarachter staat response bericht van de BestMix API (Hier zou je dus ook een error kunnen terug vinden van de BestMix API).
  • WARNING
    • Lots die eruit zijn gefilter om een error te voorkomen, meestal zijn dit de test gegevens zonder een partij code.

3.2 Errorlog


Hier worden alle errors van het script zelf geplaatst bijvoorbeeld als een loop een error geeft om een reden, lees deze error goed er staat in vermeld waar het script fout gaat.


3.3 Archive


De logs worden ook elke dag gearchiveerd, deze worden ook in de home directory geplaatst onder het mapje Error en Info, in de mapjes zie je de logs met als titel de datum.


4. Script config aanpassen


Bij het script zit een mapje "Configs" hierin kun je alle config file in Json format vinden, deze kun je vinden in de netwerkshare van de P-AP15 in het mapje DockerFile>BestMixScript.

LET OP: Na aanpassingen moet je de container opnieuw bouwen.


  • BaseConfig: API keys, rapportnummers, aantal resulaten per rapport
  • MappingConfig: Mapping die toepast op beide rapport
  • NutrientMapping: Welk variable van alis hoort bij welk varaible van bestmix
  • UnitMapping: Welk variable heeft welke eenheid Gr/Ton/%.... etc


5. Container opnieuw bouwen


  • Ga naar: https://10.100.1.34:9443/#!/2/docker/containers
  • Verwijder de BestMix container.
  • Verbind met de P-AP15-ssh
  • Voer de volgende commands uit:
    • cd DockerFile/
    • docker build . -f bestmixdockerfile.txt -t bestmixapi
    • docker run --privileged --name BestMix -v /home/administrator/BestmixLogs:/root --restart always -dp 2022:22 bestmixapi


6. Trouble shooten


Hierbij een paar simpelen troubleshoot dingen om te proberen.


6.1 Container

  • Heeft de container internet verbinding? kun je met ssh verbinden?
  • Is de service online? Dit kun je checken met: systemctl status bestmix.service
  • Herstart de service: systemctl restart bestmix.service
  • Run het script handmatig: runbestmix.sh
  • Check de logs van het script


6.2 API foutmelding

Op de website: https://bmpublicapi-prd.adifo.cloud/swagger/index.html , kun je testen met de API.

Zoek de import lots API call op en run deze handmatig met de try out knop, je kunt de API berichten die naar bestmix zijn gestuurd ook terug vinden op de container in het mapje "Messages".

Als je de message opzoekt die de error gaf en deze zelf probeert op de website kun je meestal wat meer info krijgen.