Troubleshooting IMPS


Installation issues

Pip issues

If you attempt to install IMPS using the directions provided and you encounter dependency errors running pip install -r requirements.txt you can attempt to resolve these by installing the libraries individually. For example, if the above command fails with a version error for the bcrypt library, you can try pip install bcrypt to install it.

Database issues

When IMPS is first installed, it will open a welcome page that will show you the status of various settings. If the database setting section has red indicators, or pages consistently return database errors, it's likely you database connection is misconfigured. To manually check your database, start your db server's interactive envornment (mysql -u root) and verify that your server is running and reachable. Then, attempt to login using the credentials you set in imps_cofig.toml ( mysql -u <user> -p <password>)

Included with IMPS in the static/backups directory is a setup.sql file that will create the necessary db structure. Check that this structure exists.

Directory issues

If you encounter problems with IMPS related to reading or writing files, check that the correct directories are set in imps_cofig.toml and that they are read/writable by whichever user account is running IMPS.

Password problems

If you cannot access IMPS because of problems with your password, view what it is set to in imps_cofig.toml and verify that you are using the same password to log in.