MikroTik Adoptiefouten Oplossen

Samenvatting Deze handleiding behandelt de 5 meest voorkomende fouten die de adoptie van MikroTik-apparaten in MKController verhinderen, met diagnose en oplossing voor elk probleem. Behandelde problemen: verouderde RouterOS-versie, Device Mode blokkeert fetch, ontbrekend PPP-pakket, geen internet of DNS, en onvoldoende schijfruimte. Elk probleem bevat exacte RouterOS-commando’s.

Wat zijn de meest voorkomende MikroTik-adoptiefouten?

MikroTik-adoptie in MKController mislukt door een beperkt aantal voorspelbare oorzaken. De onderstaande tabel koppelt elke fout aan de oorzaak en het gedeelte waar u de oplossing vindt.

Foutsymptoom	Oorzaak	Oplossing
Adoptie blijft minuten hangen bij “VPN aanmaken”	RouterOS-versie te oud of incompatibel	Sectie 1
`failure: not allowed by device-mode`	Device Mode staat `fetch` niet toe	Sectie 2
`expected end of command (line 6 column 33)`	PPP-pakket niet geïnstalleerd	Sectie 3
`could not resolve host name` of `status: failed / reason: timeout`	Geen internettoegang of DNS-fout	Sectie 4
`fetch` mislukt met opslagfout	Minder dan 2 MB vrije schijfruimte	Sectie 5

1. Controleer RouterOS-versie

Symptoom

Adoptie wordt niet voltooid. Het proces blijft enkele minuten hangen bij de fase “VPN aanmaken”.

Diagnose

Het apparaat draait mogelijk een RouterOS-versie die incompatibel is met de vereiste functies van MKController. Controleer eerst de lijst met ondersteunde RouterOS-versies.

Oplossingsstappen

Controleer de geïnstalleerde versie en de beschikbare versie in het ingestelde updatekanaal:
Terminal window
```
/system package update check-for-updates
```
De uitvoer ziet er ongeveer zo uit:
```
installed-version: 6.49.10
latest-version: 6.49.12
status: New version is available
```
Als een update beschikbaar is en op de ondersteunde lijst staat, installeer deze:
Terminal window
```
/system package update install
```
Start het apparaat opnieuw op:
Terminal window
```
/system reboot
```
Probeer na het opnieuw opstarten het adoptieproces opnieuw.

2. Device Mode Advanced uitgeschakeld

Symptoom

Het uitvoeren van het adoptiescript via Winbox geeft:

executing script script1 from winbox failed, please check it manually
failure: not allowed by device-mode (/tool/fetch line 1)

Uitvoeren via terminal geeft:

failure: not allowed by device-mode

Device Mode-terminalfout tijdens MikroTik-adoptie

Diagnose

MikroTik’s Device Mode blokkeert de functies fetch, hotspot en scheduler. Dit treft sommige modellen met RouterOS 7.17 en later.

Oplossingsstappen

Controleer de huidige Device Mode-configuratie. Als fetch no toont, is het geblokkeerd:
Terminal window
```
/system device-mode print
```
Schakel Device Mode Advanced in:
Terminal window
```
/system device-mode update mode=advanced
```
Voer een harde herstart uit — koppel de MikroTik even fysiek los van de stroom. Een gewone software-herstart is niet voldoende; de Device Mode-wijziging geldt pas na een volledige stroomonderbreking.
Controleer na de harde herstart de wijziging:
Terminal window
```
/system device-mode print
```
Bevestig dat fetch nu yes toont en probeer adoptie opnieuw.

3. Ontbrekend PPP-pakket

Symptoom

Het uitvoeren van het adoptiescript geeft:

expected end of command (line 6 column 33)

Diagnose

Het PPP-pakket is niet geïnstalleerd op het apparaat. Het adoptiescript van MKController vereist PPP om de VPN-tunnel aan te maken.

PPP-pakket ontbreekt op MikroTik

Oplossingsstappen

Ga naar de MikroTik archief-downloadpagina en download de Extra Packages .zip voor de RouterOS-versie en apparaatarchitectuur (mipsbe, arm, smips, enz.) die bij uw apparaat past.
Pak het .zip-bestand uit en zoek ppp.npk.
Upload ppp.npk naar de router:
- Via het tabblad Winbox → Bestanden, of
- Via FTP of SCP
Start de router opnieuw op:
Terminal window
```
/system reboot
```
Na het opnieuw opstarten zou het PPP-menu in WebFig en Winbox zichtbaar moeten zijn. Probeer het adoptiescript opnieuw.

4. Problemen bij het uitvoeren van het script

Symptomen

failure: could not resolve host name
status: failed / reason: timeout

Diagnose

Het MikroTik-apparaat heeft geen internettoegang of kan geen DNS resolven. Beide zijn vereist voor het apparaat om MKController-servers te bereiken.

Oplossingsstappen

Test de basisinternetverbinding:
Terminal window
```
ping 8.8.8.8
```
Als er geen reactie is, onderzoek dan:
- Ontbrekende standaardroute: /ip route print
- NAT- of firewallregels die uitgaand verkeer blokkeren
- Fysieke verbinding met de provider
Zodra ping 8.8.8.8 werkt, test dan DNS-resolutie:
Terminal window
```
ping app.mkcontroller.com
```
Als dit mislukt, stel dan betrouwbare DNS-servers in:
Terminal window
```
/ip dns set servers=8.8.8.8,1.1.1.1
```
Start opnieuw op:
Terminal window
```
/system reboot
```
Probeer het adoptiescript opnieuw.

5. Onvoldoende schijfruimte

Symptoom

Fouten bij het uitvoeren van fetch of het installeren van pakketten, wat wijst op een opslagprobleem.

Diagnose

MikroTik vereist minimaal 2 MB vrije schijfruimte om het adoptiescript uit te voeren en het VPN-pakket te downloaden.

Oplossingsstappen

Controleer de beschikbare schijfruimte:
Terminal window
```
/system resource print
```
Als free-hdd-space minder dan 2 MB is, geef dan een lijst van de bestanden op het apparaat:
Terminal window
```
/file print
```
Verwijder onnodige bestanden of oude back-upbestanden:
Terminal window
```
/file remove <id>
```

Probeer het adoptieproces opnieuw na het vrijmaken van voldoende ruimte.

Nog steeds problemen?

Door deze vijf stappen te volgen worden de meeste MikroTik-adoptiefouten in MKController opgelost.

Als het probleem aanhoudt na het doorlopen van alle secties, neem dan contact op met ons supportteam via WhatsApp. Wij kunnen adoptielogboeken bekijken, de scriptuitvoering inspecteren en helpen bij het diagnosticeren van specifieke gevallen voor uw RouterOS-versie of hardwaremodel.