Troubleshooting - NatLibFi/Annif GitHub Wiki
For troubleshooting and discussion, check out the Annif-users -mailing list/forum. Also feel free to open GitHub-issues if need be.
General
- To have more information on what might be wrong, it is possible see debug messages by adding
-v DEBUG
flag to a command. For example:$ cat document.txt | annif suggest tfidf-en -v DEBUG debug: creating app with configuration annif.default_config.Config debug: Suggesting subjects for text "Arkeologiaa sanotaan..." (len=307) debug: Backend tfidf: loading similarity index from data/projects/tfidf-en/tfidf-index debug: Backend tfidf: Suggesting subjects for text "Arkeologiaa sanotaan..." (len=307) debug: loading vectorizer from data/projects/tfidf-en/vectorizer debug: loading subjects from data/vocabs/yso-en/subjects debug: Got 100 hits from backend tfidf debug: 100 hits from backend <http://www.yso.fi/onto/yso/p17588> tai chi 0.3293267447549477 <http://www.yso.fi/onto/yso/p6298> water gymnastics 0.06801441885961519 <http://www.yso.fi/onto/yso/p6854> martial arts 0.06750483448477115 <http://www.yso.fi/onto/yso/p3914> ethnohistory 0.061006836768372916 <http://www.yso.fi/onto/yso/p18697> international matches 0.052560500151367734 <http://www.yso.fi/onto/yso/p19591> jujutsu 0.05164832265188628 <http://www.yso.fi/onto/yso/p17805> taekwondo 0.04821890373154558 <http://www.yso.fi/onto/yso/p22635> killer whale 0.04158137531400643 <http://www.yso.fi/onto/yso/p8059> museum roads 0.04156596842455262 <http://www.yso.fi/onto/yso/p12968> pediatricians 0.0413787581489993
Docker Troubles
-
Note that simple
docker run
ordocker-compose up
do not fetch a new version of an image, even if that existed in in a repository, but to use a more recent image than exists locally, you must dodocker pull IMAGE_NAME
ordocker-compose pull
. -
When using Docker with Windows, the
id -u
andid -g
commands will not work. Under Windows, Docker usually runs in its own virtual machine, and this virtual machine in turn is run by whoever installed it (and the permissions are set accordingly). You can try leaving the part withid
commands out when you've figured out how the permissions work in your setup... -
Windows and MacOS users should make sure the available memory for Docker is at least 8 GB (click the whale icon in the notification area, and select Settings -> Advanced).
-
In case you are using Docker on Windows or MacOS and you are having troubles with connecting to separetely run Mauiserver container, in
projects.cfg
use endpoint entry withhost.docker.internal
inplace oflocalhost
. If you are usingdocker-compose
, then in place oflocalhost
the endpoint entry should havemauiserver (or whatever name the service has you are trying to connect)
.