allianceauth/docs/maintenance/troubleshooting.md
Basraah 17dd7c04c7 Replace django-celery with base Celery (#791)
Update celery tasks to new style & remove djcelery
Vanilla celery + django-celery-beat take over the role of djcelery. Task schedules are consolidated into settings instead of residing in code.
Update docs and example supervisor configs.
2017-05-03 16:53:16 -04:00

2.4 KiB

Troubleshooting

Something broken? Stuck on an issue? Can't get it set up?

Start here:

  • check the issues - especially closed ones
  • check the forums

No answer?

Common Problems

pip install -r requirements.txt is failing

Either you need to sudo that command, or it's a missing dependency. Check the list, reinstall, and try again.

I'm getting an error 500 trying to connect to the website on a new install

Read the apache error log: sudo less /var/log/apache2/error.log. Press Shift+G to go to the end of the file.

If it talks about failing to import something, google its name and install it.

If it whines about being unable to configure logger, see below.

Failed to configure log handler

Make sure the log directory is write-able: chmod -R 777 /home/allianceserver/allianceauth/log, then reload apache/celery/supervisor/etc.

Groups aren't syncing to services

Make sure the background processes are running: ps aux | grep celery should return more than 1 line. More lines if you have more cores on your server's processor. If there are more than two lines starting with SCREEN, kill all of them with kill # where # is the process ID (second column), then restart with these background process commands from the allianceauth directory. You can't start these commands as root.

If that doesn't do it, try clearing the worker queue. First kill all celery processes as described above, then do the following:

redis-cli FLUSHALL
celery -A alliance_auth worker --purge

Press Control+C once.

Now start celery again with these background process commands.

While debugging, it is useful to see if tasks are being executed. The easiest tool is flower. Install it with this: sudo pip install flower, then start it with this: celery flower --broker=amqp://guest:guest@localhost:5672//. To view the status, navigate to your server IP, port 5555.