Update troubleshooting guide for v2. Remove homoglyph data files included with confusable-homoglyphs>=3.0
1.8 KiB
Troubleshooting
Something broken? Stuck on an issue? Can't get it set up?
Start by checking the issues - especially closed ones.
No answer?
Common Problems
pip install -r requirements.txt
is failing
It's probably a permissions issue. Ensure your current user can write to the virtual environment folder. That, or you're missing a dependency of some kind which will be indicated in the error message.
I'm getting an error 500 trying to connect to the website on a new install
Great. Error 500 is the generic message given by your web server when anything breaks. The actual error message is hidden in one of your auth project's log files. Read them to identify it.
Failed to configure log handler
Make sure the log directory is write-able by the allianceserver user: chmown -R allianceserver:allianceserver /path/to/myauth/log/
, then restart the auth supervisor processes.
Groups aren't syncing to services
Make sure the background processes are running: supervisorctl status myauth:
. If myauth:worker
or myauth:beat
do not show RUNNING
read their log files to identify why.
Task queue is way too large
Stop celery workers with supervisorctl stop myauth:worker
then clear the queue:
redis-cli FLUSHALL
celery -A myauth worker --purge
Press Control+C once.
Now start the worker again with supervisorctl start myauth:worker
Proxy timeout when entering email address
This usually indicates an issue with your email settings. Ensure these are correct and your email server/service is properly configured.