Magento 2 Service Temporarily Unavailable (503 Error)

Let op: maak je gebruik van Magento 1? Dan verwijzen we je graag door naar onze handleiding: Magento 1 Service Temporarily Unavailable (503 Error)

Over de Service Temporarily Unavailable (503 Error)

De Service Temporarily Unavailable (503 Error) is een bekende fout in Magento 2. Tijdens de installatie / upgrade van een Magento 2 plugin maakt het systeem het bestand maintenance.flag  aan om te laten zien dat het systeem in de onderhoudsmodus staat. Dit kan handig zijn om eventuele problemen die zich voordoen tijdens de installatie / upgrade van een plugin voor de bezoekers te verbergen. Het bestand wordt automatisch verwijderd nadat de algehele verwerking is voltooid. Maar soms wordt het niet automatisch verwijderd, of wordt het bestand opnieuw in het systeem aangemaakt. Dan moet het bestand handmatig verwijderd worden.

In deze handleiding laten we zien hoe je de website uit maintenance mode haalt en de 503 error oplost. De error ziet er als volgt uit:

Magento 2 Service Temporarily Unavailable (503 Error) verhelpen via cPanel

1. Log in op cPanel door jouw domeinnaam in te voeren gevolgd door /cpanel. Bijvoorbeeld www.domeinnaam.nl/cpanel.

inloggen cPanel

2. Navigeer vervolgens naar BESTANDEN > Bestandsbeheer.

Bestandsbeheer

3. Eenmaal in bestandsbeheer kies je rechts bovenin voor Instellingen.

Instellingen

4. Vink daar zowel Basismap van website (public_html or www) als Verborgen bestanden tonen (dotfiles) aan.

Voorkeuren

5. Klik vervolgens op Save om verder te gaan.

6. Ga naar de map var.

7. Doordat je het tonen van verborgen bestanden hebt aangevinkt is het bestand maintenance.flag zichtbaar. Selecteer het bestand maintenance.flag en klik op verwijderen.

8. Klik vervolgens op Delete File(s) om het bestand te verwijderen.

9. Controleer of de website werkt, deze moet inmiddels weer bereikbaar zijn.

Magento 2 Service Temporarily Unavailable (503 Error) verhelpen via SSH

Bovenstaande methode is een prima manier om de Magento 2 site uit maintenance mode te halen. Echter, Magento 2 is meer gericht op commando’s vanaf de shell. In onderstaande stappen laten we zien hoe je de 503 error oplost via SSH.

1. Log in met SSH (Nog niet verbonden met SSH? Doe dat dan eerst. Het verbinden met SSH kan op drie manieren. Voor alle drie de manieren hebben wij een handleiding geschreven: SSH verbinden met Windows, SSH verbinden met Mac OS X of SSH verbinden met Linux.) op de server van jouw domeinnaam.

2. Ga vervolgens naar public_html.

3. Met het volgende commando zie je welke mogelijkheden er zijn voor de maintenance mode:

php bin/magento | grep maintenance

Soorten maintenance mode

4. Met het volgende commando kun je zien of de maintenance mode aanstaat:

php bin/magento maintenance:status

Maintenance mode not active

4. Wanneer de maintenance mode op enabled staat, voer dan het volgende commando uit om de maintenance flag te verwijderen:

php bin/magento maintenance:disable

5. Controleer vervolgens of de website werkt. Mocht dit niet het geval zijn, dan moet je de cache flushen. Gebruik het volgende commando om de cache te flushen:

php bin/magento cache:flush

De website is nu weer bereikbaar.

in Magento 2
Was dit artikel behulpzaam?