Troubleshooting FreeMED
From FreemedDeveloperWiki, the FreeMED developers' Wiki.
This section is meant to give common troubleshooting answers for setting up FreeMED.
Contents |
General LAMP(S) Configuration
To Apache or Apache2?
Many people seem to ask whether Apache or Apache2 should be used for FreeMED. It really depends on what you're looking to do, but FreeMED does work with both Apache 1.3.x and Apache 2.x. Apache 2.x seems to perform better when forking processes (which is done heavily in FreeMED's printing subsystem), so if you do a lot of printing, might be time to switch to Apache 2.
Never Run As Root
Kind of like not running with scissors. Don't ever run Apache or Apache2 as root. It's just asking for trouble. Run it as a non-priviledged user, and work around permissions. That goes for those who decide to run it under Windows-anything; don't run as Administrator then complain that something bad happened to your system. Take precautions.
PHP Memory Limit
For one reason or another, PHP comes by default with its memory limit per process set at 8 MB. While that may be okay for websites, it isn't good when loading large modules, which FreeMED likes to do. Find this line in your php4.ini file:
memory_limit = 8M ; Maximum amount of memory a script may consume (8MB)
And set it to 64M or something more reasonable.
Sessions and Cookies
Please be warned that 99% of all bad web-browser behavior is due to "Internet Explorer". Please don't use it, don't encourage anyone to use it, and please don't complain when it doesn't work properly. Friends don't let friends use IE.
Session Expiring
If your session is expiring after a short period of time, look in your php4.ini file (located in /etc/php4/apache/php4.ini or /etc/php4/apache2/php4.ini if you're using Debian). There should be a line like:
session.gc_maxlifetime = 1440
Change that number to be 7200 or something. It's the number of seconds that a session file is kept since last activity before it is marked as garbage and erased. I know, 1440 seconds isn't a long time. Increase it.
