From 785cd47c48cbb87caeeaf07fe69534120509f840 Mon Sep 17 00:00:00 2001 From: Jeremy Stretch Date: Thu, 19 Oct 2017 15:01:40 -0400 Subject: [PATCH] Created Common Issues (markdown) --- Common-Issues.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 Common-Issues.md diff --git a/Common-Issues.md b/Common-Issues.md new file mode 100644 index 0000000..982dda1 --- /dev/null +++ b/Common-Issues.md @@ -0,0 +1,22 @@ +* [ProgrammingError Exception Following a Recent Upgrade](#programmingerror-exception-following-a-recent-upgrade) +* [502 Bad Gateway Error When Calling NAPALM API](#502-bad-gateway-error-when-calling-napalm-api) + +## ProgrammingError Exception Following a Recent Upgrade + +### What's Happening + +Django (the Python framework on which NetBox runs) is attempt to access or modify a database field which doesn't exist. The full exception class is `django.db.utils.ProgrammingError`. + +### Recommended Solution + +This is most commonly happens when new code is being run without first applying the necessary database migrations. Migrations are normally handled by the included upgrade script, but you can try applying them manually with the command `python3 manage.py migrate`. If this command indicates that new migrations have been applied successfully, try accessing NetBox again. + +## 502 Bad Gateway Error When Calling NAPALM API + +### What's Happening + +NetBox is using NAPALM to request information from a device, but the WSGI process is timing out before the device responds. + +### Recommended Solution + +You can increase the timeout of the WSGI process so that it waits longer for the device to respond. For example, you can set `timeout=60` in your Gunicorn configuration file. (Gunicorn's default timeout is 30 seconds.) Keep in mind that there's also a timeout value controlled by your HTTP daemon (e.g. nginx or Apache), which determines how long it will wait for a response from the WSGI service. This timeout must be equal to or greater than the WSGI timeout. \ No newline at end of file