.. _troubleshooting:

Troubleshooting
----------------

Connecting to userstores
~~~~~~~~~~~~~~~~~~~~~~~~

If you have problems with the initial connection to your user store,
please check the log file ``/var/log/linotp/linotp.log`` for some occurrences like *module not found*. 
This may indicate, that you are missing some Python modules.

Distribution not Found: LinOTP2
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The error message::

   pkg_resources.DistributionNotFound: LinOTP 

will appear, when the LinOTP Python modules are not installed into your system correctly. 
There might be a problem with your Python search paths. See section :ref:`python_search_path`.

SQLAlchemy error 
~~~~~~~~~~~~~~~~
During installing or upgrading a LinOTP Debian package you might get the error::

   sqlalchemy.exc.OperationalError: (OperationalError) (1045, "Access denied for user 'linotp2'@'localhost'
   (using password: YES)") None None

This indicates that you either entered a wrong password for the LinOTP mysql user or that you changed the password
manually. You can solve this problem by reinstalling::

   dpkg –purge linotp 
   dpkg -i linotp-....

the LinOTP package.

Access denied for user root@localhost
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
During installing or upgrading a LinOTP Debian package you might get the error::

   ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES) 

During the first installation process you entered an SQL user, that did not exist yet.
But you either entered a wrong root password or the installer process does not remember 
the root password correctly (in fact the installer process does not remember the root password, so it will use no
password).

You can resolve this issue by::

   dpkg –purge linotp 
   dpkg -i linotp-....