git.joshuawise.com / patchfork.git / blame
| Commit | Line | Data |
|---|---|---|
| 964dd0bc JW |
1 | Installation instructions |
| 2 | ||
| 3 | 1. Put either the pitchfork.conf or pitchfork_domain.conf file, found in this doc/ directory, | |
| 4 | in /etc/http/conf.d (or where your extra config-files are) | |
| 5 | and make sure they specify the correct directories for pitchfork. | |
| 6 | 2. Apache needs to have write access to the config directory: | |
| 7 | - Go to where you installed pitchfork | |
| 8 | - chown apache config (or whatever user apache is run as, can be 'nobody') | |
| 9 | to find out who the apache-user is check output from "ps auxww | grep httpd || ps auxww|grep apache" | |
| 10 | 3. Reload/restart apache | |
| 11 | 4. Open your web-browser to where you installed apache and answer the questions ;) | |
| 12 | ||
| 13 | Apache access logs | |
| 14 | The client by default requests information every second from the server, this means that a lot of | |
| 15 | stuff will end up in your access log. To disable logging of the these requests you will have to | |
| 16 | change the CustomLog directive in apache. It should be sufficient to add env=!pitchforknolog after it | |
| 17 | (if you have used the given .conf file) | |
| 18 | ||
| 19 | Example customlog directive: | |
| 20 | CustomLog logs/access_log combined env=!pitchforknolog | |
| 21 | ||
| 22 | For more information about logs: | |
| 23 | http://httpd.apache.org/docs/2.0/logs.html#accesslog | |
| 24 | ||
| 25 | Required PHP-Modules: | |
| 26 | Usually shipped with the php-distribution, but listed here for modular php-implementations. | |
| 27 | - Hash | |
| 28 | - SimpleXML | |
| 29 | - JSON (not required, but highly recommended) | |
| 30 | ||
| 31 | ||
| 32 | When you have problems: | |
| 33 | ||
| 34 | * apache refuses to start and you see "invalid command php_flag" | |
| 35 | * The only thing you see is some PHP-code | |
| 36 | - You have to enable PHP in httpd.conf, make sure you have | |
| 37 | "LoadModule php5_module modules/libphp5.so" somewhere in the config file | |
| 38 | ||
| 39 | * All you see is a blank page OR | |
| 40 | * Warning: require_once(PEAR/Exception.php) [function.require-once]: | |
| 41 | failed to open stream: No such file or | |
| 42 | directory in <something>/pitchfork/inc/Net/MPD.php | |
| 43 | - You need to install php-pear (might also be called PEAR-PEAR) | |
| 44 | ||
| 45 | * Allowed memory size of .. bytes exhausted in apache error log | |
| 46 | - You need to increase the allowed memory size in php.ini, | |
| 47 | set memory_limit to at least 64M | |
| 48 | ||
| 49 | * No metadata (ie. images/lyrics/etc) is showing | |
| 50 | - make sure allow_url_fopen is set to on in php.ini and that the config/ directory | |
| 51 | is writeable by apache | |
| 52 | ||
| 53 |