Troubleshooting
========================================

This chapter is a collection of known problems that can arise when installing PiAnoS. If a problem you have solved is not described here, feel free to drop me a line with the platform, problem, and steps to resolve.

Misc
------------------------------

	* require_one( unil/api.php ): failed to open stream: no such file of directory in .../Node.php on line 22

	This error is due to the fact that the "php_classes" are not located in the correct location. The files have to be in the php shared folder (/usr/share/php for debian, somewhere in the php installation folder for windows). Check the location of thoses files. They can not be located in the PiAnoS folder.

	* The images can not be uploaded to PiAnoS (error or not displayed on the interface)
	
	Please check the "php.ini" file for the upload configuration (change the maximum allowed file size). It is also possible that the imagemagic (and related) packages are not installed and loaded on the system; check the installation page for details on how to install the image related packages.
	
	* Some tools randomly freeze
	
	Save the work and reload the page. Please send a mail with the procedure to reproduce the problem (activation/deactivation of a tool, sequence of actions, ...).

Linux
------------------------------

	* Invalid locale: en_US.UTF-8
	
	This can happen if your system does not use US English as its main language. To install the appropriate locale (and until PiAnoS is fully internationalized), use the command ``dpkg-reconfigure locales`` (as root). Look for ``en_US.UTF-8`` in the list, select the item (with the spacebar key), press tab to highlight the OK button and press enter. Check the `Dockerfile` for more details on how to configure the locale.

	
Windows
------------------------------
